Xamarin.Essentials:版本跟踪
VersionTracking 类使你能够检查应用程序版本和内部版本号以及查看其他信息,例如,此应用程序是第一次启动还是当前版本的第一次启动,以及获取之前的内部版本信息等。
入门
若要开始使用此 API,请阅读 Xamarin.Essentials 的入门指南,确保在项目中正确安装和设置库。
使用版本跟踪
在类中添加对 Xamarin.Essentials 的引用:
using Xamarin.Essentials;
首次使用 VersionTracking 类时,它将开始跟踪当前版本。 每次加载时,必须仅在应用程序中提前调用 Track
以确保跟踪当前版本信息:
VersionTracking.Track();
调用初始 Track
后,可以读取版本信息:
// 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;
平台实现细节
所有版本信息均是使用 Xamarin.Essentials 中的 Preferences API 存储的,是以 [你的-应用-包-ID].xamarinessentials.versiontracking 为文件名存储的,并且遵循 Preferences 文档中概述的同一数据持久性。