Freigeben über

Aktualisieren der App-Architektur von Arm32 auf Arm64

  • Artikel

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:

  1. Öffnen Sie Ihre Projektmappe (Projektcode) in Visual Studio (Visual Studio 2017, Version 15.9 oder höher, ist erforderlich).
  2. Wählen Sie auf der Standardsymbolleiste (oder im Menü „Erstellen“) im Dropdownmenü „Lösungsplattformen“ die Option Konfigurations-Manager... aus.
  3. Öffnen Sie das Dropdownmenü "Aktive Lösungsplattform", und wählen Sie "Neu"> aus<.
  4. 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 kompiliert wurde. Sie sollten eine Ausgabe "Alle neu erstellen erfolgreich" erhalten. Falls nicht, lesen Sie den nachstehenden Abschnitt Problembehandlung.

(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 diesen 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 nicht für ARM64 kompilierte Abhängigkeit verhindert einen erfolgreichen Build

Wenn die Builderstellung aufgrund einer Abhängigkeit scheitert – unabhängig davon, ob es sich um eine interne Abhängigkeit, eine Abhängigkeit von einem Drittanbieter oder eine Open-Source-Bibliothek handelt –, müssen Sie entweder einen Weg finden, diese Abhängigkeit zur Unterstützung der ARM64-Architektur zu aktualisieren, oder Sie müssen die Abhängigkeit entfernen.

  • Für interne Abhängigkeiten empfehlen wir, die Abhängigkeit für ARM64-Unterstützung neu zu erstellen.

  • Für Drittanbieterabhängigkeiten empfehlen wir, beim Maintainer eine Neuerstellung mit ARM64-Unterstützung anzufordern.

  • 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, erwägen Sie, dem Paket selbst ARM64-Unterstützung beizufügen. Viele Open-Source-Maintainer werden Ihnen für diesen Beitrag dankbar sein.

  • Die letzte Möglichkeit wäre, die Abhängigkeit aus Ihrem App-Projekt zu entfernen und/oder sie 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.