Installazione e configurazione

Questa guida descrive la configurazione completa di WvdS FPC RAD Studio per VS Code.

Installate VS Code da code.visualstudio.com. Versione minima: 1.85.0.

Verifica della versione installata:

code --version

Opzione A: Bundle Lazarus (consigliato)

L'IDE Lazarus include FPC. Download: lazarus-ide.org

Percorsi di installazione tipici:

• Windows: %LAZARUS%\fpc\3.2.2\bin\i386-win32\fpc.exe
• Linux: /usr/lib/fpc/3.2.2/fpc
• macOS: /usr/local/lib/fpc/3.2.2/fpc

Opzione B: FPC standalone

Download: freepascal.org

Verifica:

fpc -iV

Output atteso: 3.2.2 o superiore.

pas2js è il transpiler Pascal-to-JavaScript per applicazioni browser e Node.js.

Installazione via Lazarus:

Cercate „pas2js“ nel Lazarus Online Package Manager e installatelo.

Installazione manuale:

Download: wiki.freepascal.org/pas2js

Verifica:

pas2js -h

1. Aprite VS Code
2. Cliccate sull'icona Extensions (Ctrl+Shift+X)
3. Cercate „WvdS FPC“
4. Installate le estensioni desiderate:
   • WvdS VSCode Core - Obbligatoria
   • WvdS VSCode Build - Consigliata
   • WvdS VSCode Projects - Consigliata
   • WvdS VSCode UI Designer - Per sviluppo PXAML
   • WvdS VSCode UI Meta - Per IntelliSense
   • WvdS VSCode UI Preview - Per anteprima live
   • WvdS VSCode Packaging - Per creazione VSIX

# Installazione base
code --install-extension wvds.wvds-vscode-core
code --install-extension wvds.wvds-vscode-build
code --install-extension wvds.wvds-vscode-projects
 
# Sviluppo UI
code --install-extension wvds.wvds-vscode-ui-designer
code --install-extension wvds.wvds-vscode-ui-meta
code --install-extension wvds.wvds-vscode-ui-preview
 
# Packaging
code --install-extension wvds.wvds-vscode-packaging

Per installazione offline o distribuzione interna:

1. Scaricate i file .vsix
2. In VS Code: Extensions → … → Install from VSIX…
3. Selezionate il file .vsix

Dopo l'installazione della Core Extension, i percorsi dei compilatori devono essere configurati.

La suite cerca automaticamente di trovare gli strumenti installati:

1. Aprite la palette dei comandi: Ctrl+Shift+P
2. Eseguite: WvdS: Toolchain Configuration…
3. Il dialogo mostra gli strumenti rilevati con segni di spunta verdi
4. Gli strumenti non trovati sono contrassegnati in rosso

Se il rilevamento automatico fallisce, i percorsi possono essere impostati manualmente:

Via Settings UI:

File → Preferences → Settings → Cercate „wvds.toolchain“

Via settings.json:

{
  "wvds.toolchain.fpcPath": "${env:LAZARUS}/fpc/3.2.2/bin/i386-win32/fpc.exe",
  "wvds.toolchain.pas2jsPath": "${env:LAZARUS}/fpc/3.2.2/bin/i386-win32/pas2js.exe",
  "wvds.toolchain.lazbuildPath": "${env:LAZARUS}/lazbuild.exe",
  "wvds.toolchain.innoSetupPath": "${env:PROGRAMFILES(X86)}/Inno Setup 6/ISCC.exe",
  "wvds.toolchain.makePath": "${env:MSYS2}/usr/bin/make.exe"
}

Per la cross-compilation sotto Windows, può essere attivato WSL:

1. WSL 2 con una distribuzione Linux (Ubuntu consigliato)
2. FPC installato nell'ambiente WSL

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

Con WSL attivato, viene utilizzato FPC Linux per i target Linux, mentre FPC Windows rimane attivo per i target Windows.

Verificate l'installazione:

1. Aprite la palette dei comandi: Ctrl+Shift+P
2. Eseguite: WVDS: Show Version Info
3. L'Output Channel mostra tutti gli strumenti e le versioni rilevate

Output atteso (i percorsi variano in base all'installazione):

WvdS FPC RAD Studio v0.1.0
--------------------------
FPC: 3.2.2 (%LAZARUS%\fpc\3.2.2\bin\i386-win32\fpc.exe)
pas2js: 2.2.0 (%LAZARUS%\fpc\3.2.2\bin\i386-win32\pas2js.exe)
lazbuild: 3.4 (%LAZARUS%\lazbuild.exe)
Inno Setup: 6.2.2 (%PROGRAMFILES(X86)%\Inno Setup 6\ISCC.exe)

Causa: FPC non è installato o il percorso è errato.

Soluzione:

1. Installate FPC o Lazarus
2. Impostate wvds.toolchain.fpcPath manualmente
3. Assicuratevi che il percorso punti al file .exe/.bin, non alla cartella

Causa: pas2js non è stato installato con Lazarus.

Soluzione:

1. Installate pas2js tramite il Lazarus Package Manager
2. Oppure scaricate pas2js manualmente
3. Impostate wvds.toolchain.pas2jsPath

Causa: Dipendenze non soddisfatte.

Soluzione:

1. Assicuratevi che wvds-vscode-core sia installata
2. Verificate la versione di VS Code (minimo 1.85.0)
3. Riavviate VS Code

Causa: Unit mancanti o percorsi errati.

Soluzione:

1. Controllate l'output FPC nel Terminal
2. Assicuratevi che tutti i percorsi delle unit siano corretti
3. Verificate le impostazioni del progetto

• Creare il primo progetto
• Comprendere la configurazione di build
• Core Extension nel dettaglio