Śledzenie wersji

Przeglądanie przykładu

W tym artykule opisano sposób używania interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI). IVersionTracking Ten interfejs umożliwia sprawdzenie wersji aplikacji i numerów kompilacji wraz z wyświetlaniem dodatkowych informacji, takich jak to, czy jest to pierwszy raz, gdy aplikacja została uruchomiona.

Domyślna implementacja interfejsu IVersionTracking jest dostępna za pośrednictwem VersionTracking.Default właściwości . Zarówno interfejs, jak IVersionTracking i VersionTracking klasa są zawarte w Microsoft.Maui.ApplicationModel przestrzeni nazw.

Rozpocznij

Aby włączyć śledzenie wersji w aplikacji, wywołaj metodę ConfigureEssentials w MauiAppBuilder obiekcie w pliku MauiProgram.cs . Następnie na obiekcie wywołaj IEssentialsBuilder metodę UseVersionTracking() :

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

Sprawdzanie wersji

Interfejs IVersionTracking zawiera wiele właściwości, które opisują bieżącą wersję aplikacji i sposób jej powiązania z poprzednią wersją. Poniższy przykład zapisuje informacje o śledzeniu do etykiet na stronie:

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

Przy pierwszym uruchomieniu aplikacji po włączeniu IsFirstLaunchEver śledzenia wersji właściwość zwróci wartość true. Jeśli dodasz śledzenie wersji w nowszej wersji już wydanej aplikacji, IsFirstLaunchEver może niepoprawnie zgłosić .true Ta właściwość zawsze zwraca true funkcję śledzenia wersji po raz pierwszy i użytkownik uruchamia aplikację. Nie można w pełni polegać na tej właściwości, jeśli użytkownicy uaktualnili starsze wersje, które nie śledziły wersji.

Różnice między platformami

Wszystkie informacje o wersji są przechowywane przy użyciu interfejsu API preferencji i są przechowywane z nazwą pliku [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking i jest zgodny z tą samą trwałością danych opisaną w dokumentacji preferencji.