Xamarin.Essentials: Seguimiento de versiones

La clase VersionTracking permite comprobar los números de versión y compilación de las aplicaciones además de ver información adicional, por ejemplo si es la primera vez que se ha iniciado la aplicación o para la versión actual, obtener información de la compilación anterior y mucho más.

Primeros pasos

Para empezar a usar esta API, lea la guía de introducción para Xamarin.Essentials con el fin de asegurarse de que la biblioteca está correctamente instalada y configurada en los proyectos.

Uso de Seguimiento de versiones

Agregue una referencia a Xamarin.Essentials en la clase:

using Xamarin.Essentials;

La primera vez que use la clase VersionTracking, se iniciará el seguimiento de la versión actual. Solo se debe llamar a Track al principio de la aplicación cada vez que se cargue para asegurarse de que se realiza el seguimiento de la información de versión actual:

VersionTracking.Track();

Después de la llamada inicial a Track, se puede leer la información de la versión:


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

Detalles de implementación de la plataforma

Toda la información de la versión se almacena mediante la API Preferences de Xamarin.Essentials y se almacena con un nombre de archivo [ID-DEL-PAQUETE-DE-LA-APLICACIÓN].xamarinessentials.versiontracking, y sigue la misma persistencia de datos que se describe en la documentación de Preferences.

API

Encuentre más vídeos de Xamarin en Channel 9 y YouTube.