ProfilingManager 类

定义

[Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)]
public sealed class ProfilingManager : Java.Lang.Object

[<Android.Runtime.Register("android/os/ProfilingManager", ApiSince=35, DoNotGenerateAcw=true)>]
type ProfilingManager = class
    inherit Object

继承

Object

Object

ProfilingManager

属性

RegisterAttribute

注解

此类允许调用方： <ul><li>请求分析并侦听结果。 支持的分析类型包括：系统跟踪、java 堆转储、堆配置文件和堆栈跟踪。</li li><>Register triggers for the system to captureing on the apps behalf.</li></ul>

#requestProfiling API 可用于开始分析。 分析可能使用请求中提供的 CancellationSignal 手动结束，或者由于超时。 超时可能是在选择类型的参数捆绑包中定义的系统默认值或调用方。

分析结果将传递到请求应用的数据目录，并使用提供的应用侦听器接收指向文件的指针。

应用可以通过一种或两种方式提供侦听器： <请求中包含的特定于请求的侦听器 ul><li>A。 这将仅触发它提供的请求的结果。</li li><>A global listener provided by #registerForAllProfilingResults. 这将针对属于应用的所有结果触发。 此侦听器是接收由 #addProfilingTriggers系统触发的分析实例设置的结果的唯一方法。</li></ul>

请求速率有限，无法保证填充。 可以使用 shell 命令进行本地测试 #requestProfiling 时禁用速率限制 device_config put profiling_testing rate_limiter.disabled true

对于本地测试，可以通过启用调试模式更轻松地访问分析结果。 这将在临时系统目录中保留输出文件。 保留文件的位置将在 logcat 中可用。 行为和命令因版本而异： <ul><li>For Android 版本 16 及更高版本，调试模式将保留未处理（如果适用）和临时目录中的编辑结果。 可以使用 shell 命令 device_config put profiling_testing delete_temporary_results.disabled true 启用它，并通过将相同的值设置回 false 来禁用它。 可在所有生成类型上访问保留的结果。 </li li><>对于 Android 版本 15，调试模式将仅保留临时目录中未处理的结果（如果适用）。 可以使用 shell 命令 device_config put profiling_testing delete_unredacted_trace.disabled true 启用它，并通过将相同的值设置回 false 来禁用它。 保留的未处理文件只能在具有根访问权限的生成上访问。 若要访问未根设备上的经过修订的输出文件，应用可以将该文件从中/pkg/files/profiling/file.type/pkg/cache/file.type复制到 。 </li></ul>

若要测试分析触发器，请使用 shell 命令为应用启用测试模式，该命令device_config put profiling_testing system_triggered_profiling.testing_package_name com.your.app将：<ul><li>确保后台跟踪正在运行。</li li><>允许提供包名称的所有触发器通过系统级别速率限制程序。 此模式将继续，直到使用 shell 命令 device_config delete profiling_testing system_triggered_profiling.testing_package_name手动停止。 </li></ul>

结果经过修订，仅包含有关请求过程的特定信息。

Java文档android.os.ProfilingManager。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。