Memulai dengan Toolkit Komunitas .NET Multi-platform App UI (.NET MAUI)

Artikel ini membahas cara mulai menggunakan paket yang disediakan sebagai bagian dari proyek Toolkit Komunitas MAUI .NET.

Menambahkan paket NuGet

Toolkit tersedia sebagai sekumpulan paket NuGet yang dapat ditambahkan ke proyek yang sudah ada atau baru menggunakan Visual Studio.

1. Buka proyek yang sudah ada, atau buat proyek baru sesuai dokumentasi penyiapan .NET MAUI

2. Di panel Penjelajah Solusi, klik kanan pada nama proyek Anda dan pilih Kelola Paket NuGet. Cari CommunityToolkit.Maui, dan pilih Paket NuGet yang diinginkan dari daftar.

   

3. Pilih toolkit yang paling sesuai untuk kebutuhan Anda dari opsi di bawah ini:

CommunityToolkit.Maui

Paket ini adalah kumpulan Animasi, Perilaku, Konverter, dan Tampilan Kustom untuk pengembangan dengan .NET MAUI. Ini menyederhanakan dan menunjukkan tugas pengembang umum yang membangun aplikasi iOS, Android, macOS, dan Windows dengan .NET MAUI.

Nama paket:CommunityToolkit.Maui

URL paket:https://www.nuget.org/packages/CommunityToolkit.Maui

Menginisialisasi paket

Pertama, pernyataan penggunaan perlu ditambahkan ke bagian atas file MauiProgram.cs Anda

using CommunityToolkit.Maui;

Untuk menggunakan toolkit dengan benar, metode UseMauiCommunityToolkit harus dipanggil pada kelas MauiAppBuilder saat melakukan bootstrapping aplikasi pada file MauiProgram.cs. Contoh berikut menunjukkan cara melakukan ini.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

Untuk menggunakan fitur toolkit, lihat halaman dokumentasi untuk setiap fitur tertentu.

Markup

Paket ini adalah serangkaian metode dan kelas pembantu yang fasih untuk menyederhanakan pembangunan antarmuka pengguna .NET MAUI deklaratif di C#.

Nama paket:CommunityToolkit.Maui.Markup

URL paket:https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Menginisialisasi paket

Pertama, pernyataan penggunaan perlu ditambahkan ke bagian atas file MauiProgram.cs Anda

using CommunityToolkit.Maui.Markup;

Untuk menggunakan toolkit dengan benar, metode UseMauiCommunityToolkitMarkup harus dipanggil pada kelas MauiAppBuilder saat mem-bootstrapping aplikasi di file MauiProgram.cs. Contoh berikut menunjukkan cara melakukan ini.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMarkup()

Untuk menggunakan fitur toolkit, lihat halaman dokumentasi untuk setiap fitur tertentu.

Peta

Paket ini memungkinkan Anda menampilkan peta di aplikasi Windows .NET MAUI Anda.

Penting

Bing Maps telah berhenti memberikan kunci API baru yang diperlukan agar kontrol ini berfungsi. Saat ini kami memutuskan apakah kami harus memperbarui kontrol ini untuk menggunakan kontrol WinUI yang menggunakan Azure Maps atau bahwa kami akan menunggu implementasi resmi .NET MAUI pihak pertama untuk ini. Untuk saat ini, Anda tidak dapat menggunakan kontrol ini jika Anda belum memiliki kunci Bing Maps API. Bing Maps secara keseluruhan akan dihentikan sepenuhnya pada 30 Juni 2025.

Nama paket:CommunityToolkit.Maui.Maps

URL paket:https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Menginisialisasi paket

Pertama, pernyataan penggunaan perlu ditambahkan ke bagian atas file MauiProgram.cs Anda

using CommunityToolkit.Maui.Maps;

Untuk menggunakan Map dengan benar, metode .UseMauiCommunityToolkitMaps harus dipanggil pada kelas MauiAppBuilder saat menginisialisasi aplikasi, berkas MauiProgram.cs. Metode ini mengharapkan kunci Bing Maps API yang valid yang dapat Anda peroleh melalui Portal Bing Maps.

Contoh berikut menunjukkan cara melakukan ini.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")

Saat menggunakan Peta Toolkit Komunitas .NET MAUI untuk Windows dan Peta MAUI .NET reguler bersama-sama, Anda harus memastikan bahwa setiap panggilan inisialisasi hanya dilakukan untuk platform yang relevan. Contoh berikut menunjukkan cara melakukannya.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

Untuk informasi selengkapnya tentang cara menginisialisasi peta di iOS dan Android, serta cara bekerja dengan API kontrol peta, lihat dokumentasi .NET MAUI Maps.

MediaElement

Paket ini memungkinkan Anda memutar audio dan video di aplikasi .NET MAUI Anda.

Nama paket:CommunityToolkit.Maui.MediaElement

URL paket:https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Menginisialisasi paket

Pertama, pernyataan penggunaan perlu ditambahkan ke bagian atas file MauiProgram.cs Anda

using CommunityToolkit.Maui;

Untuk menggunakan MediaElement dengan benar, metode UseMauiCommunityToolkitMediaElement harus dipanggil pada kelas MauiAppBuilder saat menginisialisasi aplikasi, berkas MauiProgram.cs. Contoh berikut menunjukkan cara melakukan ini. Anda harus menentukan apakah akan mengaktifkan layanan latar depan di Android dengan mengatur enableForegroundService parameter ke true atau false. Jika Anda memerlukan Pemberitahuan Media Kaya atau pemutaran latar belakang di Android, atur enableForegroundService ke true saat memanggil UseMauiCommunityToolkitMediaElement.

Catatan: MediaElement tidak memerlukan penambahan izin tambahan AndroidManifest.xml untuk layanan latar depan. Memanggil metode penyusun dengan enableForegroundService: true cukup untuk mengaktifkan fitur pemberitahuan dan pemutaran latar belakang. Ketika enableForegroundService adalah true, toolkit akan secara otomatis menambahkan entri manifes Android yang diperlukan untuk layanan latar depan dan pemberitahuan. Jika enableForegroundService adalah false dan Anda mencoba menggunakan fitur pemutaran latar belakang, Exception dapat muncul di Android.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMediaElement(enableForegroundService: true);

Untuk menggunakan fitur toolkit, lihat halaman dokumentasi untuk setiap fitur tertentu.

Kamera

Paket ini memungkinkan Anda untuk terhubung ke kamera, menampilkan pratinjau dari kamera dan mengambil foto.

Nama paket:CommunityToolkit.Maui.Camera

URL paket:https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Menginisialisasi paket

Pertama, pernyataan penggunaan perlu ditambahkan ke bagian atas file MauiProgram.cs Anda

using CommunityToolkit.Maui;

Untuk menggunakan CameraView dengan benar, metode UseMauiCommunityToolkitCamera harus dipanggil pada kelas MauiAppBuilder saat melakukan bootstrapping aplikasi file MauiProgram.cs. Contoh berikut menunjukkan cara melakukan ini.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitCamera()

Untuk menggunakan fitur toolkit, lihat halaman dokumentasi untuk setiap fitur tertentu.

Menggunakan paket NuGet

4. Aktifkan Toolkit di MauiProgram.cs:

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. Untuk pengaturan tingkat lanjut, atur CommunityToolkit.Maui.Options:

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. Lihat dokumentasi lainnya untuk mempelajari selengkapnya tentang menerapkan fitur tertentu.

Sumber daya lainnya

Repositori GitHub .NET MAUI Community Toolkit berisi kode sumber untuk aplikasi sampel yang dirancang untuk menunjukkan bagaimana Anda dapat menggunakan toolkit untuk membangun aplikasi .NET MAUI. Harap dicatat bahwa Anda akan diminta untuk mengkloning atau mengunduh repositori dan mengkompilasi kode sumber untuk menjalankan aplikasi sampel.

Kami merekomendasikan pengembang yang baru menggunakan .NET MAUI untuk mengunjungi dokumentasi .NET MAUI .

Kunjungi Repositori GitHub .NET MAUI Community Toolkit untuk melihat kode sumber saat ini, apa yang akan terjadi selanjutnya, dan kloning repositori. Kontribusi komunitas dipersilakan!