次の方法で共有


Xamarin.Essentials:バージョンの追跡

VersionTracking クラスを使用すると、アプリケーションのバージョンとビルド番号を確認できるだけでなく、今まで一度も起動されたことのないアプリケーションの初めての起動か、現在のバージョンの起動か、前回のビルドの情報などの追加情報を見ることができます。

作業開始

この API の使用を始めるには、Xamarin.Essentials の概要ガイドを読み、ライブラリが正しくインストールされてプロジェクトに設定されていることを確認してください。

VersionTracking の使用

クラスの 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 というファイル名で保存されて、「ユーザー設定」で概要が説明されているのと同じデータ永続化に従います。

API

他の Xamarin ビデオは、Channel 9 および YouTube でご覧いただけます。