Creare pacchetti e pubblicare estensioni

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dopo aver sviluppato l'estensione, è possibile crearne il pacchetto e pubblicarlo in Visual Studio Marketplace. Marketplace è un 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

Controllare la dimensione del vsix dopo che è stato impacchettato. Se è maggiore di 50 MB, è necessario ottimizzarlo. A tale scopo, vedere le considerazioni seguenti:

• Deduplicare le dipendenze comuni indicandole una volta nel pacchetto di estensione.
• Recuperare le dipendenze in fase di esecuzione o durante l'installazione anziché includerle nel pacchetto. È consigliabile usare la libreria del programma di installazione degli strumenti per eseguire il pull delle dipendenze degli strumenti in fase di esecuzione. Questo approccio memorizza nella cache lo strumento in base alla versione per gli agenti privati, impedendo i download per ogni compilazione. La libreria del programma di installazione degli strumenti non funziona in scenari disconnessi (nessuna Internet), che deve essere menzionata nella descrizione o nella documentazione dell'attività.
• Usare WebPack per scuotere le dipendenze nelle 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

Mentre si sviluppa l'estensione o l'integrazione per il Marketplace, mantenerla privata. Ciò limita la visibilità dell'estensione a account specifici con cui è stato condiviso.

Per rendere disponibile pubblicamente l'estensione, impostare il flag pubblico su true nel manifesto.

Qualifiche

Per avere un'inserzione pubblica nel Marketplace, l'integrazione o l'estensione devono soddisfare le qualifiche seguenti:

• Funziona con o estende Azure DevOps.
• L'utente o l'azienda è proprietario, sviluppa, ed è concesso in licenza per distribuire e annunciare l'integrazione o l'estensione.
• L'estensione o l'integrazione viene gestita attivamente.

Microsoft potrebbe richiedere anche una demo ed esaminare il contenuto pianificato per l'inserzione sul Marketplace.

Editore di punta

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

Il programma Top Publisher riconosce gli editori con impegno nei confronti dei clienti e del Marketplace attraverso criteri esemplari, qualità, affidabilità e supporto. Una volta che si diventa top publisher, tutte le offerte pubbliche visualizzano il badge Top Publisher.

Requisiti principali del server di pubblicazione

Il programma Top Publisher nel Marketplace è progettato per valutare o acquisire le estensioni e le integrazioni di Azure DevOps con sicurezza. Il badge Top Publisher implica che l'editore mostra l'impegno per i clienti e il Marketplace tramite criteri esemplari, qualità, affidabilità e supporto. È destinato agli editori con una o più estensioni o integrazioni globali di Azure DevOps e non è applicabile agli editori di estensioni di Visual Studio IDE e Visual Studio Code.

Marketplace assegna il badge a un editore dopo aver esaminato attentamente l'editore nei parametri seguenti:

• Informativa sulla privacy
• Criteri di licenza
• Politica di supporto
• Documentazione
• Reattività del Q&A
• Valutazioni e recensioni per le offerte
• Numero di adozioni e conteggio delle installazioni attive per le loro offerte
• Gestione di almeno un'estensione pubblica per Azure DevOps
• Estensione pubblica con più di 5.000 installazioni e un numero di installazioni attivo superiore a 1000

È possibile prevedere un supporto tempestivo e un'esperienza complessiva ottimale quando si ottiene un'estensione da un server di pubblicazione principale. Consultare le offerte dei principali editori.

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

1. Aggiorna il tuo profilo di editore.

   Tramite il profilo dell'editore, è possibile presentare tutte le offerte in un'unica posizione insieme alle informazioni chiave correlate all'editore. Per fornire le informazioni visualizzate nel profilo, seguire questa procedura:

   a) Accedere all'account https://marketplace.visualstudio.com/manage/publishers con cui pubblicare e gestire le offerte in Visual Studio Marketplace.

   b. Selezionare l'editore e completare la sezione Informazioni su di te nella scheda Dettagli. c. Salvare le modifiche e selezionare Visualizza profilo per vedere come appare agli utenti. È possibile usare questa pagina del profilo per promuovere le offerte.

Candidati per diventare un top editore

1. Accedi al portale di gestione Marketplace utilizzando l'account con cui pubblichi e gestisci le offerte nel Marketplace.
2. Selezionare il publisher e passare alla relativa scheda Miglior Publisher. Avere una o più estensioni o integrazioni globali di Azure DevOps (Server/Service) affinché la scheda sia visibile.
3. Se si soddisfano i requisiti elencati in precedenza e si è il proprietario dell'editore, è possibile richiedere il programma. Dopo l'applicazione, un messaggio di posta elettronica viene inviato al team del Marketplace per esaminare il caso. Rispondono entro 10 giorni lavorativi con i passaggi successivi, chiarire le domande o la concessione del badge.

È probabile che il team consideri altri parametri, ad esempio l'adozione attiva delle offerte, i conteggi di installazione/avvio e le valutazioni e recensioni tra le offerte prima di concedere il badge. Microsoft si riserva il diritto di concedere, rifiutare o revocare il badge Top Publisher in qualsiasi momento.

Una volta che un editore è un Top Publisher, tutti gli aggiornamenti e offerte futuri devono soddisfare i requisiti elencati in precedenza.

Rispondere alle revisioni delle estensioni del Marketplace

È possibile rispondere alle recensioni che i clienti lasciano per le estensioni in Visual Studio Marketplace. Trova e seleziona Rispondi accanto a una recensione se hai una delle seguenti autorizzazioni: proprietario, autore o collaboratore.

È possibile lasciare una sola risposta. Evitare di usare le recensioni come forum di supporto. Se sono necessari altri dettagli, specificare un alias di supporto per contattare il revisore. È quindi possibile risolvere i problemi esternamente e aggiornare la risposta con una risoluzione.

Linee guida per le risposte dell'editore

Mantenere Visual Studio Marketplace un luogo aperto, invito, rispettoso e utile per i clienti per trovare, provare, installare ed esaminare le estensioni. La comunicazione svolge un ruolo importante nel mantenere una comunità sana. Per creare questo ambiente, ecco le linee guida per gli editori che rispondono alle recensioni dei clienti. Considerare profondamente le interazioni con i clienti e riflettere sullo spirito dell'esperienza dei clienti che il Marketplace sta cercando di creare.

• Riservate le recensioni per i commenti dei clienti. Usare Reply solo per rispondere a una recensione.
• Rispettare tutte le opinioni dei clienti. Trattare i commenti come commenti senza discussioni, critiche o argomenti.
• Assicurarsi che le risposte aggiungono valore e siano rilevanti per i commenti dei clienti.
• Concentrarsi sulla risoluzione precisa delle domande o dei problemi. Se sono necessari altri dettagli, chiedere al cliente di contattare l'utente tramite posta elettronica anziché discutere nelle recensioni. Quando si risolve il problema, aggiornare la risposta con la risoluzione. È possibile modificare la risposta come i clienti possono modificare le recensioni.
• Contrassegnare eventuali recensioni inappropriati, ad esempio spam, abusi o contenuti offensivi, per la nostra recensione.

Richiedere di annullare una revisione

In qualità di editore, è possibile annullare una verifica se il problema segnalato è dovuto al Marketplace o alla piattaforma sottostante. Se il problema è valido, gli amministratori del Marketplace annullano la valutazione. Puoi fare appello dalla sezione delle valutazioni e delle recensioni sulla pagina del tuo hub di estensione.

Annullare la pubblicazione di un'estensione

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

Provare a rimuovere l'estensione dal Marketplace negli scenari seguenti:

• È stata sviluppata una nuova estensione e non si vuole più offrire quella corrente.
• L'estensione presenta un problema e si vuole rimuoverla dal Marketplace fino a quando non si risolve il problema.
• Hai pubblicato la tua estensione come pubblica 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

Quando l'estensione è disponibile in Visual Studio Marketplace, è possibile usare la funzionalità Report . Con questa funzionalità è possibile tenere traccia e analizzare le prestazioni dell'estensione e intraprendere le azioni necessarie. Per visitare l'hub di estensione, vai alla pagina dell'editore e seleziona l'estensione o seleziona il collegamento Rapporti nella pagina dei dettagli dell'estensione.

Acquisizione

È possibile visualizzare i dati relativi all'acquisizione in questa scheda per il periodo selezionato.

• Acquisizione aggregata nel periodo selezionato per l'acquisizione complessiva
• Suddivisione delle acquisizioni aggregate in base ai download delle estensioni, installazione connessa di Azure DevOps per un'estensione gratuita.
• Acquisizione aggregata suddivisa per prove di valutazione per l'acquisto connesso ad Azure DevOps per l'estensione a pagamento
• Tendenza giornaliera delle visualizzazioni della pagina dell'estensione con acquisizione dei dati per Azure DevOps e server collegato.
• Percentuale di conversione dalle visualizzazioni pagina all'acquisizione

Per le estensioni a pagamento, tutti i dettagli transazionali per l'acquisto e le versioni di valutazione sono disponibili con data, nome organizzazione, data di fine della versione di valutazione e quantità. È possibile usare l'azione contatto per comunicare con gli utenti. Per altre informazioni, vedere la sezione Contact fornita più avanti in questo articolo.

Disinstallare

È possibile visualizzare le statistiche seguenti:

• Quante organizzazioni hanno disinstallato l'estensione
• Tendenza giornaliera delle estensioni di disinstallazione
• Feedback dettagliato condiviso durante le disinstallazioni
• Principali motivi di disinstallazione

È possibile utilizzare la ricerca di testo e date per analizzare e ottenere maggiori intuizioni dal feedback dettagliato.

Per le estensioni a pagamento, è possibile usare l'azione contatto per comunicare con i tuoi utenti. sezione Contatti fornita più avanti in questo articolo per più dettagli.

Valutazioni e revisione

Questa scheda fornisce le informazioni seguenti:

• Valutazione media per il periodo selezionato rispetto alla valutazione complessiva
• Valutazione media per numero di revisori
• Tendenza giornaliera della valutazione media

La sezione dei dettagli fornisce tutte le revisioni e le risposte nella visualizzazione transazionale.

È possibile rispondere a una recensione o modificare una risposta precedente e gestire meglio il coinvolgimento con gli utenti dell'estensione. È anche possibile fare ricorso per annullare una valutazione se il problema segnalato è dovuto al Marketplace o alla piattaforma sottostante. Se il problema è valido, viene annullata la valutazione.

Gestire il coinvolgimento

La scheda Q & A fornisce una panoramica di tutte le domande degli utenti dell'estensione, con le richieste non risposte nella parte superiore. È possibile rispondere o modificare le risposte precedenti per gestire meglio l'engagement con gli utenti dell'estensione.

Esporta in Excel

Tutti gli elementi dati disponibili nella pagina dei report sono disponibili anche per il download in formato XLS per facilitare la creazione di report personalizzati.

Contatto

Per le estensioni a pagamento, è possibile usare l'azione contatto per comunicare con i tuoi utenti. Questa funzionalità è disponibile solo per gli editori con accesso Collaboratore+ nell'estensione.

Il Marketplace gestisce la prima comunicazione con l'utente poiché la nostra informativa sulla privacy non permette la condivisione diretta degli indirizzi email dei clienti. Solo gli utenti che hanno scelto di ricevere comunicazioni ricevono l'email. L'ultima data di contatto per un'organizzazione viene aggiornata dopo l'invio di una comunicazione.

Comunicazione transazionale: i messaggi di posta elettronica forniscono informazioni critiche necessarie per l'uso continuo dell'estensione o del servizio, ad esempio:

• Avvisi di sicurezza critici
• Conferme delle transazioni
• Avvisi di richiamo del prodotto
• Richieste di feedback specifiche
• Avvisi di interruzione del servizio

Email promozionali: messaggi di posta elettronica usati per commercializzare l'estensione, il prodotto, il servizio, il sito Web o l'evento, ad esempio:

• Inviti a eventi o webcasti
• Informazioni sui nuovi programmi di marketing o partner
• Offerte per ottenere contenuti a valore aggiunto
• Newsletter contenenti contenuti promozionali

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

Contenuti correlati

• Sviluppare un'estensione Web
• Esplorare i punti di estendibilità