Creare un pacchetto di un'app desktop o UWP in Visual Studio

Prima di distribuire l'app, è necessario crearne il pacchetto. Questo articolo descrive il processo di configurazione, creazione e test di un pacchetto MSIX con Visual Studio.

Tipi di pacchetti di app

• Pacchetto dell'app (con estensione msix o .appx)
  Un singolo pacchetto che contiene l'applicazione e le relative risorse, destinato a un'architettura di un singolo dispositivo. Ad esempio, un pacchetto di applicazione x64 o x86. Per definire come destinazione più architetture con un bundle di app, è necessario generarne uno per ogni architettura.

• Pacchetto applicazione (.msixbundle o .appxbundle)
  Un bundle di app è un tipo di pacchetto che può contenere più pacchetti di app, ognuno dei quali è progettato per supportare un'architettura specifica del dispositivo. Ad esempio, un bundle di app può contenere tre pacchetti di app separati per le configurazioni x86, x64 e ARM. I bundle di app devono essere generati quando possibile perché consentono la disponibilità dell'app nella più ampia gamma possibile di dispositivi.

• File di caricamento del pacchetto dell'app (con estensione msixupload o appxupload) - solo per l'invio nello Store
  Un singolo file che può contenere più pacchetti di app o un bundle di app per supportare diverse architetture del processore. Il file di caricamento del pacchetto dell'app contiene anche un file di simboli per Analizzare le prestazioni dell'app dopo la pubblicazione dell'app in Microsoft Store. Questo file verrà creato automaticamente se crei automaticamente l'app con Visual Studio con l'intenzione di inviarla al Centro per i partner per la pubblicazione in Microsoft Store.

Ecco una panoramica dei passaggi per preparare e creare un pacchetto dell'app:

1. Prima di creare il pacchetto dell'app. Seguire questa procedura per assicurarsi che l'app sia pronta per essere inserita in un pacchetto.

2. Configurare il progetto. Usare la finestra di progettazione manifesto di Visual Studio per configurare il pacchetto. Ad esempio, aggiungere immagini di riquadri e scegliere gli orientamenti supportati dall'app.

3. Generare un pacchetto dell'app. Usare la creazione guidata pacchetti di Visual Studio per creare un pacchetto dell'app.

4. Esegui, fai il debug e testa un'applicazione confezionata. Esegui e esegui il debug del pacchetto dell'app da Visual Studio o installa il pacchetto direttamente.

Prima di impacchettare l'app

1. Testare l'app. Prima di creare il pacchetto dell'applicazione, assicurarsi che funzioni come previsto in tutte le famiglie di dispositivi che si prevede di supportare. Queste famiglie di dispositivi possono includere desktop, dispositivi mobili, Surface Hub, Xbox, IoT o altri. Per altre informazioni sulla distribuzione e il test dell'app con Visual Studio, vedi Distribuzione e debug di app UWP (si applica anche alle app desktop in pacchetto).

2. Ottimizzare l'app. È possibile usare gli strumenti di profilatura e debug di Visual Studio per ottimizzare le prestazioni dell'applicazione in pacchetto. Ad esempio, lo strumento Sequenza temporale per la velocità di risposta dell'interfaccia utente, lo strumento Utilizzo memoria, lo strumento Utilizzo CPU e altro ancora. Per altre informazioni su questi strumenti, vedere l'argomento Presentazione delle funzionalità di profilatura .

3. Controllare la compatibilità di .NET Native (per le app VB e C#). Nella piattaforma UWP (Universal Windows Platform) è disponibile un compilatore nativo che migliorerà le prestazioni di runtime dell'app. Con questa modifica, è necessario testare l'app in questo ambiente di compilazione. Per impostazione predefinita, la configurazione della build di Release abilita la toolchain .NET native, quindi è importante testare l'app con questa configurazione Release e verificare che l'app si comporti come previsto.

Configurare il progetto

Il file manifesto dell'app (Package.appxmanifest) è un file XML che contiene le proprietà e le impostazioni necessarie per creare il pacchetto dell'app. Ad esempio, le proprietà nel file manifesto dell'app descrivono l'immagine da usare come riquadro dell'app e gli orientamenti supportati dall'app quando un utente ruota il dispositivo.

La finestra di progettazione del manifesto di Visual Studio consente di aggiornare il file manifesto senza modificare il codice XML non elaborato del file.

Configurare un pacchetto con il progettista dello schema

1. In Esplora soluzioni espandere il nodo del progetto dell'applicazione.

2. Fare doppio clic sul file Package.appxmanifest. Se il file manifesto è già aperto nella visualizzazione codice XML, Visual Studio chiede di chiudere il file.

3. È ora possibile decidere come configurare l'app. Ogni scheda contiene informazioni che è possibile configurare sull'app e collegamenti ad altre informazioni, se necessario.

   

   Verificare di avere tutte le immagini necessarie per un'app nella scheda Asset visivi. Qui puoi fornire icone e loghi dell'app.

   Nella scheda Creazione pacchetti è possibile immettere i dati di pubblicazione. Qui è possibile scegliere il certificato da usare per firmare l'app. Tutte le app MSIX devono essere firmate con un certificato.

   Annotazioni

   A partire da Visual Studio 2019, un certificato temporaneo non viene più generato nei progetti desktop o UWP in pacchetto. Per creare o esportare certificati, usare i cmdlet di PowerShell descritti in questo articolo. Nelle versioni recenti di Visual Studio è anche possibile firmare l'app con un certificato archiviato in Azure Key Vault per scenari di sviluppo e test.

   Importante

   Se stai pubblicando la tua app in Microsoft Store, la tua app verrà firmata con un certificato attendibile. In questo modo l'utente può installare ed eseguire l'app senza installare il certificato di firma dell'app associato.

   Se si installa il pacchetto dell'app nel dispositivo, è prima necessario considerare attendibile il pacchetto. Per considerare attendibile il pacchetto, il certificato deve essere installato nel dispositivo dell'utente.

4. Salvare il file Package.appxmanifest dopo aver apportato le modifiche necessarie per l'app.

Se si distribuisce l'app tramite Microsoft Store, Visual Studio può associare il pacchetto allo Store. A tale scopo, fare clic con il pulsante destro del mouse sul nome del progetto in Esplora soluzioni e scegliere Pubblica-Associa>app allo Store (prima di Visual Studio 2019 versione 16.3, il menu Pubblica è denominato Store). È anche possibile eseguire questa operazione nella creazione guidata Creare pacchetti di app, descritta nella sezione seguente. Quando si associa l'app, alcuni campi nella scheda Creazione pacchetti della finestra di progettazione del manifesto vengono aggiornati automaticamente.

Generare un pacchetto dell'app

Le app possono essere installate senza essere pubblicate nello Store pubblicandole nel sito Web, usando strumenti di gestione delle applicazioni come Microsoft Intune e Configuration Manager e così via. È anche possibile installare direttamente un pacchetto MSIX per il test nel computer locale o remoto.

Creare un pacchetto dell'app usando la procedura guidata per la creazione dei pacchetti

Annotazioni

Le istruzioni e gli screenshot seguenti descrivono il processo a partire da Visual Studio 2019 versione 16.3. Se si usa una versione precedente, alcune dell'interfaccia utente potrebbero avere un aspetto diverso. Se si crea un pacchetto di un'applicazione desktop, fare clic con il pulsante destro del mouse sul nodo Progetto di creazione pacchetti di applicazioni Windows.

1. In Esplora soluzioni aprire la soluzione per il progetto dell'applicazione.

2. Fare clic con il pulsante destro del mouse sul progetto e scegliere Pubblica-Crea>pacchetti di app (prima di Visual Studio 2019 versione 16.3, il menu Pubblica è denominato Store).

   

3. Scegliere Caricamento manuale nella prima pagina della procedura guidata e quindi fare clic su Avanti.

   

4. Nella pagina Seleziona metodo di firma selezionare se ignorare la firma dei pacchetti o selezionare un certificato per la firma. È possibile selezionare un certificato dall'archivio certificati locale, selezionare un file di certificato o creare un nuovo certificato. Affinché un pacchetto MSIX venga installato nel computer di un utente finale, deve essere firmato con un certificato attendibile nel computer.

   

5. Completare la pagina Selezionare e configurare i pacchetti come descritto nella sezione Creare il file di caricamento del pacchetto dell'app con Visual Studio .

Installare il pacchetto dell'app facendo doppio clic su

I pacchetti dell'app possono essere installati semplicemente facendo doppio clic sul file del pacchetto dell'app. A tale scopo, passare al pacchetto dell'app o al file bundle dell'app e fare doppio clic su di esso. Il programma di installazione app avvia e fornisce le informazioni di base sull'app, un pulsante di installazione, un indicatore di stato dell'installazione e eventuali messaggi di errore pertinenti.

Annotazioni

Il programma di installazione app presuppone che il pacchetto sia stato firmato con un certificato attendibile nel dispositivo. In caso contrario, sarà necessario installare il certificato di firma nell'archivio delle Autorità di certificazione Persone Fidate o Editori Fidati nel dispositivo. Se non si è certi di come eseguire questa operazione, vedere Installazione dei certificati di test.

Installare il pacchetto dell'app usando uno script di installazione

1. Aprire la cartella *_Test.

2. Fare clic con il pulsante destro del mouse sul file Add-AppDevPackage.ps1 . Scegliere Esegui con PowerShell e seguire le istruzioni.
   

   Quando il pacchetto dell'app è stato installato, nella finestra di PowerShell viene visualizzato questo messaggio: L'app è stata installata correttamente.

3. Fare clic sul pulsante Start per cercare l'app in base al nome e quindi avviarla.

Passaggi successivi: Eseguire il debug e testare il pacchetto dell'app

Vedere Eseguire, eseguire il debug e testare un pacchetto di app per informazioni su come eseguire il debug dell'applicazione in Visual Studio o usare gli strumenti di debug di Windows.

Generare un file di caricamento del pacchetto dell'app per l'invio nello Store

Per distribuire l'app in Microsoft Store, ti consigliamo di generare un file di caricamento del pacchetto dell'app (con estensione msixupload o appxupload) e inviare questo file al Centro per i partner. Anche se è possibile inviare un pacchetto dell'app o un bundle di app solo al Centro per i partner, è consigliabile inviare invece un file di caricamento del pacchetto dell'app.

È possibile creare un file di caricamento del pacchetto dell'app usando la creazione guidata pacchetti di app in Visual Studio oppure crearne uno manualmente da pacchetti di app o bundle di app esistenti.

Annotazioni

Per creare manualmente un pacchetto dell'app (con estensione msix or.appx) o un bundle di app (con estensione msixbundle o appxbundle), vedere Creare un pacchetto dell'app con lo strumento di MakeAppx.exe.

Creare il file di caricamento del pacchetto dell'app con Visual Studio

Annotazioni

Le istruzioni e gli screenshot seguenti descrivono il processo a partire da Visual Studio 2019 versione 16.3. Se si usa una versione precedente, alcune dell'interfaccia utente potrebbero avere un aspetto diverso.

1. In Esplora soluzioni aprire la soluzione per il progetto di app UWP.

2. Fare clic con il pulsante destro del mouse sul progetto e scegliere Pubblica-Crea>pacchetti di app (prima di Visual Studio 2019 versione 16.3, il menu Pubblica è denominato Store). Se questa opzione è disabilitata o non viene visualizzata, verificare che il progetto sia un progetto di Windows universale.

   

   Verrà visualizzata la procedura guidata Crea pacchetti app.

3. Selezionare Microsoft Store usando un nuovo nome di app nella prima finestra di dialogo e quindi fare clic su Avanti.

   

   Se hai già associato il progetto a un'app nello Store, hai anche un'opzione per creare pacchetti per l'app dello Store associata. Se si sceglie Sideloading, Visual Studio non genererà il file di caricamento del pacchetto dell'app (.msixupload o .appxupload) per gli invii al Centro per i Partner. Se vuoi creare solo un pacchetto MSIX o un bundle per la distribuzione non nello Store, puoi selezionare questa opzione.

4. Nella pagina successiva accedere con l'account sviluppatore al Centro per i partner. Se non si ha ancora un account per sviluppatore, la procedura guidata consentirà di crearne una.

   

5. Selezionare il nome dell'app per il pacchetto dall'elenco delle app attualmente registrate nell'account oppure riservarne una nuova se non ne è già stata riservata una nel Centro per i partner.

   Annotazioni

   Se si usa Visual Studio 2017, non sarà possibile elencare le app attualmente registrate nell'account o riservare nuovi nomi di app quando si usa un account Microsoft (MSA), solo gli account Azure Active Directory (AAD) funzioneranno. Gli account MSA sono supportati a partire da Visual Studio 2019.

6. Assicurarsi di selezionare tutte e tre le configurazioni dell'architettura (x86, x64 e ARM) nella finestra di dialogo Seleziona e configura pacchetti per assicurarsi che l'app possa essere distribuita nell'ampia gamma di dispositivi. Nella casella di riepilogo Genera bundle dell'app selezionare Sempre. Un bundle dell'app (con estensione appxbundle o msixbundle) è preferibile rispetto a un singolo file di pacchetto dell'app perché contiene una raccolta di pacchetti di app configurati per ogni tipo di architettura del processore. Quando scegli di generare il bundle dell'app, esso verrà incluso nel file finale di caricamento del pacchetto dell'app (.appxupload o .msixupload), insieme alle informazioni di debug e all'analisi dei crash. Se non sai quale architettura scegliere o vuoi altre informazioni sulle architetture usate dai diversi dispositivi, vedi Architetture per i pacchetti di app.

   

7. Includi file di simboli pubblici per Analizzare le prestazioni delle app dal Centro per i partner dopo la pubblicazione dell'app. Configurare eventuali dettagli aggiuntivi, ad esempio la numerazione delle versioni o il percorso di output del pacchetto.

8. Fare clic su Crea per generare il pacchetto dell'app. Se hai selezionato uno dei pacchetti da caricare nelle opzioni di Microsoft Store nel passaggio 3 e stai creando un pacchetto per l'invio al Centro per i partner, la procedura guidata creerà un file di caricamento del pacchetto (con estensione appxupload o msixupload). Se hai selezionato Voglio creare pacchetti per il sideloading nel passaggio 3, la procedura guidata creerà un singolo pacchetto dell'app o un bundle di app in base alle selezioni nel passaggio 6.

9. Quando l'app è stata inserita correttamente nel pacchetto, verrà visualizzata questa finestra di dialogo e sarà possibile recuperare il file di caricamento del pacchetto dell'app dal percorso di output specificato. A questo punto, è possibile convalidare il pacchetto dell'app nel computer locale o in un computer remoto e automatizzare gli invii dello Store.

   

Creare manualmente il file di caricamento del pacchetto dell'app

1. Inserire i file seguenti in una cartella:

   • Uno o più pacchetti di app (con estensione msix o .appx) o un bundle dell'app (con estensione msixbundle o appxbundle).
   • File con estensione appxsym. Si tratta di un file con estensione .pdb compresso contenente i simboli pubblici della tua app utilizzati per l'analisi degli arresti anomali nel Centro per i partner. Puoi omettere questo file, ma se lo fai, per l'applicazione non saranno disponibili analisi degli arresti anomali o informazioni di debug.

2. Selezionare tutti i file all'interno della cartella, fare clic con il pulsante destro del mouse sui file e scegliere Invia a ->Cartella compressa (zippata).

3. Modificare il nome dell'estensione del nuovo file ZIP da .zip a .msixupload o appxupload.

Convalidare il pacchetto dell'app

Convalidare l'app prima di inviarla al Centro per i partner per la certificazione in un computer locale o remoto. È possibile convalidare solo le build di versione per il pacchetto dell'app, non le compilazioni di debug. Per altre informazioni sull'invio dell'app al Centro per i partner, vedi Invii di app.

Convalidare il pacchetto dell'app in locale

1. Nella pagina finale Creazione pacchetto completata della procedura Creazione guidata pacchetti app, lasciare selezionata l'opzione Computer locale e fare clic su Avvia Kit di certificazione app Windows. Per altre informazioni sul test dell'app con il Kit di certificazione app Windows, vedi Kit di certificazione app Windows.

   Il Kit di certificazione app Windows (WACK) esegue vari test e restituisce i risultati. Per informazioni più specifiche, vedi Test del Kit di certificazione app Windows .

   Se hai un dispositivo Windows 10 remoto che vuoi usare per il test, dovrai installare manualmente il Kit di certificazione app Windows in tale dispositivo. La sezione successiva illustra questi passaggi. Al termine, è possibile selezionare Computer remoto e fare clic su Avvia Kit di certificazione app Windows per connettersi al dispositivo remoto ed eseguire i test di convalida.

2. Dopo aver completato WACK e aver superato la certificazione, sei pronto per inviare la tua app al Centro per i partner. Assicurarsi di caricare il file corretto. Il percorso predefinito del file è disponibile nella cartella radice della soluzione \[AppName]\AppPackages e termina con l'estensione .appxupload o msixupload. Il nome sarà del modulo [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload o [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload se hai scelto un bundle di app con tutta l'architettura del pacchetto selezionata.

Convalidare il pacchetto dell'app in un dispositivo Windows 10 remoto

1. Abilitare il dispositivo Windows 10 per lo sviluppo seguendo le istruzioni abilitare il dispositivo per lo sviluppo .

   Importante

   Non è possibile convalidare il pacchetto dell'app in un dispositivo ARM remoto per Windows 10.

2. Scaricare e installare gli strumenti remoti per Visual Studio. Questi strumenti vengono usati per eseguire il Kit di certificazione app Windows in remoto. Per altre informazioni su questi strumenti, vedere Eseguire applicazioni MSIX in un computer remoto.

3. Scaricare il Kit di certificazione app Windows richiesto e quindi installarlo nel dispositivo Windows 10 remoto.

4. Nella pagina Creazione pacchetto completata della procedura guidata, scegliere il pulsante opzione Macchina remota, quindi scegliere il pulsante con i puntini accanto al pulsante Test connessione.

   Annotazioni

   Il pulsante di opzione Computer remoto è disponibile solo se è stata selezionata almeno una configurazione della soluzione che supporta la convalida. Per altre informazioni sul test dell'app con WACK, vedi Kit di certificazione app Windows.

5. Specificare un modulo del dispositivo all'interno della subnet oppure specificare il nome DNS (Domain Name Server) o l'indirizzo IP di un dispositivo esterno alla subnet.

6. Nell'elenco Modalità di autenticazione scegliere Nessuno se il dispositivo non richiede l'accesso usando le credenziali di Windows.

7. Scegliere il pulsante Seleziona e quindi scegliere il pulsante Avvia kit di certificazione app Windows . Se gli strumenti remoti sono in esecuzione in tale dispositivo, Visual Studio si connette al dispositivo ed esegue i test di convalida. Vedi Test del Kit di certificazione app Windows.

Automatizzare gli invii nello Store

A partire da Visual Studio 2019, è possibile inviare direttamente dall'IDE il file .appxupload generato allo Microsoft Store selezionando l'opzione Invia automaticamente allo Microsoft Store dopo la convalida del Windows App Certification Kit alla fine della Creazione guidata Pacchetti di App. Questa funzionalità sfrutta Azure Active Directory per accedere alle informazioni sull'account del Centro per i partner necessarie per pubblicare l'app. Per usare questa funzionalità, è necessario associare Azure Active Directory all'account del Centro per i partner e recuperare diverse credenziali necessarie per gli invii.

Associare Azure Active Directory all'account del Centro per i partner

Prima di poter recuperare le credenziali necessarie per gli invii automatici nello Store, devi prima seguire questi passaggi nel dashboard del Centro per i partner, se non lo hai già fatto.

1. Associare l'account del Centro per i partner ad Azure Active Directory dell'organizzazione. Se l'organizzazione usa già Office 365 o altri servizi aziendali di Microsoft, è già disponibile Azure AD. In caso contrario, è possibile creare un nuovo tenant di Azure AD dall'interno del Centro per i partner senza costi aggiuntivi.

2. Aggiungere un'applicazione Azure AD all'account del Centro per i partner. Questa applicazione Azure AD rappresenta l'app o il servizio che si userà per accedere agli invii per l'account Dev Center. È necessario assegnare questa applicazione al ruolo Manager . Se questa applicazione esiste già nella directory di Azure AD, è possibile selezionarla nella pagina Aggiungi applicazioni Azure AD per aggiungerla all'account Dev Center. In caso contrario, è possibile creare una nuova applicazione Azure AD nella pagina Aggiungi applicazioni Azure AD .

Recuperare le credenziali necessarie per gli invii

È quindi possibile recuperare le credenziali del Centro per i partner necessarie per gli invii: l'ID tenant di Azure, l'IDclient e la chiave client.

1. Passare al dashboard del Centro per i partner e accedere con le credenziali di Azure AD.

2. Nel dashboard del Centro per i partner selezionare l'icona a forma di ingranaggio (nell'angolo superiore destro del dashboard) e quindi selezionare Impostazioni sviluppatore.

3. Nel menu Impostazioni nel riquadro sinistro fare clic su Utenti.

4. Fare clic sul nome dell'applicazione Azure AD per passare alle impostazioni dell'applicazione. In questa pagina copiare i valori ID tenant e ID client .

5. Nella sezione Chiavi fare clic su Aggiungi nuova chiave. Nella schermata successiva copiare il valore chiave , che corrisponde al segreto client. Non potrai più accedere a queste informazioni dopo aver lasciato questa pagina, quindi assicurati di non perderla. Per altre informazioni, vedere Gestire le chiavi per un'applicazione Azure AD.

Configurare gli invii automatici dello Store in Visual Studio

Dopo aver completato i passaggi precedenti, è possibile configurare gli invii automatici dello Store in Visual Studio 2019.

1. Al termine della procedura guidata Creazione pacchetti app, selezionare Invia automaticamente a Microsoft Store dopo la convalida del Kit di certificazione app Windows e fare clic su Riconfigura.

2. Nella finestra di dialogo Configura impostazioni di invio a Microsoft Store immettere l'ID tenant di Azure, l'ID client e la chiave client.

   

   Importante

   Le tue credenziali possono essere salvate nel tuo profilo da usare negli invii futuri

3. Fare clic su OK.

L'invio verrà avviato al termine del test WACK. È possibile tenere traccia dello stato di avanzamento dell'invio nella finestra Verifica e pubblicazione .