其他React Native API

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

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

调整日志级别

可以控制从 App Center 显示的日志消息量。 iOS 上的控制台和 Android 上的 LogCat 中会显示日志消息。 在调试时使用 setLogLevel API 启用其他日志记录。 默认级别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 中调用 (或 AppCenterReactNativeAnalyticsAppCenterReactNativePush 或 AppCenterReactNativeCrashes) 之前[AppCenterReactNative register];调用 。 如果该文件中缺少，则必须添加 @import AppCenter; 。

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

标识安装

安装应用后，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();