Suivi des versions

Parcourir l'exemple

Dans cet article, vous découvrirez comment utiliser l'interface .NET Multi-platform App UI (.NET MAUI) IVersionTracking. Cette interface vous permet de vérifier la version et les numéros de build des applications, ainsi que d’afficher des informations supplémentaires, comme si c’est la première fois que l’application a été lancée.

L’implémentation par défaut de l’interface IVersionTracking est disponible via la propriété VersionTracking.Default. L'interface IVersionTracking et la classe VersionTracking sont contenues dans l'espace de noms Microsoft.Maui.ApplicationModel.

Get started

Pour activer le suivi des versions dans votre application, appelez la ConfigureEssentials méthode sur l’objet MauiAppBuilder dans le fichier MauiProgram.cs . Ensuite, sur l’objet IEssentialsBuilder , appelez la UseVersionTracking() méthode :

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

Vérifier la version

L’interface IVersionTracking fournit de nombreuses propriétés qui décrivent la version actuelle de l’application et la façon dont elle se rapporte à la version précédente. L'exemple suivant écrit les informations de suivi dans les libellés de la page :

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 première fois que l’application est exécutée après l’activation du suivi des versions, la IsFirstLaunchEver propriété retourne true. Si vous ajoutez le suivi de version dans une version plus récente d'une application déjà publiée, IsFirstLaunchEver pourrait signaler true de manière incorrecte. Cette propriété retourne true toujours la première fois que le suivi des versions est activé et que l’utilisateur exécute l’application. Vous ne pouvez pas vous appuyer entièrement sur cette propriété si les utilisateurs ont effectué une mise à niveau à partir de versions antérieures qui n’ont pas suivi la version.

Différences de plateforme

Toutes les informations de version sont stockées à l’aide de l’API Préférences et sont stockées avec un nom de fichier [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking et suivent la même persistance des données décrite dans la documentation Préférences .