Aktualisieren der App-Architektur von Arm32 auf Arm64

Artikel
10/04/2023

In diesem Handbuch werden die empfohlenen Schritte zum Ändern einer vorhandenen App mit Unterstützung für die 32-Bit-Arm-Plattformarchitektur zur aktualisierten 64-Bit-Arm-Architektur beschrieben, indem sie die erforderliche Konfiguration mithilfe von Visual Studio hinzufügen. Dieses Update hilft Ihrer App, auf den neuesten Windows auf Arm-Geräten auszuführen, die 64-Bit-Arm-Prozessoren (ARM64/AArch64) verwenden.

Dieses Thema ist für UWP-Apps relevant, die nicht über ein ARM64-Ziel verfügen. Ältere UWP-Projektvorlagen haben ein ARM32-Ziel (oder AArch32)-Ziel generiert, jedoch keine Unterstützung für ARM64 (AArch64) enthalten.

Um die aktuelle Lösungsplattform für Ihre App zu überprüfen, um festzustellen, ob ARM64 vorhanden ist, öffnen Sie den App-Projektcode in Visual Studio, und wählen Sie im Dropdownmenü "Lösungsplattformen" auf der Standardsymbolleiste Configuration Manager... (auch im Menü "Erstellen") aus, in dem Sie die Liste der Lösungsplattformen anzeigen und bestätigen können, ob ARM64 vorhanden ist.

Hinweis

Windows-Geräte, die auf einem Arm-Prozessor ausgeführt werden (z. B. Snapdragon-Prozessoren von Qualcomm) unterstützen AArch32 (Arm32) nicht mehr. Diese Änderung wirkt sich auf Universelle Windows-Plattform Apps aus, die derzeit auf AArch32 (Arm32) abzielen. Die Unterstützung für 32-Bit-Arm-Versionen von Anwendungen wird in einer zukünftigen Version von Windows 11 entfernt. Systembinärdateien für ARM32-Unterstützung (vorhanden im Sysarm32-Ordner ) werden ebenfalls entfernt. Nach dieser Änderung können für die geringe Anzahl betroffener Anwendungen App-Features unterschiedlich sein, und Möglicherweise stellen Sie einen Unterschied in der Leistung fest. Daher empfehlen wir, Ihre zielbezogenen Plattformen auf AArch64 (Arm64) zu aktualisieren, die auf allen Windows-Geräten auf Arm-Geräten so schnell wie möglich unterstützt wird, um sicherzustellen, dass Ihre Kunden weiterhin die bestmögliche Erfahrung genießen können. Befolgen Sie die Anleitungen auf dieser Seite, um Ihre Anwendungen auf AArch64 (Arm64) zu aktualisieren.

Hinzufügen einer Arm64-Konfiguration zu Ihrem Projekt

So fügen Sie Ihrem vorhandenen App-Projektcode eine ARM64-Lösungsplattform hinzu:

Öffnen Sie Ihre Projektmappe (Projektcode) in Visual Studio (Visual Studio 2017, Version 15.9 oder höher, ist erforderlich).
Wählen Sie im Dropdownmenü "Lösungsplattformen" auf der Standardsymbolleiste (oder im Menü "Erstellen") Configuration Manager aus...
Öffnen Sie das Dropdownmenü "Aktive Lösungsplattform", und wählen Sie "Neu"> aus<.
Wählen Sie im Dropdownmenü "Neue Plattform eingeben oder auswählen" ARM64 aus, und stellen Sie sicher, dass der Wert "Einstellungen kopieren von" auf ARM festgelegt ist, wobei das Kontrollkästchen "Neue Projektplattformen erstellen" aktiviert ist, und wählen Sie dann "OK" aus.

Erstellen Ihrer Arm64-Lösung

Nachdem Sie die Arm64-Lösungsplattform zu Ihrem vorhandenen Projekt oder Ihrer vorhandenen Lösung hinzugefügt haben, schließen Sie das Fenster "Aktive Lösungsplattform", wenn Sie bestätigen möchten, dass die Arm64-Version Ihrer App ordnungsgemäß erstellt wird, schließen Sie das Fenster "Aktive Lösungsplattform", und ändern Sie die Buildeinstellung von Debug in Release. Wählen Sie im Dropdownmenü "Erstellen" die Option "Projektmappe neu erstellen" aus, und warten Sie, bis das Projekt neu erstellt wurde. Sie sollten eine Ausgabe "Alle neu erstellen erfolgreich" erhalten. Wenn nicht, lesen Sie den Abschnitt "Problembehandlung " weiter unten.

(Optional): Überprüfen Sie, ob ihre App-Binärdatei jetzt für die Arm64-Architektur erstellt wurde, indem Sie Ihr Projektverzeichnis in PowerShell öffnen (klicken Sie mit der rechten Maustaste auf Ihr App-Projekt in Visual Studio Projektmappen-Explorer, und wählen Sie "Im Terminal öffnen" aus. Ändern Sie Verzeichnisse so, dass das neue bin\ARM64\Release Verzeichnis Ihres Projekts ausgewählt ist. Geben Sie den Befehl ein: dumpbin .\<appname>.exe (ersetzen sie <appname> durch den Namen Ihrer App). Geben Sie dann den Befehl ein: dumpbin /headers .\<appname>.exe. Scrollen sie in den Ausgabeergebnissen Ihres Terminals nach oben, suchen Sie den FILE HEADER VALUES Abschnitt, und bestätigen Sie, dass die erste Zeile ist AA64 machine (ARM64).

Veröffentlichen Ihrer aktualisierten App im Microsoft Store

Nachdem Sie eine Arm64-Version Ihrer App erstellt haben, indem Sie die oben beschriebenen Konfigurationsschritte ausführen, können Sie Ihr vorhandenes App-Paket im Microsoft Store aktualisieren, indem Sie Ihr Partner Center-Dashboard besuchen und die neu erstellten ARM64-Binärdateien zur Übermittlung hinzufügen. (Es ist eine Option, auch die vorherigen ARM32-Binärdateien zu entfernen).

(optional) Entfernen der vorherigen Arm32-Binärdateien. Weitere Informationen zu Optionen finden Sie unter Veröffentlichen Ihrer App im Microsoft Store.

Problembehandlung

Wenn beim Portieren Ihrer Arm32-App zu Arm64 Probleme auftreten, finden Sie hier einige gängige Lösungen.

Eine Abhängigkeit, die nicht für ARM64 kompiliert wurde, blockiert Sie von einem erfolgreichen Build.

Wenn Sie aufgrund einer Abhängigkeit, ob intern, von einem Drittanbieter oder aus einer Open-Source-Bibliothek, nicht erstellen können, müssen Sie entweder eine Möglichkeit finden, diese Abhängigkeit zur Unterstützung der ARM64-Architektur zu aktualisieren oder sie zu entfernen.

Für interne Abhängigkeiten wird empfohlen, die Abhängigkeit für die ARM64-Unterstützung neu zu erstellen.
Für Abhängigkeiten von Drittanbietern empfehlen wir, eine Anforderung für den Standard tainer zur Neuerstellung mit ARM64-Unterstützung einzureichen.
Für Open Source-Abhängigkeiten wird empfohlen, zuerst vcpkg zu überprüfen, um festzustellen, ob eine neuere Version der Abhängigkeit, die ARM64-Unterstützung enthält, vorhanden ist, auf die Sie aktualisieren können. Wenn kein Update vorhanden ist, sollten Sie selbst die Unterstützung von ARM64 zum Paket beitragen. Viele Open Source Standard tainers wäre dankbar für den Beitrag.
Die letzte Wahl wäre, die Abhängigkeit von Ihrem App-Projekt zu entfernen und/oder zu ersetzen.

Benötigen Sie Hilfe? Nutzen sie unseren App Assure-Dienst

Erfahren Sie mehr über die App Assure-Kompatibilitätsunterstützung , um bei der Portierung Ihrer Windows-App oder Ihres Treibers zu Arm64 zu helfen. Um sich mit App Assure zu registrieren und eine Verbindung herzustellen, besuchen Sie aka.ms/AppAssureRequest oder senden Sie eine E-Mail, um Ihre Anforderung an windows on Arm-Kompatibilitätsunterstützung zu achelp@microsoft.com übermitteln.