WvdS VSCode Core

The Core extension forms the foundation of the WvdS FPC RAD Studio suite. It provides central services used by all other extensions.

The Core extension is mandatory for all other WvdS extensions. It provides:

• Toolchain Management - Central management of all compiler paths
• Auto-Detection - Automatic discovery of installed tools
• Shared Services - Common services for logging, configuration, RPC
• WSL Integration - Cross-compilation on Windows

The dialog shows all supported tools in a clear table:

Auto-detection searches typical installation paths:

Windows:

• %LAZARUS%\fpc\*
• %PROGRAMFILES%\Free Pascal\*
• %LOCALAPPDATA%\Programs\FPC\*
• PATH environment variable

Linux:

• /usr/lib/fpc/*
• /usr/local/lib/fpc/*
• ~/.fpc/*
• PATH environment variable

macOS:

• /usr/local/lib/fpc/*
• /opt/homebrew/lib/fpc/*
• PATH environment variable

All settings begin with wvds.toolchain. or wvds.core.:

{
  // Compiler paths
  "wvds.toolchain.fpcPath": "",
  "wvds.toolchain.pas2jsPath": "",
  "wvds.toolchain.lazbuildPath": "",
  "wvds.toolchain.innoSetupPath": "",
  "wvds.toolchain.makePath": "",
 
  // WSL configuration (Windows only)
  "wvds.toolchain.wslEnabled": false,
  "wvds.toolchain.wslDistribution": ""
}

{
  // Log level: debug, info, warn, error
  "wvds.core.logLevel": "info"
}

The Core extension provides a central logging service.

All WvdS extensions write to the shared Output Channel „WvdS“.

To open:

1. View → Output
2. Select „WvdS“ from the dropdown
3. Or: Run WVDS: Show Log

[2024-01-15 14:30:22] [INFO] Toolchain: FPC detected at %LAZARUS%\fpc\3.2.2\bin\i386-win32\fpc.exe
[2024-01-15 14:30:22] [INFO] Toolchain: Version 3.2.2
[2024-01-15 14:30:23] [WARN] Toolchain: pas2js not found in PATH

On Windows, WSL integration enables cross-compilation for Linux.

1. Windows 10/11 with WSL 2
2. A Linux distribution installed (e.g., Ubuntu)
3. FPC installed in the WSL environment

1. Install FPC in WSL:

   sudo apt update
   sudo apt install fpc

2. Enable WSL in settings:

   {
     "wvds.toolchain.wslEnabled": true,
     "wvds.toolchain.wslDistribution": "Ubuntu-22.04"
   }

3. Restart VS Code

With WSL enabled, you can:

• Create Linux binaries on Windows
• Use Linux-specific units
• Generate both targets (Windows + Linux) from one project

Other extensions can use Core services. See Core API Reference for details.

Symptom: „WVDS: Hello“ shows no output.

Solution:

1. Check the VS Code Developer Console (Help → Toggle Developer Tools)
2. Search for error messages containing „wvds“
3. Ensure VS Code >= 1.85.0

Symptom: The command shows no response.

Solution:

1. Check if the Core extension is activated
2. In Extensions: Search for „WvdS Core“, check the status
3. Disable and re-enable the extension

Symptom: All tools remain marked red.

Solution:

1. Verify the tools are actually installed
2. Ensure the paths are readable
3. Configure paths manually

• Installation and Configuration
• Build Extension
• Projects Extension
• Core API for Developers (Internal)