Xamarin.Essentials: Controle de Versão

  • Artigo

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.

Introdução

Para começar a usar essa API, leia o guia de introdução para Xamarin.Essentials garantir que a biblioteca esteja instalada e configurada corretamente em seus projetos.

Como usar Version Tracking

Adicione uma referência a Xamarin.Essentials em sua classe:

using Xamarin.Essentials;

A primeira vez que você usar a classe VersionTracking, ela começará a acompanhar a versão atual. 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:

VersionTracking.Track();

Após a chamada da Track inicial, é possível ler as informações de versão:


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

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 de [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking e seguem a mesma persistência de dados descrita na documentação Preferências .

API

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.