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;
平台實作特性
所有版本信息都會使用喜好設定 API 儲存在 中Xamarin.Essentials,並以 [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking 的檔名儲存,並遵循喜好設定檔中概述的相同數據持續性。