Creare il 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 tramite Visual Studio.

Tipi di pacchetti di app

• Pacchetto 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.

• Bundle dell'app (.msixbundle o .appxbundle)
  Un bundle di app è un tipo di pacchetto che può contenere più pacchetti dell'app, ognuno dei quali è progettato per supportare un'architettura del dispositivo specifica. 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 la tua 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 nel pacchetto.

2. Configurare il progetto. Usare la finestra di progettazione del manifesto di Visual Studio per configurare il pacchetto. Ad esempio, aggiungi immagini di riquadri e scegli 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. Eseguire, eseguire il debug e testare un'applicazione in pacchetto. Eseguire ed eseguire il debug del pacchetto dell'app da Visual Studio o installando direttamente il pacchetto.

Prima di creare il pacchetto dell'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 la tua 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 Profiling Feature Tour .For more information about these tools, see the Profiling Feature Tour topic.

3. Verificare la compatibilità .NET Native (per le app C# e VB): Nella piattaforma UWP (Universal Windows Platform) è presente 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 versione abilita la toolchain nativa .NET , quindi è importante testare l'app con questa configurazione di versione 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 Progettazione manifesto

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

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

3. Ora puoi decidere come configurare l'app. Ogni scheda contiene informazioni che puoi configurare per l'app e collegamenti ad altre informazioni, se necessario.

   

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

   Nella scheda Creazione pacchetto puoi immettere i dati relativi alla pubblicazione. In questa fase puoi scegliere il certificato da usare per firmare l'app. Tutte le app MSIX devono essere firmate con un certificato.

   Nota

   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, usa 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, l'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 distribuisci 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 pacchetti di app , descritta nella sezione seguente. Quando si associa l'app, alcuni dei 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 creazione guidata dei pacchetti

Nota

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. Selezionare Trasferimento locale 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 considerato 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, nonché un pulsante di installazione, un indicatore di stato dell'installazione e eventuali messaggi di errore pertinenti.

Nota

Il programma di installazione app presuppone che il pacchetto sia stato firmato con un certificato attendibile nel dispositivo. In caso contrario, è necessario installare il certificato di firma nell'archivio autorità di certificazione trusted Persone o autori attendibili 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, la finestra di PowerShell visualizza 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

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

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

Per distribuire l'app in Microsoft Store, è consigliabile 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 di app o un bundle di app 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 app in Visual Studio oppure crearne uno manualmente da pacchetti di app esistenti o bundle di app.

Nota

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

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

Nota

Le istruzioni e gli screenshot seguenti descrivono il processo a partire da Visual Studio 2019 versione 16.3. Se si usa una versione precedente, alcuni dell'interfaccia utente potrebbero essere diversi.

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

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

   

   Viene visualizzata la procedura guidata Crea pacchetti dell'app.

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

   

   Se il progetto è già associato a un'app nello Store, è anche possibile creare pacchetti per l'app dello Store associata. Se si sceglie Sideloading, Visual Studio non genererà il file del pacchetto dell'app (con estensione msixupload o appxupload) per gli invii al Centro per i partner. Se si vuole creare solo un pacchetto MSIX o un bundle per la distribuzione non store, è possibile selezionare questa opzione.

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

   

5. Selezionare il nome dell'app per il pacchetto dall'elenco delle app attualmente registrate nel proprio account o riservarne uno nuovo se non ne è già stato riservato uno nel Centro per i partner.

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 il bundle dell’app seleziona Sempre. Un bundle di app (.appxbundle o msixbundle) è preferito rispetto a un singolo file di pacchetto app perché contiene una raccolta di pacchetti app configurati per ogni tipo di architettura del processore. Quando si sceglie di generare il bundle dell'app, il bundle dell'app verrà incluso nel file di caricamento del pacchetto dell'app finale (con estensione appxupload o msixupload) insieme alle informazioni di debug e di analisi di arresto anomalo. Se non si è certi di quali architetture scegliere o si desidera ottenere altre informazioni sulle architetture usate da vari dispositivi, vedere Architetture del pacchetto app.

   

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

8. Fare clic su Crea per generare il pacchetto dell'app. Se è stato selezionato uno dei pacchetti da caricare nelle opzioni di Microsoft Store nel passaggio 3 e si crea 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 sideload nel passaggio 3, la procedura guidata creerà un singolo pacchetto 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 dell'archivio.

   

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 di app (con estensione msixbundle o appxbundle).
   • File con estensione appxsym. Si tratta di un file con estensione pdb compresso contenente simboli pubblici dell'app usata per l'analisi degli arresti anomali nel Centro per i partner. È possibile omettere questo file, ma se non si esegue alcuna analisi di arresto anomalo o informazioni di debug saranno disponibili per l'app.

2. Selezionare tutti i file all'interno della cartella, fare clic con il pulsante destro del mouse sui file e selezionare Invia alla cartella compressa>(compressa).

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 eseguire il debug delle compilazioni. Per altre informazioni sull'invio dell'app al Centro per i partner, vedere Invii di app.

Convalidare il pacchetto dell'app in locale

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

   Windows App Certification Kit (WACK) esegue vari test e restituisce i risultati. Per informazioni più specifiche, vedere Test di Windows App Certification Kit .

   Se si dispone di un dispositivo remoto Windows 10 che si vuole usare per il test, è necessario installare manualmente il Kit di certificazione app windows nel dispositivo. Nella sezione successiva sono riportate informazioni che ti guideranno nell'esecuzione di queste attività. Dopo aver eseguito questa operazione, puoi selezionare Computer remoto e fare clic su Avvia kit di certificazione applicazioni Windows per connetterti al dispositivo remoto ed eseguire i test di convalida.

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

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

1. Abilita il dispositivo Windows 10 per lo sviluppo seguendo le istruzioni riportate in Abilitare il dispositivo per lo sviluppo.

   Importante

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

2. Scarica e installa Remote Tools per Visual Studio. Questi strumenti vengono usati per eseguire il Kit di certificazione app Windows in modalità remota. È possibile ottenere altre informazioni su questi strumenti, tra cui dove scaricarli visitando Eseguire applicazioni MSIX in un computer remoto.

3. Scarica il Kit di certificazione app Windows richiesto e quindi installalo nel tuo dispositivo Windows 10 remoto.

4. Nella pagina Creazione pacchetti completata della procedura guidata scegli il pulsante di opzione Computer remoto e quindi scegli il pulsante con i puntini di sospensione accanto al pulsante Test connessione.

   Nota

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

5. Specifica un dispositivo dall'interno della subnet oppure fornisci un nome DNS (Domain Name Server) o un indirizzo IP del dispositivo esterno alla subnet.

6. Nell’elenco Modalità di autenticazione scegli Nessuna se il dispositivo non richiede l’accesso usando le credenziali di Windows.

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

Automatizzare gli invii dello Store

A partire da Visual Studio 2019, è possibile inviare il file con estensione appxupload generato direttamente dall'IDE selezionando l'opzione Invia automaticamente a Microsoft Store dopo la convalida del Kit di certificazione app di Windows alla fine della creazione guidata pacchetti 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 dello Store, è prima necessario seguire questa procedura nel dashboard del Centro per i partner se non è già stato fatto.

1. Associare l'account del Centro per i partner ad Azure Active Directory dell'organizzazione. Se la tua organizzazione usa già Office 365 o altri servizi aziendali Microsoft, hai già 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 Azure AD, puoi selezionarla nella pagina Aggiungi applicazioni Azure AD per aggiungerla al tuo account di Dev Center. In caso contrario, puoi 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 sarà possibile accedere nuovamente a queste informazioni dopo aver lasciato questa pagina, quindi assicurarsi di non perderlo. 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. Alla fine della creazione guidata pacchetti app selezionare Invia automaticamente a Microsoft Store dopo la convalida del Kit di certificazione app di Windows e fare clic su Riconfigurazione.

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

   

   Importante

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

3. Fare clic su OK.

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