Instalacija i konfiguracija

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

Instalirajte VS Code s code.visualstudio.com. Minimalna verzija: 1.85.0.

Provjera instalirane verzije:

code --version

Opcija A: Lazarus paket (preporučeno)

Lazarus IDE sadrži FPC. Preuzimanje: 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: freepascal.org

Provjera:

fpc -iV

Očekivani izlaz: 3.2.2 ili novije.

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: wiki.freepascal.org/pas2js

Provjera:

pas2js -h

1. Otvorite VS Code
2. Kliknite na ikonu Extensions (Ctrl+Shift+X)
3. Potražite „WvdS FPC“
4. 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

# 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

Za offline instalaciju ili internu distribuciju:

1. Preuzmite .vsix datoteke
2. U VS Code: Extensions → … → Install from VSIX…
3. Odaberite .vsix datoteku

Nakon instalacije Core ekstenzije potrebno je konfigurirati putanje prevoditelja.

Paket automatski pokušava pronaći instalirane alate:

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

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

Putem Settings UI:

File → Preferences → Settings → Pretraži „wvds.toolchain“

Putem 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"
}

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

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

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

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

Provjerite instalaciju:

1. Otvorite paletu naredbi: Ctrl+Shift+P
2. Izvršite: WVDS: Show Version Info
3. Output Channel prikazuje sve otkrivene alate i verzije

Očekivani izlaz (putanje variraju ovisno o instalaciji):

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)

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

Rješenje:

1. Instalirajte FPC ili Lazarus
2. Ručno postavite wvds.toolchain.fpcPath
3. Osigurajte da putanja pokazuje na .exe/.bin, ne na mapu

Uzrok: pas2js nije instaliran s Lazarusom.

Rješenje:

1. Instalirajte pas2js putem Lazarus Package Managera
2. Ili ručno preuzmite pas2js
3. Postavite wvds.toolchain.pas2jsPath

Uzrok: Ovisnosti nisu ispunjene.

Rješenje:

1. Osigurajte da je wvds-vscode-core instaliran
2. Provjerite verziju VS Code (minimalno 1.85.0)
3. Ponovno pokrenite VS Code

Uzrok: Nedostaju unitovi ili su putanje pogrešne.

Rješenje:

1. Provjerite FPC izlaz u Terminalu
2. Osigurajte da su sve putanje do unitova ispravne
3. Provjerite postavke projekta

• Izrada prvog projekta
• Razumijevanje konfiguracije kompilacije
• Core Extension u detaljima