Seguimiento de versiones

Examinar la muestra.

En este artículo se describe cómo puedes usar la interfaz IVersionTracking de .NET Multi-platform App UI (.NET MAUI). Esta interfaz te permite comprobar la versión y los números de compilación de las aplicaciones. Además, te permite ver información adicional, como si es la primera vez que se inicia la aplicación.

La implementación predeterminada de la interfaz IVersionTracking está disponible a través de la propiedad VersionTracking.Default. Tanto la interfaz IVersionTracking como la clase VersionTracking están contenidas en el espacio de nombres Microsoft.Maui.ApplicationModel.

Introducción

Para habilitar el seguimiento de versiones en la aplicación, invoca el método ConfigureEssentials en el objeto MauiAppBuilder en el archivo MauiProgram.cs. Luego, en el objeto IEssentialsBuilder, llama al método 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();
}

Compruebe la versión.

La interfaz IVersionTracking proporciona muchas propiedades que describen la versión actual de la aplicación y cómo se relaciona con la versión anterior. El ejemplo siguiente escribe la información de seguimiento en las etiquetas de la 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";
}

La primera vez que se ejecuta la aplicación después de habilitar el seguimiento de versiones, la propiedad IsFirstLaunchEver devolverá true. Si agregas el seguimiento de versiones en una versión más reciente de una aplicación ya publicada, IsFirstLaunchEver podría notificar true incorrectamente. Esta propiedad siempre devuelve true la primera vez que se habilita el seguimiento de versiones y el usuario ejecuta la aplicación. No podrás confiar completamente en esta propiedad si los usuarios han actualizado a partir de versiones anteriores que no tenían habilitado el seguimiento de versiones.

Diferencias entre plataformas

Toda la información de la versión se almacena mediante la API Preferences, se almacena con un nombre de archivo [ID-DEL-PAQUETE-DE-LA-APLICACIÓN].microsoft.maui.essentials.versiontracking y sigue la misma persistencia de datos que se describe en la documentación de Preferences.