<پروفایل>

نحو:

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

موجود در:

<application>

توضیحات:

نحوه دسترسی نمایه‌سازان به این برنامه را مشخص می‌کند.

صفات:

android:shell

مشخص می کند که آیا کاربر دستگاه می تواند این برنامه را از طریق ابزارهای اشکال زدایی محلی مانند موارد زیر نمایه کند:

• android.os.Trace Tracing API (Android 11 و پایین‌تر)
• simpleperf
• دستورات am profile
• پروفایلرهای perfetto (حافظه اصلی، حافظه جاوا، CPU)

اگر این تنظیم نشده باشد یا روی false تنظیم شده باشد، این ابزارها و APIها فقط زمانی کار می‌کنند که برنامه debuggable باشد. برنامه‌های قابل اشکال‌زدایی با کاهش عملکرد قابل توجه و متنوعی مواجه می‌شوند و برای اندازه‌گیری دقیق زمان‌بندی مفید نیستند. این عنصر به شدت برای اندازه گیری عملکرد محلی توصیه می شود تا نتایج دقیق را به دست آورید.

این عنصر به گونه ای طراحی شده است که در نسخه های انتشار یا تولید قابل استفاده باشد تا پروفایل محلی را فعال کند. حداقل خطر قرار گرفتن در معرض داده ها را متحمل می شود: هیچ داده حافظه ای توسط ابزارهای پروفایل میزبان و فرآیند پوسته قابل خواندن نیست. فقط ردپای پشته قابل خواندن است، که معمولاً مبهم یا فاقد نمادها در ساخت‌های انتشار هستند.

android:enabled

مشخص می کند که آیا برنامه می تواند توسط سرویس های سیستم یا ابزارهای پوسته نمایه شود. برای دومی، android:shell نیز تنظیم کردید. اگر نادرست باشد، برنامه به هیچ وجه نمی تواند نمایه شود. پیش فرض درست است. این ویژگی در سطح API 30 اضافه شد.

معرفی شده در:

API سطح 29