Bagikan melalui

Memperbarui proyek yang ada ke rilis SDK Aplikasi Windows yang berbeda

  • Artikel

Jika Anda membuat proyek dengan versi SDK Aplikasi Windows yang lebih lama (sebelumnya disebut Project Reunion) atau WinUI 3, maka Anda dapat memperbarui proyek untuk menggunakan rilis yang lebih baru. Untuk mempelajari selengkapnya tentang apa yang saat ini tersedia di setiap saluran rilis, lihat SDK Aplikasi Windows saluran rilis.

Catatan

Instruksi ini mungkin memiliki masalah karena keunikan masing-masing skenario aplikasi. Harap ikuti mereka dengan hati-hati, dan jika Anda menemukan masalah, silakan ajukan bug terhadap repositori GitHub microsoft-ui-xaml .

Pembaruan antara versi yang dirilis setelah 1.0

Jika proyek Anda tidak mereferensikan versi paket SDK Aplikasi Windows NuGet yang Anda butuhkan, maka Anda dapat menggunakan Manajer Paket NuGet di Visual Studio untuk memperbarui referensi paket NuGet proyek Anda. Misalnya, jika Anda membuat proyek baru dengan menggunakan rilis stabil SDK Aplikasi Windows VSIX, proyek Anda akan mereferensikan rilis SDK Aplikasi Windows yang stabil. Tetapi Anda dapat dengan mudah mengonfigurasi ulang proyek tersebut untuk direferensikan, misalnya, rilis eksperimental SDK Aplikasi Windows. Atau konfigurasi ulang untuk mereferensikan rilis stabil terbaru.

Untuk langkah-langkahnya, lihat instruksi dalam Menggunakan SDK Aplikasi Windows dalam proyek yang sudah ada.

Pembaruan dari 0.8 ke 1.0

Jika Anda membuat proyek menggunakan versi 0.8 (misalnya, versi 0.8.4), maka Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke rilis 1.0.

Prasyarat: Unduh dan instal rilis terbaru SDK Aplikasi Windows. Untuk informasi selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Petunjuk

  1. .wapproj Dalam file , jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, maka ubah menjadi 10.0.17763.0.

  2. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget. Proses ini terdiri dari menghapus instalasi referensi paket Project Reunion yang ada dari .csproj/.vcxproj file dan .wapproj , lalu menginstal referensi paket ke file-file tersebut.WindowsAppSDK

  3. Masukkan perintah berikut untuk menghapus instalan paket yang ProjectReunion ada dari Anda .csproj/.vcxproj

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

  4. Kemudian, jalankan hal berikut untuk menghapus instalan ProjectReunion paket yang ada dari :.wapproj

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

  5. Sekarang jalankan perintah untuk menginstal paket stabil WindowsAppSDK .

  6. Untuk menambahkan WindowsAppSDK referensi paket ke/.csproj.vcxproj :

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

  7. Untuk menambahkan WindowsAppSDK referensi paket ke .wapproj:

    install-package Microsoft.WindowsAppSDK -Version 1.0.0

Pembaruan dari Pratinjau 0.8 atau 0.8 ke 1.0 Eksperimental atau Pratinjau 3

Penting

Pratinjau 1.0 versi 1 dan Pratinjau 2 berisi bug penting. Jika Anda telah menginstal salah satu pratinjau ini, lihat Masalah penting yang memengaruhi 1.0 Pratinjau 1 dan Pratinjau 2. Sebaiknya gunakan Versi 1.0 Pratinjau 3 (1.0.0-preview3) sebagai gantinya.

Jika Anda membuat proyek menggunakan Pratinjau versi 0.8 atau versi 0.8 apa pun (misalnya, versi 0.8.1), Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke Pratinjau 1.0 3 atau Rilis eksperimental.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut untuk 1.0 Pratinjau 3:

    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}

    Atau perintah berikut untuk 1.0 Eksperimental:

    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. Buat perubahan berikut dalam Aplikasi Anda (paket).wapproj:

    1. Hapus grup item ini (jika Anda memperbarui dari versi yang berbeda dari 0.8.0, Anda akan melihat bahwa nomor versi terkait yang direferensikan dalam grup item ini):

      <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. Tambahkan grup item ini untuk menggantinya dengan Pratinjau 1.0 3:

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

      Atau grup item ini untuk menggantinya dengan 1.0 Eksperimental:

      <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. Buat perubahan berikut pada file proyek Anda (.csproj atau .vcproj):

    1. Hapus grup item ini (jika Anda memperbarui dari versi yang berbeda dari 0.8.0, Anda akan melihat bahwa nomor versi terkait yang direferensikan dalam grup item ini):

      <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. Tambahkan grup item ini untuk menggantinya dengan Pratinjau 1.0 3:

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

      Atau grup item ini untuk menggantinya dengan 1.0 Eksperimental:

      <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. Jika solusi Anda gagal membangun, bersihkan output build, mulai ulang Visual Studio, dan coba jalankan kembali aplikasi.

Perbarui dari Pratinjau 0,8 ke 0,8 atau antara versi 0,8 yang stabil

Jika Anda membuat proyek menggunakan Pratinjau versi 0.8, Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke versi stabil 0.8. Instruksi ini juga berlaku jika Anda telah membuat proyek dengan versi stabil 0.8 yang lebih lama (misalnya, 0.8.0) dan ingin memperbarui proyek Anda ke versi stabil yang lebih baru (misalnya, 0.8.2).

Catatan

Anda mungkin dapat memperbarui proyek secara otomatis melalui Visual Studio Extension Manager, tanpa melalui langkah-langkah manual di bawah ini. Di Visual Studio 2019, klik Ekstensi>Kelola Ekstensi dan pilih Pembaruan dari bilah menu sebelah kiri. Pilih "Reuni Proyek" dari daftar dan klik Perbarui.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut:

    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. Buat perubahan berikut dalam Aplikasi Anda (paket).wapproj:

    1. Hapus grup item ini (jika Anda memperbarui dari versi yang berbeda dari Pratinjau 0.8, Anda akan melihat bahwa nomor versi terkait yang direferensikan dalam grup item ini):

      <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. Tambahkan grup item ini untuk menggantinya:

      <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. Buat perubahan berikut pada file proyek Anda (.csproj atau .vcproj):

    1. Hapus grup item ini (jika Anda memperbarui dari versi yang berbeda dari Pratinjau 0.8, Anda akan melihat bahwa nomor versi terkait yang direferensikan dalam grup item ini): 
      <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. Tambahkan grup item ini untuk menggantinya: 
      <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. Jika solusi Anda gagal membangun, bersihkan output build, mulai ulang Visual Studio, dan coba jalankan kembali aplikasi.

Pembaruan dari 0.5 ke 0.8

Jika Anda membuat proyek menggunakan versi 0.5 stabil, Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke versi 0.8 stabil.

Catatan

Anda mungkin dapat memperbarui proyek secara otomatis melalui Visual Studio Extension Manager, tanpa melalui langkah-langkah manual di bawah ini. Di Visual Studio 2019, klik Ekstensi>Kelola Ekstensi dan pilih Pembaruan dari bilah menu sebelah kiri. Pilih "Reuni Proyek" dari daftar dan klik Perbarui.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut:

    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. Tambahkan baris berikut ke file proyek Anda (.csproj atau .vcproj), di dalam file pertama <PropertyGroup>:

    <UseWinUI>true</UseWinUI>

  4. Buat perubahan berikut dalam Aplikasi Anda (paket).wapproj:

    1. Tambahkan bagian ini:

      <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. Temukan baris berikut:

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

      Pindahkan baris ini dan letakkan pada baris baru tepat di bawah <TargetPlatformVersion> tag.

    3. Hapus grup item ini (jika Anda memperbarui dari versi yang lebih lama dari 0.5.7, Anda akan melihat nomor versi sebelumnya yang direferensikan dalam grup item ini):

      <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. Jika solusi Anda gagal membangun, bersihkan output build, mulai ulang Visual Studio, dan coba jalankan kembali aplikasi.

Perbarui dari Pratinjau 0.5 ke Pratinjau 0.8

Jika Anda membuat proyek menggunakan pratinjau versi 0.5, Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda untuk menggunakan pratinjau versi 0.8.

Catatan

Anda mungkin dapat memperbarui proyek secara otomatis melalui Visual Studio Extension Manager, tanpa melalui langkah-langkah manual di bawah ini. Di Visual Studio 2019, klik Ekstensi>Kelola Ekstensi dan pilih Pembaruan dari bilah menu sebelah kiri. Pilih "Reuni Proyek" dari daftar dan klik Perbarui.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

  • Templat proyek default untuk aplikasi C++ dan C# menyertakan baris berikut. Peristiwa Application.Suspending ini tidak lagi dipanggil untuk aplikasi desktop, jadi pastikan untuk menghapus baris ini (dan penggunaan lain dari peristiwa ini) jika masih ada dalam kode Anda:

    this.Suspending += OnSuspending;

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

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut:

    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. Buat perubahan berikut dalam Aplikasi Anda (paket).wapproj:

    1. Tambahkan bagian ini:

      <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. Tambahkan baris berikut ke baris baru tepat di <TargetPlatformVersion> bawah tag.

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

    3. Hapus baris ini:

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

      Dan baris-baris ini:

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

      Dan grup item ini:

      <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. Buat perubahan berikut pada file proyek Anda (.csproj atau .vcproj):

    1. Hapus grup item ini:

      <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. Tambahkan grup item ini:

      <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. Jika solusi Anda gagal membangun, bersihkan output build, mulai ulang Visual Studio, dan coba jalankan kembali aplikasi.

Pembaruan dari Pratinjau 0.5 ke 0.5

Jika Anda membuat proyek menggunakan pratinjau versi 0.5, Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke versi stabil 0.5.7.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • [Hanya aplikasi desktop] Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

  • Templat proyek default untuk aplikasi C++ dan C# menyertakan baris berikut. Peristiwa Application.Suspending ini tidak lagi dipanggil untuk aplikasi desktop, jadi pastikan untuk menghapus baris ini (dan penggunaan lain dari peristiwa ini) jika masih ada dalam kode Anda:

    this.Suspending += OnSuspending;

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

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut:

    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. Jika Anda memiliki aplikasi UWP, proses pembaruan Anda harus selesai pada tahap ini. Jika Anda memiliki aplikasi desktop, buat perubahan berikut di Aplikasi Anda (paket).wapproj:

    1. Tambahkan bagian ini:

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

    2. <TargetPlatformVersion> Temukan tag, dan tambahkan yang berikut ini pada baris baru tepat di bawah tag tersebut

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

    3. Hapus baris ini:

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

      Dan baris-baris ini:

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

      Dan grup item ini:

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

Pembaruan dari WinUI 3 Pratinjau 4 ke 0,5

Jika Anda membuat aplikasi desktop menggunakan WinUI 3 Preview 4, Anda dapat mengikuti instruksi ini untuk memperbarui proyek Anda ke Project Reunion 0.5.

Sebelum memulai, pastikan Anda telah menginstal semua prasyarat SDK Aplikasi Windows, termasuk paket VSIX dan NuGet terbaru. Untuk detail selengkapnya, lihat Menginstal alat untuk SDK Aplikasi Windows.

Pertama, lakukan hal berikut:

  • Dalam file .wapproj, jika TargetPlatformMinVersion Anda lebih lama dari 10.0.17763.0, ubah menjadi 10.0.17763.0.

  • Templat proyek default untuk aplikasi C++ dan C# menyertakan baris berikut. Peristiwa Application.Suspending ini tidak lagi dipanggil untuk aplikasi desktop, jadi pastikan untuk menghapus baris ini (dan penggunaan lain dari peristiwa ini) jika masih ada dalam kode Anda:

    this.Suspending += OnSuspending;

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

Selanjutnya, buat perubahan ini pada proyek Anda:

  1. Di Visual Studio, buka Alat>Konsol Manajer Paket Manajer>Paket Nuget.

  2. Masukkan perintah berikut:

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

  3. Buat perubahan berikut dalam Aplikasi Anda (paket).wapproj:

    1. Tambahkan bagian ini:

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

    2. Hapus baris berikut:

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

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

  4. Hapus file yang Microsoft.WinUI.AppX.targets ada di bawah folder {YourProject}(package)/build/proyek Anda.