WvdS VSCode Packaging

La Packaging Extension crea pacchetti VSIX e permette la pubblicazione su Visual Studio Marketplace.

La Packaging Extension offre:

• Creazione VSIX - Pacchetti per estensioni VS Code
• Gestione versioni - Gestione automatica dei numeri di versione
• Supporto multi-estensione - Pacchettizzare più estensioni contemporaneamente
• Pubblicazione Marketplace - Pubblicazione diretta

• Node.js installato
• Tool vsce disponibile:

  npm install -g @vscode/vsce

1. Assicuratevi che il progetto compili
2. Ctrl+Shift+P → WVDS: Create VSIX Package
3. Selezionate l'estensione (se ce ne sono più di una)
4. Il pacchetto viene creato in binaries/dist/

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

La suite utilizza Semantic Versioning (SemVer):

MAJOR.MINOR.PATCH
  1.0.0

Durante la pacchettizzazione, la versione può essere incrementata automaticamente:

1. Selezionate „Increment Version“ nel dialogo
2. Scegliete la parte da incrementare (MAJOR, MINOR, PATCH)
3. Il package.json viene aggiornato

Per release beta:

1.0.0-beta.1
1.0.0-rc.1

La suite è composta da più estensioni che possono essere pacchettizzate insieme.

Un Extension Pack raggruppa più estensioni:

{
  "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"
  ]
}

Pacchettizzare tutte le estensioni in una volta:

1. WVDS: Create VSIX Package
2. Selezionate „All Extensions“
3. Tutti i pacchetti vengono creati

1. Organizzazione Azure DevOps - Per account publisher
2. Personal Access Token (PAT) - Con permessi Marketplace
3. Publisher ID - Registrato su marketplace.visualstudio.com

1. Visitate marketplace.visualstudio.com/manage
2. Create un publisher
3. Annotate il Publisher ID

1. Visitate dev.azure.com
2. User Settings → Personal Access Tokens
3. Create un token con scope „Marketplace (Publish)“

1. WVDS: Publish Package
2. Inserite il PAT (viene memorizzato in modo sicuro)
3. L'estensione viene caricata

Prima della pubblicazione vengono controllati automaticamente:

Per la pubblicazione su Marketplace:

{
  "name": "wvds-vscode-core",
  "displayName": "WvdS VSCode Core",
  "description": "Infrastruttura centrale per 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"]
}

Per testare prima della pubblicazione:

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

Oppure in VS Code:

1. Extensions → „…“ → „Install from VSIX…“
2. Selezionate il file VSIX

Causa: vsce non installato.

Soluzione:

npm install -g @vscode/vsce

Causa: Publisher ID in package.json non corrisponde al publisher registrato.

Soluzione:

1. Controllate il Publisher ID in package.json
2. Assicuratevi che il publisher sia registrato

Causa: Questa versione è già stata pubblicata.

Soluzione:

1. Incrementate il numero di versione
2. Utilizzate la funzione Increment

Causa: Personal Access Token scaduto.

Soluzione:

1. Create un nuovo PAT
2. Inseritelo alla prossima pubblicazione

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