Xamarin.Essentials: Suivi des versionsXamarin.Essentials: Version Tracking

La classe VersionTracking vous permet de connaître les numéros de version et de build des applications. Elle vous permet également de voir des informations supplémentaires, par exemple le premier lancement de l’application ou, pour la version actuelle, d’obtenir les informations de build précédentes, etc.The VersionTracking class lets you check the applications version and build numbers along with seeing additional information such as if it is the first time the application launched ever or for the current version, get the previous build information, and more.

Prise en mainGet started

Pour commencer à utiliser cette API, lisez le Guide de prise en main de Xamarin.Essentials pour vérifier que la bibliothèque est correctement installée et configurée dans vos projets.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Utilisation du suivi des versionsUsing Version Tracking

Ajoutez une référence à Xamarin.Essentials dans votre classe :Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

La première fois que vous utilisez la classe VersionTracking, elle commence par effectuer le suivi de la version actuelle.The first time you use the VersionTracking class it will start tracking the current version. Vous devez appeler Track tôt et uniquement dans votre application à chaque chargement pour vérifier que les informations de la version actuelle font l’objet d’un suivi :You must call Track early only in your application each time it is loaded to ensure the current version information is tracked:

VersionTracking.Track();

Une fois le Track initial appelé, les informations de version peuvent être lues :After the initial Track is called version information can be read:


// First time ever launched application
var firstLaunch = VersionTracking.IsFirstLaunchEver;

// First time launching current version
var firstLaunchCurrent = VersionTracking.IsFirstLaunchForCurrentVersion;

// First time launching current build
var firstLaunchBuild = VersionTracking.IsFirstLaunchForCurrentBuild;

// Current app version (2.0.0)
var currentVersion = VersionTracking.CurrentVersion;

// Current build (2)
var currentBuild = VersionTracking.CurrentBuild;

// Previous app version (1.0.0)
var previousVersion = VersionTracking.PreviousVersion;

// Previous app build (1)
var previousBuild = VersionTracking.PreviousBuild;

// First version of app installed (1.0.0)
var firstVersion = VersionTracking.FirstInstalledVersion;

// First build of app installed (1)
var firstBuild = VersionTracking.FirstInstalledBuild;

// List of versions installed (1.0.0, 2.0.0)
var versionHistory = VersionTracking.VersionHistory;

// List of builds installed (1, 2)
var buildHistory = VersionTracking.BuildHistory;

Caractéristiques de mise en œuvre de la plateformePlatform Implementation Specifics

Toutes les informations de version sont stockées à l’aide de l’API de préférences de Xamarin.Essentials. Elles sont également stockées avec un nom de fichier de type [VOTRE-PAQUET-D’APPLICATION-ID].xamarinessentials.versiontracking et suivent la même persistance de données décrite dans la documentation sur Preferences.All version information is stored using the Preferences API in Xamarin.Essentials and is stored with a filename of [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking and follows the same data persistence outlined in the Preferences documentation.

APIAPI

Retrouvez d’autres vidéos Xamarin sur Channel 9 et YouTube.Find more Xamarin videos on Channel 9 and YouTube.