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 sur l’architecture arm 64 bits plus mise à jour en ajoutant la configuration nécessaire à l’aide de Visual Studio. Cette mise à jour aidera 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 et dans le menu déroulant « Plateformes de solutions » dans la barre d’outils Standard, sélectionnez Configuration Manager... (également disponible dans le menu Build) où vous pourrez afficher la liste des plateformes de solutions et vérifier si ARM64 est présent.

Remarque

Les appareils Windows qui s’exécutent sur un processeur Arm (par exemple, les processeurs Snaphz de Amd) ne prennent plus en charge AArch32 (Arm32). Cette modification a un impact sur les applications de plateforme Windows universelle qui ciblent actuellement AArch32 (Arm32). La prise en charge des versions Arm 32-bits des applications sera supprimée dans une prochaine version de Windows 11.. Les fichiers binaires système pour la prise en charge d’ARM32 (présents dans le dossier sysarm32 ) seront également supprimés. Après cette modification, pour le petit nombre d’applications affectées, les fonctionnalités d’application peuvent être différentes et vous remarquerez peut-être une différence de performances. Par conséquent, nous vous recommandons de mettre à jour vos plateformes ciblées vers AArch64 (Arm64), qui est prise en charge sur tous les appareils Windows sur Arm, dès que possible afin de vous assurer que vos clients peuvent continuer à bénéficier de la meilleure expérience possible. Suivez les instructions de cette page pour mettre à jour vos applications vers AArch64 (Arm64).

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 de nouvelles plateformes de projet », puis sélectionnez OK.

Créer votre solution Arm64

Une fois que vous avez ajouté la plateforme de solution Arm64 à votre projet ou solution existant, si vous souhaitez confirmer que la version Arm64 de votre application est générée correctement, fermez la fenêtre « Plateforme de solution active » et remplacez le paramètre de génération de débogage par Version. 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 ci-dessous.

(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

Une fois que vous avez créé une version Arm64 de votre application en suivant les étapes de configuration ci-dessus, vous pouvez mettre à jour votre package d’application existant dans le Microsoft Store en visitant votre tableau de bord de l’Espace partenaires et en ajoutant les fichiers binaires ARM64 nouvellement créés à la soumission. (Il s’agit d’une option permettant également de supprimer les fichiers binaires ARM32 précédents).

(éventuellement) en supprimant les fichiers binaires Arm32 précédents. Pour plus d’informations sur les options, 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 trouver un moyen de mettre à jour cette dépendance pour prendre en charge l’architecture ARM64 ou la supprimer.

• Pour les dépendances internes, nous vous recommandons de reconstruire les dépendances pour assurer la prise en charge d’ARM64.

• Pour les dépendances tierces, nous vous recommandons de déposer une demande auprès du responsable de la maintenance pour une reconstruction avec la compatibilité ARM64.

• Pour les dépendances open source, nous vous recommandons d’abord de vérifier vcpkg pour voir si une version plus récente de la dépendance qui inclut la prise en charge d’ARM64 existe que vous pouvez mettre à 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.

• Le dernier choix serait de supprimer et/ou de remplacer la dépendance de 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 ou envoyez un e-mail à achelp@microsoft.com pour envoyer votre demande de support de compatibilité Windows sur Arm.