دستور systrace
ابزار Systrace را فراخوانی میکند که به شما امکان میدهد اطلاعات زمانبندی را در تمام فرآیندهای در حال اجرا در دستگاه شما در سطح سیستم جمعآوری و بررسی کنید.
این سند نحوه تولید گزارش های Systrace را از خط فرمان توضیح می دهد. در دستگاههای دارای Android 9 (سطح API 28) یا بالاتر، میتوانید گزارشهای Systrace را نیز با استفاده از برنامه System Tracing ایجاد کنید.
برای اجرای systrace
مراحل زیر را انجام دهید:
- از Android Studio، آخرین ابزار Android SDK Tools را دانلود و نصب کنید .
- پایتون را نصب کنید و آن را در متغیر محیطی
PATH
ایستگاه کاری خود قرار دهید. -
android-sdk /platform-tools/
را به متغیر محیطیPATH
خود اضافه کنید. این فهرست شامل Android Debug Bridge باینری (adb) است که توسط برنامهsystrace
فراخوانی می شود. - دستگاهی را که دارای Android نسخه 4.3 (سطح API 18) یا بالاتر است، با استفاده از اتصال اشکالزدایی USB به سیستم توسعه خود متصل کنید.
دستور systrace
در بسته Android SDK Tools ارائه شده است و در android-sdk /platform-tools/systrace/
قرار دارد.
نحو
برای ایجاد گزارش HTML برای برنامه، باید systrace
از خط فرمان با استفاده از نحو زیر اجرا کنید:
python systrace.py [options] [categories]
به عنوان مثال، دستور زیر systrace
برای ضبط فعالیت دستگاه و ایجاد یک گزارش HTML به نام mynewtrace.html
فراخوانی می کند. این لیست از دسته ها یک لیست پیش فرض معقول برای اکثر دستگاه ها است.
$ python systrace.py -o mynewtrace.html sched freq idle am wm gfx view \
binder_driver hal dalvik camera input res memory
نکته: اگر می خواهید نام وظایف را در خروجی ردیابی ببینید، باید دسته بندی sched
را در پارامترهای دستوری خود وارد کنید.
برای مشاهده لیست دسته هایی که دستگاه متصل شما پشتیبانی می کند، دستور زیر را اجرا کنید:
$ python systrace.py --list-categories
اگر هیچ دسته یا گزینه ای را مشخص نکنید، systrace
گزارشی تولید می کند که شامل تمام دسته های موجود است و از تنظیمات پیش فرض استفاده می کند. دسته بندی های موجود به دستگاه متصلی که استفاده می کنید بستگی دارد.
گزینه های جهانی
گزینه های جهانی | توضیحات |
---|---|
-h | --help | پیام راهنما را نشان دهید. |
-l | --list-categories | دستههای ردیابی موجود برای دستگاه متصل شما را فهرست میکند. |
دستورات و گزینه های فرمان
دستورات و گزینه ها | توضیحات |
---|---|
-o file | گزارش ردیابی HTML را در file مشخص شده بنویسید. اگر این گزینه را مشخص نکنید، systrace گزارش شما را در همان دایرکتوری systrace.py ذخیره می کند و نام آن را trace.html می گذارد. |
-t N | --time= N | ردیابی فعالیت دستگاه برای N ثانیه. اگر این گزینه را مشخص نکنید، systrace از شما می خواهد که با فشار دادن کلید Enter از خط فرمان، ردیابی را پایان دهید. |
-b N | --buf-size= N | از اندازه بافر ردیابی N کیلوبایت استفاده کنید. این گزینه به شما امکان می دهد اندازه کل داده های جمع آوری شده در طول ردیابی را محدود کنید. |
-k functions | ردیابی فعالیت توابع هسته خاص، مشخص شده در یک لیست جدا شده با کاما. |
-a app-name | ردیابی را برای برنامهها فعال کنید، که بهعنوان فهرستی از نامهای فرآیند با کاما از هم جدا شدهاند. برنامه ها باید حاوی تماس های ابزار دقیق ردیابی از کلاس Trace باشند. هر زمان که برنامه خود را نمایه میکنید، باید این گزینه را مشخص کنید—بسیاری از کتابخانهها، مانند RecyclerView ، شامل تماسهای ابزار دقیق ردیابی هستند که هنگام فعال کردن ردیابی در سطح برنامه، اطلاعات مفیدی را ارائه میدهند. برای اطلاعات بیشتر، به تعریف رویدادهای سفارشی مراجعه کنید. برای ردیابی همه برنامهها در دستگاهی که دارای Android 9 (سطح API 28) یا بالاتر است، کاراکتر عام |
--from-file= file-path | به جای اجرای یک ردیابی زنده، یک گزارش HTML تعاملی از یک فایل، مانند فایلهای TXT که شامل دادههای ردیابی خام است، ایجاد کنید. |
-e device-serial | ردیابی را روی یک دستگاه متصل خاص انجام دهید که با شماره سریال دستگاه آن مشخص شده است. |
categories | شامل اطلاعات ردیابی برای فرآیندهای سیستمی که مشخص میکنید، مانند gfx برای فرآیندهای سیستمی که گرافیک را ارائه میکنند. می توانید systrace با دستور -l اجرا کنید تا لیستی از خدمات موجود برای دستگاه متصل خود را مشاهده کنید. |
برای شما توصیه می شود
- توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود
- ردیابی سیستم را روی دستگاه ضبط کنید