Xamarin.Essentials: Suivi de version
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.
Bien démarrer
Pour commencer à utiliser cette API, lisez le guide de prise en main pour Xamarin.Essentials vous assurer que la bibliothèque est correctement installée et configurée dans vos projets.
Utilisation du suivi des versions
Ajoutez une référence à Xamarin.Essentials dans votre classe :
using Xamarin.Essentials;
La première fois que vous utilisez la classe VersionTracking, elle commence par effectuer le suivi de la version actuelle. 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 :
VersionTracking.Track();
Une fois le Track initial appelé, les informations de version peuvent être lues :
// 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 plateforme
Toutes les informations de version sont stockées à l’aide de l’API Préférences dans Xamarin.Essentials et sont stockées avec un nom de fichier de [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking et suivent la même persistance des données décrite dans la documentation préférences .
API
- Code source de la fonctionnalité de suivi des versions
- Documentation sur l’API de suivi des versions