其他 React Native API

2025-05-13

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用，但分析和诊断功能除外，这些功能将继续受支持，直到 2026 年 6 月 30 日。了解详细信息。

调整日志级别

可以控制从 App Center 显示的日志消息量。 iOS 上的控制台和 Android 上的 LogCat 中显示日志消息。在调试时使用 setLogLevel API 启用额外的日志记录。默认级别适用于 LogLevel.ASSERT iOS 应用商店环境和 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]; 中调用 [AppCenterReactNative register];，然后才能调用 AppCenterReactNativeAnalytics、AppCenterReactNativeCrashes、AppCenterReactNativePush 或。如果该文件中缺少，则必须添加 @import AppCenter; 。

在 Android 中，在AppCenter.setLogLevel(android.util.Log.VERBOSE);中的SoLoader.init回调调用onCreate，然后再调用MainApplication.java。

识别安装

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

import AppCenter from 'appcenter';

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

标识用户

App Center SDK 支持设置用户 ID，用于增强崩溃报告。若要使用此功能，

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

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

设置用户 ID 后，可以使用 App Center 的搜索功能搜索 ID 的特定故障报告。在 App Center 的搜索文档中了解详细信息。

注释

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

在运行时禁用所有服务

若要一次性禁用所有 App Center 服务，请使用 setEnabled() API。禁用后，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();

注释

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

在运行时更改服务状态

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

await AppCenter.Analytics.setEnabled(false);

检查是否已启用 App Center

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

const enabled = await AppCenter.isEnabled();

在运行时检查应用中心 SDK 版本

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

AppCenter.getSdkVersion();

通过