====== WvdS FPC RAD Studio za VS Code ======

//Profesionalni razvoj u Pascalu unutar Visual Studio Code//

===== Što je WvdS FPC RAD Studio? =====

WvdS FPC RAD Studio je integrirano razvojno okruženje za Free Pascal, implementirano kao paket ekstenzija za Visual Studio Code. Paket omogućuje razvoj:

  * **Desktop aplikacija** - Nativne GUI i konzolne aplikacije s FPC-om
  * **Web aplikacija** - Aplikacije za preglednik putem pas2js transpilera
  * **Terminal-UI** - Tekstualna sučelja za poslužitelje i CLI alate
  * **VSCode ekstenzija** - Pascal-bazirane ekstenzije za sam VS Code

===== Zašto WvdS FPC RAD Studio? =====

^ Izazov ^ Rješenje ^
| Razvoj u Pascalu zahtijeva Lazarus IDE | Potpuni razvoj direktno u VS Code |
| Nema vizualnog dizajnera u VS Code | PXAML-dizajner s pregledom uživo |
| Složena konfiguracija kompilacije | Kompilacija jednim klikom s automatskim otkrivanjem alata |
| Nedostatak IntelliSense za UI | Registar komponenti s automatskim dovršavanjem |

===== Ekstenzije paketa =====

Paket se sastoji od sedam specijaliziranih ekstenzija:

^ Ekstenzija ^ Funkcija ^ Ovisnosti ^
| [[.:core|Core]] | Središnja infrastruktura, konfiguracija toolchaina | - |
| [[.:build|Build]] | Kompilacija s FPC-om i pas2js | Core |
| [[.:projects|Projects]] | Upravljanje projektima i predlošci | Core |
| [[.:designer|UI Designer]] | Vizualni PXAML-editor | Core |
| [[.:meta|UI Meta]] | Registar komponenti, IntelliSense | Core |
| [[.:preview|UI Preview]] | Pregled PXAML-a uživo | Core, Designer |
| [[.:packaging|Packaging]] | Izrada i objava VSIX-a | Core, Build |

===== Brzi početak =====

==== 1. Instalacija ====

Instalirajte ekstenzije putem VS Code Marketplacea:

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

Alternativno: Potražite "WvdS FPC" u pregledniku ekstenzija u VS Code.

==== 2. Konfiguracija toolchaina ====

Nakon instalacije:

  - Otvorite paletu naredbi (''Ctrl+Shift+P'')
  - Izvršite ''WvdS: Toolchain Configuration...''
  - Paket automatski otkriva instalirane prevoditelje
  - Po potrebi: Ručno prilagodite putanje

==== 3. Izrada prvog projekta ====

  - ''Ctrl+Shift+P'' -> ''WvdS Projects: New Project from Template...''
  - Odaberite predložak:
    * **Desktop Console** - Jednostavna konzolna aplikacija
    * **Desktop GUI** - LCL-bazirana GUI aplikacija
    * **Web PWA** - Progresivna web aplikacija s pas2js
    * **TUI App** - Terminal-UI aplikacija
    * **VSCode Extension** - Pascal-bazirana ekstenzija
  - Unesite naziv projekta i lokaciju
  - Projekt se stvara i otvara

==== 4. Kompilacija i pokretanje ====

  - ''Ctrl+Shift+P'' -> ''WvdS: Build Project''
  - Ili: ''Ctrl+Shift+B'' za Build task
  - Izlaz se prikazuje u Terminal panelu
  - Greške se prikazuju u Problems panelu

===== Sistemski zahtjevi =====

^ Komponenta ^ Minimalni zahtjev ^ Preporučeno ^
| VS Code | 1.85.0 | Najnovija verzija |
| Free Pascal | 3.2.0 | 3.2.2 ili 3.3.1 |
| pas2js | 2.0.0 | 2.2.0 |
| Operacijski sustav | Windows 10, Linux, macOS | Windows 11, Ubuntu 22.04+ |

===== Podržane vrste projekata =====

^ Vrsta ^ Prevoditelj ^ Izlaz ^ Primjena ^
| Desktop Console | FPC | Nativna .exe/.bin | CLI alati, servisi, batch obrada |
| Desktop GUI | FPC + LCL | Nativna .exe/.bin | Desktop aplikacije s prozorima |
| Desktop Library | FPC | .dll/.so | Dijeljene biblioteke, plugini |
| Web PWA | pas2js | JavaScript | Aplikacije za preglednik, SPA |
| TUI App | FPC | Nativna .exe/.bin | Terminalna sučelja, administracija poslužitelja |
| VSCode Extension | pas2js | JavaScript | VS Code ekstenzije |
| Installer | Inno Setup | .exe | Windows instalacijski paketi |

===== Sljedeći koraci =====

  * [[.:installation|Detaljna uputa za instalaciju]]
  * [[.:core|Core Extension - Postavljanje toolchaina]]
  * [[.:build|Build Extension - Opcije kompilacije]]
  * [[.:projects|Projects Extension - Korištenje predložaka]]
  * [[.:designer|UI Designer - Oblikovanje PXAML sučelja]]
  * [[.:controls|UI Controls - Dostupne komponente (108)]]
  * [[.:controls-installation|Instalacija kontrola]]
  * [[.:faq|Često postavljana pitanja]]
  * [[.:qualitaetssicherung|Standardi kvalitete]]
  * [[.:beitragen|Doprinos (Contributing)]]

===== Podrška i zajednica =====

  * **GitHub Issues**: [[https://github.com/ArmandoFilho/WvdS.FPC/issues|Prijave grešaka i zahtjevi za značajke]]
  * **Dokumentacija**: Ove Wiki stranice
  * **Licenca**: MIT licenca - besplatno za komercijalnu i privatnu uporabu