Partager via

Suivi des versions

  • Article

Browse sample. Parcourir l’exemple

Cet article explique comment utiliser l’interface utilisateur de l’application multiplateforme .NET (.NET MAUI). IVersionTracking Cette interface vous permet de case activée les numéros de version et 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 VersionTracking.Default propriété. L’interface et VersionTracking la IVersionTracking classe sont contenues dans l’espace Microsoft.Maui.ApplicationModel de noms.

Démarrage

Pour activer le suivi des versions dans votre application, appelez la ConfigureEssentials méthode sur l’objet dans le MauiAppBuilder 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 étiquettes 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 des versions dans une version plus récente d’une application déjà publiée, IsFirstLaunchEver il est possible qu’il soit incorrect de signaler true. 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.