其他React Native API

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

调整日志级别

可以控制从 App Center 显示的日志消息数量。 iOS 上的控制台和 Android 上的 LogCat 中会显示日志消息。 使用 API 在 setLogLevel 调试时启用其他日志记录。 默认级别LogLevel.ASSERT适用于 iOS App Store环境和 Android 版本。 否则，它设置为 LogLevel.WARNING。

若要输出所有日志消息，请使用 LogLevel.VERBOSE。

import AppCenter from 'appcenter';

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

注意

在加载 JavaScript 之前，JavaScript setLogLevel API 无法增加应用启动代码的日志记录。

如果要增加应用启动的日志记录，请使用本机 App Center setLogLevel API。

在 iOS 中，在[MSACAppCenter setLogLevel: MSACLogLevelVerbose];项目的 AppDelegate.m 中调用 (或 AppCenterReactNativeAnalytics 或 AppCenterReactNativeCrashesAppCenterReactNativePush) 之前调用 [AppCenterReactNative register]; 。 如果该文件中缺少 ，则必须添加 @import AppCenter; 。

在 Android 中，在 的回调中MainApplication.javaonCreate先SoLoader.init调用 AppCenter.setLogLevel(android.util.Log.VERBOSE); 。

确定安装

安装应用后，App Center SDK 会为每个设备创建 UUID。 更新应用时，此标识符对于设备保持不变，并且仅在重新安装应用或用户在 Android 上手动删除所有应用数据时才生成新标识符。 以下 API 可用于调试目的。

import AppCenter from 'appcenter';

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

标识用户

App Center SDK 支持设置用于扩充故障报告 的用户 ID 。 若要使用此功能，请：

1. 按照 App Center SDK 入门指南中所述配置 App Center SDK。
2. userID使用以下代码在 SDK 中设置 ：

AppCenter.setUserId("your-user-id");

设置用户 ID 后，可以使用 App Center 的搜索功能搜索该 ID 的特定故障报告。 有关详细信息，请参阅 App Center 的 搜索文档。

注意

用户 ID 的值限制为 256 个字符。 它将随故障报告一起显示，但不用于聚合或受影响用户的计数。 如果多次设置用户 ID，将仅使用最后一个用户 ID。 需要在每次启动应用程序之前自行设置用户 ID，因为两次启动之间 SDK 不会存储此值。

在运行时禁用所有服务

如果要一次禁用所有 App Center 服务，请使用 API setEnabled() 。 禁用后，SDK 不会将任何信息转发到 App Center。

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

若要再次启用所有服务，请使用同一 API，但将 作为参数传递 true 。

await AppCenter.setEnabled(true);

在应用程序启动时，状态将保留在设备的存储中。

禁止网络请求

在 App Center SDK 中，默认允许网络请求。 如果要发送用户关注的 App Center SDK 收集的数据，可以禁止自动发送数据。

await AppCenter.setNetworkRequestsAllowed(false);

在这种情况下，App Center SDK 将继续收集数据，但仅当允许网络请求时才会发送数据。

await AppCenter.setNetworkRequestsAllowed(true);

注意

此值在启动之间保留。

可以随时检查是否允许在 App Center SDK 中发送数据。

await AppCenter.isNetworkRequestsAllowed();

注意

在 Android 平台上启动之前 AppCenter ，将忽略 SharedPreferences 中保存的值。 如果在 AppCenter 启动之前未更改该值，它将返回使用 setNetworkRequestsAllowed 或 true 设置的最后一个值。

更改运行时中的服务状态

可以使用以下代码在运行时启用或禁用服务：

await AppCenter.Analytics.setEnabled(false);

检查是否已启用 App Center

还可以检查 App Center 是否已启用。

const enabled = await AppCenter.isEnabled();

在运行时检查 App Center SDK 版本

可以获取当前使用的 App Center SDK 版本。

AppCenter.getSdkVersion();