<profileable>

<profileable android:shell=["true" | "false"] android:enabled=["true" | "false"] />

android:shell

기기 사용자가 다음과 같은 로컬 디버깅 도구를 통해 이 애플리케이션을 프로파일링할 수 있는지 지정합니다.

• android.os.Trace 추적 API(Android 11 이하)
• simpleperf
• am profile 명령어
• perfetto 프로파일러(네이티브 메모리, Java 메모리, CPU)

설정하지 않거나 false로 설정하면 이러한 도구 및 API는 앱이 debuggable일 때만 작동합니다. 디버그 가능한 앱은 크고 다양한 성능 저하를 야기하며 타이밍을 정확하게 측정하는 데 유용하지 않습니다. 이 요소는 정확한 결과를 캡처하기 위해 로컬 성능 측정에 사용하는 것이 좋습니다.

이 요소는 출시 또는 프로덕션 빌드에서 사용할 수 있도록 설계되었으며, 이를 통해 로컬 프로파일링이 가능합니다. 데이터 노출에 대한 위험이 최소화됩니다. 호스트 프로파일링 도구 및 셸 프로세스에서 메모리 데이터를 읽을 수 없습니다. 스택 트레이스만 읽을 수 있으며 일반적으로 출시 빌드에서 난독화되거나 기호가 없습니다.

android:enabled

애플리케이션을 시스템 서비스 또는 셸 도구로 프로파일링할 수 있는지 지정합니다. 후자의 경우 android:shell도 설정합니다. false인 경우 애플리케이션을 전혀 프로파일링할 수 없습니다. 기본값은 true입니다. 이 속성은 API 수준 30에 추가되었습니다.