Pubblicazione in Microsoft Store

Quando l'app Unreal è pronta per essere pubblicata, è necessario aggiornare alcune impostazioni di progetto prima dell'invio a Microsoft Store. Tutte queste impostazioni hanno valori predefiniti. Per rappresentare l'applicazione in modo ottimale, tuttavia, devono essere modificate per la fase di produzione.

Impostazioni di progetto per la creazione di pacchetti per lo Store

  1. Prima di tutto, selezionare Project Settings Description (Descrizione impostazioni > progetto ) e aggiornare le informazioni sul gioco e sull'editore:
    • Game Name (Nome gioco) verrà visualizzato nel riquadro dell'app in HoloLens
    • Company Distinguished Name (Nome distinto società) viene usato durante la generazione del certificato di progetto e deve avere il formato seguente:
      • CN=CommonName, O=OrganizationName, L=LocalityName, S=StateOrProvinceName, C=CountryName:

Screenshot dell'editor di Unreal con la sezione relativa alla descrizione espansa nelle impostazioni di progetto

  1. Espandere la sezione HoloLens delle impostazioni di progetto e aggiornare le risorse per la creazione di pacchetti. Questi nomi di risorse verranno visualizzati nella pagina dell'applicazione nello Store:

Screenshot dell'editor di Unreal con la sezione relativa alla creazione di pacchetti espansa nelle impostazioni di progetto

  1. Espandere la sezione Images (Immagini) e aggiornare le immagini predefinite dello Store con le trame che rappresentano l'app dello Store. Facoltativamente, selezionare la casella di controllo 3D Logo (Logo 3D) per caricare un file con estensione glb da usare come cubo live 3D all'avvio dell'applicazione:

Screenshot dell'editor di Unreal con la sezione relativa alle immagini espansa nelle impostazioni di progetto

  1. Infine, selezionare Generate New (Genera nuovo) per generare un certificato di firma dal nome del progetto e dal nome distinto della società
    • Impostare un valore per Tile Background Color (Colore di sfondo riquadro), che verrà visualizzato al posto di eventuali pixel trasparenti nelle immagini dello Store.
    • Espandere l'elenco a discesa e abilitare Use Retail Windows Store Environment (Usa ambiente Windows Store retail) per l'esecuzione in dispositivi bloccati per utenti retail e non sbloccati per sviluppatori.

Screenshot dell'editor di Unreal con la sezione relativa alla generazione del certificato espansa nelle impostazioni di progetto

Programma di installazione app facoltativo

È possibile creare un file del programma di installazione app da HoloLens impostazioni > progetto, che può essere usato per distribuire l'applicazione all'esterno dell'archivio. Abilitare la casella di controllo Should Create App Installer (Devi creare Programma di installazione app) e impostare un URL o un percorso di rete nella posizione in cui si vuole archiviare il pacchetto appxbundle del gioco.

Screenshot dell'editor di Unreal con la sezione relativa al Programma di installazione app espansa nelle impostazioni di progetto

Quando si crea il pacchetto dell'app, vengono generati sia appxbundle sia appinstaller. Caricare appxbundle nell'URL di installazione e quindi avviare appinstaller per installare l'app dal percorso di rete.

Kit di certificazione app Windows

Windows 10 SDK viene fornito con il Kit di certificazione app Windows (WACK) per convalidare problemi comuni che possono influire sul caricamento di un pacchetto nello Store. È possibile trovare WACK nella directory Windows Kits, in genere nel percorso seguente:

C:\Program Files (x86)\Windows Kits\10\App Certification Kit.
  1. Dopo la creazione del pacchetto del file appx per la pubblicazione, eseguire appcertui.exe e seguire le istruzioni per eseguire la scansione di appx:

Screenshot dell'app selezionata per la convalida nel Kit di certificazione app Windows

  1. Selezionare Convalida app di Store:

Screenshot della selezione della convalida nel Kit di certificazione app Windows

  1. Individuare appx nella sezione superiore e selezionare Avanti:

Screenshot della selezione di test nel Kit di certificazione app Windows

  1. Selezionare Avanti per eseguire i test e creare un report:
    • Tutti i test disponibili che possono essere eseguiti nel PC host saranno abilitati per impostazione predefinita

Screenshot dello stato di avanzamento della convalida nel Kit di certificazione app Windows

  1. Attendere il completamento dei test. Al termine, nella finestra finale verrà indicato l'esito positivo o negativo, che può essere visualizzato nel report salvato.

Screenshot dei risultati del report finale nel Kit di certificazione app Windows

Errore noto di WACK nella versione 4.25

Il plug-in di Windows Mixed Reality in Unreal 4.25 non riuscirà a eseguire WACK perché vengono inclusi alcuni file binari x64 durante la creazione del pacchetto per HoloLens. L'errore sarà simile al seguente:

Screenshot dell'errore dovuto all'analizzatore binario e alle API supportate dal Kit di certificazione app Windows

Per correggere il problema:

  1. Passare alla directory radice di installazione o di origine di Unreal aprendo un progetto di Unreal e facendo clic con il pulsante destro del mouse sull'icona di Unreal nella barra delle applicazioni.
  2. Fare clic con il pulsante destro del mouse su UE4Editor, selezionare Properties (Proprietà) e passare al percorso indicato alla voce Location (Posizione):
Open Engine\Plugins\Runtime\WindowsMixedReality\Source\WindowsMixedRealityHMD\WindowsMixedRealityHMD.Build.cs.
  1. In WindowsMixedRealityHMD.Build.cs modificare la riga 32 da:
if(Target.Platform != UnrealTargetPlatform.Win32)

in:

if(Target.Platform == UnrealTargetPlatform.Win64)

  1. Chiudere Unreal, riaprire il progetto e creare nuovamente il pacchetto per HoloLens. Eseguire nuovamente WACK e l'errore verrà rimosso.

Vedi anche