- söz dizimi:
<profileable android:shell=["true" | "false"] android:enabled=["true" | "false"] />
- bulunduğu yer:
<application>
- description:
- Profil kullanıcılarının bu uygulamaya nasıl erişebileceğini belirtir.
- özellikler:
android:shell
- .
Cihaz kullanıcısının, yerel hata ayıklama yoluyla bu uygulamanın profilini çıkarıp çıkaramayacağını belirtir
araçlar vardır:
android.os.Trace
izleme API'leri (Android 11 ve önceki sürümler)simpleperf
am profile
komutlarıperfetto
profil aracı (yerel bellek, Java belleği, CPU)
false
olarak ayarlanırsa bu araçlar ve API'ler yalnızca bir uygulama şu durumlarda çalışır:debuggable
. Hata ayıklanabilir uygulamalar önemli ve değişken performans düşüşüne neden olur ve aşağıdakiler için faydalı değildir: ne kadar iyi karşıladığını görebileceksiniz. Bu öğe, yerel performans için önemle tavsiye edilir ölçümler yapabilirsiniz.Bu öğe, yerel profil oluşturmayı etkinleştirmek için sürümde veya üretimde kullanılabilecek şekilde tasarlanmıştır. Verilerin açığa çıkma riski minimum düzeydedir: hiçbir bellek verisi ana makine profil oluşturma araçları tarafından okunamaz. bahsedeceğiz. Genellikle kod karartma veya simge içermeyen yığın izlemeler (stack trace) okunabilir durumdadır pek çok farklı işlevi vardır.
android:enabled
- .
Uygulamanın, sistem hizmetleri veya kabuk araçları tarafından profilinin profilinden alınıp alınamayacağını belirtir.
İkincisi için de
android:shell
değerini ayarlamanız gerekir. Yanlış değeri döndürülürse uygulamanın profili hiç çıkarılamaz. Varsayılan değer, doğru değeridir. Bu özellik, API düzeyi 30'da eklendi.
- tanıtıldığı yer:
- API Düzeyi 29
<profillenebilir>
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# <profileable\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cprofileable android:shell=[\"true\" | \"false\"] android:enabled=[\"true\" | \"false\"] /\u003e\n ```\n\ncontained in:\n: [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\ndescription:\n: Specifies how profilers can access this application.\n\nattributes:\n:\n\n `android:shell`\n :\n Specifies whether the user of the device can profile this application through local debugging\n tools such as the following:\n\n - [android.os.Trace](/reference/kotlin/android/os/Trace) tracing APIs (Android 11 and lower)\n - [simpleperf](/ndk/guides/simpleperf)\n - [am profile](/studio/command-line/adb#am) commands\n - [`perfetto` profilers](/studio/command-line/perfetto) (native memory, Java memory, CPU)\n\n\n If this isn't set, or is set to `false`, these tools and APIs work only when an app is\n [debuggable](/guide/topics/manifest/application-element#debug).\n Debuggable apps incur significant and varied performance degradation and aren't useful for\n measuring timing accurately. This element is strongly recommended for local performance\n measurements, to capture accurate results.\n\n This element is designed to be usable in release, or production, builds to enable local profiling.\n It incurs minimal risk of data exposure: no memory data is readable by the host profiling tools\n and the shell process. Only stack traces are readable, which are typically obfuscated or lacking symbols\n in release builds.\n\n:\n\n `android:enabled`\n :\n Specifies whether the application can be profiled by system services or shell tools.\n For the latter, you also set [`android:shell`](#shell).\n If false, the application can't be profiled at all. The default is true.\n\n This attribute was added in API level 30.\n\nintroduced in:\n: API Level 29"]]