Memulai 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 UseMauiCommunityToolkit , metode harus dipanggil pada MauiAppBuilder kelas saat bootstrapping aplikasi 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.

CommunityToolkit.Maui.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 UseMauiCommunityToolkitMarkup , metode harus dipanggil pada MauiAppBuilder kelas saat bootstrapping aplikasi 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.

CommunityToolkit.Maui.Maps

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

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 metode dengan Map benar .UseMauiCommunityToolkitMaps harus dipanggil pada MauiAppBuilder kelas saat bootstrapping aplikasi file 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.

CommunityToolkit.Maui.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 metode dengan MediaElement benar UseMauiCommunityToolkitMediaElement harus dipanggil pada MauiAppBuilder kelas saat bootstrapping aplikasi file MauiProgram.cs . Contoh berikut menunjukkan cara melakukan ini.

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

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

CommunityToolkit.Maui.Camera

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, UseMauiCommunityToolkitCamera metode harus dipanggil pada MauiAppBuilder kelas saat 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!