Andere React Native-APIs

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 möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

• Android
• iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

Anpassen der Protokollebene

Sie können die Anzahl der Protokollnachrichten steuern, die aus App Center angezeigt werden. Protokollmeldungen werden in der Konsole unter iOS und LogCat unter Android angezeigt. Verwenden Sie die setLogLevel API, um beim Debuggen zusätzliche Protokollierung zu aktivieren. Die Standardebene gilt LogLevel.ASSERT für die iOS-App Store-Umgebung und Android-Releasebuilds. Andernfalls ist es auf LogLevel.WARNINGfestgelegt.

Verwenden Sie LogLevel.VERBOSEzum Ausgeben aller Protokollmeldungen .

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 in iOS vor jedem Aufruf [AppCenterReactNative register]; von (oder AppCenterReactNativeAnalytics oder oderAppCenterReactNativeCrashes) AppCenterReactNativePushin der AppDelegate.m des Projekts auf[MSACAppCenter setLogLevel: MSACLogLevelVerbose];. Sie müssen hinzufügen @import AppCenter; , wenn in dieser Datei fehlt.

Rufen Sie AppCenter.setLogLevel(android.util.Log.VERBOSE); in Android im onCreate Rückruf in MainApplication.javavor aufSoLoader.init.

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 gleich, wenn die App aktualisiert wird und nur dann eine neue generiert wird, wenn die App erneut installiert wird oder der Benutzer alle App-Daten unter Android manuell 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 Leitfaden Erste Schritte für das App Center SDK beschrieben.
2. Legen Sie einen userID im SDK mit dem folgenden Code fest:

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 mit Ihren Absturzberichten angezeigt, aber nicht für die Aggregation oder Anzahl 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 jedem Anwendungsstart selbst festlegen, 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 setEnabled() API. Wenn sie deaktiviert ist, leitet das SDK keine Informationen an App Center weiter.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

Der Zustand wird im Speicher des Geräts bei allen Anwendungsstarts 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, sie werden jedoch 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.

await AppCenter.isNetworkRequestsAllowed();

Hinweis

Der in SharedPreferences gespeicherte Wert wird ignoriert, bis AppCenter auf der Android-Plattform gestartet wird. Er gibt den letzten Wert zurück, der mit setNetworkRequestsAllowed oder festgelegt wurde, 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 der App Center SDK-Version zur Laufzeit

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

AppCenter.getSdkVersion();