Xamarin.Essentials: Acompanhamento de versão: Version Tracking

A classe VersionTracking permite que você verifique a versão e os números de build dos aplicativos, junto com informações adicionais, por exemplo, se é a primeira vez que o aplicativo é iniciado ou, para a versão atual, obter informações do build anterior e muito mais.The VersionTracking class lets you check the applications version and build numbers along with seeing additional information such as if it is the first time the application launched ever or for the current version, get the previous build information, and more.

IntroduçãoGet started

Para começar a usar essa API, leia o guia de Introdução para Xamarin.Essentials a fim de garantir que a biblioteca esteja corretamente instalada e configurada em seus projetos.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Como usar Version TrackingUsing Version Tracking

Adicione uma referência a Xamarin.Essentials em sua classe:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

A primeira vez que você usar a classe VersionTracking, ela começará a acompanhar a versão atual.The first time you use the VersionTracking class it will start tracking the current version. Chame Track antecipadamente em seu aplicativo sempre que ele for carregado, a fim de garantir que as informações da versão atual sejam rastreadas:You must call Track early only in your application each time it is loaded to ensure the current version information is tracked:

VersionTracking.Track();

Após a chamada da Track inicial, é possível ler as informações de versão:After the initial Track is called version information can be read:


// 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;

Particularidades de implementação da plataformaPlatform Implementation Specifics

Todas as informações de versão são armazenadas usando a API de preferências no Xamarin.Essentials e são armazenadas com um nome de arquivo [Your-app-Package-ID]. xamarinessentials. versiontracking e segue a mesma persistência de dados descrita na documentação de preferências .All version information is stored using the Preferences API in Xamarin.Essentials and is stored with a filename of [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking and follows the same data persistence outlined in the Preferences documentation.

APIAPI

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.Find more Xamarin videos on Channel 9 and YouTube.