Freigeben über

Andere native React-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 im App Center angezeigt werden. Protokollmeldungen werden in der Konsole unter iOS und LogCat unter Android angezeigt. Verwenden Sie die setLogLevel API, um zusätzliche Protokollierung beim Debuggen zu aktivieren. Die Standardebene ist LogLevel.ASSERT für die iOS-App-Store-Umgebung und Android-Release-Builds. Andernfalls ist sie auf LogLevel.WARNING festgelegt.

Um alle Protokollnachrichten auszugeben, verwenden Sie LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Hinweis

Die JavaScript-API setLogLevel kann die Protokollierung für App-Startcode nicht erhöhen, bevor JavaScript geladen wird.

Wenn Sie die Protokollierung für den App-Start erhöhen möchten, verwenden Sie die nativen App Center setLogLevel-APIs.

Rufen Sie [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; in iOS vor einem Aufruf von [AppCenterReactNative register]; (oder AppCenterReactNativeAnalytics oder AppCenterReactNativeCrashesAppCenterReactNativePush) im AppDelegate.m des Projekts auf. Sie müssen @import AppCenter; hinzufügen, wenn es in dieser Datei fehlt.

In Android, rufen Sie AppCenter.setLogLevel(android.util.Log.VERBOSE); vor SoLoader.init im onCreate-Rückruf in MainApplication.java auf.

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 gleich, wenn die App aktualisiert wird und eine neue nur generiert wird, wenn die App erneut installiert wird oder der Benutzer manuell alle App-Daten unter Android löscht. Die folgende API ist für Debuggingzwecke nützlich.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

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 wie im Handbuch für erste Schritte im App Center SDK beschrieben.
  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 setEnabled() API. Wenn dies deaktiviert ist, leitet das SDK keine Informationen an das App Center weiter.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

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

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.

await AppCenter.setNetworkRequestsAllowed(false);

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

await AppCenter.setNetworkRequestsAllowed(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.

await AppCenter.isNetworkRequestsAllowed();

Hinweis

Der in SharedPreferences gespeicherte Wert wird ignoriert, bis AppCenter auf der Android-Plattform gestartet wird. Sie gibt den zuletzt verwendeten setNetworkRequestsAllowed 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 folgendem Code aktivieren oder deaktivieren:

await AppCenter.Analytics.setEnabled(false);

Überprüfen, ob App Center aktiviert ist

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

const enabled = await AppCenter.isEnabled();

Ü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.getSdkVersion();
  • Last updated on