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;

Особенности реализации для платформ

Все сведения о версии сохраняются с помощью API параметров в Xamarin.Essentials с именем файла [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking. Режим сохранения данных соответствует описанному в документации о параметрах.

API

Другие видео о Xamarin см. на Channel 9 и YouTube.