Maui

.Net Maui Community Toolkit

Toolkit Komunitas .NET Maui adalah kumpulan elemen umum untuk pengembangan dengan .NET Maui yang cenderung direplikasi oleh pengembang di beberapa aplikasi. Ini menyederhanakan dan menunjukkan tugas pengembang umum saat membangun aplikasi dengan .net Maui.

Semua fitur dikontribusikan oleh Anda, komunitas .NET kami yang luar biasa, dan dikelola oleh serangkaian inti pengelola.

Dan - bagian terbaik - fitur yang Anda tambahkan ke .Net Maui Toolkit suatu hari nanti dapat dimasukkan ke dalam Perpustakaan .NET Maui resmi! Kami memanfaatkan toolkit komunitas untuk debut fitur baru dan bekerja sama dengan tim teknik .NET Maui untuk mencalonkan fitur untuk promosi.

Dokumentasi

Semua dokumentasi untuk CommunityToolkit.Maui dapat ditemukan di sini di Microsoft Learn:

https://learn.microsoft.com/dotnet/communitytoolkit/maui/get-started

Memulai

Untuk menggunakan perangkat komunitas .net Maui, Anda perlu memanggil metode ekstensi dalam file MauiProgram.cs Anda sebagai berikut:

 using CommunityToolkit . Maui ;

public static class MauiProgram
{
	public static MauiApp CreateMauiApp ( )
	{
		var builder = MauiApp . CreateBuilder ( ) ;
		builder
			. UseMauiApp < App > ( )
			// Initialize the .NET MAUI Community Toolkit by adding the below line of code
			. UseMauiCommunityToolkit ( )
			// After initializing the .NET MAUI Community Toolkit, optionally add additional fonts
			. ConfigureFonts ( fonts =>
			{
				fonts . AddFont ( "OpenSans-Regular.ttf" , "OpenSansRegular" ) ;
				fonts . AddFont ( "OpenSans-Semibold.ttf" , "OpenSansSemibold" ) ;
			} ) ;

		// Continue initializing your .NET MAUI App here

		return builder . Build ( ) ;
	}
}

Penggunaan XAML

Untuk memanfaatkan toolkit dalam XAML, Anda dapat menggunakan namespace ini:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Roadmap / Plan

Semua pekerjaan yang dilakukan pada toolkit dilakukan oleh masyarakat dan pengelola inti di waktu luang kami di malam hari dan akhir pekan. Karena alasan ini kami tidak memiliki rencana konkret ketika fitur akan ditambahkan dan dikirim. Yang kami miliki adalah daftar proposal dan dewan proyek yang merangkum mereka menyatakan. Jangan ragu untuk memeriksanya dan melompat untuk memberikan bantuan apa pun yang Anda rasa bisa.

Mengirimkan fitur baru

Fitur baru akan mengikuti alur kerja di bawah ini, dijelaskan secara lebih rinci dalam langkah -langkah di bawah ini

1. Diskusi dimulai

Debat yang berkaitan dengan fitur Maui Toolkit baru terjadi dalam bentuk diskusi dalam repo ini.

Jika Anda ingin menyarankan fitur, diskusikan catatan atau proposal desain saat ini, dll., Buka topik diskusi baru.

Diskusi yang pendek dan tetap pada topik jauh lebih mungkin dibaca. Jika Anda meninggalkan nomor komentar Fifty, kemungkinan hanya beberapa orang yang akan membacanya. Untuk membuat diskusi lebih mudah dinavigasi dan mendapat manfaat, harap amati beberapa aturan praktis:

• Diskusi harus relevan dengan .NET Maui Toolkit. Jika tidak, mereka akan ditutup.
• Pilih topik deskriptif yang dengan jelas mengomunikasikan ruang lingkup diskusi.
• Tetap berpegang pada topik diskusi. Jika sebuah komentar tangensial, atau dirinci pada subtopik, mulailah diskusi baru dan tautkan kembali.
• Apakah komentar Anda berguna untuk dibaca orang lain, atau dapatkah diekspresikan secara memadai dengan reaksi emoji terhadap komentar yang ada?

2. Proposal diajukan

Setelah Anda memiliki proposal yang sepenuhnya disempurnakan yang menggambarkan fitur baru dalam detail sintaksis dan semantik, silakan buka masalah untuk itu, dan itu akan diberi label sebagai proposal. Utas komentar tentang masalah ini dapat digunakan untuk hash atau membahas rincian proposal secara singkat, serta pro dan kontra dari mengadopsinya ke dalam toolkit .NET Maui. Jika suatu masalah tidak memenuhi bilah menjadi proposal penuh, kami dapat memindahkannya ke diskusi, sehingga dapat lebih matang. Masalah terbuka khusus atau diskusi yang lebih luas dengan proposal akan sering menjamin membuka diskusi sampingan daripada mengacaukan bagian komentar tentang masalah ini.

3. Proposal diperjuangkan

Ketika anggota tim inti .NET Maui Toolkit menemukan bahwa proposal pantas dipromosikan ke toolkit, mereka dapat memperjuangkannya, yang berarti bahwa mereka akan membawanya ke standup komunitas .NET Maui Toolkit bulanan.

4. Proposal disetujui

Tim inti .NET Maui Toolkit akan secara kolektif memilih untuk bekerja mengadopsi dan/atau memodifikasi proposal, membutuhkan persetujuan mayoritas (yaitu lebih dari 50%) untuk ditambahkan ke toolkit.

Setelah proposal telah diperjuangkan dan telah menerima persetujuan mayoritas dari tim inti .NET Maui Toolkit, permintaan tarik dapat dibuka.

5. Permintaan Tarik Disetujui

Setelah permintaan tarik diajukan, itu akan ditinjau dan disetujui oleh juara proposal.

Setiap fitur baru juga memerlukan sampel terkait untuk ditambahkan ke aplikasi sampel .NET Maui Toolkit.

6. Dokumentasi Lengkap

Sebelum permintaan tarik dapat digabungkan ke dalam toolkit .net Maui, penulis permintaan tarik juga harus mengirimkan dokumentasi ke repositori dokumentasi.

7. Selesai

Setelah permintaan tarik telah ditinjau + disetujui dan dokumentasi telah ditulis, diserahkan dan disetujui, fitur baru akan digabungkan menambahkannya ke toolkit .net Maui

Kode Etik

Sebagai bagian dari .NET Foundation, kami telah mengadopsi kode perilaku .NET Foundation. Harap biasakan diri Anda dengan itu sebelum berpartisipasi dengan repositori ini. Terima kasih!

.NET Foundation

Proyek ini didukung oleh .NET Foundation.