Pubblicazione di estensioni

Si applica a: Windows Admin Center, Windows Admin Center Preview

Dopo aver sviluppato l'estensione, è necessario pubblicarla e renderla disponibile ad altri utenti per testare o usare. In questo articolo vengono presentate alcune opzioni di pubblicazione insieme ai passaggi e ai requisiti a seconda del gruppo di destinatari e dello scopo della pubblicazione.

Opzioni di pubblicazione

Esistono tre opzioni principali per le origini di pacchetti configurabili supportate da Windows Admin Center:

• Feed NuGet di Windows Admin Center pubblico di Microsoft
• Feed NuGet privato
• Condivisione file locale o di rete

Pubblicazione nel feed dell'estensione Windows Admin Center

Per impostazione predefinita, Windows Admin Center è connesso a un feed NuGet gestito dal team del prodotto Windows Admin Center in Microsoft. Le versioni di anteprima iniziali delle nuove estensioni sviluppate da Microsoft possono essere pubblicate in questo feed e rese disponibili agli utenti di Windows Admin Center. Gli sviluppatori esterni che pianificano di compilare e rilasciare le estensioni pubblicamente possono anche inviare una richiesta a Pubblicare l'estensione nel feed di Windows Admin Center. Prima della pubblicazione in questo feed, gli sviluppatori esterni devono accettare il Contratto di pubblicazione dell'estensione di Windows Admin Center e Criteri di partecipazione alle estensioni.

Pubblicazione in un feed NuGet diverso

È anche possibile creare un feed NuGet personalizzato per pubblicare le estensioni usando una delle numerose opzioni diverse per configurare un'origine privata o usando un servizio di hosting NuGet. Il feed NuGet deve supportare l'API NuGet v2. Poiché Windows Admin Center attualmente non supporta l'autenticazione dei feed, il feed deve essere configurato per consentire l'accesso in lettura a chiunque.

Pubblicazione in una condivisione file

Per limitare l'accesso dell'estensione all'organizzazione o a un gruppo limitato di persone, è possibile usare una condivisione file SMB come feed di estensioni. Quando si usa una condivisione file per ospitare il feed di estensioni, vengono applicate le autorizzazioni di file e cartelle per gestire l'accesso al feed.

Preparazione dell'estensione per il rilascio

Assicurarsi di leggere e prendere in considerazione i seguenti articoli di sviluppo:

• Controllare la visibilità dello strumento
• Stringhe e localizzazione

Prendere in considerazione il rilascio come versione di anteprima

Se si rilascia una versione di anteprima dell'estensione a scopo di valutazione, è consigliabile:

• Aggiungere "(Anteprima)" alla fine del titolo dell'estensione nel file .nuspec
• Spiegare le limitazioni nella descrizione dell'estensione nel file .nuspec

Creazione di un pacchetto di estensione

Windows Admin Center usa pacchetti e feed NuGet per la distribuzione e il download delle estensioni. Affinché il pacchetto venga fornito, è necessario generare un pacchetto NuGet contenente i plug-in e le estensioni. Un singolo pacchetto può contenere un'estensione dell'interfaccia utente e un plug-in gateway. La sezione seguente descrive il processo in modo dettagliato.

Compilare l'estensione

Non appena si è pronti per iniziare a creare il pacchetto dell'estensione, creare una nuova directory nel file system, aprire una console e quindi CD in esso. Questa directory è la directory radice usata per contenere tutte le directory di contenuto e nuspec che costituiscono il pacchetto. Questa cartella viene chiamata pacchetto NuGet per il resto di questo articolo.

Estensioni dell'interfaccia utente

Per iniziare il processo durante la raccolta di tutto il contenuto necessario per un'estensione dell'interfaccia utente, eseguire "gulp build" nello strumento e assicurarsi che la compilazione abbia esito positivo. Questo processo raggruppa tutti i componenti in una cartella denominata "bundle" che si trova nella directory radice dell'estensione (allo stesso livello della directory src). Copiare questa directory e tutto il relativo contenuto nella cartella "Pacchetto NuGet".

Plug-in gateway

Usando l'infrastruttura di compilazione (che potrebbe essere semplice come aprire Visual Studio e selezionare il pulsante Compila), compilare e costruire il plug-in. Aprire la directory di output di compilazione, copiare la DLL o le DLL che rappresentano il plug-in e inserirle in una nuova cartella all'interno della directory "Pacchetto NuGet" denominata "package". Non è necessario copiare la DLL FeatureInterface, ma solo la DLL o le DLL che rappresentano il codice.

Creare il file nuspec

Per creare il pacchetto NuGet, è prima necessario creare un file .nuspec. Un file .nuspec è un manifesto XML che contiene i metadati del pacchetto NuGet. Questo manifesto viene usato per compilare il pacchetto e per fornire informazioni ai consumer. Posizionare il file nella radice della cartella "Pacchetto NuGet".

Ecco un file di esempio .nuspec e l'elenco delle proprietà obbligatorie o consigliate. Per lo schema completo, vedere le informazioni di riferimento su nuspec. Salvare il file .nuspec nella cartella radice del progetto usando un nome file di propria scelta.

Importante

Il valore <id> nel file .nuspec deve corrispondere al valore "name" nel file manifest.json del progetto oppure l'estensione pubblicata non verrà caricata correttamente in Windows Admin Center.

<?xml version="1.0">
<package>
  <metadata>
    <id>contoso.project.extension</id>
    <version>1.0.0</version>
    <title>Contoso Hello Extension</title>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Hello World extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright>
    <tags></tags>
  </metadata>
  <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
  </files>
</package>

Proprietà obbligatorie o consigliate

Nome proprietà	Obbligatorio/Consigliato	Descrizione
packageType	Obbligatorio	Usare WindowsAdminCenterExtension, ovvero il tipo di pacchetto NuGet definito per le estensioni di Windows Admin Center.
ID	Obbligatorio	Identificatore univoco del pacchetto all'interno del feed. Questo valore deve corrispondere al valore "name" nel file manifest.json del progetto. Vedere Choosing a unique package identifier and setting the version number (Scelta di un identificatore univoco del pacchetto e impostazione del numero di versione) per altre indicazioni.
title	Obbligatorio per la pubblicazione nel feed di Windows Admin Center	Nome descrittivo del pacchetto visualizzato in Gestione estensioni di Windows Admin Center.
versione	Obbligatorio	Versione dell'estensione. È consigliabile usare Controllo delle versioni semantiche (convenzione SemVer), ma non è obbligatorio.
authors	Obbligatorio	Se si pubblica per conto della società, usare il nome della società.
description	Obbligatori	Specificare una descrizione delle funzionalità dell'estensione.
iconUrl	Consigliato durante la pubblicazione nel feed di Windows Admin Center	URL per l'icona da visualizzare in Gestione estensioni.
projectUrl	Obbligatorio per la pubblicazione nel feed di Windows Admin Center	URL del sito Web dell'estensione. Se non si ha un sito Web separato, usare l'URL per la pagina Web del pacchetto nel feed NuGet.
licenseUrl	Obbligatorio per la pubblicazione nel feed di Windows Admin Center	URL del contratto di licenza dell'utente finale dell'estensione.
files	Obbligatorio	Queste due impostazioni configurano la struttura di cartelle prevista da Windows Admin Center per le estensioni dell'interfaccia utente e i plug-in gateway.

Compilare il pacchetto NuGet dell'estensione

Usando il file .nuspec creato, è ora necessario creare il file .nupkg di pacchetto NuGet, che è possibile caricare e pubblicare nel feed NuGet.

1. Scaricare lo strumento dell'interfaccia della riga di comando nuget.exe dal sito Web degli strumenti client NuGet.
2. Eseguire nuget.exe pack <>.nuspec file name> per creare il file .nupkg.

Firmare il pacchetto NuGet dell'estensione

Tutti i file .dll inclusi nell'estensione devono essere firmati con un certificato da un'autorità di certificazione (CA) attendibile. Per impostazione predefinita, i file non firmati .dll non vengono eseguiti quando Windows Admin Center è in esecuzione in modalità di produzione.

È consigliabile firmare il pacchetto NuGet dell'estensione per garantire l'integrità del pacchetto.

Nota

Se si prevede l'estensione che supporta Windows Defender Application Control, il pacchetto e tutti i file all'interno devono essere firmati. Maggiori informazioni sulla firma con Windows Defender Application Control.

Testare il pacchetto NuGet dell'estensione

Il pacchetto di estensione è ora pronto per il test! Caricare il file .nupkg in un feed NuGet o copiarlo in una condivisione file. Per visualizzare e scaricare pacchetti da un feed o una condivisione file diversa, è necessario modificare la configurazione del feed in modo che punti al feed NuGet o alla condivisione file. Quando si esegue il test, assicurarsi che le proprietà vengano visualizzate correttamente in Gestione estensioni ed è possibile installare e disinstallare correttamente l'estensione.

Pubblicare l'estensione nel feed di Windows Admin Center

Pubblicando il feed di Windows Admin Center, è possibile rendere disponibile l'estensione a qualsiasi utente di Windows Admin Center. Poiché Windows Admin Center SDK è ancora in anteprima, vorremmo collaborare con te per risolvere i problemi di sviluppo e aiutarti a distribuire un prodotto e un'esperienza di qualità agli utenti.

Prima di inviare una richiesta di revisione dell'estensione a Microsoft, è necessario inviare un messaggio di posta elettronica per wacextensionrequest@microsoft.com esprimere la finalità di pubblicare un'estensione nel feed pubblico. Ti forniamo copie del Contratto di pubblicazione dell'estensione e dei criteri di partecipazione dell'estensione da esaminare e confermare per iscritto.

Prima di rilasciare la versione iniziale dell'estensione, è consigliabile inviare una richiesta di revisione dell'estensione a Microsoft almeno 2-3 settimane prima del rilascio. Il termine di 2-3 settimane prima del rilascio ci garantisce il tempo sufficiente per la revisione e per apportare eventuali modifiche all'estensione, se necessario. Dopo che l'estensione è pronta per la pubblicazione, è necessario inviarla a Microsoft per la revisione. Se l'estensione è approvata, la pubblicheremo nel feed. Inviando il pacchetto di estensione Microsoft, si accetta di essere vincolati dalle condizioni del Contratto di pubblicazione dell'estensione e dai criteri di partecipazione alle estensioni.

In seguito, se si vuole rilasciare un aggiornamento all'estensione, è necessario inviare un'altra richiesta di revisione. A seconda dell'ambito della modifica, i tempi di revisione degli aggiornamenti sono in genere più brevi.

Inviare una richiesta di revisione dell'estensione a Microsoft

Per inviare una richiesta di revisione dell'estensione, specificare le informazioni seguenti e inviare come messaggio di posta elettronica a wacextensionrequest@microsoft.com. Rispondiamo ai messaggi di posta elettronica entro una settimana.

Windows Admin Center - Informazioni sulla richiesta di revisione dell'estensione:

• Nome e indirizzo di posta elettronica del proprietario/sviluppatore dell'estensione (fino a 3 utenti). Se si sta rilasciando un'estensione per conto dell'azienda, specificare l'indirizzo di posta elettronica aziendale.
• Nome società (obbligatorio solo se si rilascia un'estensione per conto dell'azienda)
• Nome estensione
• Data di rilascio della versione (stima)
• Per l'invio di una nuova estensione - Descrizione dell'estensione (frame di cavi di progettazione anticipata, mockup dello schermo o screenshot del prodotto consigliati)
• Per la revisione dell'aggiornamento dell'estensione - Descrizione delle modifiche (includere screenshot del prodotto se l'interfaccia utente è cambiata in modo significativo)

Inviare il pacchetto di estensione per la revisione e la pubblicazione

Assicurarsi di seguire le istruzioni precedenti per la creazione di un pacchetto di estensione, che il file .nuspec sia definito correttamente e che i file siano firmati. È anche consigliabile avere un sito Web del progetto, tra cui:

• Descrizione dettagliata dell'estensione, inclusi screenshot o video
• Funzionalità indirizzo Email o sito Web per ricevere commenti e suggerimenti o domande

Quando si è pronti per pubblicare l'estensione, inviare un messaggio di posta elettronica a wacextensionrequest@microsoft.com. Vengono fornite le istruzioni su come inviare il pacchetto di estensione. Dopo aver ricevuto il pacchetto, lo esamineremo. Dopo l'approvazione del pacchetto di estensione, verrà pubblicato nel feed di Windows Admin Center.