Portieren auf die universelle Windows-Plattform (C++)

  • Artikel

In diesem Thema finden Sie Informationen zum Portieren von vorhandenem C++-Code zur Windows-App-Plattform, dem Universelle Windows-Plattform. Was mit dem Begriff "universell " gemeint ist, ist, dass Ihr Code auf jedem der Geräte ausgeführt werden kann, auf denen Windows 10 oder höher ausgeführt wird. Sie erstellen ein einzelnes Projekt und eine einzelne XAML-Basis-Benutzeroberfläche, die gut auf jedem Gerät funktioniert, auf dem Windows 10 oder höher ausgeführt wird. Sie können dynamische Layout-Features in XAML verwenden, damit sich die Benutzeroberfläche der App an die unterschiedlichen Displaygrößen anpassen lässt.

Die Windows-Entwicklungscenter-Dokumentation enthält eine Anleitung zum Portieren von Windows 8.1-Apps auf die universelle Windows-Plattform. Weitere Informationen finden Sie unter Wechsel von Windows-Runtime 8 zu UWP. Obwohl sich das Handbuch vor allem auf C#-Code konzentriert, gilt ein Großteil der Anleitung für C++. In den folgenden Vorgehensweisen finden Sie detailliertere Informationen. Siehe auch "Wechseln von einer Desktopanwendung zu UWP".

Dieses Thema enthält die folgenden Verfahren zum Portieren von Code für die UWP.

Wenn Sie über eine klassische Wind32-DLL-Datei für Desktopcomputer verfügen und sie über eine UWP-Anwendung aufrufen möchten, können Sie dies ebenfalls vornehmen. Auf diese Weise können Sie eine UWP-Benutzeroberflächenebene für eine vorhandene klassische Windows C++-Desktopcomputeranwendung oder Ihren plattformübergreifenden C++-Standardcode erstellen. Siehe Vorgehensweise: Verwenden von vorhandenem C++-Code in einer universelle Windows-Plattform-App.

Portieren einer Windows 8.1 Store-App auf UWP

Wenn Sie über eine Windows 8.1 Store-App verfügen, können Sie dieses Verfahren verwenden, um sie auf der UWP und allen Geräten zu verwenden, auf denen Windows 10 oder höher ausgeführt wird. Es empfiehlt sich, zuerst das Projekt mit Visual Studio 2019 als Windows 8.1-Projekt zu erstellen, um zuerst alle Probleme zu beseitigen, die sich aus Änderungen in den Compilern und Bibliotheken ergeben. Nachdem Sie dies getan haben, gibt es zwei Möglichkeiten, dies in ein Windows UWP-Projekt zu konvertieren. Die einfachste Möglichkeit (wird in der folgenden Vorgehensweise erläutert) besteht darin, indem Sie ein universelles Windows-Projekt erstellen und Ihren vorhandenen Code hineinkopieren. Wenn Sie ein universelles Projekt für Windows 8.1-Desktopcomputer und Windows Phone 8.1 verwendet haben, beginnt das Projekt zwei unterschiedliche Layouts in XAML, endet jedoch mit einem einzelnen dynamischen Layout, das die Größe anpasst.

So portieren Sie einer Windows 8.1 Store-App auf UWP

  1. Falls noch nicht erfolgt, öffnen Sie Ihr Windows 8.1-App-Projekt in Visual Studio 2017, und befolgen Sie die Anweisungen zum Aktualisieren der Projektdatei.

    Sie müssen die Windows 8.1-Tools im Visual Studio-Setup installiert haben. Wenn Sie diese Tools nicht installiert haben, starten Sie das Visual Studio-Setup über das Fenster Programme und Funktionen. Klicken Sie auf Visual Studio 2017, und wählen Sie im Setup-Fenster Ändern aus. Suchen Sie nach Windows 8.1-Tools, stellen Sie sicher, dass diese Option ausgewählt ist, und klicken Sie auf OK.

  2. Öffnen Sie das Fenster Projekteigenschaften, und legen Sie unter C++>Allgemein das Plattformtoolset auf v141 (das Toolset für Visual Studio 2017) fest.

  3. Erstellen Sie das Projekt als Windows 8.1-Projekt, und lösen Sie alle Buildfehler. Fehler in dieser Phase liegen wahrscheinlich an wichtigen Änderungen an den Build-Tools und Bibliotheken. Unter Änderungsverlauf von Visual C++ von 2003 bis 2015 finden Sie eine ausführliche Erläuterung der Änderungen, die sich auf Ihren Code auswirken.

    Nachdem Ihr Projekt sauber erstellt wurde, können Sie zum Universelle Windows-Plattform portieren.

  4. Erstellen Sie ein neues universelles Windows-App-Projekt mit der leeren Vorlage. Sie möchten dem Projekt möglicherweise den gleichen Namen wie dem vorhandenen Projekt geben, obwohl sich die Projekte dazu in unterschiedlichen Verzeichnissen befinden müssen.

  5. Schließen Sie die Projektmappe, und verwenden Sie dann den Windows Explorer oder die Befehlszeile, kopieren Sie die Codedateien (mit den Dateierweiterungen CPP, H und XAML) aus Ihrem Windows 8.1-Projekt in denselben Ordner wie die Projektdatei (VCXPROJ) für das Projekt, das Sie in Schritt 1 erstellt haben. Kopieren Sie nicht die Datei "Package.appxmanifest", und wenn Sie eigenen Code für Windows 8.1 Desktop- und -Phone haben, wählen Sie zunächst eines als Portierungsziel aus (Sie müssen später zur Angleichung an die andere Anpassungen vornehmen). Achten Sie darauf, dass Sie ebenfalls alle Inhalte aus den Unterordnern kopieren. Wenn Sie aufgefordert werden, wählen Sie aus, dass Dateien mit doppelten Namen ersetzt werden.

  6. Öffnen Sie die Projektmappe erneut, und klicken Sie im Kontextmenü für den Projektknoten auf Hinzufügen>Vorhandenes Element hinzufügen. Wählen Sie alle kopierten Dateien, außer denen, die bereits Teil des Projekts sind.

    Überprüfen Sie die Unterordner, und stellen Sie sicher, dass die darin enthaltenen Dateien ebenfalls hinzufügt werden.

  7. Wenn Sie nicht den gleichen Projektnamen wie bei dem alten Projekt verwenden, öffnen Sie die Datei „Package.appxmanifest“, und aktualisieren Sie den Einstiegspunkt entsprechend des Namespacenamens für die App-Klasse.

    Das Feld Einstiegspunkt in der Datei „Package.appxmanifest“ enthält einen bereichsbezogenen Namen für die App-Klasse, die den Namespace enthält, der die App-Klasse enthält. Wenn Sie ein universelles Windows-Projekt erstellen, wird für den Namespace der Name des Projekts festgelegt. Wenn Unterschiede zu den von Ihnen aus dem alten Projekt kopierten Dateien bestehen, müssen Sie eines der beiden Projekte aktualisieren, damit sie übereinstimmen.

  8. Erstellen Sie das Projekt, und lösen Sie alle Buildfehler durch wichtige Änderungen zwischen den verschiedenen Versionen des Windows SDK.

  9. Führen Sie das Projekt auf dem lokalen Desktop aus. Stellen Sie sicher, dass keine Bereitstellungsfehler vorliegen, das Layout der App angemessen ist und es korrekt auf dem Desktop funktioniert.

  10. Wenn Sie unterschiedliche Codedateien für XAML für ein anderes Gerät hatten, wie z. B. Windows Phone 8.1, überprüfen Sie den Code, und ermitteln Sie, wo er von dem für das Standardgerät abweicht. Ist der Unterschied nur im Layout, können Sie die XAML-Datei mit einem Manager für den visuellen Zustand bearbeiten, damit sie an die Bildschirmgröße der Anzeige angepasst werden kann. Um weitere Unterschiede anzuzeigen, können Sie die Bedingungsabschnitte in Ihrem Code mithilfe der folgenden #if-Anweisungen verwenden.

    #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PC_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PHONE_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

    Diese Anweisungen gelten jeweils für UWP-Apps, Windows Phone Store-Apps, beide oder keines von beiden (nur klassische Win32-Desktop-Apps). Diese Makros sind nur in Windows SDK 8.1 und höher verfügbar. Wenn Code mit früheren Versionen des Windows SDK oder für andere Plattformen als Windows kompiliert werden muss, sollten Sie daher auch den Fall berücksichtigen, dass sie nicht definiert sind.

  11. Führen Sie die App in einem Emulator oder auf einem physischen Gerät, dessen Gerätetyp von Ihrer App unterstützt wird. Um einen Emulator auszuführen, müssen Sie Visual Studio auf einem physischen Computer ausführen, nicht auf einem virtuellen Computer.

Portieren einer Windows 8.1-Runtime-Komponente auf UWP

Wenn Sie über eine DLL oder eine Windows-Runtime Komponente verfügen, die bereits mit Windows 8.1 Store-Apps funktioniert, können Sie dieses Verfahren verwenden, um die Komponente oder DLL abzurufen, die mit der UWP unter Windows arbeitet. Das grundlegende Verfahren besteht darin, ein neues Projekt zu erstellen und Ihren Code hinein zu kopieren.

So portieren Sie eine Windows 8.1-Runtime-Komponente zur UWP

  1. Suchen Sie im Dialogfeld Neues Projekt in Visual Studio 2017 den Knoten Windows Universal. Wenn dieser Knoten nicht angezeigt wird, installieren Sie zuerst das Windows SDK . Wählen Sie die Vorlage Komponente für Windows-Runtime , benennen Sie Ihre Komponente, und wählen Sie die Schaltfläche OK aus. Der Komponentenname wird als der Namespacename verwendet. Sie möchten daher möglicherweise denselben Namen wie beim Namespace Ihres alten Projekts verwenden. Dafür müssen Sie das Projekt in einem Ordner erstellen, der sich vom alten unterscheidet. Wenn Sie einen anderen Namen auswählen, können Sie den Namespace in den generierten Codedateien aktualisieren.

  2. Schließen Sie das Projekt.

  3. Kopieren Sie sämtliche Codedateien (.cpp, .h, .xaml usw.) aus Ihrer Windows 8.1-Komponente in Ihr neu erstelltes Projekt. Kopieren Sie nicht die Datei „Package.appxmanifest“.

  4. Beheben Sie alle Fehler, die auf Umbrechungsänderungen zwischen unterschiedlichen Versionen des Windows SDK zurückgehen.

Problembehandlung

Im Rahmen des Portierens von Code für die UWP können verschiedene Fehler auftreten. Hier sind einige der möglichen Probleme, die auftreten können.

Probleme bei der Projektkonfiguration

Sie erhalten möglicherweise diese Fehlermeldung:

could not find assembly 'platform.winmd': please specify the assembly search path using /AI or by setting the LIBPATH environment variable

In diesem Fall wird das Projekt nicht als universelles Windows-Projekt erstellt. Überprüfen Sie die Projektdatei, und stellen Sie sicher, dass sie über die richtigen XML-Elemente verfügt, die ein Projekt als universelles Windows-Projekt bezeichnen. Die folgenden Elemente sollten vorhanden sein (die Versionsnummer der Zielplattform weicht möglicherweise ab):

<AppContainerApplication>true</AppContainerApplication>
<ApplicationType>Windows Store</ApplicationType>
<WindowsTargetPlatformVersion>10.0.10156.0</WindowsTargetPlatformVersion>
<WindowsTargetPlatformMinVersion>10.0.10156.0</WindowsTargetPlatformMinVersion>
<ApplicationTypeRevision>10.0</ApplicationTypeRevision>

Wenn Sie ein neues UWP-Projekt mithilfe von Visual Studio erstellt haben, sollte dieser Fehler nicht angezeigt werden.

Siehe auch

Visual C++: Portierungsanleitung
Entwickeln von Apps für die universelle Windows-Plattform (UWP)