Freigeben über

Andere MAUI- und Xamarin-APIs

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

Anpassen der Protokollebene

Sie können die Anzahl der Protokollmeldungen steuern, die über das App Center in der Konsole angezeigt werden. Verwenden Sie die LogLevel-API, um zusätzliche Protokollierung beim Debuggen zu aktivieren. Standardmäßig ist sie auf ASSERT für die App Store-Umgebungen festgelegt und andernfalls auf WARN.

Um so viele Protokollnachrichten wie möglich zu haben, verwenden Sie LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Identifizieren von Installationen

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

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

Hinweis

Unter Android darf diese Methode erst verwendet werden, nachdem AppCenter gestartet wurde; sie gibt immer null zurück, bevor AppCenter startet.

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 wie im AppCenter.Start(...)" beschrieben aufrufen.
  2. Legen Sie ein userID SDK mit dem folgenden Code fest:
AppCenter.SetUserId("your-user-id");

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

Hinweis

Der Wert für die Benutzer-ID ist auf 256 Zeichen beschränkt. Sie wird mit Ihren Absturzberichten angezeigt, jedoch nicht für Aggregations- oder Zählungen der betroffenen Benutzer verwendet. Wenn Sie die Benutzer-ID mehrmals festlegen, wird nur die letzte Benutzer-ID verwendet. Sie müssen die Benutzer-ID vor dem Start jeder Anwendung selbst festlegen, da dieser Wert nicht vom SDK zwischen starts gespeichert wird.

Deaktivieren aller Dienste zur Laufzeit

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

AppCenter.SetEnabledAsync(false);

Um alle Dienste erneut zu aktivieren, verwenden Sie dieselbe API, übergeben true sie aber als Parameter.

AppCenter.SetEnabledAsync(true);

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

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

Hinweis

Diese Methode darf nur verwendet werden, nachdem AppCenter gestartet wurde.

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 aber nur gesendet, wenn die Netzwerkanforderungen zulässig sind.

AppCenter.IsNetworkRequestsAllowed = true;

Hinweis

Dieser Wert wird zwischen den Starts beibehalten.

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

AppCenter.IsNetworkRequestsAllowed;

Hinweis

Der zuvor in SharedPreferences gespeicherte Wert wird ignoriert, bis AppCenter auf der Android-Plattform gestartet wird. Sie gibt den zuletzt verwendeten AppCenter.IsNetworkRequestsAllowed = allowed Wert zurück oder true 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 nur verwendet werden, nachdem Analytics gestartet wurde.

Überprüfen, ob App Center aktiviert ist

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

bool enabled = await AppCenter.IsEnabledAsync();

Hinweis

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

Überprüfen Sie die App Center SDK-Version zur Laufzeit

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

AppCenter.SdkVersion;
  • Last updated on