FPC Solution Manager

Upravljanje projektov, Build-System, Debugging in Form Designer za Free Pascal / Lazarus v Visual Studio Code.

Package-ID: wvds.wvds-fpc-solution-manager

Solution Manager je osrednja razširitev za razvoj v Free Pascalu v VSCode. Ponuja:

• Tree View — Hierarhični prikaz projektnih skupin, projektov, enot in obrazcev
• Build-System — Build, Rebuild, Clean prek lazbuild ali FPC Direct
• Form Designer — Vizualni LFM-urejevalnik s podporo za skine
• Debugger — Integrirano razhroščevanje z fpdserver / GDB
• Language Server — Code Completion, Go to Definition, Hover prek pasls
• Code Formatter — ptop ali jcf integracija

Razširitev samodejno odkrije projekte v odprtem Workspace:

Multi-Root Workspaces so podprti — vsaka mapa Workspace se pregleda ločeno.

Tree View se pojavi v Activity Bar (leva stran) z ikono FPC Solution Manager.

Workspace Folder
├── Projektna skupina (.lpg)
│   ├── Projekt (.lpi)        ← z Inline Build/Run gumbi
│   │   ├── Enote (.pas)
│   │   ├── Obrazci (.pas + .lfm)
│   │   ├── Build načini (Debug, Release, ...)
│   │   ├── Odvisnosti (Required Packages)
│   │   └── Viri (.rc)
│   └── Projekt 2 ...
├── Paket (.lpk)
│   ├── Enote
│   └── Required Packages
├── Extension (package.json)  ← Virtualni pas2js-projekt
│   ├── Enote
│   └── npm Dependencies
└── Setup (.iss)              ← InnoSetup projekt
    └── Sekcije ([Files], [Run], ...)

Desni klik na elemente drevesa prikaže kontekstno odvisna dejanja:

Projekt:

• Build / Rebuild / Clean
• Build and Run / Run / Stop
• Properties (F4)
• Select Build Mode
• Add Unit / Form / Existing File
• Navigate (Dependencies, Call Hierarchy)

Projektna skupina:

• Build All / Rebuild All / Clean All
• Set Active Project
• Add New/Existing Project

Enota / Obrazec:

• Open File (Enter)
• Reveal in File Explorer
• Copy Path / Copy Relative Path
• Remove from Project
• Show Dependencies / Call Hierarchy

Desni klik v Pascal-urejevalniku (.pas, .pp, .lpr) prikaže podmeni FPC Solution Manager:

• Sort and Remove Unused Units
• Show Call Hierarchy
• Show Dependency Explorer
• Add Watch (le pri izbiri)

Vsak projekt ima lahko več build-načinov:

Zamenjava build-načina: Desni klik na projekt → Select Build Mode ali Ctrl+Shift+M.

V nastavitvah lahko definirate lupinske ukaze, ki se zaženejo pred/po vsakem buildu:

fpc-solution-manager.preBuildCommand: "echo Building {projectName} in {buildMode}"
fpc-solution-manager.postBuildCommand: "copy {outputPath} D:\\Deploy\\"

Razpoložljive spremenljivke: {projectName}, {buildMode}, {projectDir}, {outputPath}

Razhroščevalnik potrebuje fpdserver (Free Pascal Debug Server) kot zaledje.

Pridobitev fpdserver:

• Lazarus-Bundle (od 3.0): fpdserver je že vključen (<lazarus>/tools/fpdserver)
• Ročna gradnja: Iz izvorne kode FPC:

cd <fpc-source>/packages/fcl-passrc/utils/fpdserver
lazbuild --bm=Release fpdserver.lpi

Nastavitev:

• fpc-solution-manager.fpdserverPath — Pot do fpdserver.exe (prazno = samodejna zaznava)

Ustvarite launch.json v mapi .vscode delovnega prostora:

{
  "type": "lazarus",
  "request": "launch",
  "name": "Debug MyApp",
  "program": "${command:fpcse2.getExecutablePath}",
  "cwd": "${workspaceFolder}",
  "stopOnEntry": false,
  "args": []
}

Namig: ${command:fpcse2.getExecutablePath} samodejno določi izhodno pot iz nastavitev projekta.

• Breakpoints v .pas in .inc datotekah
• Step In/Out/Over — Koračno izvajanje
• Variables — Pregled lokalnih in globalnih spremenljivk
• Watches — Spremljanje izrazov (Ctrl+Alt+W pri izbiri)
• Call Stack — Prikaz klicne verige
• Immediate Window — Vrednotenje izrazov med izvajanjem

• Vrstične točke prekinitve — Klik na rob vrstice v .pas in .inc datotekah
• Pogojne točke prekinitve — Desni klik na točko prekinitve → Edit Breakpoint → vnesite pogoj (npr. i > 100)
• Števec zadetkov — Točka prekinitve se sproži šele po N zadetkih
• Logpoints — Izpis sporočila v konzolo brez prekinitve programa

Spremljanje izrazov med izvajanjem:

• Dodajanje: Ctrl+Alt+W pri izbranem besedilu v Pascal-urejevalniku
• Panel: V spodnjem delu pod FPC Solution Manager → Watches
• Izrazi: Spremenljivke, polja zapisov (MyRecord.Field), indeksi polj (MyArray[0])

Interaktivno vrednotenje med sejo razhroščevanja:

• Odpri: Panel FPC Solution Manager → Immediate
• Vnesite izraz in pritisnite Enter
• Podpira: vrednosti spremenljivk, pretvorbe tipov, preproste aritmetične izraze

V spodnjem panelu (področje FPC):

• Immediate — Interaktivno vrednotenje izrazov
• Watches — Spremljani izrazi/spremenljivke

Za uspešno razhroščevanje mora biti projekt zgrajen v načinu Debug:

• Zamenjava build-načina: Ctrl+Shift+M → Debug
• Informacije za razhroščevanje: zastavice prevajalnika -g -gl -gw morajo biti aktivne
• Izklop optimizacije: brez -O2 v načinu Debug

Form Designer se samodejno odpre za .lfm datoteke.

Designer podpira skine za vizualni izgled:

• fpc-solution-manager.designer.skinName — Aktivni skin (npr. WvdS-Shell)
• fpc-solution-manager.designer.skinVariant — Varianta (npr. Amber, Plum)
• fpc-solution-manager.designer.defaultSkinAutoDetect — Samodejna Light/Dark zaznava glede na VSCode-temo

Odpre se za .po datoteke (GNU gettext). Ponuja:

• Tabelarični prikaz vseh prevodnih vnosov (izvirnik → prevod)
• Iskanje in filtriranje po ključu ali besedilu
• Neposredno urejanje prevodov v WebView-panelu
• Spremembe se zapišejo nazaj v .po datoteko

Odpre se za .rc datoteke. Ponuja:

• Pregled vseh virov (ikone, bitne slike, kazalci, tabele nizov, informacije o različici)
• Dodajanje in odstranjevanje vnosov virov
• Urejanje poti do datotek virov

Opcijska integracija Pascal Language Serverja za napredne funkcije kode.

• fpc-solution-manager.pasls.enabled — true (privzeto)
• fpc-solution-manager.paslsPath — Pot do pasls.exe (prazno = samodejna zaznava)
• fpc-solution-manager.lazarusSourcePath — Lazarus-izvorna koda za razreševanje simbolov

Ko se z miško pomaknete nad simbol, hover-tooltip prikaže do tri ravni informacij:

1. Signatura — Popolna deklaracija kot sintaktično poudarjen Pascal blok kode, pridobljena iz CodeTools FindSmartHint (npr. private procedure TMyClass.DoSomething(const A: Integer): Boolean) — vključno z vidnostjo, imenom razreda, modifikatorji parametrov in tipom vrnitve
2. PasDoc-dokumentacija — Komentarji v obliki ( @abstract(…) @param(…) @returns(…) *) neposredno iz izvorne kode, oblikovani kot Markdown - Izvorna pozicija — Ime datoteke in vrstična pozicija deklaracije (npr. MyUnit.pas(42,5)) pasls zagotavlja textDocument/hover in interno uporablja CodeTools FindSmartHint (enak mehanizem kot Lazarus IDE) za ekstrakcijo signatur. PasDoc-komentarji se preberejo prek GetPasDocComments in se na strežniški strani oblikujejo v Markdown. Če pasls ni na voljo, razširitev uporabi textDocument/definition kot nadomestek s klientskim večvrstičnim izločevanjem. Primer hover-a: <code> ┌───────────────────────────────────────────────────────────┐ │ private procedure TMyClass.DoSomething(const A: Integer); │ ← Signatura (FindSmartHint) │ ───────────────────────────────────────────────────────── │ │ Izvede akcijo. │ ← @abstract │ │ │ Parameters: │ │ - A — Vrednost │ ← @param │ ───────────────────────────────────────────────────────── │ │ Source: MyUnit.pas(42,5) │ ← Izvorna pozicija └───────────────────────────────────────────────────────────┘ </code> Podprte PasDoc-oznake: | Oznaka | Opis | Primer | ^ @abstract | Kratek opis | @abstract(Izračuna kontrolno vsoto) | ^ @param | Dokumentacija parametra | @param(Buffer Podatki za preverjanje) | ^ @returns | Vrnjena vrednost | @returns(CRC32-vrednost kot Cardinal) | ^ @raises | Izjeme | @raises(EInvalidOperation Ob praznem bufferju) | <note>PasDoc-komentarji se začnejo z ( (dvojna zvezdica). Navadni (* komentarji se ne prikažejo kot dokumentacija.</note>

Naslednje funkcionalnosti zahtevajo strežniško podporo pasls in trenutno še niso na voljo:

• Rename Symbol (F2) — Preimenovanje simbola v vseh datotekah. Zahteva textDocument/rename v pasls.
• Live Diagnostics — Napake in opozorila med tipkanjem. Zahteva globlje vključevanje CodeTools v pasls.

Ctrl+T odpre iskalnik simbolov delovnega prostora. Tu je mogoče iskati procedure, funkcije, tipe in spremenljivke v vseh datotekah delovnega prostora.

• Vtipkajte iskalni izraz → pasls vrne ustrezne simbole
• Enter navigira neposredno na mesto definicije
• Prazno iskanje → prazen seznam (brez napake)

Linux-buildi na Windows prek WSL (Windows Subsystem for Linux).

1. Namestitev WSL: wsl –install v PowerShell (skrbnik)
2. Izbira distribucije: npr. Ubuntu (privzeto) ali Debian
3. Namestitev FPC v WSL:

# V WSL:
sudo apt install fpc lazarus

• fpc-solution-manager.wslEnabled — true
• fpc-solution-manager.wslActiveDistro — WSL-distribucija (npr. Ubuntu)
• fpc-solution-manager.wslLazbuildPath — Linux-pot do lazbuild (npr. /usr/bin/lazbuild)
• fpc-solution-manager.wslFpcPath — Linux-pot do fpc

• Select Cross-Compile Target — Izberi ciljno platformo (x86_64-linux, i386-linux, aarch64-linux)
• Configure WSL — Odpri nastavitve WSL
• Build for Linux (WSL) — Zaženi Linux-build

1. Izbira ciljne platforme: Desni klik na projekt → Select Cross-Compile Target
2. Zagon builda: Build for Linux (WSL) ali Ctrl+Shift+B (ko je WSL-cilj aktiven)
3. Razširitev preda build lazbuild / fpc znotraj WSL-instance
4. Izhodne datoteke pristanejo v nastavljeni izhodni poti

Show Dependencies — na voljo v Tree View in v kontekstnem meniju urejevalnika:

• Prikaže odvisnosti enot kot drevo
• Zazna krožne reference
• Pomaga pri refaktoriranju

Show Call Hierarchy — na voljo v Tree View in v kontekstnem meniju urejevalnika:

Desni klik na enoto → Show Call Hierarchy odpre WebView-panel z:

• Incoming — Katere funkcije kličejo ta simbol (klicatelji)
• Outgoing — Katere funkcije kliče ta simbol (klicanci)
• Klikljivi vnosi navigirajo neposredno do mesta klica

Desni klik v Pascal-urejevalniku → FPC Solution Manager → Show Call Hierarchy prikaže hierarhijo klicev kot vgrajeni Peek-pripomoček neposredno v urejevalniku (podobno kot Peek Definition). Kazalec mora biti na imenu funkcije ali metode.

• WvdS FPC Tools pregled
• Namestitev in nastavitev
• FPC PAS2JS Studio
• FPC ISS Designer
• Pogosta vprašanja (FAQ)