Versionsnachverfolgung

Durchsuchen Sie das Beispiel

In diesem Artikel wird beschrieben, wie Sie die .NET Multi-Platform App UI (.NET MAUI) IVersionTracking-Schnittstelle verwenden können. Mit dieser Schnittstelle können Sie die Anwendungsversion und die Buildnummern überprüfen und zusätzliche Informationen anzeigen, z. B. wenn die Anwendung zum ersten Mal gestartet wurde.

Die Standardimplementierung der IVersionTracking-Schnittstelle ist über die VersionTracking.Default-Eigenschaft verfügbar. Die IVersionTracking-Schnittstelle sowie die VersionTracking-Klasse sind im Microsoft.Maui.ApplicationModel-Namespace enthalten.

Erste Schritte

Rufen Sie die ConfigureEssentials-Methode im MauiAppBuilder-Objekt in der MauiProgram.cs-Datei auf, um die Versionsnachverfolgung zu aktivieren. Rufen Sie dann im IEssentialsBuilder-Objekt die UseVersionTracking()-Methode auf:

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

Version überprüfen

Die IVersionTracking-Schnittstelle enthält viele Eigenschaften, die die aktuelle Version der App beschreiben und wie sie sich auf vorherige Version bezieht. Im folgenden Beispiel werden die Nachverfolgungsinformationen in Bezeichnungen auf der Seite geschrieben:

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";
}

Wenn die App zum ersten Mal ausgeführt wird, nachdem die Versionsnachverfolgung aktiviert wurde, gibt die IsFirstLaunchEver-Eigenschaft true zurück. Wenn Sie die Versionsnachverfolgung in einer neueren Version einer bereits veröffentlichten App hinzufügen, gibt IsFirstLaunchEver möglicherweise fälschlicherweise true zurück. Diese Eigenschaft gibt beim ersten Aktivieren der Versionsnachverfolgung immer true zurück, wenn der/die Benutzer*in die App ausführt. Sie können sich nicht vollständig auf diese Eigenschaft verlassen, wenn Benutzer*innen ein Upgrade von älteren Versionen durchgeführt haben, die die Version nicht nachverfolgen.

Plattformunterschiede

Alle Versionsinformationen werden mithilfe der Preferences-API mit einem Dateinamen in Form von [IHRE-APP-PAKET-ID].microsoft.maui.essentials.versiontracking gespeichert und unterliegen der gleichen Datenpersistenz, wie sie in der Preferences-Dokumentation beschrieben ist.