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 文档中概述的同一数据持久性。

API

第 9 频道YouTube 上查找更多 Xamarin 视频。