Creare pacchetti e pubblicare estensioni

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

Dopo aver sviluppato l'estensione, crearne il pacchetto e pubblicarlo in Visual Studio Marketplace. Marketplace è il repository globale per estensioni private e pubbliche, integrazioni e altre offerte di Microsoft.

Prerequisiti

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

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. Accedere 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 del publisher; il campo ID viene compilato automaticamente in base all'input.

   

   Nota

   • Verificare che il nome dell'editore sia compreso tra 16 caratteri per i caratteri multibyte.
   • Salvare l'ID dell'editore, necessario nel file 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.
   • Imposta 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.

Confeziona la tua estensione

Per caricare l'estensione, impacchettarla in un file .vsix compatibile con VSIX 2.0. Microsoft offre un'interfaccia della riga di comando multipiattaforma per creare un pacchetto e pubblicare l'estensione.

1. Apri il file manifesto dell'estensione (vss-extension.json) e imposta il valore del campo publisher sull'ID del tuo editore. Ad esempio:

   {
       ...
       "id": "my-first-extension",
       "publisher": "AnnetteNielsen",
       ...
   }
   

2. Dal prompt dei comandi, eseguire il comando di creazione dei pacchetti dello strumento TFX nella directory dell'estensione.

   npx tfx-cli extension create
   

   Viene visualizzato un messaggio che indica che l'estensione è stata inserita correttamente nel pacchetto:

   === Completed operation: create extension ===
   - VSIX: C:\my-first-extension\AnnetteNielsen.my-first-extension-1.0.0.vsix
   - Extension ID: my-first-extension
   - Extension Version: 1.0.0
   - Publisher: AnnetteNielsen
   

Controllare le dimensioni del pacchetto

Se il pacchetto .vsix supera i 50 MB, ottimizzarlo:

• Deduplicare le dipendenze : dichiarare le dipendenze condivise una sola volta nel pacchetto di estensione.
• Recupera in fase di esecuzione — Usa la libreria di installazione degli strumenti per scaricare le dipendenze in fase di esecuzione invece di creare un bundle. Questa libreria memorizza nella cache gli strumenti sugli agenti self-hosted in base alla versione. Non funziona in scenari disconnessi, pertanto è importante notare questa limitazione nella documentazione.
• Tree-shake : usare Webpack per rimuovere il codice inutilizzato dai bundle di attività.

Pubblicare l'estensione

Dopo aver creato il pacchetto dell'estensione, puoi caricarla nel Marketplace sotto il nome di un editore. L'identificatore publisher specificato nel file manifesto dell'estensione deve corrispondere all'identificatore del server di pubblicazione 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. Trascinare e rilasciare il file o selezionarlo per trovare il file VSIX creato nel passaggio di creazione del pacchetto precedente e quindi scegliere 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'estensione

Condividere l'estensione con un'organizzazione prima di poterla installare in Azure DevOps. Per condividere un'estensione, eseguire le attività seguenti:

1. Nel portale di gestione del Marketplace selezionare l'estensione dall'elenco, fare clic con il pulsante destro del mouse e quindi scegliere Condividi/Annulla condivisione o Pubblica/Annulla pubblicazione, a seconda dell'estensione.

   

2. Selezionare Organizzazione e quindi immettere il nome dell'organizzazione. Selezionare INVIO.

   

3. Chiudere il pannello.

L'estensione può ora essere installata in questa organizzazione.

Installare l'estensione

Per installare l'estensione condivisa, seguire questa procedura.

1. Nel Marketplace selezionare l'estensione per aprire la relativa pagina di panoramica.

   

   Nota

   Poiché l'estensione è privata, solo l'utente e i membri dell'organizzazione con cui è condiviso possono visualizzare questa pagina.

2. Selezionare Scarica gratuitamente per avviare il processo di installazione. Selezionare l'organizzazione con cui è stata condivisa l'estensione dal menu a discesa.

   

3. Selezionare Installa.

Complimenti. L'estensione è stata installata in un'organizzazione ed è possibile provarla.

Prova l'estensione

1. Selezionare Continua all'organizzazione alla fine dell'installazione guidata per passare alla home page dell'organizzazione in cui è stata installata l'estensione (https://dev.azure.com/{organization}).

2. Aggiorna il browser.

3. Aprire Impostazioni organizzazione e quindi selezionare Estensioni.

   

Verrà visualizzata la nuova estensione nella scheda Installato .

Eseguire il debug dell'estensione

Per eseguire il debug dell'estensione usando Visual Studio o Browser Developer Tools, modificare il manifesto aggiungendo la baseUri proprietà . Questa azione accelera lo sviluppo senza la necessità di ridistribuire l'estensione ogni volta che si modifica il codice sorgente.

{
    ...
    "baseUri": "https://localhost:44300",
    ...
}

Quando si modifica il file manifest, carica l'estensione dall'istanza del server web locale. Ad esempio, IISExpress in Visual Studio. Dopo aver modificato il manifesto, installa e deploia questa estensione di debug una sola volta.

Aggiornare l'estensione

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'estensione

Durante lo sviluppo, mantenere privata l'estensione in modo che solo le organizzazioni condivise possano visualizzarla. Quando si è pronti, impostare il flag pubblico su true nel manifesto per elencarlo pubblicamente.

Qualifiche

Le presentazioni del Marketplace pubblico devono soddisfare i requisiti seguenti:

• Funziona con o estende Azure DevOps.
• L'utente o la società è proprietaria, sviluppa e ha la licenza per distribuire l'estensione.
• L'estensione viene gestita attivamente.

Microsoft potrebbe richiedere una demo ed esaminare i contenuti di immissione del Marketplace pianificati.

Editore di punta

Il programma Top Publisher è disponibile solo per gli editori con estensioni o integrazioni di Azure DevOps. Non si applica agli editori di estensioni di Visual Studio IDE o Visual Studio Code.

Il programma riconosce gli editori che dimostrano l'impegno dei clienti attraverso criteri esemplari, qualità, affidabilità e supporto. Una volta che si diventa top publisher, tutte le offerte pubbliche visualizzano il badge.

Requisiti principali del server di pubblicazione

Il Marketplace assegna il badge dopo aver esaminato l'editore nei criteri seguenti:

• Informativa sulla privacy
• Criteri di licenza
• Politica di supporto
• Documentazione
• Reattività Q&A
• Valutazioni e recensioni
• Numero di adozioni e installazioni attive
• Almeno un'estensione Azure DevOps pubblica con più di 5.000 installazioni e un numero di installazioni attivo superiore a 1.000

Per ulteriori informazioni sull'aggiunta di criteri alla tua offerta, consulta il manifesto dell'estensione.

Prima di presentare la domanda, aggiorna il tuo profilo di pubblicazione.

1. Accedere al portale di gestione dell'editore.

2. Selezionare l'editore e completare la sezione Informazioni dettagliate nella scheda Dettagli .

   

3. Salvare le modifiche e selezionare Visualizza profilo per verificare la modalità di visualizzazione degli utenti.

Candidati per diventare un top editore

1. Accedere al portale di gestione del Marketplace.
2. Selezionare l'editore e passare alla scheda Server di pubblicazione superiore . Questa scheda viene visualizzata solo se sono presenti una o più estensioni o integrazioni globali di Azure DevOps.
3. Se soddisfi i requisiti e sei il proprietario del publisher, seleziona Applica. Il team del Marketplace esamina l'applicazione e risponde entro 10 giorni lavorativi.

Il team può anche prendere in considerazione l'adozione attiva, il numero di installazioni e le valutazioni e recensioni prima di concedere il badge. Microsoft si riserva il diritto di concedere, rifiutare o revocare il badge Top Publisher in qualsiasi momento.

Una volta concessi, tutti gli aggiornamenti e le offerte futuri dell'editore devono continuare a soddisfare i requisiti.

Rispondere alle revisioni delle estensioni del Marketplace

È possibile rispondere alle recensioni che i clienti lasciano per le estensioni. Selezionare Rispondi accanto a una recensione se si dispone di permessi di proprietario, creatore o collaboratore.

È possibile lasciare una sola risposta. Evitare di usare le recensioni come forum di supporto. Fornire invece un alias di supporto per il revisore da contattare, risolvere il problema esternamente e quindi aggiornare la risposta con la risoluzione.

Linee guida per le risposte dell'editore

• Usare Reply solo per rispondere a una recensione.
• Considera tutti i commenti come feedback: non dibattere, criticare o discutere.
• Concentrarsi direttamente sulla risoluzione di domande o problemi.
• Se sono necessari altri dettagli, chiedere al cliente di contattare l'utente tramite posta elettronica. Aggiornare la risposta quando si risolve il problema.
• Contrassegnare revisioni inappropriate (spam, contenuti abusivi o offensivi) per la revisione del Marketplace.

Richiedere di annullare una revisione

È possibile richiedere di annullare una verifica se il problema segnalato è causato dal Marketplace o dalla piattaforma sottostante. Se valido, gli amministratori del Marketplace annullano la valutazione. Selezionare Appeal nella sezione Valutazioni e recensioni nella pagina dell'hub di estensione.

Annullare la pubblicazione di un'estensione

È possibile annullare la pubblicazione delle estensioni gratuite se non si vuole più offrirle nel Marketplace. Scenari comuni:

• L'estensione è stata sostituita con una nuova.
• È necessario rimuoverlo temporaneamente durante la risoluzione di un problema.
• Hai pubblicato come pubblico per errore.

Per annullare o rimuovere un'estensione, è necessario soddisfare determinati criteri:

1. Selezionare l'estensione nella pagina dell'editore e scegliere Annulla pubblicazione dal menu.

   L'estensione non è pubblicata immediatamente dal Marketplace e i nuovi utenti non possono installarla. Valutazioni e recensioni per l'estensione rimangono intatte.

Per offrire nuovamente l'estensione nel Marketplace, selezionare Pubblica dal menu.

Se l'estensione ha zero installazioni, è possibile scegliere di rimuoverla completamente dal Marketplace. A tale scopo, selezionare Rimuovi dal menu. Non è possibile invertire questa azione.

Hub di reportistica estensioni

Dopo la pubblicazione dell'estensione, usare la funzionalità Report per tenere traccia delle prestazioni. Passare alla pagina dell'editore e selezionare l'estensione oppure selezionare Report nella pagina dei dettagli dell'estensione.

Acquisizione

La scheda Acquisizione mostra:

• Acquisizione aggregata per il periodo selezionato
• Acquisizione divisa per download e installazioni di Azure DevOps (gratuite) o versioni di valutazione e acquisti (a pagamento)
• Tendenza giornaliera delle visualizzazioni di pagina e acquisizione
• Percentuale di conversione dalle visualizzazioni pagina all'acquisizione

Per le estensioni a pagamento, i dettagli transazionali includono data, nome organizzazione, data di fine della versione di valutazione e quantità. Usare l'azione Contatto per comunicare con gli utenti.

Disinstallare

La scheda Disinstalla mostra:

• Numero di organizzazioni disinstallate
• Tendenza giornaliera di disinstallazione
• Feedback dettagliato condiviso durante le disinstallazioni
• Principali motivi di disinstallazione

Usare la ricerca per filtrare in base a testo e date. Per le estensioni a pagamento, usare l'azione Contatto per raggiungere gli utenti.

Valutazioni e revisione

La scheda Ratings and review (Classificazioni e revisione ) mostra:

• Valutazione media per il periodo selezionato rispetto all'insieme
• Valutazione media per numero di revisori
• Tendenza di valutazione giornaliera

Nella sezione dei dettagli è possibile rispondere alle recensioni, Modificare le risposte precedenti o Annullare una valutazione causata da un problema del Marketplace o della piattaforma.

Domande e risposte

Nella scheda Domande e risposte sono elencate tutte le domande degli utenti dell'estensione, con query senza risposta nella parte superiore. Rispondere o modificare le risposte precedenti per gestire l'engagement.

Esporta in Excel

Tutti i dati del report sono disponibili per il download in formato XLS per la creazione di report personalizzati.

Contatto

Per le estensioni a pagamento, l'azione Contatto consente di comunicare con gli utenti. Questa funzionalità richiede un accesso di tipo Collaboratore o superiore per l'estensione.

Il Marketplace gestisce la prima comunicazione: gli indirizzi di posta elettronica dei clienti non vengono condivisi direttamente. Solo gli utenti che hanno scelto esplicitamente ricevono l'email.

Comunicazione transazionale (consentita): avvisi di sicurezza critici, conferme delle transazioni, avvisi di richiamo del prodotto, richieste di feedback specifiche e avvisi di interruzione del servizio.

Email promozionali (con restrizioni): inviti agli eventi, annunci di programma di marketing, offerte di contenuti a valore aggiunto e newsletter con contenuti promozionali.

Per altre informazioni, vedere Il Contratto di pubblicazione del Marketplace.

Contenuti correlati

• Sviluppare un'estensione Web
• Riferimento al manifesto di estensione
• Punti di Estensibilità