Xamarin.Essentials: VersionsnachverfolgungXamarin.Essentials: Version Tracking

Mit der Klasse VersionTracking können Sie die Anwendungsversion und Buildnummern überprüfen und weitere Informationen anzeigen. So können Sie z. B. feststellen, ob es sich um den allerersten Start der Anwendung oder der aktuellen Version handelt, die Nummer des vorherigen Builds abrufen usw.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.

Erste SchritteGet started

Lesen Sie zum Einstieg in diese API das Handbuch Erste Schritte mit Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.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.

Verwenden der VersionsnachverfolgungUsing Version Tracking

Fügen Sie Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

Bei der ersten Verwendung der Klasse VersionTracking wird die Nachverfolgung der aktuellen Version gestartet.The first time you use the VersionTracking class it will start tracking the current version. Sie müssen früh und nur in Ihrer Anwendung bei jedem Laden Track aufrufen, um sicherzustellen, dass die Informationen zur aktuellen Version nachverfolgt werden:You must call Track early only in your application each time it is loaded to ensure the current version information is tracked:

VersionTracking.Track();

Nach dem ersten Aufrufen von Track können Versionsinformationen gelesen werden: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;

Besonderheiten bei der plattformspezifischen ImplementierungPlatform Implementation Specifics

Alle Versionsinformationen werden mithilfe der Preferences-API in Xamarin.Essentials mit einem Dateinamen in Form von [IHRE-APP-PAKET-ID].xamarinessentials.versiontracking gespeichert und unterliegen der gleichen Datenpersistenz, wie sie in der Dokumentation zu den Einstellungen beschrieben wird.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

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu Xamarin.Find more Xamarin videos on Channel 9 and YouTube.