====== Instalacija i konfiguracija ======

Ova uputa opisuje potpuno postavljanje WvdS FPC RAD Studia za VS Code.

===== Preduvjeti =====

==== Visual Studio Code ====

Instalirajte VS Code s [[https://code.visualstudio.com/|code.visualstudio.com]]. Minimalna verzija: 1.85.0.

Provjera instalirane verzije:
<code>
code --version
</code>

==== Free Pascal Compiler (FPC) ====

**Opcija A: Lazarus paket (preporučeno)**

Lazarus IDE sadrži FPC. Preuzimanje: [[https://www.lazarus-ide.org/|lazarus-ide.org]]

Tipične putanje instalacije:
  * 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''

**Opcija B: Samostalni FPC**

Preuzimanje: [[https://www.freepascal.org/download.html|freepascal.org]]

Provjera:
<code bash>
fpc -iV
</code>
Očekivani izlaz: ''3.2.2'' ili novije.

==== pas2js (za web projekte) ====

pas2js je Pascal-u-JavaScript transpiler za aplikacije u pregledniku i Node.js.

**Instalacija putem Lazarusa:**

U Lazarus Online Package Manageru potražite "pas2js" i instalirajte.

**Ručna instalacija:**

Preuzimanje: [[https://wiki.freepascal.org/pas2js|wiki.freepascal.org/pas2js]]

Provjera:
<code bash>
pas2js -h
</code>

==== Opcijski alati ====

^ Alat ^ Korištenje ^ Preuzimanje ^
| lazbuild | Kompiliranje Lazarus projekata (.lpi) bez IDE-a | Uključeno u Lazarus |
| Inno Setup | Izrada Windows instalera | [[https://jrsoftware.org/isinfo.php|jrsoftware.org]] |
| GNU make | Izvršavanje Makefileova | Uključeno u MinGW/MSYS2 |

===== Instalacija ekstenzija =====

==== Metoda 1: VS Code Marketplace ====

  - Otvorite VS Code
  - Kliknite na ikonu Extensions (''Ctrl+Shift+X'')
  - Potražite "WvdS FPC"
  - Instalirajte željene ekstenzije:
    * **WvdS VSCode Core** - Obavezno
    * **WvdS VSCode Build** - Preporučeno
    * **WvdS VSCode Projects** - Preporučeno
    * **WvdS VSCode UI Designer** - Za PXAML razvoj
    * **WvdS VSCode UI Meta** - Za IntelliSense
    * **WvdS VSCode UI Preview** - Za pregled uživo
    * **WvdS VSCode Packaging** - Za izradu VSIX-a

==== Metoda 2: Naredbeni redak ====

<code bash>
# Osnovna instalacija
code --install-extension wvds.wvds-vscode-core
code --install-extension wvds.wvds-vscode-build
code --install-extension wvds.wvds-vscode-projects

# UI razvoj
code --install-extension wvds.wvds-vscode-ui-designer
code --install-extension wvds.wvds-vscode-ui-meta
code --install-extension wvds.wvds-vscode-ui-preview

# Pakiranje
code --install-extension wvds.wvds-vscode-packaging
</code>

==== Metoda 3: VSIX datoteka ====

Za offline instalaciju ili internu distribuciju:

  - Preuzmite .vsix datoteke
  - U VS Code: ''Extensions'' -> ''...'' -> ''Install from VSIX...''
  - Odaberite .vsix datoteku

===== Konfiguracija toolchaina =====

Nakon instalacije Core ekstenzije potrebno je konfigurirati putanje prevoditelja.

==== Automatsko otkrivanje ====

Paket automatski pokušava pronaći instalirane alate:

  - Otvorite paletu naredbi: ''Ctrl+Shift+P''
  - Izvršite: ''WvdS: Toolchain Configuration...''
  - Dijaloški okvir prikazuje otkrivene alate sa zelenim kvačicama
  - Neotkriveni alati označeni su crveno

==== Ručna konfiguracija ====

Ako automatsko otkrivanje ne uspije, putanje se mogu postaviti ručno:

**Putem Settings UI:**

''File'' -> ''Preferences'' -> ''Settings'' -> Pretraži "wvds.toolchain"

**Putem settings.json:**

<note tip>Koristite varijable okruženja umjesto apsolutnih putanja za bolju prenosivost.</note>

<code 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"
}
</code>

==== Postavke u detaljima ====

^ Postavka ^ Opis ^ Zadano ^
| ''wvds.toolchain.fpcPath'' | Putanja do fpc.exe / fpc | Automatsko otkrivanje |
| ''wvds.toolchain.pas2jsPath'' | Putanja do pas2js.exe / pas2js | Automatsko otkrivanje |
| ''wvds.toolchain.lazbuildPath'' | Putanja do lazbuild.exe / lazbuild | Automatsko otkrivanje |
| ''wvds.toolchain.innoSetupPath'' | Putanja do ISCC.exe | Automatsko otkrivanje |
| ''wvds.toolchain.makePath'' | Putanja do make.exe / make | Automatsko otkrivanje |
| ''wvds.toolchain.wslEnabled'' | WSL za Linux cross-kompilaciju | false |
| ''wvds.toolchain.wslDistribution'' | WSL distribucija (npr. Ubuntu-22.04) | "" |

===== WSL podrška (Windows) =====

Za cross-kompilaciju pod Windowsima može se aktivirati WSL:

==== Preduvjeti ====

  - WSL 2 s Linux distribucijom (preporuča se Ubuntu)
  - FPC instaliran u WSL okruženju

==== Aktivacija ====

<code json>
{
  "wvds.toolchain.wslEnabled": true,
  "wvds.toolchain.wslDistribution": "Ubuntu-22.04"
}
</code>

==== Korištenje ====

Kada je WSL aktiviran, Linux FPC koristi se za Linux ciljeve, dok Windows FPC ostaje aktivan za Windows ciljeve.

===== Verifikacija =====

Provjerite instalaciju:

  - Otvorite paletu naredbi: ''Ctrl+Shift+P''
  - Izvršite: ''WVDS: Show Version Info''
  - Output Channel prikazuje sve otkrivene alate i verzije

Očekivani izlaz (putanje variraju ovisno o instalaciji):
<code>
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)
</code>

===== Rješavanje problema =====

==== "FPC not found" ====

**Uzrok:** FPC nije instaliran ili je putanja pogrešna.

**Rješenje:**
  - Instalirajte FPC ili Lazarus
  - Ručno postavite ''wvds.toolchain.fpcPath''
  - Osigurajte da putanja pokazuje na .exe/.bin, ne na mapu

==== "pas2js not found" ====

**Uzrok:** pas2js nije instaliran s Lazarusom.

**Rješenje:**
  - Instalirajte pas2js putem Lazarus Package Managera
  - Ili ručno preuzmite pas2js
  - Postavite ''wvds.toolchain.pas2jsPath''

==== Ekstenzija se ne pokreće ====

**Uzrok:** Ovisnosti nisu ispunjene.

**Rješenje:**
  - Osigurajte da je ''wvds-vscode-core'' instaliran
  - Provjerite verziju VS Code (minimalno 1.85.0)
  - Ponovno pokrenite VS Code

==== Kompilacija ne uspijeva ====

**Uzrok:** Nedostaju unitovi ili su putanje pogrešne.

**Rješenje:**
  - Provjerite FPC izlaz u Terminalu
  - Osigurajte da su sve putanje do unitova ispravne
  - Provjerite postavke projekta

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

  * [[.:projects|Izrada prvog projekta]]
  * [[.:build|Razumijevanje konfiguracije kompilacije]]
  * [[.:core|Core Extension u detaljima]]