Requisiti per il pacchetto dell’app

Segui queste linee guida per preparare i pacchetti della tua app per l'invio a Microsoft Store.

Prima di compilare il pacchetto dell'app per Microsoft Store

Assicurarsi di testare l'app con il Kit di certificazione app Windows. Ti consigliamo anche di testare l'app su diversi tipi di hardware. Tieni presente che finché non certifica la tua app e la rendere disponibile da Microsoft Store, può essere installata ed eseguita solo nei computer con licenze per sviluppatori.

Compilazione del pacchetto dell'app con Microsoft Visual Studio

Se si usa Microsoft Visual Studio come ambiente di sviluppo, sono già disponibili strumenti predefiniti che semplificano la creazione di un pacchetto di app. Per altre info, vedi Creazione di pacchetti di app.

Nota

Assicurarsi che tutti i nomi file usino ANSI.

Quando si crea il pacchetto in Visual Studio, assicurarsi di aver eseguito l'accesso con lo stesso account associato all'account per sviluppatore. Alcune parti del manifesto del pacchetto hanno dettagli specifici correlati all'account. Queste informazioni vengono rilevate e aggiunte automaticamente. Senza le informazioni aggiuntive aggiunte al manifesto, è possibile che si verifichino errori di caricamento del pacchetto.

Quando crei i pacchetti UWP dell'app, Visual Studio può creare un file con estensione msix o appx oppure un file con estensione msixupload o appxupload. Per le app UWP, ti consigliamo di caricare sempre il file con estensione msixupload o appxupload nella pagina Pacchetti . Per altre info sulla creazione di pacchetti di app UWP per lo Store, vedi Creare un 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 di app

Per le app UWP, Visual Studio può generare un bundle di app (con estensione msixbundle o appxbundle) per ridurre le dimensioni dell'app scaricata dagli utenti. Questo può essere utile se sono stati definiti asset specifici del linguaggio, un'ampia gamma di asset di scalabilità delle immagini o risorse applicabili a versioni specifiche di Microsoft DirectX.

Nota

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

Con un bundle di app, un utente scaricherà solo i file pertinenti, anziché tutte le risorse possibili. Per altre info sui bundle di app, vedi Creazione di pacchetti di app e Creazione di pacchetti di un'app UWP con Visual Studio.

Compilazione manuale del pacchetto dell'app

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

Assicurarsi di esaminare la documentazione del manifesto del pacchetto dell'app per informazioni dettagliate e requisiti completi sul manifesto. Il manifesto deve seguire lo schema del manifesto del pacchetto per passare 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. Gli spazi e altri segni di punteggiatura devono corrispondere anche. Immettere attentamente i valori e esaminarli per assicurarsi che siano corretti.

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

Suggerimento

 Assicurarsi di eseguire il Kit di certificazione app Windows prima di inviare i pacchetti. Ciò consente di determinare se il manifesto presenta problemi che potrebbero causare errori di certificazione o invio.

Requisiti di formato del pacchetto

I pacchetti dell'app devono essere conformi a questi requisiti.

Proprietà del pacchetto dell'app Requisito
Dimensioni pacchetto .msixbundle o .appxbundle: massimo 25 GB per bundle
Pacchetti msix o .appx destinati a 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 Telefono 8.x. Le app già presenti nello Store con pacchetti XAP continueranno a funzionare nei dispositivi Windows 10 Mobile. Per altre info, vedi 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 vanno 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 è abilitare le funzionalità, ad esempio dichiarare l'app come app per dispositivi di Microsoft Store o dichiarare i requisiti da cui dipende un pacchetto da applicare a un dispositivo, che il manifesto del pacchetto non copre. Se usato, StoreManifest.xml viene inviato con il pacchetto dell'app e deve trovarsi nella cartella radice del progetto principale dell'app. Per altre info, vedi 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 per le app.