Rilevamento delle versioni

Esplorare l'esempio

Questo articolo descrive come usare l'interfaccia dell'interfaccia utente dell'app multipiattaforma .NET (.NET MAUI). IVersionTracking Questa interfaccia consente di controllare la versione e i numeri di build delle applicazioni, oltre a visualizzare informazioni aggiuntive, ad esempio se è la prima volta che l'applicazione è stata avviata.

L'implementazione predefinita dell'interfaccia IVersionTracking è disponibile tramite la VersionTracking.Default proprietà . Sia l'interfaccia che VersionTracking la IVersionTracking classe sono contenute nello spazio dei Microsoft.Maui.ApplicationModel nomi .

Introduzione

Per abilitare il rilevamento delle versioni nell'app, richiamare il ConfigureEssentials metodo sull'oggetto MauiAppBuilder nel file MauiProgram.cs . Quindi, nell'oggetto IEssentialsBuilder chiamare il UseVersionTracking() metodo :

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();

    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        })
        .ConfigureEssentials(essentials =>
        {
            essentials.UseVersionTracking();
        });

    return builder.Build();
}

Controllare la versione

L'interfaccia IVersionTracking fornisce molte proprietà che descrivono la versione corrente dell'app e il modo in cui è correlata alla versione precedente. L'esempio seguente scrive le informazioni di rilevamento nelle etichette nella pagina:

private void ReadVersion_Clicked(object sender, EventArgs e)
{
    labelIsFirst.Text = VersionTracking.Default.IsFirstLaunchEver.ToString();
    labelCurrentVersionIsFirst.Text = VersionTracking.Default.IsFirstLaunchForCurrentVersion.ToString();
    labelCurrentBuildIsFirst.Text = VersionTracking.Default.IsFirstLaunchForCurrentBuild.ToString();
    labelCurrentVersion.Text = VersionTracking.Default.CurrentVersion.ToString();
    labelCurrentBuild.Text = VersionTracking.Default.CurrentBuild.ToString();
    labelFirstInstalledVer.Text = VersionTracking.Default.FirstInstalledVersion.ToString();
    labelFirstInstalledBuild.Text = VersionTracking.Default.FirstInstalledBuild.ToString();
    labelVersionHistory.Text = String.Join(',', VersionTracking.Default.VersionHistory);
    labelBuildHistory.Text = String.Join(',', VersionTracking.Default.BuildHistory);

    // These two properties may be null if this is the first version
    labelPreviousVersion.Text = VersionTracking.Default.PreviousVersion?.ToString() ?? "none";
    labelPreviousBuild.Text = VersionTracking.Default.PreviousBuild?.ToString() ?? "none";
}

La prima volta che l'app viene eseguita dopo l'abilitazione del rilevamento della versione, la IsFirstLaunchEver proprietà restituirà true. Se si aggiunge il rilevamento delle versioni in una versione più recente di un'app già rilasciata, IsFirstLaunchEver potrebbe segnalare trueerroneamente . Questa proprietà restituisce true sempre la prima volta che il rilevamento delle versioni è abilitato e l'utente esegue l'app. Non è possibile basarsi completamente su questa proprietà se gli utenti hanno eseguito l'aggiornamento da versioni precedenti che non monitoravano la versione.

Differenze tra le piattaforme

Tutte le informazioni sulla versione vengono archiviate usando l'API Preferences e vengono archiviate con un nome file [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking e segue la stessa persistenza dei dati descritta nella documentazione preferenze .