其他 MAUI 和 Xamarin API

重要

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

调整日志级别

可以控制从控制台中的 App Center 显示的日志消息量。 使用LogLevel API在调试时启用额外日志记录。 默认情况下,对于 App Store 环境,它设置为 ASSERT,否则为 WARN

如需尽可能多的日志消息,请使用 LogLevel.Verbose

AppCenter.LogLevel = LogLevel.Verbose;

识别安装

安装应用后,App Center SDK 会为每个设备创建 UUID。 当应用更新时,此标识符对于设备保持不变,并且仅在重新安装应用时生成一个新标识符。 以下 API 可用于调试目的。

System.Guid? installId = await AppCenter.GetInstallIdAsync();

注释

在 Android 上,此方法只能在启动后 AppCenter 使用,它始终会在启动前返回 null

标识用户

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

  1. 按照AppCenter.Start(...)中所述,通过调用配置 App Center SDK。
  2. 在 SDK 中使用以下代码设置 userID
AppCenter.SetUserId("your-user-id");

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

注释

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

在运行时禁用所有服务

如果要一次性禁用所有 App Center 服务,请使用该 Enabled 属性。 禁用后,SDK 不会将任何信息转发到 App Center。

AppCenter.SetEnabledAsync(false);

若要再次启用所有服务,请使用相同的 API,但作为参数传递 true

AppCenter.SetEnabledAsync(true);

无需等待此调用即可使其他 API 调用(例如 IsEnabledAsync)保持一致。

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

注释

此方法只能在启动 AppCenter 后使用。

禁止网络请求

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

AppCenter.IsNetworkRequestsAllowed = false;

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

AppCenter.IsNetworkRequestsAllowed = true;

注释

此值在每次启动之间会保留。

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

AppCenter.IsNetworkRequestsAllowed;

注释

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

在运行时更改服务状态

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

Analytics.SetEnabledAsync(true);

注释

此方法只能在启动 Analytics 后使用。

检查是否已启用 App Center

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

bool enabled = await AppCenter.IsEnabledAsync();

注释

此方法应仅在 AppCenter 启动后使用,在启动前,它将始终返回 false

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

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

AppCenter.SdkVersion;