Creare un pacchetto e pubblicare un'integrazione

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Pubblicare lo strumento, il servizio o il prodotto che si integra con Azure DevOps in Visual Studio Marketplace. Marketplace è l'hub centrale per consentire agli utenti di individuare integrazioni ed estensioni.

Prerequisiti

Prima di pubblicare nel Marketplace, è necessario soddisfare l'elenco seguente dei requisiti.

Sono necessari anche gli asset seguenti:

• Almeno uno screenshot dell'integrazione
• UN URL di invito all'azione o un URL introduttivo per gli utenti

Creare un autore

Ogni estensione o integrazione, inclusi quelli di Microsoft, deve avere un editore. Chiunque può creare un editore e pubblicare le estensioni al suo interno. È anche possibile condividere l'accesso all'editore con altri utenti, ad esempio il team di sviluppo.

1. Accedi al portale di pubblicazione di Visual Studio Marketplace .

2. Se non si fa parte di un server di pubblicazione esistente, selezionare + Crea un server di pubblicazione.
   Immettere un nome dell'editore; il campo ID viene compilato automaticamente in base all'inserimento.

   

   Nota

   • Verificare che il nome dell'editore sia compreso tra 16 caratteri per i caratteri multibyte.
   • Salva l'ID editore, necessario nel file di manifest dell'estensione.

   Se non viene richiesto di creare un server di pubblicazione, scorrere fino a Pubblica estensioni in Siti correlati.

   • Impostare un identificatore di autore univoco, ad esempio mycompany-myteam. Usare questo valore per l'attributo publisher nel manifesto.
   • Impostare un nome visualizzato, ad esempio My Team.

3. Esaminare il Contratto di pubblicazione del Marketplace e quindi selezionare Crea.

   

Dopo aver creato l'editore, è possibile gestire gli elementi, anche se non vengono visualizzati elementi fino alla pubblicazione.

Configurare la struttura del progetto

Creare il layout di directory seguente:

home/
├── images/
│   ├── integration-logo.png    (128×128 px minimum)
│   └── screenshot.png          (1366×768 px)
├── overview.md
└── vss-integration.json

Creare il manifesto

Creare vss-integration.json con il contenuto seguente, quindi aggiornare i valori per l'integrazione:

{
    "manifestVersion": 1,
    "id": "myservice",
    "version": "1.0.0",
    "name": "My Service",
    "publisher": "mycompany",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],    
    "icons": {
        "default": "images/service-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "screenshots": [
        {
            "path": "images/screen1.png"
        },
        {
            "path": "images/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "fabrikam-license-terms.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.mycompany.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.mycompany.com/features"
        },
        "support": {
            "uri": "https://www.mycompany.com/support"
        }
    },
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    }
}

Aggiornare i campi usando i riferimenti seguenti:

Sono necessarie le proprietà seguenti:

Le proprietà facoltative seguenti consentono agli utenti di individuare e ottenere informazioni sull'estensione:

Creare un pacchetto per l'integrazione

1. Installare lo strumento di creazione pacchetti se non l'hai già installato.

   npm install -g tfx-cli
   

2. Impacchetta la tua integrazione in un file .vsix:

   tfx extension create --manifest-globs vss-integration.json
   

   Suggerimento

   Usare --rev-version per incrementare automaticamente il numero di versione della patch.

Pubblicare nel Marketplace

Dopo aver creato il pacchetto dell'estensione, è possibile caricarla sul Marketplace sotto un publisher. L'identificatore publisher specificato nel file manifesto dell'estensione deve corrispondere all'identificatore dell'autore in cui viene caricata l'estensione.

1. Nel portale di gestione selezionare l'editore dal menu a discesa nella parte superiore della pagina.

2. Selezionare Nuova estensione>Azure DevOps.

   

3. Trascina e rilascia il tuo file oppure selezionalo per trovare il tuo file VSIX, che hai creato nel passaggio di creazione del pacchetto precedente, e quindi scegli Carica.

   

   Dopo la convalida rapida, l'estensione viene visualizzata nell'elenco delle estensioni pubblicate. Non preoccuparti, l'estensione è visibile solo per te.

   

A questo punto, l'estensione non è visibile ad alcun account. Per renderlo visibile ad altri utenti, è necessario condividere l'estensione.

Condividere l'integrazione

Prima di poter installare un'integrazione in un'organizzazione Azure DevOps, è necessario condividerla con tale organizzazione.

1. Selezionare l'integrazione nell'elenco degli elementi visualizzati.
2. Seleziona Condividi.
3. Immettere il nome dell'organizzazione, fabrikam-fiber-inc ad esempio per dev.azure.com/fabrikam-fiber-inc.

Aggiornare l'integrazione

Per aggiornare un'estensione già pubblicata, seguire questa procedura:

1. Selezionare l'estensione dall'elenco di elementi visualizzati.
2. Fare clic con il pulsante destro del mouse e selezionare Aggiorna per la versione di sviluppo, ad esempio publisher.extension-dev.
3. Convalidare l'estensione.
4. Applicare gli stessi aggiornamenti alla versione di produzione, ad esempio publisher.extension.
5. Accedi al file .vsix per la tua estensione e caricalo.

Azure DevOps installa automaticamente la versione aggiornata per tutti gli account che dispongono già dell'estensione. Le nuove installazioni ricevono anche la versione più recente.

Rendere pubblica l'integrazione

Per rendere visibile l'integrazione a tutti gli utenti del Marketplace, impostare il public flag su true nel manifesto e ripubblicare.

Per altre informazioni sulle qualifiche necessarie per le inserzioni pubbliche, vedere Rendere pubblica l'estensione.

Contenuti correlati

• Riferimento al manifesto di estensione
• Creare pacchetti e pubblicare estensioni
• Visual Studio Marketplace