Domande frequenti (FAQ)

Risposte alle domande frequenti sulla suite WvdS FPC RAD Studio.

Minimo VS Code 1.85.0. Consigliamo la versione stabile più recente.

Verifica:

code --version

Non obbligatoriamente, ma consigliato.

• Con Lazarus: Tutte le funzionalità disponibili, setup più semplice
• Senza Lazarus: Solo FPC, nessun progetto GUI LCL

Per progetti Desktop GUI con LCL, Lazarus è necessario.

Sì, con alcune limitazioni.

code --uninstall-extension wvds.wvds-vscode-core
code --uninstall-extension wvds.wvds-vscode-build
# ... altre estensioni

Oppure: In VS Code Extensions → Clic destro → „Uninstall“

Possibili cause:

1. Percorsi unit non configurati - Controllate le impostazioni del progetto
2. Maiuscole/minuscole errate - Linux/macOS sono case-sensitive
3. Unit non compilata - Assicuratevi che la unit esista

Soluzione: Aggiungete i percorsi delle unit nelle impostazioni del progetto.

FPC non riesce a trovare una unit referenziata.

Passi per la soluzione:

1. Controllate l'ortografia nella clausola uses
2. Verificate che il file della unit esista
3. Aggiungete il percorso ai percorsi di ricerca delle unit

Cross-compilation nativa:

1. Installate il cross-compiler FPC
2. Selezionate il target nelle impostazioni del progetto

Con WSL (Windows):

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

Possibili cause:

1. Molte unit - Il build incrementale aiuta
2. Antivirus - Aggiungete un'eccezione per la cartella del progetto
3. Unità di rete - Usate l'archiviazione locale

Suggerimenti:

1. Usate „Build“ invece di „Rebuild“
2. Attivate lo Smart Linking
3. Riducete le informazioni di debug in release

Attualmente non direttamente. PXAML è un nuovo formato con un concetto diverso.

Alternative:

• Ricreare nel Designer
• Convertire manualmente
• Sviluppo di tool pianificato

Passi per la soluzione:

1. Salvate il file (Ctrl+S)
2. Controllate wvds.preview.autoRefresh
3. Eseguite WVDS: Refresh Preview
4. Verificate errori di sintassi PXAML

Sì, ma limitato in design-time.

• La sintassi binding è supportata
• Vengono visualizzati valori statici
• Il binding reale solo a runtime

1. File → Add Folder to Workspace…
2. Aggiungete le cartelle dei progetti
3. File → Save Workspace As…

Parzialmente. La sintassi è supportata, ma:

• Mancano unit specifiche Delphi
• VCL non è supportata
• I file di progetto (.dproj) non vengono letti

Raccomandazione: Migrare il progetto a FPC/Lazarus.

Opzioni:

1. Cartella condivisa: Unit in una cartella comune, configurare i percorsi
2. Package: Creare un package Lazarus
3. Copia: Copiare la unit (non raccomandato)

1. Create un account publisher su VS Marketplace
2. Create un Personal Access Token su Azure DevOps
3. Eseguite WVDS: Publish Package

Motivi comuni:

• README mancante o vuoto
• Versione già pubblicata
• package.json non valido
• Publisher ID non corrispondente

Controllate l'output nel Terminal per dettagli.

Sì, senza Marketplace:

1. Create il pacchetto VSIX
2. Distribuite il file internamente (rete, email, ecc.)
3. Installazione: code –install-extension file.vsix

Soluzioni:

1. Riavviate VS Code
2. Disinstallate e reinstallate l'estensione
3. Controllate la Developer Console (Help → Toggle Developer Tools)

Soluzioni:

1. Verificate se l'estensione è attivata
2. Attendete l'attivazione completa dopo l'avvio
3. Controllate le dipendenze (Core Extension installata?)

VS Code Output:

1. View → Output
2. Dropdown: „WvdS“

Extension Host Log:

1. Help → Toggle Developer Tools
2. Tab Console

Build Log:

1. Pannello Terminal
2. binaries/logs/ (se configurato)

GitHub Issues: github.com/ArmandoFilho/WvdS.FPC/issues

Indicate:

• Versione VS Code
• Versione estensione
• Sistema operativo
• Passi per riprodurre
• Messaggi di errore (estratti log)

• Documentazione: Queste pagine wiki
• GitHub: github.com/ArmandoFilho/WvdS.FPC
• Issues: Bug report e richieste funzionalità