WindowsAppSDK Samples

Contoh SDK Aplikasi Windows

Repositori ini menghosting sampel untuk Windows App SDK. Contoh untuk berbagai fitur yang dikirimkan di Windows App SDK akan ditambahkan ke repositori ini. Untuk informasi lebih lanjut tentang Windows App SDK, kunjungi Dokumentasi Windows App SDK. Untuk mempelajari lebih lanjut tentang desain Windows App SDK atau untuk berkontribusi pada proyek, membuat proposal fitur, atau memulai diskusi, kunjungi halaman GitHub Windows App SDK.

Daftar sampel

Siklus Hidup Aplikasi dan Layanan Sistem

• Siklus Hidup Aplikasi: Contoh ini mendemonstrasikan pembuatan instans aplikasi menggunakan API AppLifecycle. Fitur-fitur tersebut mencakup fitur-fitur berikut:
  • Aktivasi: Contoh ini menunjukkan dukungan untuk jenis aktivasi kaya.
  • Instancing: Sampel ini menunjukkan dukungan untuk multi-instancing tunggal dan selektif.
  • Notifikasi Daya: Contoh ini menunjukkan notifikasi status daya/sistem untuk mengelola beban kerja aplikasi.
  • Mulai ulang: Contoh ini menunjukkan memulai ulang aplikasi secara sinkron dengan argumen mulai ulang baris perintah.
  • Target Berbagi: Contoh ini menunjukkan aplikasi yang dapat diaktifkan sebagai target berbagi.

Data dan File

• Manajemen Sumber Daya: Contoh ini menunjukkan manajemen sumber daya aplikasi menggunakan MRT Core API.

Penyebaran

• Deployment Manager: Contoh ini menunjukkan cara menginisialisasi dan mengakses informasi penerapan untuk runtime Windows App SDK.
• Penginstal: Contoh ini menunjukkan cara meluncurkan penginstal Windows App SDK tanpa jendela konsol.
• Tidak dikemas: Contoh ini menunjukkan inisialisasi otomatis dengan paket Windows App SDK dari aplikasi non-MSIX (tidak dikemas).

Ketergantungan Dinamis

• DirectX: Contoh ini menunjukkan cara menggunakan API Ketergantungan Dinamis untuk memuat paket kerangka kerja MSIX DirectX Runtime secara dinamis.

Grafik

• Rendering Teks: Contoh ini adalah galeri API DWriteCore yang mendemonstrasikan rendering teks.

Pemberitahuan

• Pemberitahuan Push: Ini adalah contoh aplikasi yang menampilkan Pemberitahuan Push.
• Notifikasi Aplikasi: Ini adalah contoh aplikasi yang menampilkan Notifikasi Aplikasi.

Komponen Waktu Proses

• Kontrol Kustom: Contoh ini menunjukkan cara membuat Komponen Runtime Windows di C# dengan kontrol WinUI kustom.

Antarmuka Pengguna dan Masukan

• Windowing: Contoh ini menunjukkan cara mengelola jendela aplikasi menggunakan Windowing API.
• Galeri Input dan Komposisi Windows: Kumpulan sampel ini menampilkan Microsoft.UI.Composition dan Microsoft.UI.Input API.
• Galeri WinUI 3: Ini adalah contoh aplikasi yang menampilkan semua kontrol WinUI 3 beraksi.

Persyaratan

Sampel Windows App SDK memiliki persyaratan sistem berikut:

• Windows 10, versi 1809 (build 17763) atau lebih baru.

• Visual Studio 2022 atau Visual Studio 2019 versi 16.9 atau lebih baru, dengan beban kerja dan komponen berikut:

  • Pengembangan Platform Windows Universal
  • Pengembangan Desktop .NET (diperlukan meskipun Anda hanya membuat aplikasi C++ Win32)
  • Pengembangan desktop dengan C++ (diperlukan meskipun Anda hanya membuat aplikasi .NET)
  • Windows SDK versi 2004 (build 19041) atau lebih baru. Ini diinstal dengan Visual Studio secara default.

• Membuat sampel .NET C# dengan Windows App SDK 1.1 juga memerlukan salah satu versi .NET SDK berikut atau yang lebih baru:

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Lihat dokumen tentang persyaratan sistem dan alat untuk pengembangan aplikasi Windows untuk daftar detail persyaratan untuk mengembangkan aplikasi dengan Windows App SDK.

Menggunakan sampel

Untuk menggunakan sampel dengan Git, kloning repositori WindowsAppSDK-Samples dengan menjalankan git clone https://github.com/microsoft/WindowsAppSDK-Samples.git dari prompt perintah. Anda kemudian dapat menavigasi ke direktori sampel dan membuka file solusi di Visual Studio.

Cara termudah untuk menggunakan sampel ini tanpa Git adalah dengan mengunduh file ZIP. Pilih Unduh ZIP dari dropdown unduhan, unzip seluruh arsip dan buka sampel di Visual Studio.

Versi sampel

Sampel akan diperbarui dengan rilis GA dari Windows App SDK. Cabang main mencakup sampel terbaru, yang mungkin juga menyertakan fitur eksperimental atau pratinjau. Cabang rilis tertentu diberi nama release/xy dan berisi sampel yang mereferensikan versi GA Windows App SDK yang sesuai. Repositori ini saat ini mencakup cabang rilis berikut:

• rilis/1.0
• rilis/0.8
• rilis/0,5

Berkontribusi

Sampel ini disediakan oleh tim fitur dan kami menyambut masukan Anda mengenai masalah dan saran untuk sampel baru. Kami mendorong Anda untuk mengajukan masalah baru untuk mendapatkan masukan atau pertanyaan!

Penulis sampel harus mengikuti pedoman sampel untuk mulai mengembangkan sampelnya. Untuk sampel Windows App SDK berbasis WinUI, gunakan templat sampel. File VSIX tersedia untuk diunduh di halaman rilis Github di sini.

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi lebih lanjut, lihat FAQ Pedoman Perilaku atau hubungi [email protected] jika ada pertanyaan atau komentar tambahan.

Setelah aplikasi sampel baru ditambahkan, pengembang Microsoft harus mempertimbangkan untuk memperbarui alur Agregator internal ke:

• Aktifkan pembuatan aplikasi sampel baru secara rutin.
• Tambahkan kasus uji baru ke driver uji SampleTests TAEF yang ada untuk memverifikasi keberhasilan peluncuran aplikasi sampel secara berkala terhadap versi Windows App SDK terbaru.

Lihat dokumentasi pada repositori Agregator internal untuk mendapatkan petunjuk, di Tahapan BuildSampleApps dan TestSampleApps.