Xamarin.Essentials: Versionsnachverfolgung

  • Artikel

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.

Erste Schritte

Lesen Sie zum Einstieg in die Verwendung dieser API den Leitfaden mit ersten Schritte für Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.

Verwenden der Versionsnachverfolgung

Fügen Sie in Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:

using Xamarin.Essentials;

Bei der ersten Verwendung der Klasse VersionTracking wird die Nachverfolgung der aktuellen Version gestartet. 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:

VersionTracking.Track();

Nach dem ersten Aufrufen von Track können Versionsinformationen gelesen werden:


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

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

API

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu Xamarin.