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

  • Article

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 case activée la plateforme de solutions actuelle pour votre application pour voir si ARM64 est présent, ouvrez le code du 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 Snap xeon de Soc) ne prennent plus en charge AArch32 (Arm32). Ce changement affecte plateforme Windows universelle applications 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 valeur « Créer de nouvelles plateformes de projet » case activée box activée, 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 Debug par Version. Dans le menu déroulant « Générer », sélectionnez Reconstruire la solution et attendez que le projet se régénère. Vous devez recevoir une sortie « Reconstruire tout réussi ». Si ce n’est pas le cas, consultez la section Résolution des problèmes ci-dessous.

(Facultatif) : Vérifiez que votre fichier binaire d’application est maintenant 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 Visual Studio Explorateur de solutions, puis sélectionnez Ouvrir dans terminal). Modifiez les répertoires afin que le nouveau bin\ARM64\Release répertoire de votre projet soit sélectionné. Entrez la commande : dumpbin .\<appname>.exe (en <appname> remplaçant par le nom de votre application). Entrez ensuite la commande : dumpbin /headers .\<appname>.exe. Faites défiler vers le haut les résultats de sortie de votre terminal, recherchez la FILE HEADER VALUES section et confirmez 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 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 la dépendance pour la prise en charge d’ARM64.

  • Pour les dépendances tierces, nous vous recommandons de déposer une demande de reconstruction de la maintenance avec la prise en charge ARM64.

  • Pour code source ouvert dépendances, nous vous recommandons d’abord case activée ing 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. Beaucoup de code source ouvert mainteneurs 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 pour achelp@microsoft.com envoyer votre demande de support de compatibilité Windows on Arm.