Rastreamento de versão

Navegue pelo exemplo

Este artigo descreve como você pode usar a interface .NET Multi-platform App UI (.NET MAUI). IVersionTracking Essa interface permite que você verifique a versão dos aplicativos e os números de compilação, além de ver informações adicionais, como se é a primeira vez que o aplicativo é iniciado.

A implementação padrão da interface está disponível por meio da IVersionTracking VersionTracking.Default propriedade. A interface e VersionTracking a IVersionTracking classe estão contidas no Microsoft.Maui.ApplicationModel namespace.

Introdução

Para habilitar o controle de versão em seu aplicativo, chame o ConfigureEssentials MauiAppBuilder método no objeto no arquivo MauiProgram.cs Em seguida, no objeto, chame IEssentialsBuilder o UseVersionTracking() método:

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

Verificar a versão

A IVersionTracking interface fornece muitas propriedades que descrevem a versão atual do aplicativo e como ela se relaciona com a versão anterior. O exemplo a seguir grava as informações de controle em rótulos na página:

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

Na primeira vez que o aplicativo for executado após o rastreamento de versão estar habilitado, a IsFirstLaunchEver propriedade retornará true. Se você adicionar o controle de versão em uma versão mais recente de um aplicativo já lançado, IsFirstLaunchEver poderá relatar trueincorretamente o . Essa propriedade sempre retorna true a primeira vez que o controle de versão é habilitado e o usuário executa o aplicativo. Você não poderá confiar totalmente nessa propriedade se os usuários atualizaram de versões mais antigas que não estavam rastreando a versão.

Diferenças de plataforma

Todas as informações de versão são armazenadas usando a API de Preferências e são armazenadas com um nome de arquivo de [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking e seguem a mesma persistência de dados descrita na documentação de Preferências.