Condividi tramite


Xamarin.Essentials: rilevamento delle versioni

La classe VersionTracking consente di controllare la versione delle applicazioni e i numeri di build e di visualizzare informazioni aggiuntive, ad esempio se l'applicazione è stata avviata per la prima volta in assoluto o, per la versione corrente, di ottenere informazioni sulla build precedente e altro ancora.

Operazioni preliminari

Per iniziare a usare questa API, leggere la guida introduttiva per Xamarin.Essentials assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Uso di Version Tracking

Aggiungere un riferimento a Xamarin.Essentials nella classe :

using Xamarin.Essentials;

La prima volta che viene usata, la classe VersionTracking inizierà a tenere traccia della versione corrente. È necessario chiamare Track in anticipo solo nell'applicazione ogni volta che viene caricata per assicurarsi che venga tenuta traccia delle informazioni sulla versione corrente:

VersionTracking.Track();

Dopo la chiamata iniziale a Track, è possibile leggere le informazioni sulla versione:


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

Informazioni di implementazione specifiche della piattaforma

Tutte le informazioni sulla versione vengono archiviate usando l'API Preferences in Xamarin.Essentials e vengono archiviate con un nome file [YOUR-APP-PACKAGE-ID].xamarinessentials.versiontracking e segue la stessa persistenza dei dati descritta nella documentazione preferenze .

API

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.