Bagikan melalui

Migrasi dari UWP ke SDK Aplikasi Windows

  • Artikel

Untuk memigrasikan aplikasi Anda dari Platform Windows Universal (UWP) ke SDK Aplikasi Windows, kode UI Anda kemungkinan hanya memerlukan beberapa perubahan namespace layanan, sementara sebagian besar kode platform Anda dapat tetap sama. Anda harus menyesuaikan beberapa kode karena perbedaan antara aplikasi UWP dan aplikasi desktop. Tetapi kami mengharapkan bahwa untuk sebagian besar aplikasi (tergantung pada ukuran basis kode, tentu saja), migrasi akan memakan waktu dalam urutan hari daripada minggu.

Catatan

Jika Anda senang dengan fungsionalitas platform UWP saat ini dan aplikasi UWP Anda, maka tidak perlu memigrasikan proyek Anda. WinUI 2 dan Windows SDK terus mendukung jenis proyek UWP.

Di bawah ini adalah langkah-langkahnya, pada tingkat tinggi, untuk bermigrasi secara manual. Tetapi lihat bagian berikut untuk informasi tentang menggunakan alat .NET Upgrade Assistant).

  1. Buat proyek desktop paket WinUI 3 baru (lihat Membuat proyek WinUI 3 pertama Anda). Itu bisa masuk ke solusi proyek Anda yang sudah ada.
  2. Salin kode XAML/UI Anda. Dalam banyak kasus, Anda cukup mengubah namespace (misalnya, Windows.UI.* ke Microsoft.UI.*).
  3. Salin kode logika aplikasi Anda. Beberapa API memerlukan tweak, seperti Popup, Pickers, dan SecondaryTiles.

Untuk detail selengkapnya, lihat topik dalam tabel di bawah ini. Mereka menjelaskan dan menunjukkan cara memigrasikan aplikasi Platform Windows Universal (UWP) Anda secara manual ke SDK Aplikasi Windows.

Perhatikan apa yang didukung saat bermigrasi dari UWP ke WinUI 3, yang menjelaskan fungsionalitas apa pun yang belum didukung di WinUI 3 dan SDK Aplikasi Windows. Jika aplikasi Anda memerlukan salah satu fitur/pustaka tersebut, maka Anda mungkin ingin mempertimbangkan untuk menunda migrasi.

Catatan

Jika kode sumber aplikasi UWP Anda ditulis dalam C++/CX, lihat Juga Pindah ke C++/WinRT dari C++/CX.

Migrasi dengan menggunakan alat .NET Upgrade Assistant

Sebagai langkah lebih lanjut dalam membantu Anda memigrasikan aplikasi UWP Anda ke SDK Aplikasi Windows dan WinUI 3, kami telah memanfaatkan Asisten Peningkatan .NET, menambahkan dukungan untuk memigrasikan aplikasi C# UWP. Dukungan UWP mengotomatiskan banyak proses migrasi. Untuk informasi selengkapnya, lihat topik Migrasi dari UWP ke SDK Aplikasi Windows dengan Asisten Peningkatan .NET.

Manfaat kontainerisasi

Saat beralih ke SDK Aplikasi Windows, aplikasi UWP mungkin kehilangan manfaat kontainerisasi yang melekat dari platform aslinya. Namun, manfaat tersebut dapat dipulihkan dengan menggunakan Isolasi Aplikasi Win32—fitur keamanan baru yang meningkatkan perlindungan dengan mengisolasi aplikasi dalam lingkungan kotak pasir. Pendekatan ini menawarkan keamanan tambahan terhadap potensi ancaman dengan perubahan minimal pada kode yang ada. Untuk informasi selengkapnya, dan untuk mulai menggunakan Isolasi Aplikasi Win32, kunjungi Selamat Datang di repositori isolasi aplikasi Win32 di GitHub.

Topik di bagian ini

Topik Deskripsi
Strategi migrasi keseluruhan Pertimbangan dan strategi untuk mendekati proses migrasi, dan cara menyiapkan lingkungan pengembangan Anda untuk migrasi.
Memetakan fitur UWP ke SDK Aplikasi Windows Topik ini membandingkan area fitur utama dalam berbagai bentuk di mana mereka muncul di UWP dan di SDK Aplikasi Windows.
Apa yang didukung Pelajari fitur apa yang saat ini tersedia di WinUI 3 Desktop untuk mengevaluasi apakah Anda harus mencoba memigrasikan aplikasi UWP Anda hari ini.
Memetakan API dan pustaka UWP ke SDK Aplikasi Windows Topik ini menyediakan pemetaan API dan pustaka UWP ke SDK Aplikasi Windows yang setara.
Panduan area fitur Kumpulan topik panduan migrasi, masing-masing berfokus pada area fitur tertentu.
Studi kasus 1—PhotoLab (C#) Topik ini adalah studi kasus tentang mengambil aplikasi sampel C# UWP PhotoLab, dan memigrasikannya ke SDK Aplikasi Windows.
Studi kasus 2—Editor Foto (C++/WinRT) Topik ini adalah studi kasus tentang mengambil aplikasi sampel C++/WinRT UWP Photo Editor, dan memigrasikannya ke SDK Aplikasi Windows.
Panduan migrasi tambahan Topik ini berisi panduan migrasi tambahan yang tidak dikategorikan ke dalam area fitur di panduan area fitur.
Migrasi dari UWP ke SDK Aplikasi Windows dengan Asisten Peningkatan .NET Asisten Peningkatan .NET adalah alat baris perintah yang dapat membantu memigrasikan aplikasi C# UWP ke aplikasi WinUI 3 yang menggunakan SDK Aplikasi Windows.

Lihat Juga