Bagikan melalui

Menggunakan SDK Aplikasi Windows dalam proyek yang sudah ada

  • Artikel

Jika Anda memiliki proyek desktop tempat Anda ingin menggunakan SDK Aplikasi Windows, maka Anda dapat menginstal paket nuGet SDK Aplikasi Windows di proyek Anda (versi terbaru, atau versi apa pun yang Anda butuhkan). Aplikasi yang tidak dikemas (yaitu, aplikasi yang tidak menggunakan MSIX untuk teknologi penyebarannya) harus mengikuti prosedur ini jika mereka menggunakan SDK Aplikasi Windows. Tetapi aplikasi kemasan juga dapat melakukannya.

Penting

Jika Anda sedang mengerjakan aplikasi UWP, lihat Migrasi dari UWP ke SDK Aplikasi Windows.

Catatan

Prosedur ini didukung dalam proyek C# .NET 6 (dan yang lebih baru) dan proyek desktop C++. Jenis proyek tersebut dapat menggunakan paket NuGet dari saluran rilis stabil, saluran rilis pratinjau, atau saluran rilis eksperimental.

Prasyarat

Petunjuk

  1. Buka proyek yang sudah ada di Visual Studio.

    Catatan

    Jika Anda memiliki proyek desktop C#, pastikan bahwa elemen TargetFramework dalam file proyek diatur ke moniker khusus Windows 10 (seperti net6.0-windows10.0.19041.0) sehingga Anda dapat memanggil WINDOWS Runtime API. Untuk informasi selengkapnya, lihat Memanggil WINDOWS Runtime API di aplikasi desktop. Selain itu, Anda harus menargetkan 18362 atau yang lebih baru, karena ada masalah yang diketahui memblokir aplikasi yang menargetkan 17763 (lihat Kesalahan build saat menggunakan TFM 17763 di GitHub).

  2. Pastikan referensi paket diaktifkan:

    1. Di Visual Studio, klik Alat>NuGet Package Manager>Package Manager Settings.
    2. Pastikan packageReference dipilih untuk Format manajemen paket default.

  3. Klik kanan proyek Anda di Penjelajah Solusi lalu pilih Kelola Paket NuGet.

  4. Di jendela Manajer Paket NuGet, pilih kotak centang Sertakan prarilis di dekat bagian atas jendela, pilih tab Telusuri , dan cari salah satu paket berikut ini:

    • Untuk menginstal salah satu rilis 1.0 atau yang lebih baru, cari paket Microsoft.WindowsAppSDK.
    • Untuk menginstal salah satu rilis 0.8, cari paket Microsoft.ProjectReunion .

  5. Setelah Anda menemukan paket NuGet SDK Aplikasi Windows yang sesuai, pilih paket, dan klik Instal di panel kanan jendela Manajer Paket NuGet.

    Cuplikan layar paket NuGet SDK Aplikasi Windows sedang diinstal

    Catatan

    Paket SDK Aplikasi Windows NuGet berisi sub-paket lain (termasuk Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI, dan lainnya) yang berisi implementasi untuk komponen tertentu dalam SDK Aplikasi Windows. Anda tidak dapat menginstal sub-paket ini satu per satu untuk hanya mereferensikan komponen tertentu dalam proyek Anda. Anda harus menginstal paket utama SDK Aplikasi Windows NuGet, yang mencakup semua komponen.

  6. Hanya untuk aplikasi yang tidak dikemas. Sebelum aplikasi yang tidak dikemas dapat menggunakan API dan komponen SDK Aplikasi Windows, aplikasi Anda harus terlebih dahulu memuat runtime SDK Aplikasi Windows untuk mereferensikan paket kerangka kerja SDK Aplikasi Windows. Untuk informasi selengkapnya, lihat Menggunakan runtime SDK Aplikasi Windows untuk aplikasi yang dikemas dengan lokasi eksternal atau tidak dikemas dan Tutorial: Menggunakan API bootstrapper dalam aplikasi yang dikemas dengan lokasi eksternal atau tidak dikemas yang menggunakan SDK Aplikasi Windows.

  7. Aplikasi Anda sekarang dapat menggunakan API SDK Aplikasi Windows dan komponen yang tersedia di saluran rilis yang Anda instal. Untuk daftar fitur yang tersedia, lihat saluran rilis.

Info lebih lanjut

Jika proyek yang ada adalah proyek C++, dan Anda ingin memanggil WINDOWS Runtime API di SDK Aplikasi Windows, maka Anda harus menambahkan dukungan untuk C++/WinRT. Lihat Dukungan Visual Studio untuk C++/WinRT, XAML, ekstensi VSIX, dan paket NuGet. Cari info di sana tentang paket NuGet Microsoft.Windows.CppWinRT. Tanpa paket tersebut, proyek Anda tidak akan dapat menemukan file header namespace untuk WINDOWS Runtime API di SDK Aplikasi Windows.

Jika Anda mengalami kesalahan Kelas yang tidak terdaftar saat mencoba menggunakan komponen SDK Aplikasi Windows, maka Anda mungkin harus menambahkan ke proyek Anda dependensi dinamis pada paket SDK Aplikasi Windows Framework. Untuk informasi selengkapnya, lihat Paket kerangka kerja MSIX dan dependensi dinamis.

Lihat Juga