Démarrer avec RDCore
This document is available in English
Note
La plateforme est en alpha. Attendez-vous à des aspérités, et à des changements d'une version à l'autre.
Obtenir la plateforme
Téléchargez l'archive de votre système parmi les versions publiées de RDCore : rdcore-<version>-win-x64.zip pour Windows, ou un .tar.gz pour Linux et macOS. La plateforme a besoin du runtime .NET 11 de l'architecture de votre système.
- Extrayez l'archive dans un dossier qui lui est propre. Sous Linux et macOS, extrayez-la avec
tar -xzf, qui conserve le bit d'exécution des programmes. Sous macOS, levez ensuite la quarantaine du dossier :xattr -dr com.apple.quarantine <dossier>. - Ouvrez un terminal dans le dossier
RDCore.CLIdu dossier extrait et lancez.\rdc install(Windows) ou./rdc install(Linux et macOS). La commande installe la plateforme pour votre compte d'utilisateur et metrdcdans votre PATH (voir Installer la plateforme). - Ouvrez un nouveau terminal :
rdcse lance de n'importe quel dossier. Vous pouvez ensuite supprimer le dossier extrait.
Les programmes ne sont pas signés; sous Windows, SmartScreen peut donc vous en avertir.
Pour plutôt construire la plateforme à partir de son code source, avec le SDK .NET 11, voir Compiler la plateforme à partir des sources. rdc install installe de la même façon une plateforme que vous avez construite, à partir de son dossier RDCore.CLI.
Le shell RD-VBA
Lancez rdc dans un terminal. Si tout va bien, vous voyez l'écran d'accueil de la plateforme :

Vous voilà quelque part entre le mode programme du BASIC du Commodore 64, le volet exécution (immediate) du VBIDE, et un éditeur moderne :
- Tapez
HELPpour la liste des commandes. - Tapez n'importe quelle instruction RD-VBA pour l'exécuter sur-le-champ :
Debug.Print 6 * 7. - Commencez une ligne par un numéro de ligne pour l'écrire dans le programme courant :
10 Debug.Print "Bonjour", puis listez-le avecLISTet exécutez-le avecRUN.
Toutes les commandes du shell, et les commandes que rdc exécute sans le shell, sont dans Le shell et les commandes rdc.
Apporter un projet VBA
RDCore travaille avec les fichiers sources de votre projet, exportés de l'éditeur VBA. Rubberduck (legacy) exporte un projet entier en un clic; le VBIDE exporte un module à la fois, à moins de l'automatiser avec la bibliothèque VBIDE Extensibility.
Placez les fichiers exportés dans un dossier à part, puis faites-en un espace de travail RDCore. À partir du dossier RDCore.CLI :
rdc new <chemin>
Cette commande écrit un fichier .rdproj dans ce dossier, qui nomme chaque fichier source qu'elle y trouve. Les fichiers qu'elle ne reconnaît pas sont listés sous « autres fichiers » : ils font quand même partie de l'espace de travail, simplement pas du code source.
Ouvrez ensuite le shell sur cet espace de travail avec rdc --workspace <chemin>.
Un projet Visual Basic 6 obtient plutôt son .rdproj de son .vbp : voir Projets VB6.
Utiliser RDCore à partir d'un IDE
Le shell est amusant, mais le vrai travail se fait dans le serveur de langage derrière lui, et un serveur de langage a besoin d'un éditeur. Nous recommandons HexIDE, conçu pour les développeurs VB : voir RDCore dans HexIDE.
Bon à savoir
- RDCore s'exécute en 64 bits, alors ce qu'il charge doit l'être aussi :
- les UserForms requièrent Office 64 bits (Microsoft Forms 2.0 en 64 bits);
- la bibliothèque d'une instruction
Declaredoit être une DLL 64 bits; - l'automatisation d'Office (
CreateObject("Excel.Application")) requiert que l'application Office soit installée.
- Vos paramètres sont conservés dans
%APPDATA%\RDCore, et les journaux dans%LOCALAPPDATA%\RDCore\Logs. Rien n'est écrit dans le dossier de la plateforme : mettre à jour, c'est remplacer ce dossier. - RDCore parle français et anglais, et suit la langue d'affichage de votre machine.
CONFIG Environment.Regional.Language en(oufr) en choisit une au prochain démarrage de RDCore. Ce paramètre ne change pas la façon d'écrire les nombres ni les dates. - Vos projets vous appartiennent : la GPLv3 couvre RDCore lui-même, et non le code que vous écrivez ni ce que RDCore en construit (voir l'AVIS).
- Vous voulez contribuer, ou bâtir sur la plateforme? Voyez Bâtir sur RDCore.
Note
La version française des documents techniques, lorsque disponible, utilise les termes originaux en anglais qui conservent la précision de leur signification, plutôt qu'une traduction approximative qui pourrait facilement être plus confondante qu'utile.
ACCUEIL • HOME | ℹ️ BIENVENUE • WELCOME | 🧩 BÂTISSONS • BUILD | RD-VBAL | SDK | 🌐 rubberduckvba.ca