====== WvdS FPC RAD Studio per VS Code ======

//Sviluppo Pascal professionale in Visual Studio Code//

===== Cos'è WvdS FPC RAD Studio? =====

WvdS FPC RAD Studio è un ambiente di sviluppo integrato per Free Pascal, implementato come suite di estensioni per Visual Studio Code. La suite consente lo sviluppo di:

  * **Applicazioni desktop** - Applicazioni GUI native e console con FPC
  * **Applicazioni web** - App basate su browser tramite transpiler pas2js
  * **Terminal-UI** - Interfacce testuali per server e strumenti CLI
  * **Estensioni VSCode** - Estensioni basate su Pascal per VS Code stesso

===== Perché WvdS FPC RAD Studio? =====

^ Sfida ^ Soluzione ^
| Lo sviluppo Pascal richiede Lazarus IDE | Sviluppo completo direttamente in VS Code |
| Nessun designer visuale in VS Code | Designer PXAML con anteprima live |
| Configurazione build complessa | Build con un clic con rilevamento automatico degli strumenti |
| Mancanza di IntelliSense per UI | Registro componenti con auto-completamento |

===== Estensioni della suite =====

La suite è composta da sette estensioni specializzate:

^ Estensione ^ Funzione ^ Dipendenze ^
| [[.:core|Core]] | Infrastruttura centrale, configurazione toolchain | - |
| [[.:build|Build]] | Compilazione con FPC e pas2js | Core |
| [[.:projects|Projects]] | Gestione progetti e template | Core |
| [[.:designer|UI Designer]] | Editor visuale PXAML | Core |
| [[.:meta|UI Meta]] | Registro componenti, IntelliSense | Core |
| [[.:preview|UI Preview]] | Anteprima live per PXAML | Core, Designer |
| [[.:packaging|Packaging]] | Creazione e pubblicazione VSIX | Core, Build |

===== Avvio rapido =====

==== 1. Installazione ====

Installate le estensioni tramite il VS Code Marketplace:

<code>
code --install-extension wvds.wvds-vscode-core
code --install-extension wvds.wvds-vscode-build
code --install-extension wvds.wvds-vscode-projects
</code>

In alternativa: cercate "WvdS FPC" nel browser delle estensioni di VS Code.

==== 2. Configurare la toolchain ====

Dopo l'installazione:

  - Aprite la palette dei comandi (''Ctrl+Shift+P'')
  - Eseguite ''WvdS: Toolchain Configuration...''
  - La suite rileva automaticamente i compilatori installati
  - Se necessario: regolate manualmente i percorsi

==== 3. Creare il primo progetto ====

  - ''Ctrl+Shift+P'' -> ''WvdS Projects: New Project from Template...''
  - Scegliete un template:
    * **Desktop Console** - Semplice applicazione console
    * **Desktop GUI** - Applicazione GUI basata su LCL
    * **Web PWA** - Progressive Web App con pas2js
    * **TUI App** - Applicazione Terminal-UI
    * **VSCode Extension** - Estensione basata su Pascal
  - Inserite nome del progetto e posizione
  - Il progetto viene creato e aperto

==== 4. Compilare ed eseguire ====

  - ''Ctrl+Shift+P'' -> ''WvdS: Build Project''
  - Oppure: ''Ctrl+Shift+B'' per il task di build
  - L'output appare nel pannello Terminal
  - Gli errori vengono visualizzati nel pannello Problems

===== Requisiti di sistema =====

^ Componente ^ Requisito minimo ^ Consigliato ^
| VS Code | 1.85.0 | Versione più recente |
| Free Pascal | 3.2.0 | 3.2.2 o 3.3.1 |
| pas2js | 2.0.0 | 2.2.0 |
| Sistema operativo | Windows 10, Linux, macOS | Windows 11, Ubuntu 22.04+ |

===== Tipi di progetto supportati =====

^ Tipo ^ Compilatore ^ Output ^ Caso d'uso ^
| Desktop Console | FPC | Nativo .exe/.bin | Strumenti CLI, servizi, elaborazione batch |
| Desktop GUI | FPC + LCL | Nativo .exe/.bin | Applicazioni desktop con finestre |
| Desktop Library | FPC | .dll/.so | Librerie condivise, plugin |
| Web PWA | pas2js | JavaScript | Applicazioni browser, SPA |
| TUI App | FPC | Nativo .exe/.bin | Interfacce terminale, admin server |
| VSCode Extension | pas2js | JavaScript | Estensioni VS Code |
| Installer | Inno Setup | .exe | Pacchetti di installazione Windows |

===== Prossimi passi =====

  * [[.:installation|Guida dettagliata all'installazione]]
  * [[.:core|Core Extension - Configurare la toolchain]]
  * [[.:build|Build Extension - Opzioni di compilazione]]
  * [[.:projects|Projects Extension - Utilizzare i template]]
  * [[.:designer|UI Designer - Progettare interfacce PXAML]]
  * [[.:controls|UI Controls - Componenti disponibili (108)]]
  * [[.:controls-installation|Installare i controls]]
  * [[.:faq|Domande frequenti]]
  * [[.:qualitaetssicherung|Standard di qualità]]
  * [[.:beitragen|Contribuire (Contributing)]]

===== Supporto e community =====

  * **GitHub Issues**: [[https://github.com/ArmandoFilho/WvdS.FPC/issues|Bug report e richieste di funzionalità]]
  * **Documentazione**: Queste pagine wiki
  * **Licenza**: MIT License - libero per uso commerciale e privato