- syntax:
<profileable android:shell=["true" | "false"] android:enabled=["true" | "false"] />
- contained in:
<application>
- description:
- Specifies how profilers can access this application.
- attributes:
android:shell
-
Specifies whether the user of the device can profile this application through local debugging
tools such as the following:
android.os.Trace
tracing APIs (Android 11 and lower)simpleperf
am profile
commandsperfetto
profilers (native memory, Java memory, CPU)
false
, these tools and APIs work only when an app isdebuggable
. Debuggable apps incur significant and varied performance degradation and aren't useful for measuring timing accurately. This element is strongly recommended for local performance measurements, to capture accurate results.This element is designed to be usable in release, or production, builds to enable local profiling. It incurs minimal risk of data exposure: no memory data is readable by the host profiling tools and the shell process. Only stack traces are readable, which are typically obfuscated or lacking symbols in release builds.
android:enabled
-
Specifies whether the application can be profiled by system services or shell tools.
For the latter, you also set
android:shell
. If false, the application can't be profiled at all. The default is true. This attribute was added in API level 30.
- introduced in:
- API Level 29
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2023-03-22 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-03-22 UTC."],[],[]]