WvdS VSCode Packaging

Packaging ekstenzija stvara VSIX pakete i omogućuje objavljivanje na Visual Studio Marketplaceu.

Packaging ekstenzija nudi:

• Izrada VSIX-a - Paketi za VS Code ekstenzije
• Upravljanje verzijama - Automatsko upravljanje brojevima verzija
• Multi-Extension podrška - Pakiranje više ekstenzija odjednom
• Objava na Marketplace - Direktno objavljivanje

• Node.js instaliran
• vsce alat dostupan:

  npm install -g @vscode/vsce

1. Osigurajte da se projekt kompilira
2. Ctrl+Shift+P → WVDS: Create VSIX Package
3. Odaberite ekstenziju (ako ih ima više)
4. Paket se stvara u binaries/dist/

binaries/dist/
  wvds-vscode-core-0.1.0.vsix
  wvds-vscode-build-0.1.0.vsix
  ...

Paket koristi Semantic Versioning (SemVer):

MAJOR.MINOR.PATCH
  1.0.0

Prilikom pakiranja verzija se može automatski povećati:

1. Odaberite „Increment Version“ u dijaloškom okviru
2. Odaberite dio koji se povećava (MAJOR, MINOR, PATCH)
3. package.json se ažurira

Za beta izdanja:

1.0.0-beta.1
1.0.0-rc.1

Paket se sastoji od više ekstenzija koje se mogu pakirati zajedno.

Extension Pack objedinjuje više ekstenzija:

{
  "name": "wvds-fpc-rad-suite",
  "displayName": "WvdS FPC RAD Suite",
  "extensionPack": [
    "wvds.wvds-vscode-core",
    "wvds.wvds-vscode-build",
    "wvds.wvds-vscode-projects",
    "wvds.wvds-vscode-ui-designer",
    "wvds.wvds-vscode-ui-meta",
    "wvds.wvds-vscode-ui-preview",
    "wvds.wvds-vscode-packaging"
  ]
}

Pakiranje svih ekstenzija odjednom:

1. WVDS: Create VSIX Package
2. Odaberite „All Extensions“
3. Svi paketi se stvaraju

1. Azure DevOps Organisation - Za Publisher račun
2. Personal Access Token (PAT) - S Marketplace pravima
3. Publisher ID - Registriran na marketplace.visualstudio.com

1. Posjetite marketplace.visualstudio.com/manage
2. Stvorite Publisher
3. Zapišite Publisher-ID

1. Posjetite dev.azure.com
2. User Settings → Personal Access Tokens
3. Stvorite token s „Marketplace (Publish)“ scopeom

1. WVDS: Publish Package
2. Unesite PAT (sigurno se pohranjuje)
3. Ekstenzija se učitava

Prije objavljivanja automatski se provjerava:

Za objavu na Marketplace:

{
  "name": "wvds-vscode-core",
  "displayName": "WvdS VSCode Core",
  "description": "Središnja infrastruktura za WvdS FPC RAD Studio",
  "version": "0.1.0",
  "publisher": "wvds",
  "license": "MIT",
  "icon": "images/icon.png",
  "repository": {
    "type": "git",
    "url": "https://github.com/ArmandoFilho/WvdS.FPC"
  },
  "engines": {
    "vscode": "^1.85.0"
  },
  "categories": ["Other"],
  "keywords": ["pascal", "fpc", "free pascal"]
}

Za testiranje prije objavljivanja:

code --install-extension binaries/dist/wvds-vscode-core-0.1.0.vsix

Ili u VS Code:

1. Extensions → „…“ → „Install from VSIX…“
2. Odaberite VSIX datoteku

Uzrok: vsce nije instaliran.

Rješenje:

npm install -g @vscode/vsce

Uzrok: Publisher-ID u package.json ne odgovara registriranom publisheru.

Rješenje:

1. Provjerite Publisher-ID u package.json
2. Osigurajte da je publisher registriran

Uzrok: Ova verzija je već objavljena.

Rješenje:

1. Povećajte broj verzije
2. Koristite funkciju Increment

Uzrok: Personal Access Token je istekao.

Rješenje:

1. Stvorite novi PAT
2. Unesite ga pri sljedećem objavljivanju

• Build Extension - Kompilacija
• Core Extension - Toolchain
• VS Code Publishing Docs