Introduzione a .NET Multipiattaforma App UI (.NET MAUI) Community Toolkit

Questo articolo illustra come iniziare a usare i pacchetti forniti come parte del progetto .NET MAUI Community Toolkit.

Aggiunta dei pacchetti NuGet

Il toolkit è disponibile come set di pacchetti NuGet che possono essere aggiunti a qualsiasi progetto esistente o nuovo usando Visual Studio.

1. Aprire un progetto esistente o creare un nuovo progetto in base alla documentazione di installazione di .NET MAUI

2. Nel pannello Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto e scegli Gestisci pacchetti NuGet. Cercare CommunityToolkit.Maui e scegliere il pacchetto NuGet desiderato dall'elenco.

   

3. Scegliere i toolkit più appropriati per le proprie esigenze dalle opzioni seguenti:

CommunityToolkit.Maui

Questo pacchetto è una raccolta di animazioni, comportamenti, convertitori e visualizzazioni personalizzate per lo sviluppo con .NET MAUI. Semplifica e illustra le attività di sviluppo comuni che creano app iOS, Android, macOS e Windows con .NET MAUI.

Nome pacchetto: CommunityToolkit.Maui

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

Inizializzazione del pacchetto

Prima di tutto l'istruzione using deve essere aggiunta all'inizio del file MauiProgram.cs

using CommunityToolkit.Maui;

Per usare correttamente il toolkit, è necessario chiamare il UseMauiCommunityToolkit metodo nella classe durante il MauiAppBuilder bootstrap di un'applicazione nel file MauiProgram.cs . Nell'esempio seguente viene illustrato come eseguire questa operazione.

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

Per usare le funzionalità del toolkit, vedere le pagine della documentazione per ogni funzionalità specifica.

CommunityToolkit.Maui.Markup

Questo pacchetto è un set di metodi e classi helper Fluent per semplificare la creazione di interfacce utente .NET MAUI dichiarative in C#.

Nome pacchetto: CommunityToolkit.Maui.Markup

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

Inizializzazione del pacchetto

Prima di tutto l'istruzione using deve essere aggiunta all'inizio del file MauiProgram.cs

using CommunityToolkit.Maui.Markup;

Per usare correttamente il toolkit, è necessario chiamare il UseMauiCommunityToolkitMarkup metodo nella classe durante il MauiAppBuilder bootstrap di un'applicazione nel file MauiProgram.cs . Nell'esempio seguente viene illustrato come eseguire questa operazione.

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

Per usare le funzionalità del toolkit, vedere le pagine della documentazione per ogni funzionalità specifica.

CommunityToolkit.Maui.Maps

Questo pacchetto consente di visualizzare una mappa nell'applicazione Windows .NET MAUI.

Importante

Bing Maps ha smesso di fornire nuove chiavi API necessarie per il funzionamento di questo controllo. Attualmente stiamo decidendo se aggiornare questo controllo per usare il controllo WinUI che usa Mappe di Azure o che attenderemo l'implementazione ufficiale di .NET MAUI per questo. Per il momento questo significa che non è possibile usare questo controllo se non si dispone già di una chiave API di Bing Maps. Bing Maps nel suo complesso non sarà più disponibile il 30 giugno 2025.

Nome pacchetto: CommunityToolkit.Maui.Maps

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

Inizializzazione del pacchetto

Prima di tutto l'istruzione using deve essere aggiunta all'inizio del file MauiProgram.cs

using CommunityToolkit.Maui.Maps;

Per usare correttamente il Map .UseMauiCommunityToolkitMaps metodo deve essere chiamato sulla classe durante il MauiAppBuilder bootstrap di un'applicazione il file MauiProgram.cs . Questo metodo prevede una chiave API di Bing Maps valida che è possibile ottenere tramite il portale di Bing Maps.

Nell'esempio seguente viene illustrato come eseguire questa operazione.

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

Quando si usa la mappa di .NET MAUI Community Toolkit per Windows e le normali mappe MAUI .NET, è necessario assicurarsi che ogni chiamata di inizializzazione venga eseguita solo per la piattaforma pertinente. L'esempio seguente illustra come farlo.

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

Per altre informazioni su come inizializzare la mappa in iOS e Android, nonché su come usare l'API di controllo mappa, vedere la documentazione di Mappe MAUI .NET.

CommunityToolkit.Maui.MediaElement

Questo pacchetto consente di riprodurre audio e video nell'applicazione .NET MAUI.

Nome pacchetto: CommunityToolkit.Maui.MediaElement

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

Inizializzazione del pacchetto

Prima di tutto l'istruzione using deve essere aggiunta all'inizio del file MauiProgram.cs

using CommunityToolkit.Maui;

Per usare correttamente il MediaElement UseMauiCommunityToolkitMediaElement metodo deve essere chiamato sulla classe durante il MauiAppBuilder bootstrap di un'applicazione il file MauiProgram.cs . Nell'esempio seguente viene illustrato come eseguire questa operazione.

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

Per usare le funzionalità del toolkit, vedere le pagine della documentazione per ogni funzionalità specifica.

CommunityToolkit.Maui.Camera

Questo pacchetto consente di connettersi a una fotocamera, visualizzare un'anteprima dalla fotocamera e scattare foto.

Nome pacchetto: CommunityToolkit.Maui.Camera

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

Inizializzazione del pacchetto

Prima di tutto l'istruzione using deve essere aggiunta all'inizio del file MauiProgram.cs

using CommunityToolkit.Maui;

Per usare CameraView correttamente , è necessario chiamare il metodo sulla classe durante il UseMauiCommunityToolkitCamera MauiAppBuilder bootstrap di un'applicazione nel file MauiProgram.cs . Nell'esempio seguente viene illustrato come eseguire questa operazione.

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

Per usare le funzionalità del toolkit, vedere le pagine della documentazione per ogni funzionalità specifica.

Uso dei pacchetti NuGet

4. Abilitare toolkit in MauiProgram.cs:

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

4.1. Per le impostazioni avanzate, impostare CommunityToolkit.Maui.Options:

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

5. Per altre informazioni sull'implementazione di funzionalità specifiche, vedere il resto della documentazione.

Altre risorse

Il repository GitHub di .NET MAUI Community Toolkit contiene il codice sorgente per un'applicazione di esempio progettata per illustrare come è possibile usare il toolkit per compilare un'applicazione MAUI .NET. Si noti che sarà necessario clonare o scaricare il repository e compilare il codice sorgente per eseguire l'applicazione di esempio.

Si consiglia agli sviluppatori che non hanno esperienza con .NET MAUI di visitare la documentazione di .NET MAUI .

Visitare il repository GitHub di .NET MAUI Community Toolkit per visualizzare il codice sorgente corrente, le novità successive e clonare il repository. I contributi della community sono benvenuti.