Andere MAUI- und Xamarin-APIs

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Anpassen der Protokollebene

Sie können die Menge der Protokollmeldungen steuern, die aus App Center in der Konsole angezeigt werden. Verwenden Sie die LogLevel-API, um während des Debuggens zusätzliche Protokollierung zu aktivieren. Standardmäßig ist er für die App Store-Umgebungen und WARN andernfalls auf festgelegtASSERT.

Um so viele Protokollmeldungen wie möglich zu erhalten, verwenden Sie LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Identifizieren von Installationen

Das App Center SDK erstellt nach der Installation der App eine UUID für jedes Gerät. Dieser Bezeichner bleibt für ein Gerät identisch, wenn die App aktualisiert wird, und ein neuer Bezeichner wird nur generiert, wenn die App erneut installiert wird. Die folgende API ist für Debugzwecke nützlich.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Hinweis

Unter Android darf diese Methode nur verwendet werden, nachdem AppCenter sie gestartet wurde. Sie wird immer vor dem Start zurückgegeben null .

Identifizieren von Benutzern

Das App Center SDK unterstützt das Festlegen einer Benutzer-ID , die zum Erweitern von Absturzberichten verwendet wird. So verwenden Sie diese Funktion:

  1. Konfigurieren Sie das App Center SDK, indem Sie aufrufen AppCenter.Start(...) , wie im Leitfaden Erste Schritte beschrieben.
  2. Legen Sie im SDK mithilfe des folgenden Codes fest userID :
AppCenter.SetUserId("your-user-id");

Nachdem Sie eine Benutzer-ID festgelegt haben, können Sie die Suchfunktion von App Center verwenden, um nach bestimmten Absturzberichten für die ID zu suchen. Weitere Informationen finden Sie in der App Center-Suchdokumentation.

Hinweis

Der Wert für die Benutzer-ID ist auf 256 Zeichen beschränkt. Es wird zusammen mit Ihren Absturzberichten angezeigt, aber nicht für die Aggregation oder Anzahl betroffener Benutzer verwendet. Falls Sie die Benutzer-ID mehrmals festlegen, wird nur die letzte Benutzer-ID verwendet. Sie müssen die Benutzer-ID selbst festlegen, bevor jede Anwendung gestartet wird, da dieser Wert zwischen den Starts nicht vom SDK gespeichert wird.

Deaktivieren aller Dienste zur Laufzeit

Wenn Sie alle App Center-Dienste gleichzeitig deaktivieren möchten, verwenden Sie die Enabled -Eigenschaft. Wenn es deaktiviert ist, leitet das SDK keine Informationen an App Center weiter.

AppCenter.SetEnabledAsync(false);

Um alle Dienste gleichzeitig zu aktivieren, verwenden Sie dieselbe API, übergeben true Sie jedoch als Parameter.

AppCenter.SetEnabledAsync(true);

Sie müssen nicht auf diesen Aufruf warten, um andere API-Aufrufe (z IsEnabledAsync. B. ) konsistent auszuführen.

Der Zustand wird über Anwendungsstarts hinweg im Speicher des Geräts beibehalten.

Hinweis

Diese Methode darf erst nach dem AppCenter Start verwendet werden.

Netzwerkanforderungen nicht zulassen

Im App Center SDK sind Netzwerkanforderungen standardmäßig zulässig. Wenn Sie Daten senden möchten, die das App Center SDK vom Benutzer erfasst, können Sie das automatische Senden von Daten nicht zulassen.

AppCenter.IsNetworkRequestsAllowed = false;

In diesem Fall sammelt das App Center SDK weiterhin Daten, wird jedoch nur gesendet, wenn die Netzwerkanforderungen zulässig sind.

AppCenter.IsNetworkRequestsAllowed = true;

Hinweis

Dieser Wert wird zwischen starts beibehalten.

Sie können jederzeit überprüfen, ob das Senden von Daten im App Center SDK zulässig ist.

AppCenter.IsNetworkRequestsAllowed;

Hinweis

Der zuvor in SharedPreferences gespeicherte Wert wird ignoriert, bis AppCenter auf der Android-Plattform gestartet wird. Es wird der letzte Wert zurückgegeben, der mit AppCenter.IsNetworkRequestsAllowed = allowed oder true festgelegt wurde, wenn der Wert vor dem Start von AppCenter nicht geändert wurde.

Ändern des Dienststatus in der Laufzeit

Sie können den Dienst zur Laufzeit mit dem folgenden Code aktivieren oder deaktivieren:

Analytics.SetEnabledAsync(true);

Hinweis

Diese Methode darf erst nach dem Analytics Start verwendet werden.

Überprüfen, ob App Center aktiviert ist

Sie können auch überprüfen, ob App Center aktiviert ist.

bool enabled = await AppCenter.IsEnabledAsync();

Hinweis

Diese Methode darf nur verwendet werden, nachdem AppCenter gestartet wurde. Sie wird immer vor dem Start zurückgegeben false .

Überprüfen der App Center SDK-Version zur Laufzeit

Sie können die Version des App Center SDK abrufen, die Sie derzeit verwenden.

AppCenter.SdkVersion;