Maui

.NET MAUI Community Toolkit

Das .NET MAUI Community Toolkit ist eine Sammlung gemeinsamer Elemente für die Entwicklung mit .NET MAUI, die Entwickler dazu neigen, über mehrere Apps hinweg zu replizieren. Es vereinfacht und demonstriert gemeinsame Entwickleraufgaben beim Erstellen von Apps mit .NET MAUI.

Alle Funktionen werden von Ihnen, unserer erstaunlichen .NET -Community, beigetragen und von einer Kernmenge von Wartenden gepflegt.

Und - das Beste daran - die Funktionen, die Sie dem .NET MAUI -Toolkit hinzufügen, können eines Tages in die offizielle .net -Maui -Bibliothek aufgenommen werden! Wir nutzen die Community -Toolkits, um neue Funktionen zu debütieren und eng mit dem .NET MAUI Engineering Team zusammenzuarbeiten, um Funktionen für die Werbung zu nominieren.

Dokumentation

Alle Dokumentationen für CommunityToolkit.Maui finden Sie hier auf Microsoft Learn:

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

Erste Schritte

Um das .NET MAUI Community Toolkit zu verwenden, müssen Sie die Erweiterungsmethode in Ihrer Datei MauiProgram.cs wie folgt aufrufen:

 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 ( ) ;
	}
}

XAML -Verwendung

Um das Toolkit in XAML zu verwenden, können Sie diesen Namespace verwenden:

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

Roadmap / Plan

Alle Arbeiten am Toolkit erfolgen dies von der Community und den Kernbädern in unserer Freizeit in Nächten und Wochenenden. Aus diesem Grund haben wir keinen konkreten Plan, wenn Funktionen hinzugefügt und geliefert werden. Was wir haben, ist eine Liste von Vorschlägen und ein Projektausschuss, das sie zusammenfasst. Bitte sehen Sie sich an und springen Sie ein, um alle Hilfe zu bieten, die Sie für möglich halten.

Senden einer neuen Funktion

Neue Funktionen folgen dem folgenden Workflow, der in den folgenden Schritten ausführlicher beschrieben wird

1. Diskussion begann

Die Debatte über neue Maui -Toolkit -Funktionen findet in Form von Diskussionen in diesem Repo statt.

Wenn Sie eine Funktion vorschlagen möchten, diskutieren Sie aktuelle Entwurfsnotizen oder Vorschläge usw., eröffnen Sie bitte ein neues Diskussionsthema.

Diskussionen, die kurz sind und zum Thema bleiben, werden viel wahrscheinlicher gelesen. Wenn Sie die Nummer fünfzig Kommentare hinterlassen, werden die Chancen wahrscheinlich nur wenige Personen lesen. Um Diskussionen leichter zu navigieren und davon zu profitieren, beachten Sie bitte einige Faustregeln:

• Die Diskussion sollte für das .NET MAUI -Toolkit relevant sein. Wenn dies nicht der Fall ist, werden sie kurzerhand geschlossen.
• Wählen Sie ein beschreibendes Thema, das den Diskussionsumfang klar kommuniziert.
• Halten Sie sich an das Thema der Diskussion. Wenn ein Kommentar tangential ist oder auf ein subtopisches Detail eingeht, starten Sie eine neue Diskussion und verbinden Sie sich zurück.
• Ist Ihr Kommentar für andere nützlich, um zu lesen, oder kann er mit einer Emoji -Reaktion auf einen vorhandenen Kommentar angemessen ausgedrückt werden?

2. Vorschlag eingereicht

Sobald Sie einen voll ausgestatteten Vorschlag haben, der eine neue Funktion in syntaktischen und semantischen Details beschreibt, öffnen Sie bitte ein Problem dafür, und es wird als Vorschlag bezeichnet. Der Kommentar -Thread zu diesem Thema kann verwendet werden, um Details des Vorschlags auszuschließen oder kurz zu diskutieren, sowie Vor- und Nachteile der Übernahme in das .NET MAUI -Toolkit. Wenn ein Problem nicht der Messlatte eines vollständigen Vorschlags entspricht, können wir es zu einer Diskussion verschieben, damit es weiter reift werden kann. Spezifische offene Probleme oder eine expansivere Diskussion mit einem Vorschlag garantieren häufig die Öffnung einer Nebendiskussion, anstatt den Kommentarbereich zu diesem Thema zu überfüllen.

3. Vorschlag

Wenn ein Mitglied des .Net Maui Toolkit Core -Teams feststellt, dass ein Vorschlag eine Werbung für das Toolkit verdient, können sie sich dafür einsetzen, was bedeutet, dass sie ihn in den monatlichen Maui -Toolkit -Community -Standup bringen.

4. Vorschlag genehmigt

Das Core -Team von .NET Maui Toolkit wird gemeinsam an der Annahme und/oder Änderung des Vorschlags stimmen, wobei eine Mehrheitsgenehmigung (dh mehr als 50%) zum Toolkit hinzugefügt werden muss.

Sobald ein Vorschlag einverstanden ist und vom .NET MAUI -Toolkit -Core -Team mehrheitlich zugelassen wurde, kann eine Pull -Anfrage eröffnet werden.

5. Anfrage genehmigt Anfrage genehmigt

Nachdem ein Pull -Antrag gestellt wurde, wird sie vom Vorschlag -Champion überprüft und genehmigt.

Für jede neue Funktion muss auch eine zugehörige Probe in die .NET MAUI -Toolkit -Beispiel -App hinzugefügt werden.

6. Dokumentation vollständig

Bevor eine Pull -Anfrage in das .NET MAUI -Toolkit zusammengefasst werden kann, muss der Pull -Request -Autor die Dokumentation auch an das Dokumentationsrepository einreichen.

7. abgeschlossen

Sobald eine Pull -Anfrage überprüft wurde + genehmigt und die Dokumentation geschrieben, eingereicht und genehmigt wurde, wird die neue Funktion zusammengeführt, um sie dem .NET MAUI -Toolkit hinzuzufügen

Verhaltenskodex

Als Teil der .NET Foundation haben wir den Verhaltenskodex der .NET Foundation übernommen. Bitte machen Sie sich damit vertraut, bevor Sie mit diesem Repository teilnehmen. Danke!

.NET Foundation

Dieses Projekt wird von der .NET Foundation unterstützt.