====== WvdS VSCode Core ======

Core ekstenzija čini temelj WvdS FPC RAD Studio paketa. Pruža središnje usluge koje koriste sve ostale ekstenzije.

===== Funkcija i svrha =====

Core ekstenzija je **obavezna** za sve ostale WvdS ekstenzije. Nudi:

  * **Upravljanje toolchainom** - Središnje upravljanje svim putanjama prevoditelja
  * **Automatsko otkrivanje** - Automatsko pronalaženje instaliranih alata
  * **Dijeljene usluge** - Zajedničke usluge za zapisivanje, konfiguraciju, RPC
  * **WSL integracija** - Cross-kompilacija pod Windowsima

===== Naredbe =====

^ Naredba ^ Tipkovnička kratica ^ Opis ^
| ''WVDS: Toolchain Configuration...'' | - | Otvara dijaloški okvir za konfiguraciju toolchaina |
| ''WVDS: Show Log'' | - | Prikazuje WvdS Output Channel |
| ''WVDS: Clear Log'' | - | Briše sadržaj zapisa |
| ''WVDS: Show Version Info'' | - | Prikazuje informacije o verzijama svih komponenti |
| ''WVDS: Hello'' | - | Testna naredba za verifikaciju instalacije |

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

==== Dijaloški okvir za konfiguraciju ====

Dijaloški okvir prikazuje sve podržane alate u preglednoj tablici:

{{ :de:int:vsce:fpc:p:toolchain-dialog.png?600 |Dijaloški okvir toolchaina}}

^ Stupac ^ Značenje ^
| Tool | Naziv alata |
| Status | Zeleno = Pronađeno, Crveno = Nije pronađeno, Žuto = Zastarjela verzija |
| Path | Trenutna putanja do izvršne datoteke |
| Version | Otkrivena verzija |
| Actions | Gumbi: Browse, Auto-Detect, Clear |

==== Automatsko otkrivanje ====

Automatsko otkrivanje pretražuje tipične putanje instalacije:

**Windows:**
  * ''%LAZARUS%\fpc\*''
  * ''%PROGRAMFILES%\Free Pascal\*''
  * ''%LOCALAPPDATA%\Programs\FPC\*''
  * PATH varijabla okruženja

**Linux:**
  * ''/usr/lib/fpc/*''
  * ''/usr/local/lib/fpc/*''
  * ''~/.fpc/*''
  * PATH varijabla okruženja

**macOS:**
  * ''/usr/local/lib/fpc/*''
  * ''/opt/homebrew/lib/fpc/*''
  * PATH varijabla okruženja

==== Podržani alati ====

^ Alat ^ Datoteka ^ Korištenje ^
| Free Pascal Compiler | fpc / fpc.exe | Nativna Pascal kompilacija |
| pas2js | pas2js / pas2js.exe | Pascal-u-JavaScript transpilacija |
| lazbuild | lazbuild / lazbuild.exe | Kompiliranje Lazarus projekata bez IDE-a |
| Inno Setup | ISCC.exe | Izrada Windows instalera |
| GNU make | make / make.exe | Izvršavanje Makefileova |

===== Postavke =====

Sve postavke počinju s ''wvds.toolchain.'' ili ''wvds.core.'':

==== Postavke toolchaina ====

<code json>
{
  // Putanje prevoditelja
  "wvds.toolchain.fpcPath": "",
  "wvds.toolchain.pas2jsPath": "",
  "wvds.toolchain.lazbuildPath": "",
  "wvds.toolchain.innoSetupPath": "",
  "wvds.toolchain.makePath": "",

  // WSL konfiguracija (samo Windows)
  "wvds.toolchain.wslEnabled": false,
  "wvds.toolchain.wslDistribution": ""
}
</code>

==== Core postavke ====

<code json>
{
  // Razina zapisa: debug, info, warn, error
  "wvds.core.logLevel": "info"
}
</code>

^ Razina zapisa ^ Opis ^
| debug | Sve poruke, uključujući debug informacije |
| info | Informacije, upozorenja, greške |
| warn | Samo upozorenja i greške |
| error | Samo greške |

===== Zapisivanje =====

Core ekstenzija pruža centraliziranu uslugu zapisivanja.

==== Output Channel ====

Sve WvdS ekstenzije pišu u zajednički Output Channel "WvdS".

Otvaranje:
  - ''View'' -> ''Output''
  - U padajućem izborniku odaberite "WvdS"
  - Ili: izvršite ''WVDS: Show Log''

==== Format zapisa ====

<code>
[2024-01-15 14:30:22] [INFO] Toolchain: FPC detected at %LAZARUS%\fpc\3.2.2\bin\i386-win32\fpc.exe
[2024-01-15 14:30:22] [INFO] Toolchain: Version 3.2.2
[2024-01-15 14:30:23] [WARN] Toolchain: pas2js not found in PATH
</code>

<note>Prikazane putanje odgovaraju razriješenim vrijednostima vašeg lokalnog okruženja.</note>

===== WSL integracija =====

Pod Windowsima WSL integracija omogućuje cross-kompilaciju za Linux.

==== Preduvjeti ====

  - Windows 10/11 s WSL 2
  - Instalirana Linux distribucija (npr. Ubuntu)
  - FPC instaliran u WSL okruženju

==== Postavljanje ====

  - Instalirajte FPC u WSL: <code bash>
sudo apt update
sudo apt install fpc
</code>
  - Aktivirajte WSL u postavkama: <code json>
{
  "wvds.toolchain.wslEnabled": true,
  "wvds.toolchain.wslDistribution": "Ubuntu-22.04"
}
</code>
  - Ponovno pokrenite VS Code

==== Korištenje ====

S aktiviranim WSL-om možete:
  * Stvarati Linux binarne datoteke pod Windowsima
  * Koristiti Linux-specifične unitove
  * Generirati oba cilja (Windows + Linux) iz jednog projekta

===== API za razvijatelje ekstenzija =====

Ostale ekstenzije mogu koristiti Core usluge. Pogledajte [[..:i:core-api|Core API referenca]] za detalje.

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

==== Ekstenzija se ne aktivira ====

**Simptom:** "WVDS: Hello" ne prikazuje izlaz.

**Rješenje:**
  - Provjerite VS Code Developer Console (''Help'' -> ''Toggle Developer Tools'')
  - Potražite poruke o greškama s "wvds"
  - Osigurajte da je VS Code >= 1.85.0

==== Dijaloški okvir toolchaina se ne otvara ====

**Simptom:** Naredba ne pokazuje reakciju.

**Rješenje:**
  - Provjerite je li Core ekstenzija aktivirana
  - U Extensions: Potražite "WvdS Core", provjerite status
  - Deaktivirajte i reaktivirajte ekstenziju

==== Automatsko otkrivanje ne pronalazi ništa ====

**Simptom:** Svi alati ostaju označeni crveno.

**Rješenje:**
  - Provjerite jesu li alati zaista instalirani
  - Osigurajte da su putanje čitljive
  - Ručno konfigurirajte putanje

===== Tehnički detalji =====

^ Svojstvo ^ Vrijednost ^
| Extension ID | wvds.wvds-vscode-core |
| Aktivacija | onStartupFinished |
| Ovisnosti | Nema |
| Min. VS Code | 1.85.0 |

===== Vidi također =====

  * [[.:installation|Instalacija i konfiguracija]]
  * [[.:build|Build Extension]]
  * [[.:projects|Projects Extension]]
  * [[..:i:core-api|Core API za razvijatelje]] (Interno)