MAUI usa l'SDK .NET, che punta a netstandard2.0 ed è lo stesso pacchetto che userebbe un'applicazione WPF, WinForms, Avalonia o da riga di comando; vedi misurare un'app per che cosa riporta. Quello che è specifico di MAUI è dove lo avvii, dove metti la sua coda, e come le schermate prendono il nome.

Il codice sorgente, e un'app desktop di dimostrazione che riporta se stessa, stanno su skomi-sdk-dotnet.

Un client, per tutta la vita dell'app

Registralo in MauiProgram.cs così che l'applicazione ne abbia esattamente uno:

builder.Services.AddSingleton(_ => new SkomiClient(new SkomiOptions
{
    AppId = Guid.Parse("your-app-id"),          // da Le mie app dentro Skomi
    AppVersion = AppInfo.Current.VersionString,
    StoragePath = FileSystem.Current.AppDataDirectory,
}));

AppVersion di serie prende la versione dell'assembly di ingresso, che su MAUI non è la versione che hai pubblicato su uno store. AppInfo.Current.VersionString lo è.

StoragePath decide dove vive la coda per quando non c'è rete. FileSystem.Current.AppDataDirectory è privato dell'app su ogni bersaglio MAUI e sopravvive a un aggiornamento, cosa che il percorso di serie dei dati locali dell'applicazione su mobile non fa in modo affidabile.

⚠ Dismettilo alla chiusura. Questo ferma il temporizzatore e fa un ultimo tentativo limitato di consegna; quello che non parte adesso è su disco e parte all'esecuzione successiva. Se l'hai registrato come singleton, il contenitore di iniezione lo dismette per te quando l'host si spegne, ma un'app MAUI spesso viene uccisa invece che spenta, che è il motivo per cui la coda esiste.

Dai un nome alle tue schermate

skomi.Screen("checkout/review", new Dictionary<string, object?> { ["tier"] = "gold" });

Non c'è nessuna cattura automatica dei nomi di pagina: la classe di una pagina è come il tuo codice chiama una schermata, non come la chiameresti in un report. Il posto naturale in MAUI è un solo gestore sulla navigazione:

Shell.Current.Navigated += (_, e) =>
    skomi.Screen(e.Current.Location.OriginalString.Trim('/'));

Che è un punto di partenza invece che una regola: le stringhe di rotta danno nomi leggibili solo se le tue rotte sono leggibili.

Errori

try
{
    await CheckoutAsync();
}
catch (Exception ex)
{
    skomi.CaptureError(ex, fatal: false, screenName: "checkout/review");
    ShowRetry();
}

I guasti sono raggruppati per tipo invece che per messaggio, perché un messaggio porta identificativi e importi che rendono unica ogni occorrenza.

⚠ Questo non è un sistema di segnalazione dei crash. Registra i guasti che gli consegni e le eccezioni gestite che riesce a vedere; un crash nativo su Android o su iOS si porta via il processo prima che si possa scrivere qualunque cosa. Tieni la segnalazione dello store stesso, o Crashlytics o Sentry, per quelli; quello che Skomi aggiunge è un tasso senza crash accanto ai numeri delle tue versioni, e gli errori che hai scelto di segnalare.

Non c'è nemmeno il caricamento di un file di mappatura, quindi lo stack di una versione di rilascio minificata arriva com'è stato lanciato.

Non lancia mai dentro il tuo codice

Ogni metodo pubblico inghiotte e segnala attraverso OnError, che di serie è silenzioso, giusto per un'app pubblicata e sbagliato mentre stai integrando:

OnError = (ex, stage) => Debug.WriteLine($"Skomi {stage}: {ex}"),

In attesa del consenso

new SkomiOptions { AppId = id, Enabled = false }

Con Enabled = false non si registra niente e non si manda niente, quindi un client può esistere fin dall'avvio e cominciare a raccogliere solo dopo che qualcuno ha acconsentito.

Controlla che funzioni

Fai girare l'app, passa fra due pagine, e guarda la tua dashboard. Se non arriva niente, imposta prima OnError: un identificativo di app dell'app sbagliata e un client mai dismesso sono le due cause solite, e senza di lui sono tutte e due silenziose.