====== Pogosta vprašanja (FAQ) ======

Odgovori na pogosta vprašanja o WvdS FPC Tools.

===== Namestitev in nastavitev =====

==== Katera različica VS Code je potrebna? ====

**Najmanj VS Code 1.85.0.** Priporočamo najnovejšo stabilno različico.

Preverjanje:
<code bash>
code --version
</code>

==== Ali moram namestiti Lazarus? ====

**Ni nujno, vendar priporočeno.**

  * **Z Lazarus:** Vse funkcije (lazbuild, LCL-GUI, Form Designer, pas2js)
  * **Brez Lazarus:** Samo FPC Direct-buildi, brez LCL-GUI-projektov

Za namizne GUI-projekte z LCL je Lazarus obvezen.

==== Ali deluje na Linux/macOS? ====

**Primarno Windows.** Linux je podprt prek WSL.

^ Funkcija ^ Windows ^ Linux (WSL) ^ macOS ^
| FPC-prevajanje | Da | Da | Načrtovano |
| LCL-GUI projekti | Da | Da | Načrtovano |
| pas2js | Da | Da | Načrtovano |
| InnoSetup | Da | Ne | Ne |
| Form Designer | Da | Da | Načrtovano |
| WSL Cross-Compilation | Da | N/A | N/A |

==== Kako odstranim razširitve? ====

<code bash>
code --uninstall-extension wvds.wvds-fpc-tools
</code>

Ali posamezno:
<code bash>
code --uninstall-extension wvds.wvds-fpc-solution-manager
code --uninstall-extension wvds.wvds-fpc-pas2js-studio
code --uninstall-extension wvds.wvds-fpc-iss-designer
</code>

Alternativno: V VS Code Extensions → Desni klik → **Uninstall**

==== Ali potrebujem vse tri razširitve? ====

**Ne.** Solution Manager je samostojno delujoč.

  * **Samo FPC/Lazarus:** Namestite samo Solution Manager
  * **+ pas2js/Web:** Solution Manager + PAS2JS Studio
  * **+ Installer:** Solution Manager + ISS Designer
  * **Vse:** Extension Pack ''wvds.wvds-fpc-tools'' (priporočeno)

===== Prevajanje =====

==== Zakaj FPC ne najde mojih enot? ====

**Možni vzroki:**

  - **Poti enot niso nastavljene** — Desni klik na projekt → Properties → Paths
  - **Napačna velika/mala začetnica** — Linux/macOS razlikujeta
  - **Manjkajoč paket** — Desni klik na projekt → Add Required Package

**Rešitev:** Dodajte iskalne poti enot v projektne lastnosti (zavihek "Paths").

==== Kaj pomeni "Fatal: Can't find unit..."? ====

FPC ne najde referencirane enote.

**Koraki za rešitev:**
  - Preverite črkovanje v klavzuli ''uses''
  - Preverite, ali datoteka enote obstaja
  - Dodajte pot med iskalne poti enot (Properties → Paths)
  - Pri paketih: Dodajte Required Package

==== Kako prevajam za različne platforme? ====

**WSL Cross-Compilation (Windows → Linux):**
  - Namestite WSL z Linux-distribucijo
  - Namestite FPC/Lazarus v WSL
  - ''fpc-solution-manager.wslEnabled'' nastavite na ''true''
  - Nastavite WSL-distribucijo in poti
  - Zaženite **Build for Linux (WSL)**

==== Kakšna je razlika med lazbuild in FPC Direct? ====

| Vidik | lazbuild | FPC Direct |
^ Zahteva | Lazarus nameščen | Samo FPC |
^ LCL-projekti | Da | Ne |
^ Razreševanje paketov | Samodejno | Ročno |
^ Hitrost | Nekoliko počasnejše | Hitrejše |

FPC Direct se samodejno uporabi kot rezervna možnost, ko ''lazbuild'' ni nastavljen.

===== Form Designer =====

==== Kakšna je razlika med LFM in WFM? ====

^ Vidik ^ LFM (Solution Manager) ^ WFM (PAS2JS Studio) ^
| Ciljna platforma | Namizje (LCL) | Splet (brskalnik) |
| Končnica datoteke | ''.lfm'' | ''.wfm'' |
| Izris | Nativni Windows/Linux/macOS | HTML/CSS v brskalniku |

==== Ali lahko odprem obstoječe Lazarus-obrazce? ====

**Da.** Form Designer odpre ''.lfm'' datoteke neposredno. Pogoji:

  * Pripadajoča ''.pas'' enota mora obstajati
  * Uporabljeni paketi morajo biti nameščeni (ali uporabite katalog komponent)

===== pas2js =====

==== Kaj je pas2js? ====

**pas2js** je prevajalnik Pascal-v-JavaScript, ki prevede Object Pascal v JavaScript. S tem lahko pišete VSCode razširitve in spletne aplikacije v Pascalu.

==== Kje dobim pas2js? ====

pas2js je vključen v **Lazarus-Bundle** (od verzije 3.0). Ločen prenos:

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

===== InnoSetup =====

==== Ali moram InnoSetup namestiti ločeno? ====

**Da.** InnoSetup je treba namestiti ločeno:

[[https://jrsoftware.org/isinfo.php]]

ISS Designer uporablja ''iscc.exe'' (InnoSetup ukazni prevajalnik).

==== Kako podpišem svoj namestitveni program? ====

  - Namestite ''signtool.exe'' (vključen v Windows SDK)
  - Pridobite certifikat (''.pfx'')
  - Nastavite Settings:
    * ''fpc-iss.signTool.path'' — Pot do ''signtool.exe''
    * ''fpc-iss.signTool.certFile'' — Pot do ''.pfx''
  - Desni klik na ''.iss'' → **Sign Installer**

===== Odpravljanje napak =====

==== Razširitev se ne aktivira ====

  * Preverite, ali je ''.lpi'', ''.lpg'', ''.lpk'' ali ''package.json'' prisotna v Workspace
  * Output Panel → Preverite kanal **FPC Solution Manager**
  * Ponovno naložite VSCode: ''Ctrl+Shift+P'' → ''Developer: Reload Window''

==== Prevajalnik ni najden ====

  * Preverite poti v nastavitvah (''fpc-solution-manager.fpcPath'', ''fpc-solution-manager.lazbuildPath'')
  * Zaženite čarovnik **Setup Toolchain**: ''Ctrl+Shift+P'' → ''Setup Toolchain''
  * Preverite FPC-namestitev: ''fpc -v'' v terminalu

==== pasls (Language Server) ne deluje ====

  * Preverite ''fpc-solution-manager.pasls.enabled'' ali je ''true''
  * Pot do ''pasls.exe'' nastavite v ''fpc-solution-manager.paslsPath''
  * ''fpc-solution-manager.lazarusSourcePath'' mora kazati na Lazarus-izvorno kodo
  * Output Panel → Preverite kanal **pasls**

==== Kje najdem dnevnike? ====

  * **Output Panel:** ''View'' → ''Output'' → Spustni meni **FPC Solution Manager**
  * **Developer Tools:** ''Help'' → ''Toggle Developer Tools'' → Zavihek Console
  * ''fpc-solution-manager.logLevel'' nastavite na ''debug'' za podrobne dnevnike

===== Dodatna vprašanja? =====

  * [[.:start|Dokumentacija]]
  * [[.:installation|Namestitev in nastavitev]]