Sledování verzí

Procházení ukázky

Tento článek popisuje, jak můžete použít rozhraní .NET Multi-Platform App UI (.NET MAUI). IVersionTracking Toto rozhraní umožňuje zkontrolovat verze aplikací a čísla buildů spolu s dalšími informacemi, jako je první spuštění aplikace.

Výchozí implementace IVersionTracking rozhraní je k dispozici prostřednictvím VersionTracking.Default vlastnosti. Rozhraní IVersionTracking i VersionTracking třída jsou obsaženy v Microsoft.Maui.ApplicationModel oboru názvů.

Začínáme

Pokud chcete ve vaší aplikaci povolit sledování verzí, vyvolejte ConfigureEssentials metodu objektu MauiAppBuilder v souboru MauiProgram.cs . Pak na IEssentialsBuilder objektu zavolejte metodu 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();
}

Kontrola verze

Rozhraní IVersionTracking poskytuje mnoho vlastností, které popisují aktuální verzi aplikace a jak souvisí s předchozí verzí. Následující příklad zapíše informace o sledování popisků na stránce:

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

Při prvním spuštění aplikace po povolení IsFirstLaunchEver sledování verzí se tato vlastnost vrátí true. Pokud přidáte sledování verzí v novější verzi již vydané aplikace, IsFirstLaunchEver může se nesprávně hlásit true. Tato vlastnost vždy vrátí true sledování verzí při prvním povolení a uživatel spustí aplikaci. Tuto vlastnost nelze plně spoléhat, pokud uživatelé upgradovali ze starších verzí, které verzi nesloužely.

Rozdíly mezi platformami

Všechny informace o verzi se ukládají pomocí rozhraní API předvoleb a ukládají se s názvem souboru [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking a řídí se stejnou trvalost dat popsanou v dokumentaci Předvolby .