Publication sur le Microsoft StorePublishing to the Microsoft Store

Quand vous êtes prêt à lancer votre application, vous devez mettre à jour quelques paramètres du projet avant de la soumettre au Microsoft Store.When you're ready to get your Unreal app out to the world, there are a few project settings that need updating before you submit to the Microsoft Store. Tous ces paramètres ont des valeurs par défaut, que vous devez toutefois changer pour la production afin de mieux représenter l’application.All of these settings have default values, but should be changed for production to best represent the application.

Paramètres du projet pour l’empaquetage du StoreProject settings for the store packaging

  1. Tout d’abord, sélectionnez Paramètres du projet > Description et mettez à jour les informations sur le jeu et son éditeur :First, select Project Settings > Description and update the game and publisher information:
    • Le nom du jeu apparaît dans la vignette de l’application sur le HoloLens.The Game Name will appear in the app tile on the HoloLens
    • Le nom unique de l’entreprise est utilisé lors de la génération du certificat de projet et doit être au format :The Company Distinguished Name is used when generating the project certificate and should be in the format:
      • CN=CommonName, O=OrganizationName, L=LocalityName, S=StateOrProvinceName, C=CountryName :CN=CommonName, O=OrganizationName, L=LocalityName, S=StateOrProvinceName, C=CountryName:

Capture d’écran de l’éditeur Unreal avec la section de description développée dans les paramètres du projet

  1. Développez la section HoloLens des paramètres du projet et mettez à jour les ressources d’empaquetage.Expand the HoloLens section of the project settings and update the packaging resources. Ces noms de ressources seront indiquées dans la page du Store de l’application :These resource names will be shown on the application’s store page:

Capture d’écran de l’éditeur Unreal avec la section d’empaquetage développée dans les paramètres du projet

  1. Développez la section Images et mettez à jour les images du Store par défaut avec les textures qui représentent l’application du Store.Expand the Images section and update the default store images with textures that represent the store app. Cochez éventuellement la case Logo 3D pour charger un fichier glb à utiliser comme cube 3D lors du lancement de l’application :Optionally, select the 3D Logo checkbox to upload a glb file to use as a 3D live cube when launching the application:

Capture d’écran de l’éditeur Unreal avec la section des images développée dans les paramètres du projet

  1. Enfin, sélectionnez Générer pour générer un certificat de signature à partir du nom du projet et du nom unique de l’entreprise.Lastly, select Generate New to generate a signing certificate from the project name and company distinguished name
    • Définissez une couleur d’arrière-plan de vignette, qui va remplacer tous les pixels transparents dans les images du Store.Set a Tile Background Color, which will appear in place of any transparent pixels in the store images.
    • Développez la liste déroulante et activez Utiliser l’environnement du Windows Store pour une exécution sur des appareils verrouillés par le Store, non déverrouillés par le développeur.Expand the dropdown and enable Use Retail Windows Store Environment to run on retail-locked, not dev-unlocked, devices.

Capture d’écran de l’éditeur Unreal avec la section de génération de certificats développée dans les paramètres du projet

Programme d’installation d’application facultatifOptional App Installer

Un fichier de programme d’installation d’application peut être créé à partir de Paramètres du projet > HoloLens, lequel peut servir à distribuer l’application en dehors du Store.An App Installer file can be created from Project Settings > HoloLens, which can be used to distribute the application outside of the store. Cochez la case permettant de créer un programme d’installation d’application et définissez une URL ou un chemin réseau où stocker le fichier appxbundle du jeu.Enable the Should Create App Installer checkbox and set a URL or network path where you'd like the game’s appxbundle to be stored.

Capture d’écran de l’éditeur Unreal avec la section du programme d’installation d’application développée dans les paramètres du projet

Quand l’application est empaquetée, les fichiers appxbundle et appinstaller sont générés.When the app is being packaged, both the appxbundle and appinstaller will be generated. Chargez le fichier appxbundle sur l’URL d’installation, puis lancez le fichier appinstaller pour installer l’application à partir de l’emplacement réseau.Upload the appxbundle to the installation URL, then launch the appinstaller to install the app from the network location.

Kit de certification des applications WindowsWindows App Certification Kit

Le SDK Windows 10 est fourni avec le kit de certification des applications Windows (WACK) pour valider les problèmes courants susceptibles d’affecter le chargement d’un package dans le Store.The Windows 10 SDK ships with the Windows App Certification Kit (WACK) to validate common issues that could affect uploading a package to the store. Vous pouvez trouver le WACK dans le répertoire des kits Windows, généralement sous le chemin suivant :You can find the WACK in the Windows Kits directory, usually under the following path:

C:\Program Files (x86)\Windows Kits\10\App Certification Kit.
  1. Une fois votre fichier appx est empaqueté pour la publication, exécutez appcertui.exe et suivez les invites pour analyser le fichier appx :After your appx file is packaged for publication, run appcertui.exe and follow the prompts to scan the appx:

Capture d’écran de l’application sélectionnée à des fins de validation dans le kit de certification des applications Windows

  1. Sélectionnez Valider l’application du Store :Select Validate Store App:

Capture d’écran de la sélection de la validation dans le kit de certification des applications Windows

  1. Recherchez le fichier appx dans la section supérieure et sélectionnez Suivant :Browse for the appx in the top section and select Next:

Capture d’écran de la sélection des tests dans le kit de certification des applications Windows

  1. Sélectionnez Suivant pour exécuter les tests et créer un rapport :Select Next to run the tests and create a report:
    • Tous les tests disponibles exécutables sur l’ordinateur hôte sont activés par défaut.All available tests that can be run on the host PC will be enabled by default

Capture d’écran de la progression de la validation de l’application dans le kit de certification des applications Windows

  1. Attendez la fin des tests.Wait for the tests to finish. Une fois l’opération terminée, la fenêtre finale indique une réussite ou un échec, que vous pouvez consulter dans le rapport enregistré.Once complete, the final window will show a pass or fail result, which can be viewed in the saved report.

Capture d’écran des résultats du rapport final dans le kit de certification des applications Windows

Échec du WACK connu avec la version 4.25Known WACK failure with 4.25

Le plug-in Windows Mixed Reality dans Unreal 4.25 fait échouer le WACK, car certains binaires x64 sont inclus lors de l’empaquetage pour HoloLens.The Windows Mixed Reality plugin in Unreal 4.25 will fail WACK because some x64 binaries are included while packaging for HoloLens. L’échec ressemble à ceci :The failure will look like this:

Capture d’écran d’un échec en raison de l’analyseur binaire et des API prises en charge par le kit de certification des applications Windows

Pour résoudre le problème :To fix the issue:

  1. Accédez à la racine de l’installation ou du répertoire source Unreal en ouvrant un projet Unreal et cliquez avec le bouton droit sur l’icône Unreal dans la barre des tâches.Browse to the Unreal installation or source directory root by opening an Unreal project and right-click on the Unreal icon in the taskbar.
  2. Cliquez avec le bouton droit sur UE4Editor, sélectionnez Propriétés, puis accédez au chemin dans l’entrée Emplacement :Right-click on UE4Editor, select properties, and browse to the path in the Location entry:
Open Engine\Plugins\Runtime\WindowsMixedReality\Source\WindowsMixedRealityHMD\WindowsMixedRealityHMD.Build.cs.
  1. Dans WindowsMixedRealityHMD.Build.cs, modifiez la ligne 32 suivante :In WindowsMixedRealityHMD.Build.cs, modify line 32 from:
if(Target.Platform != UnrealTargetPlatform.Win32)

to:to:

if(Target.Platform == UnrealTargetPlatform.Win64)

  1. Fermez Unreal, rouvrez le projet, puis réempaquetez pour HoloLens.Close Unreal, reopen the project, and repackage for HoloLens. Réexécutez le WACK et l’erreur sera supprimée.Rerun WACK and the error will be gone.

Voir aussiSee also