La Core Extension costituisce le fondamenta della suite WvdS FPC RAD Studio. Fornisce servizi centrali utilizzati da tutte le altre estensioni.

La Core Extension è obbligatoria per tutte le altre estensioni WvdS. Offre:

• Gestione toolchain - Gestione centralizzata di tutti i percorsi dei compilatori
• Rilevamento automatico - Ricerca automatica degli strumenti installati
• Servizi condivisi - Servizi comuni per logging, configurazione, RPC
• Integrazione WSL - Cross-compilation sotto Windows

Il dialogo mostra tutti gli strumenti supportati in una tabella chiara:

Il rilevamento automatico cerca nei percorsi di installazione tipici:

Windows:

• %LAZARUS%\fpc\*
• %PROGRAMFILES%\Free Pascal\*
• %LOCALAPPDATA%\Programs\FPC\*
• Variabile d'ambiente PATH

Linux:

• /usr/lib/fpc/*
• /usr/local/lib/fpc/*
• ~/.fpc/*
• Variabile d'ambiente PATH

macOS:

• /usr/local/lib/fpc/*
• /opt/homebrew/lib/fpc/*
• Variabile d'ambiente PATH

Tutte le impostazioni iniziano con wvds.toolchain. o wvds.core.:

{
  // Percorsi dei compilatori
  "wvds.toolchain.fpcPath": "",
  "wvds.toolchain.pas2jsPath": "",
  "wvds.toolchain.lazbuildPath": "",
  "wvds.toolchain.innoSetupPath": "",
  "wvds.toolchain.makePath": "",
 
  // Configurazione WSL (solo Windows)
  "wvds.toolchain.wslEnabled": false,
  "wvds.toolchain.wslDistribution": ""
}

{
  // Livello di log: debug, info, warn, error
  "wvds.core.logLevel": "info"
}

La Core Extension fornisce un servizio di logging centralizzato.

Tutte le estensioni WvdS scrivono nell'Output Channel condiviso „WvdS“.

Apertura:

1. View → Output
2. Nel dropdown selezionate „WvdS“
3. Oppure: eseguite 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

Su Windows, l'integrazione WSL consente la cross-compilation per Linux.

1. Windows 10/11 con WSL 2
2. Una distribuzione Linux installata (es. Ubuntu)
3. FPC installato nell'ambiente WSL

1. Installate FPC in WSL:

   sudo apt update
   sudo apt install fpc

2. Attivate WSL nelle impostazioni:

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

3. Riavviate VS Code

Con WSL attivato potete:

• Creare binari Linux sotto Windows
• Utilizzare unit specifiche per Linux
• Generare entrambi i target (Windows + Linux) da un progetto

Altre estensioni possono utilizzare i servizi Core. Vedere Riferimento API Core per i dettagli.

Sintomo: „WVDS: Hello“ non mostra alcun output.

Soluzione:

1. Controllate la VS Code Developer Console (Help → Toggle Developer Tools)
2. Cercate messaggi di errore con „wvds“
3. Assicuratevi che VS Code sia >= 1.85.0

Sintomo: Il comando non mostra alcuna reazione.

Soluzione:

1. Verificate se la Core Extension è attivata
2. In Extensions: cercate „WvdS Core“, controllate lo stato
3. Disattivate e riattivate l'estensione

Sintomo: Tutti gli strumenti rimangono contrassegnati in rosso.

Soluzione:

1. Verificate se gli strumenti sono effettivamente installati
2. Assicuratevi che i percorsi siano leggibili
3. Configurate i percorsi manualmente

• Installazione e configurazione
• Build Extension
• Projects Extension
• Core API per sviluppatori (Interno)