Mettre à jour l’architecture d’application d’Arm32 vers Arm64

Ce guide décrit les étapes recommandées pour modifier une application existante avec prise en charge de l’architecture de plateforme Arm 32 bits vers l’architecture Arm 64 bits plus mise à jour en ajoutant la configuration nécessaire à l’aide de Visual Studio. Cette mise à jour aide votre application à s’exécuter sur les derniers appareils Windows sur Arm qui utilisent des processeurs Arm (Arm64/AArch64) 64 bits.

Cette rubrique est pertinente pour les applications UWP qui n’ont pas de cible Arm64. Les anciens modèles de projet UWP ont généré une cible Arm32 (ou AArch32), mais n’ont pas inclus la prise en charge d’Arm64 (AArch64).

Pour vérifier la plateforme de solutions actuelle de votre application pour voir si Arm64 est présent, ouvrez le code de votre projet d’application dans Visual Studio. Dans le menu déroulant « Plateformes de solutions » dans la barre d’outils Standard, sélectionnez Configuration Manager... (également disponible dans le menu Build) dans lequel vous pouvez afficher la liste des plateformes de solution et vérifier si Arm64 est présent.

Ajouter une configuration Arm64 à votre projet

Pour ajouter une plateforme de solution Arm64 au code de votre projet d’application existant :

1. Ouvrez votre solution (code de projet) dans Visual Studio (Visual Studio 2017 version 15.9 ou ultérieure est nécessaire).
2. Dans le menu déroulant « Plateformes de solutions » dans la barre d’outils Standard (ou dans le menu « Générer »), sélectionnez Configuration Manager...
3. Ouvrez le menu déroulant « Plateforme de solution active » et sélectionnez <nouveau...>.
4. Dans le menu déroulant « Tapez ou sélectionnez la nouvelle plateforme », sélectionnez Arm64 et vérifiez que la valeur « Copier les paramètres à partir de » est définie sur ARM avec la case à cocher « Créer des plateformes de projet » activée, puis sélectionnez OK.

Créer votre solution Arm64

Après avoir ajouté la plateforme de solution Arm64 à votre projet ou solution existant, si vous souhaitez confirmer que la version Arm64 de votre application s’génère correctement, fermez la fenêtre « Plateforme de solution active » et remplacez le paramètre de génération de Debug vers Release. Dans le menu déroulant « Générer », sélectionnez Reconstruire la solution et attendez que le projet se reconstruise. Vous devriez recevoir un message indiquant « Reconstruction totale réussie ». Si ce n’est pas le cas, consultez la section Résolution des problèmes .

(facultatif): vérifiez que le fichier binaire de votre application est désormais généré pour l’architecture Arm64 en ouvrant votre répertoire de projet dans PowerShell (cliquez avec le bouton droit sur votre projet d’application dans l’Explorateur de solutions Visual Studio, puis sélectionnez Ouvrir dans terminal). Modifiez les répertoires afin que le nouveau répertoire bin\ARM64\Release de votre projet soit sélectionné. Entrez la commande : dumpbin .\<appname>.exe (en remplaçant <appname> par le nom de votre application). Entrez ensuite la commande : dumpbin /headers .\<appname>.exe. Faites défiler vers le haut dans les résultats de sortie de votre terminal, recherchez la section FILE HEADER VALUES et vérifiez que la première ligne est AA64 machine (ARM64).

Publier votre application mise à jour dans le Microsoft Store

Après avoir créé une version Arm64 de votre application en suivant les étapes de configuration de la section précédente, vous pouvez mettre à jour votre package d’application existant dans le Microsoft Store. Visitez votre tableau de bord de l’Espace partenaires et ajoutez les fichiers binaires ARM64 nouvellement créés à la soumission. Vous pouvez également supprimer les fichiers binaires ARM32 précédents si vous le souhaitez.

Pour plus d’informations sur les options de publication, consultez Publier votre application dans le Microsoft Store.

Résolution des problèmes

Si vous rencontrez des problèmes lors du portage de votre application Arm32 vers Arm64, voici quelques solutions courantes.

Une dépendance non compilée pour ARM64 vous empêche d’une build réussie

Si vous ne pouvez pas générer en raison d’une dépendance, qu’elle soit interne, d’un tiers ou d’une bibliothèque open source, vous devez mettre à jour cette dépendance pour prendre en charge l’architecture ARM64 ou la supprimer.

• Pour les dépendances internes, recompilez la dépendance afin de prendre en charge ARM64.

• Pour les dépendances tierces, demandez au mainteneur de reconstruire avec la prise en charge d’ARM64.

• Pour les dépendances open source, vérifiez vcpkg pour voir si une version plus récente de la dépendance inclut la prise en charge d’ARM64 vers laquelle vous pouvez effectuer la mise à jour. Si aucune mise à jour n’existe, envisagez de contribuer à l’ajout de la prise en charge ARM64 au package vous-même. De nombreux responsables open source seraient reconnaissants de la contribution.

• Supprimez et remplacez la dépendance sur votre projet d’application.

Vous avez besoin d’aide ? Tirer parti de notre service App Assure

En savoir plus sur l’assistance de compatibilité de l’assurance des applications pour faciliter le portage de votre application ou pilote Windows vers Arm64. Pour vous inscrire et vous connecter à App Assure, visitez aka.ms/AppAssureRequest.