Repository navigation
Releases
RDCore 0.1.0-alpha (preview)
The first public prerelease of the RDCore platform. RDCore runs and analyzes VBA and Visual Basic 6 code outside the VBA editor. It implements the language from its specification, MS-VBAL, with a runtime of its own, on Windows, Linux and macOS.
What this version has
- The RD-VBA shell: run
rdcand type a statement to run it right away, or write a program line by line. - The
rdccommands: run a project's program (rdc run), or build it into an executable (rdc build). - The language server: diagnostics, completion, signature help, hover, rename, references and navigation, for any editor that speaks the Language Server Protocol.
- VBA and VB6 projects: from the source files exported from the VBA editor, or from a VB6 project.
Getting started has every step.
In HexIDE
The RDCore add-in for HexIDE is available from within HexIDE v0.5.0 and later versions, and is published separately from the platform. It uses the platform rdc install installed, or installs this release itself, with your consent (see RDCore in HexIDE). The add-in is signed with RDCore's publisher key. HexIDE shows its fingerprint on the Publisher row of the add-in trust view (Tools → Options → Add-Ins):
85B8 053E D1A2 E466 F45A 7B03 B69E 13CA 4B98 46A2 9F55 A373 73D7 810B DC4F DFED
A package with any other fingerprint was not signed by RDCore: do not install it.
Preview build. RDCore 0.1.0-alpha is a prerelease for evaluation, not a certified build.
Built from commit 3f095c2 by this workflow run.
Downloads
| System | Archive |
|---|---|
| Windows x64 | rdcore-0.1.0-alpha-win-x64.zip |
| Linux x64 | rdcore-0.1.0-alpha-linux-x64.tar.gz |
| macOS on Intel (x64) | rdcore-0.1.0-alpha-osx-x64.tar.gz |
| macOS on Apple silicon (arm64) | rdcore-0.1.0-alpha-osx-arm64.tar.gz |
Each archive has its release metadata beside it, rdcore-0.1.0-alpha-<system>.release.json (the release.json it contains), and SHA256SUMS covers them all.
Requirements
- The .NET 10 runtime (
Microsoft.NETCore.App) for the archive's architecture. Every archive is framework-dependent and does not include it; itsrelease.jsonrecords the minimum version. - Windows x64. RDCore runs as a 64-bit process, so UserForms need 64-bit Office (the 64-bit Microsoft Forms 2.0), a
Declarestatement's library must be a 64-bit DLL, and Office automation needs the Office application installed. - Linux and macOS. The platform has no automation servers there: a program that creates an object of one (
CreateObject, orNewof a library's class such asScripting.Dictionary) gets error 429. It can still be analyzed.
Installing
- Extract the archive into a folder of its own. The archive's top level is the platform root (
rdcore.json); keep the tree together. On Linux and macOS, extract it withtar -xzf, which keeps the executables' execute bit. On macOS, then clear the extracted folder's quarantine (see Verifying below). - In the extracted folder's
RDCore.CLIfolder, run.\rdc install(Windows) or./rdc install(Linux and macOS). It copies the platform intoRDCore/Platform/versions/0.1.0-alpha/in your local application data folder, where the RDCore add-in for HexIDE installs it too, and putsrdcon your PATH: open a new terminal to use it. Installing the platform describes its options. - An IDE launches the language server with its own folder as the working directory, as
launch.languageServerinrelease.jsondescribes:RDCore.LanguageServer.exe --client-process-id <client pid> --pipe-name <pipe> --workspace <workspace>on Windows, andRDCore.LanguageServerwith the same arguments elsewhere. Pass the client's own process ID: without it, the server and the processes it starts keep running if the client dies. - Do not set
RDCORE_PLATFORM_ROOTglobally: each server finds its platform root from its own location, and a global value would point every installed version at one tree.
Verifying
sha256sum -c --ignore-missing SHA256SUMS
gh attestation verify rdcore-0.1.0-alpha-win-x64.zip -R rubberduck-vba/RDCore --signer-workflow rubberduck-vba/RDCore/.github/workflows/release.yml --source-ref refs/tags/v0.1.0-alphaThe second line takes any of the archives, or a .release.json. On macOS, shasum -a 256 -c SHA256SUMS checks the sums once every asset is downloaded.
The binaries are not code-signed. On Windows, SmartScreen may warn about them, and Smart App Control may block them. On macOS, Gatekeeper refuses to start a downloaded program that Apple has not notarized: once you trust the archive, clear the quarantine of the extracted folder with xattr -dr com.apple.quarantine <folder>.
Source and licences
SOURCE.md in each archive says where the corresponding source is: https://github.com/rubberduck-vba/RDCore/tree/v0.1.0-alpha. RDCore is licensed under the GPLv3 or later (LICENSE-GPLv3.md), with NOTICE.md saying what it covers; THIRD-PARTY-NOTICES.txt lists the packages the archive contains and their licences, the MIT-licensed RDCore.SDK package among them, with the RDCore.SDK.Protocol assembly inside it.