Aktualisieren vorhandener Projekte auf ein anderes Release von Windows App SDK

  • Artikel

Wenn Sie ein Projekt mit einem früheren Release des Windows App SDK (zuvor als Project Reunion bezeichnet) oder WinUI 3 erstellt haben, können Sie das Projekt aktualisieren, um ein neueres Release zu verwenden. Weitere Informationen dazu, was derzeit in jedem Releasekanal verfügbar ist, finden Sie unter Windows App SDK-Releasekanäle.

Hinweis

Aufgrund der Einzigartigkeit jedes App-Szenarios kann es bei Verwendung dieser Anweisungen zu Problemen kommen. Bitte folgen Sie den Anweisungen sorgfältig, und wenn Sie auf ein Problem stoßen, reichen Sie bitte einen Fehler für das GitHub-Repository microsoft-ui-xaml ein.

Update zwischen Versionen, die nach 1.0 veröffentlicht wurden

Wenn Ihr Projekt nicht auf die benötigte Version des Windows App SDK NuGet-Pakets verweist, können Sie den NuGet-Paket-Manager in Visual Studio verwenden, um die NuGet-Paketverweise Ihres Projekts zu aktualisieren. Wenn Sie beispielsweise ein neues Projekt mithilfe einer stabilen Version des Windows App SDK VSIX erstellen, verweist Ihr Projekt auf eine stabile Version des Windows App SDK. Sie können dieses Projekt jedoch ganz einfach neu konfigurieren, um beispielsweise auf eine experimentelle Version des Windows App SDK zu verweisen. Oder konfigurieren Sie es neu, um auf die neueste stabile Version zu verweisen.

Anweisungen zu den einzelnen Schritten finden Sie unter Verwenden des Windows App SDK in einem vorhandenen Projekt.

Aktualisieren von 0.8 auf 1.0

Wenn Sie ein Projekt mit Version 0.8 (z. B. Version 0.8.4) erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf die Version 1.0 zu aktualisieren.

Voraussetzung: Laden Sie das neueste experimentelle Release des Windows App SDK herunter, und installieren Sie es. Weitere Informationen finden Sie unter Installieren von Tools für das Windows App SDK.

Anweisungen

  1. Wenn in der .wapproj-Datei die TargetPlatformMinVersion älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

  2. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole. Dieser Vorgang besteht darin, vorhandene Project Reunion-Paketverweise aus .csproj/.vcxproj- und .wapproj-Dateien zu deinstallieren und dann die WindowsAppSDK-Paketverweise auf diese Dateien zu installieren.

  3. Geben Sie die folgenden Befehle ein, um vorhandene ProjectReunion-Pakete aus .csproj/.vcxproj zu deinstallieren.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} 
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}

  4. Führen Sie dann Folgendes aus, um vorhandene ProjectReunion-Pakete aus .wapproj zu deinstallieren:

    uninstall-package Microsoft.ProjectReunion 
uninstall-package Microsoft.ProjectReunion.WinUI

  5. Führen Sie nun die Befehle aus, um das stabile WindowsAppSDK-Paket zu installieren.

  6. So fügen Sie den WindowsAppSDK-Paketverweis zu .csproj/.vcxproj hinzu:

    install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0

  7. So fügen Sie den WindowsAppSDK-Paketverweis zu .wapproj hinzu:

    install-package Microsoft.WindowsAppSDK -Version 1.0.0

Aktualisieren von 0.8 oder 0.8 Preview auf 1.0 Experimental oder Preview 3

Wichtig

Version 1.0 Vorschau 1 und Vorschau 2 enthalten einen kritischen Bug. Wenn Sie bereits eine dieser Vorschauversionen installiert haben, lesen Sie Wichtiges Problem, das sich auf 1.0 Preview 1 und Preview 2 auswirkt. Wir empfehlen stattdessen die Verwendung von Version 1.0 Preview 3 (1.0.0-preview3).

Wenn Sie ein Projekt mit Version 0.8 Preview oder einer beliebigen Version von 0.8 (z. B. Version 0.8.1) erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf das 1.0 Preview 3- oder Experimental-Release zu aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle für 1.0 Preview 3 ein:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.WindowsAppSDK -Version 1.0.0-preview3 -ProjectName {yourProjectName}

    Oder die folgenden Befehle für 1.0 Experimental:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.WindowsAppSDK -Version 1.0.0-experimental1 -ProjectName {yourProjectName}

  3. Nehmen Sie die folgenden Änderungen in Ihrer WAPPROJ-Datei der Anwendung (Paket) vor:

    1. Entfernen Sie diese Elementgruppe (wenn Sie von einer anderen Version als 0.8.0 aktualisieren, wird die entsprechende Versionsnummer angezeigt, auf die in dieser Elementgruppe verwiesen wird):

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Fügen Sie diese Elementgruppe hinzu, um sie durch 1.0 Preview 3 zu ersetzen:

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-preview3]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

      Oder diese Elementgruppe, um sie durch 1.0 Experimental zu ersetzen:

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-experimental1]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="[1.0.0-experimental1]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  4. Nehmen Sie die folgenden Änderungen an Ihrer Projektdatei (.csproj oder .vcproj) vor:

    1. Entfernen Sie diese Elementgruppe (wenn Sie von einer anderen Version als 0.8.0 aktualisieren, wird die entsprechende Versionsnummer angezeigt, auf die in dieser Elementgruppe verwiesen wird):

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

    2. Fügen Sie diese Elementgruppe hinzu, um sie durch 1.0 Preview 3 zu ersetzen:

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-preview3" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

      Oder diese Elementgruppe, um sie durch 1.0 Experimental zu ersetzen:

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-experimental1" />
    <PackageReference Include="Microsoft.WindowsAppSDK.Foundation" Version="1.0.0-experimental1" />
    <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="1.0.0-experimental1" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. Wenn die Projektmappe nicht erstellt werden kann, bereinigen Sie die Buildausgabe, starten Sie Visual Studio neu, und führen Sie die App erneut aus.

Aktualisieren von 0.8 Preview auf 0.8 oder zwischen stabilen 0.8-Versionen

Wenn Sie ein Projekt mit Version 0.8 Preview erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf eine stabile Version von 0.8 zu aktualisieren. Diese Anweisungen gelten auch, wenn Sie ein Projekt mit einer älteren stabilen Version von 0.8 (z. B. 0.8.0) erstellt haben und Ihr Projekt auf eine neuere stabile Version aktualisieren möchten (z. B. 0.8.2).

Hinweis

Möglicherweise können Sie Ihr Projekt automatisch über den Visual Studio-Erweiterungs-Manager aktualisieren, ohne die folgenden manuellen Schritte auszuführen. Klicken Sie in Visual Studio 2019 auf Erweiterungen>Erweiterungen verwalten, und wählen Sie in der linken Menüleiste Updates aus. Wählen Sie in der Liste „Project Reunion“ aus, und klicken Sie auf Aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle ein:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.2 -ProjectName {yourProjectName}

  3. Nehmen Sie die folgenden Änderungen in Ihrer WAPPROJ-Datei der Anwendung (Paket) vor:

    1. Entfernen Sie diese Elementgruppe (wenn Sie von einer anderen Version als 0.8 Preview aktualisieren, wird die entsprechende Versionsnummer angezeigt, auf die in dieser Elementgruppe verwiesen wird):

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Fügen Sie diese Elementgruppe hinzu, um sie zu ersetzen:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.2]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.2]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  4. Nehmen Sie die folgenden Änderungen an Ihrer Projektdatei (.csproj oder .vcproj) vor:

    1. Entfernen Sie diese Elementgruppe (wenn Sie von einer anderen Version als 0.8 Preview aktualisieren, wird die entsprechende Versionsnummer angezeigt, auf die in dieser Elementgruppe verwiesen wird): 
      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>
    2. Fügen Sie diese Elementgruppe hinzu, um sie zu ersetzen: 
      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.2" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.2" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.2" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. Wenn die Projektmappe nicht erstellt werden kann, bereinigen Sie die Buildausgabe, starten Sie Visual Studio neu, und führen Sie die App erneut aus.

Aktualisieren von 0.5 auf 0.8

Wenn Sie ein Projekt mit Version 0.5 Stable erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf Version 0.8 Stable zu aktualisieren.

Hinweis

Möglicherweise können Sie Ihr Projekt automatisch über den Visual Studio-Erweiterungs-Manager aktualisieren, ohne die folgenden manuellen Schritte auszuführen. Klicken Sie in Visual Studio 2019 auf Erweiterungen>Erweiterungen verwalten, und wählen Sie in der linken Menüleiste Updates aus. Wählen Sie in der Liste „Project Reunion“ aus, und klicken Sie auf Aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle ein:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.0 -ProjectName {yourProjectName}

  3. Fügen Sie der Projektdatei (.csproj oder .vcproj) in der ersten <PropertyGroup> die folgende Zeile hinzu:

    <UseWinUI>true</UseWinUI>

  4. Nehmen Sie die folgenden Änderungen in Ihrer WAPPROJ-Datei der Anwendung (Paket) vor:

    1. Fügen Sie diesen Abschnitt hinzu:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Suchen Sie die folgende Zeile:

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

      Verschieben Sie diese Zeile, und platzieren Sie sie direkt unter dem <TargetPlatformVersion>-Tag in einer neuen Zeile.

    3. Entfernen Sie diese Elementgruppe (wenn Sie von einer früheren Version als 0.5.7 aktualisieren, wird in dieser Elementgruppe auf eine frühere Versionsnummer verwiesen):

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  5. Wenn die Projektmappe nicht erstellt werden kann, bereinigen Sie die Buildausgabe, starten Sie Visual Studio neu, und führen Sie die App erneut aus.

Aktualisieren von 0.5 Preview auf 0.8 Preview

Wenn Sie ein Projekt mit Version 0.5 Preview erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf Version 0.8 Preview zu aktualisieren.

Hinweis

Möglicherweise können Sie Ihr Projekt automatisch über den Visual Studio-Erweiterungs-Manager aktualisieren, ohne die folgenden manuellen Schritte auszuführen. Klicken Sie in Visual Studio 2019 auf Erweiterungen>Erweiterungen verwalten, und wählen Sie in der linken Menüleiste Updates aus. Wählen Sie in der Liste „Project Reunion“ aus, und klicken Sie auf Aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

  • Die Standardprojektvorlagen für C++-und C#-Apps enthielten die folgenden Zeilen. Das Ereignis Application.Suspending wird nicht mehr für Desktop-Apps aufgerufen. Achten Sie daher darauf, diese Zeilen (und andere Verwendungen dieses Ereignisses) zu entfernen, wenn sie noch in Ihrem Code vorhanden sind:

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle ein:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.0-preview -ProjectName {yourProjectName}

  3. Nehmen Sie die folgenden Änderungen in Ihrer WAPPROJ-Datei der Anwendung (Paket) vor:

    1. Fügen Sie diesen Abschnitt hinzu:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Fügen Sie die folgende Zeile direkt unterhalb des <TargetPlatformVersion>-Tags zu einer neuen Zeile hinzu.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

    3. Entfernen Sie die folgende Zeile:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      Sowie diese Zeilen:

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
<Import Project="$(Microsoft_WinUI_AppX_targets)" />

      Und diese Elementgruppe:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
</ItemGroup>

  4. Nehmen Sie die folgenden Änderungen an Ihrer Projektdatei (.csproj oder .vcproj) vor:

    1. Entfernen Sie diese Elementgruppe:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.5.0-prerelease" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.5.0-prerelease" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.5.0-prerelease" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

    2. Fügen Sie diese Elementgruppe hinzu:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. Wenn die Projektmappe nicht erstellt werden kann, bereinigen Sie die Buildausgabe, starten Sie Visual Studio neu, und führen Sie die App erneut aus.

Aktualisieren von 0.5 Preview auf 0.5

Wenn Sie ein Projekt mit Version 0.5 Preview erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf die stabile Version 0.5.7 zu aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • [Nur Desktop-Apps] Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

  • Die Standardprojektvorlagen für C++-und C#-Apps enthielten die folgenden Zeilen. Das Ereignis Application.Suspending wird nicht mehr für Desktop-Apps aufgerufen. Achten Sie daher darauf, diese Zeilen (und andere Verwendungen dieses Ereignisses) zu entfernen, wenn sie noch in Ihrem Code vorhanden sind:

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle ein:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}

  3. Wenn Sie über eine UWP-App verfügen, sollte der Updatevorgang zu diesem Zeitpunkt abgeschlossen sein. Wenn Sie über eine Desktop-App verfügen, nehmen Sie die folgenden Änderungen in der (Paket).wapproj-Datei Ihrer Anwendung vor:

    1. Fügen Sie diesen Abschnitt hinzu:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
        <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Suchen Sie das <TargetPlatformVersion>-Tag, und fügen Sie Folgendes in einer neuen Zeile direkt unter diesem Tag hinzu.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

    3. Entfernen Sie die folgende Zeile:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      Sowie diese Zeilen:

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
<Import Project="$(Microsoft_WinUI_AppX_targets)" />

      Und diese Elementgruppe:

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
</ItemGroup>

Aktualisieren von WinUI 3 Preview 4 auf 0.5

Wenn Sie eine Desktop-App mit WinUI 3 Preview 4 erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt auf Project Reunion 0.5 zu aktualisieren.

Bevor Sie beginnen, stellen Sie sicher, dass Sie alle erforderlichen Komponenten für das Windows App SDK installiert haben, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Einzelheiten finden Sie unter Installieren von Tools für das Windows App SDK.

Tun Sie zunächst Folgendes:

  • Wenn die TargetPlatformMinVersion in der .wapproj-Datei älter als 10.0.17763.0 ist, aktualisieren Sie sie auf 10.0.17763.0.

  • Die Standardprojektvorlagen für C++-und C#-Apps enthielten die folgenden Zeilen. Das Ereignis Application.Suspending wird nicht mehr für Desktop-Apps aufgerufen. Achten Sie daher darauf, diese Zeilen (und andere Verwendungen dieses Ereignisses) zu entfernen, wenn sie noch in Ihrem Code vorhanden sind:

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

Nehmen Sie als Nächstes die folgenden Änderungen an Ihrem Projekt vor:

  1. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole.

  2. Geben Sie die folgenden Befehle ein:

    uninstall-package Microsoft.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}

  3. Nehmen Sie die folgenden Änderungen in Ihrer WAPPROJ-Datei der Anwendung (Paket) vor:

    1. Fügen Sie diesen Abschnitt hinzu:

      <ItemGroup>
  <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
  </PackageReference>
</ItemGroup>

    2. Entfernen Sie die folgenden Zeilen:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      <Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />

  4. Löschen Sie die vorhandene Microsoft.WinUI.AppX.targets-Datei im Ordner „{IhrProjekt} (package)/build/“ Ihres Projekts.