Requisiti per il pacchetto dell’app

Attenersi alle seguenti linee guida per preparare i pacchetti dell'app da inviare a Microsoft Store.

Prima di creare il pacchetto dell'app per Microsoft Store

Assicurarsi di testare l'app con il Kit di certificazione app Windows. Si consiglia inoltre di testare l'app su diversi tipi di hardware. Finché non sarà certificata e resa disponibile su Microsoft Store, l'app potrà essere installata ed eseguita solo su computer che dispongono di licenze per sviluppatori.

Creazione del pacchetto dell'app con Microsoft Visual Studio

Se si utilizza Microsoft Visual Studio come ambiente di sviluppo, sono già disponibili strumenti predefiniti che semplificano e accelerano la creazione di un pacchetto dell'app. Per ulteriori informazioni, vedere Creazione di pacchetti delle app.

Nota

Assicurarsi che tutti i nomi file siano ANSI.

Quando si crea il pacchetto in Visual Studio, assicurarsi di aver effettuato l'accesso con lo stesso account associato al proprio account di sviluppatore. Alcune parti del manifesto del pacchetto contengono dettagli specifici relativi al proprio account. Queste informazioni vengono rilevate e aggiunte automaticamente. Senza le informazioni supplementari aggiunte al manifesto, si possono verificare errori di caricamento del pacchetto.

Quando si creano i pacchetti UWP della propria app, Visual Studio può creare un file .msix o appx oppure un file .msixupload o .appxupload. Per le app UWP, si consiglia di caricare sempre il file .msixupload o .appxupload nella pagina Pacchetti. Per ulteriori informazioni sulla creazione di pacchetti di app UWP per lo Store, vedere Creare il pacchetto di un'app UWP con Visual Studio.

I pacchetti dell'app non devono essere firmati con un certificato rooted in un'autorità di certificazione attendibile.

Bundle dell'app

Per le app UWP, Visual Studio può generare un bundle di app (.msixbundle o .appxbundle) per ridurre le dimensioni dell'app scaricata dagli utenti. Questo può essere utile se sono state definite risorse specifiche per la lingua, una varietà di risorse a scala di immagine o risorse che si applicano a versioni specifiche di Microsoft DirectX.

Nota

 Un bundle di app può contenere i pacchetti per tutte le architetture.

Con un bundle di app, l'utente scaricherà solo i file rilevanti, anziché tutte le risorse possibili. Per ulteriori informazioni sui bundle di app, vedere Creazione di pacchetti delle app e Creare il pacchetto di un'app UWP con Visual Studio.

Creazione manuale del pacchetto di app

Se non si utilizza Visual Studio per creare il pacchetto, è necessario creare manualmente il manifesto del pacchetto.

Assicurarsi di esaminare la documentazione del manifesto del pacchetto dell'appper informazioni dettagliate e requisiti completi sul manifesto. Il manifesto deve seguire lo schema del manifesto del pacchetto per poter ottenere la certificazione.

Il manifesto deve includere alcune informazioni specifiche sull'account e sull'app. Per trovare queste informazioni, vedere Visualizzare i dettagli dell'identità dell'app nella sezione Gestione dei prodotti della pagina di panoramica dell'app nel dashboard.

Nota

 I valori nel manifesto fanno distinzione tra maiuscole e minuscole. Anche gli spazi e altri segni di punteggiatura devono corrispondere. Immettere attentamente i valori ed esaminarli per verificare che siano corretti.

I bundle di app (.msixbundle o appxbundle) utilizzano un manifesto diverso. Esaminare la documentazione del manifesto del bundle per informazioni dettagliate e requisiti per i manifesti del bundle dell'app. In un file con estensione .msixbundle o .appxbundle, il manifesto di ogni pacchetto incluso deve utilizzare gli stessi elementi e attributi, a eccezione dell'attributo ProcessorArchitecture dell'elemento Identity.

Suggerimento

 Assicurarsi di eseguire il Kit di certificazione app Windows prima di inviare i pacchetti. In questo modo è possibile determinare se il manifesto presenta problemi che potrebbero causare errori di certificazione o di invio.

Requisiti per il formato dei pacchetti

I pacchetti dell'app devono essere conformi ai seguenti requisiti.

Proprietà del pacchetto dell'app	Requisito
Dimensioni pacchetto	.msixbundle o .appxbundle: massimo 25 GB per bundle Pacchetti .msix o .appx per Windows 10 o Windows 11: massimo 25 GB per pacchetto
Hash della mappa a blocchi	Algoritmo SHA2-256

Importante

Non è più possibile caricare nuovi pacchetti XAP compilati usando Gli SDK di Windows Phone 8.x. Le app già presenti nello Store con pacchetti XAP continueranno a funzionare sui dispositivi Windows 10 Mobile. Per altre informazioni, leggi questo post di blog.

Versioni supportate

Per le app UWP, tutti i pacchetti devono essere destinati a una versione di Windows 10 o Windows 11 supportata dallo Store. Le versioni supportate dal pacchetto devono essere indicate negli attributi MinVersion e MaxVersionTested dell'elemento TargetDeviceFamily del manifesto dell'app.

Le versioni attualmente supportate partono da:

• Minimo: 10.0.10240.0
• Massimo: 10.0.22621.0

File XML StoreManifest

StoreManifest.xml è un file di configurazione facoltativo che può essere incluso nei pacchetti dell'app. Il suo scopo è quello di abilitare funzionalità, come la dichiarazione dell'app come app per dispositivi di Microsoft Store o la dichiarazione dei requisiti da cui dipende un pacchetto per essere applicabile a un dispositivo, che il manifesto del pacchetto non copre. Se utilizzato, StoreManifest.xml viene inviato con il pacchetto dell'app e deve trovarsi nella cartella radice del progetto principale dell'app. Per ulteriori informazioni, vedere Schema StoreManifest.

Inviare un URL di download abilitato per HTTPS (collegamento diretto) ai file binari del programma di installazione del prodotto. I prodotti inviati in questo modo sono soggetti ai requisiti seguenti:

• Il file binario del programma di installazione può essere solo un file .msi o .exe.

• I file binari e tutti i rispettivi file eseguibili di tipo PE devono essere firmati digitalmente con un certificato di firma del codice concatenato fino a un certificato rilasciato da un'autorità di certificazione inclusa nel Microsoft Trusted Root Program.

• È necessario inviare un URL di download con versione nel Centro per i partner. Il file binario associato a tale URL non deve cambiare dopo l'invio.

• Ogni volta che è disponibile un file binario aggiornato da distribuire, è necessario fornire un URL di download aggiornato nel Centro per i partner associato al file binario aggiornato. L'utente è responsabile della gestione e dell'aggiornamento dell'URL di download.

• L'avvio dell'installazione non deve visualizzare un'interfaccia utente di installazione (ad esempio, è necessaria l'installazione invisibile all'utente), ma è consentita la finestra di dialogo Controllo dell'account utente.

• Il programma di installazione è un programma di installazione autonomo e non è uno stub del downloader/programma di installazione Web che scarica bit durante l'esecuzione.

Importante

I requisiti del pacchetto dell'app non sono supportati per i componenti aggiuntivi dell'app.