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 的檔名儲存,並遵循喜好設定檔中概述的相同數據持續性。

API

Channel 9YouTube 上尋找更多 Xamarin 影片。