Aktualisieren vorhandener Projekte auf eine andere Version der Windows App SDK

  • Artikel

Wenn Sie ein Projekt mit einer früheren Version der Windows App SDK (zuvor Project Reunion genannt) oder WinUI 3 erstellt haben, können Sie das Projekt aktualisieren, um eine neuere Version zu verwenden. Weitere Informationen dazu, was derzeit in den einzelnen Releasekanälen verfügbar ist, finden Sie unter Windows App SDK Releasekanäle.

Hinweis

Diese Anweisungen können Probleme aufgrund der Eindeutigkeit des einzelnen Szenarios jeder App haben. Befolgen Sie sie sorgfältig, und wenn Sie ein Problem finden, melden Sie einen Fehler für das GitHub-Repository microsoft-ui-xaml .

Update zwischen Versionen, die nach 1.0 veröffentlicht wurden

Wenn Ihr Projekt nicht auf die version des Windows App SDK NuGet-Pakets verweist, das Sie benötigen, 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 der Windows App SDK. Sie können dieses Projekt jedoch problemlos neu konfigurieren, um beispielsweise auf eine experimentelle Version der Windows App SDK zu verweisen. Oder konfigurieren Sie sie neu, um auf das neueste stabile Release zu verweisen.

Schritte finden Sie in den Anweisungen unter Verwenden der Windows App SDK in einem vorhandenen Projekt.

Update 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 die neueste Version der Windows App SDK herunter, und installieren Sie sie. Weitere Informationen finden Sie unter Installieren von Tools für das Windows App SDK.

Instructions

  1. Wenn Ihre TargetPlatformMinVersion in der .wapproj Datei älter als 10.0.17763.0ist, ändern Sie sie in 10.0.17763.0.

  2. Navigieren Sie in Visual Studio zu Extras>NuGet-Paket-Manager>Paket-Manager-Konsole. Dieser Prozess 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 Ihrer .csproj/.vcxproj

    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 Ihrem .wapprojzu 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 ihrem den WindowsAppSDK Paketverweis hinzu/.csproj.vcxproj:

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

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

    install-package Microsoft.WindowsAppSDK -Version 1.0.0

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

Wichtig

Version 1.0 Preview 1 und Preview 2 enthalten einen kritischen Fehler. Wenn Sie bereits eine dieser Vorschauversionen installiert haben, erfahren Sie, wie Sie das Problem beheben. Es wird empfohlen, stattdessen Version 1.0 Preview 3 zu verwenden.

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 die Version 1.0 Preview 3 oder experimentelle Version zu aktualisieren.

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

Gehen Sie zunächst wie folgt vor:

  • Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 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, sehen Sie die entsprechende Versionsnummer, 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, sehen Sie die entsprechende Versionsnummer, 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, sauber Sie die Buildausgabe, starten Sie Visual Studio neu, und versuchen Sie, die App erneut auszuführen.

Update von 0.8 Preview auf 0.8 oder zwischen stabilen Versionen 0.8

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 (z. B. 0.8.2) aktualisieren möchten.

Hinweis

Möglicherweise können Sie Ihr Projekt über den Visual Studio-Erweiterungs-Manager automatisch aktualisieren, ohne die unten angegebenen 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 alle Windows App SDK erforderlichen Komponenten installiert sind, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Informationen finden Sie unter Installieren von Tools für die Windows App SDK.

Gehen Sie zunächst wie folgt vor:

  • Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 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, sehen Sie die entsprechende Versionsnummer, 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, sehen Sie die entsprechende Versionsnummer, 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, sauber Sie die Buildausgabe, starten Sie Visual Studio neu, und versuchen Sie, die App erneut auszuführen.

Update 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 über den Visual Studio-Erweiterungs-Manager automatisch aktualisieren, ohne die unten angegebenen 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 alle Windows App SDK erforderlichen Komponenten installiert sind, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Informationen finden Sie unter Installieren von Tools für die Windows App SDK.

Gehen Sie zunächst wie folgt vor:

  • Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 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) die folgende Zeile in der ersten <PropertyGroup>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 in einer neuen Zeile direkt unter dem <TargetPlatformVersion> Tag.

    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, sauber Sie die Buildausgabe, starten Sie Visual Studio neu, und versuchen Sie, die App erneut auszuführen.

Update von 0.5 Preview auf 0.8 Preview

Wenn Sie ein Projekt mit Version 0.5 (Vorschauversion) erstellt haben, können Sie diese Anweisungen befolgen, um Ihr Projekt für die Verwendung von Version 0.8 (Vorschauversion) zu aktualisieren.

Hinweis

Möglicherweise können Sie Ihr Projekt über den Visual Studio-Erweiterungs-Manager automatisch aktualisieren, ohne die unten angegebenen 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 alle Windows App SDK erforderlichen Komponenten installiert sind, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Informationen finden Sie unter Installieren von Tools für die Windows App SDK.

Gehen Sie zunächst wie folgt vor:

  • Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 10.0.17763.0.

  • Die Standardprojektvorlagen für C++- und C#-Apps enthielten die folgenden Zeilen. Das Application.Suspending Ereignis wird für Desktop-Apps nicht mehr aufgerufen. Achten Sie daher darauf, diese Zeilen (und alle anderen 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 einer neuen Zeile direkt unter dem <TargetPlatformVersion> Tag hinzu.

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

    3. Entfernen Sie die folgende Zeile:

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

      Und 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, sauber Sie die Buildausgabe, starten Sie Visual Studio neu, und versuchen Sie, die App erneut auszuführen.

Update von 0.5 Preview auf 0.5

Wenn Sie ein Projekt mit Version 0.5 (Vorschauversion) 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 alle Windows App SDK erforderlichen Komponenten installiert sind, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Informationen finden Sie unter Installieren von Tools für die Windows App SDK.

Gehen Sie zunächst wie folgt vor:

  • [Nur Desktop-Apps] Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 10.0.17763.0.

  • Die Standardprojektvorlagen für C++- und C#-Apps enthielten die folgenden Zeilen. Das Application.Suspending Ereignis wird für Desktop-Apps nicht mehr aufgerufen. Achten Sie daher darauf, diese Zeilen (und alle anderen 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 an Ihrer Anwendung (Paket).wapproj 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>

      Und 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>

Update 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 alle Windows App SDK erforderlichen Komponenten installiert sind, einschließlich des neuesten VSIX- und NuGet-Pakets. Weitere Informationen finden Sie unter Installieren von Tools für die Windows App SDK.

Gehen Sie zunächst wie folgt vor:

  • Wenn Ihre TargetPlatformMinVersion in der WAPPROJ-Datei älter als 10.0.17763.0 ist, ändern Sie sie in 10.0.17763.0.

  • Die Standardprojektvorlagen für C++- und C#-Apps enthielten die folgenden Zeilen. Das Application.Suspending Ereignis wird für Desktop-Apps nicht mehr aufgerufen. Achten Sie daher darauf, diese Zeilen (und alle anderen 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.