Xamarin.Essentials: Seguimiento de versionesXamarin.Essentials: Version Tracking

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.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.

Primeros pasosGet started

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.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.

Uso de Seguimiento de versionesUsing Version Tracking

Agregue una referencia a Xamarin.Essentials en su clase:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

La primera vez que use la clase VersionTracking, se iniciará el seguimiento de la versión actual.The first time you use the VersionTracking class it will start tracking the current version. 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:You must call Track early only in your application each time it is loaded to ensure the current version information is tracked:

VersionTracking.Track();

Después de la llamada inicial a Track, se puede leer la información de la versión: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;

Detalles de implementación de la plataformaPlatform Implementation Specifics

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 de [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.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