Mengembangkan Widget dan Dasbor Windows

Widgets

Windows widget adalah kontainer UI kecil yang terkait dengan aplikasi yang diinstal. Papan Widget menampilkannya dalam kisi di atas desktop Windows, dengan konten yang dipersonalisasi dan tindakan cepat dari aplikasi Anda. Anda dapat mendefinisikan konten dengan Kartu Adaptif, yang mengikat data ke templat JSON, atau menampilkan HTML dari URL dengan penyedia widget web. Widget web masih menggunakan payload JSON Kartu Adaptif untuk menentukan URL konten.

Untuk panduan desain, lihat gambaran umum desain Windows Widget.

Pilih jalur pengembangan widget

Gunakan tabel ini untuk memilih jalur implementasi dan topik berikutnya untuk dibuka.

Jika Anda ingin...	Gunakan pendekatan ini	Mulai di sini
Menambahkan widget Kartu Adaptif ke aplikasi desktop C# terpaket	Terapkan IWidgetProvider, kirim templat dan pembaruan data dengan WidgetManager, dan daftarkan penyedia melalui manifes paket.	Panduan langkah demi langkah penyedia widget C#
Menambahkan widget Kartu Adaptif ke aplikasi desktop C++/WinRT yang dipaketkan	Terapkan IWidgetProvider di server COM di luar proses dan daftarkan CLSID-nya serta definisi widget-nya dalam manifes paket.	Panduan penyedia widget C++/WinRT
Menampilkan HTML dari URL di dalam widget desktop	Gunakan penyedia widget web. Fitur ini hanya tersedia untuk pengguna di EEA. Penyedia masih mengirim payload Kartu Adaptif yang berisi URL web dan konten fallback.	Penyedia widget web
Menambahkan widget untuk Progressive Web App (PWA) yang sudah ada	Tentukan widget dalam manifes aplikasi web dan tangani peristiwa widget di pekerja layanan. Ini terpisah dari jalur IWidgetProvider desktop.	Membuat widget berbasis PWA
Menangani aksi tombol atau formulir di penyedia desktop Anda	Gunakan Action.Execute dan tangani verb di OnActionInvoked. Perlihatkan hanya jika $host.isUserContextAuthenticated benar.	Membuat templat widget
Buka halaman aplikasi atau situs web tanpa callback penyedia	Gunakan Action.OpenUrl. Ini tetap tersedia ketika konteks pengguna widget tidak diautentikasi.	Buat templat widget
Mengizinkan pengguna mengonfigurasi widget	Terapkan IWidgetProvider2, atur atribut IsCustomizable manifes, dan berikan payload kustomisasi.	Menyesuaikan widget
Menyesuaikan konten untuk ukuran, tema, pengaturan, header, dukungan web, atau autentikasi	Gunakan properti Windows $host dalam templat Kartu Adaptif dan nyatakan setiap ukuran yang didukung dalam manifes paket.	Properti host widget Windows
Perlihatkan konten pemuatan atau konten saat keluar dari akun	Kirim templat dan data fallback yang disengaja. Atur IsPlaceholderContent saat konten belum dipersonalisasi atau siap digunakan.	Penyedia widget
Menambahkan umpan dasbor alih-alih widget individual	Implementasikan feed provider. Penyedia umpan adalah integrasi terpisah dan hanya tersedia di EEA.	Dasbor dan penyedia umpan
Minta GitHub Copilot untuk membuat dan memvalidasi widget	Gunakan prompt yang dapat digunakan kembali, yang memilih jalur yang didukung dan memerlukan validasi paket, manifes, build, dan Widgets Board.	Buat widget Windows dengan GitHub Copilot

Dashboards

Provider feed mendaftarkan umpan konten yang muncul sebagai dasbor di Papan Widget. Penyedia umpan adalah integrasi terpisah dari penyedia widget; menampilkan HTML di dalam widget tidak mendaftarkan umpan dasbor.

Important

Penyedia umpan hanya tersedia untuk pengguna di Wilayah Ekonomi Eropa (EEA). Untuk persyaratan ketersediaan dan implementasi, lihat Dasbor dan penyedia umpan.

Di bagian ini

Topik	Deskripsi
Penyedia konten	Pelajari cara mendaftarkan umpan konten aplikasi Anda agar muncul langsung di Papan Widget Windows.
Penyedia widget	Pelajari cara menerapkan penyedia widget yang menyediakan konten, tata letak, dan elemen interaktif untuk widget Anda.
Penyedia widget web	Tampilkan HTML dalam widget dan tangani permintaan sumber daya dan pesan antara penyedia Anda dan konten web Anda.
Kartu Adaptif Designer	Pelajari cara membuat templat widget menggunakan Kartu Adaptif Designer.
Buat widget Windows dengan GitHub Copilot	Gunakan prompt yang dapat digunakan kembali untuk menghasilkan, mengemas, dan memvalidasi widget di repositori yang ada.