نظرة عامة

تتيح لك واجهة برمجة التطبيقات ProfilingManager جمع ملفات تعريف الأداء للمستخدمين الحقيقيين، مثل سجلّات تتبُّع النظام ولقطات أجزاء من الذاكرة في Java، من أجهزة الإصدار العلني التي تعمل بنظام التشغيل Android 15 (مستوى واجهة برمجة التطبيقات 35) والإصدارات الأحدث. تتيح هذه الواجهة آليتَين لجمع البيانات: الملفات الشخصية المستندة إلى التطبيق حيث يتحكّم تطبيقك في جمع الملفات الشخصية من البداية إلى النهاية (الإصدار 15 من Android والإصدارات الأحدث) والملفات الشخصية المستندة إلى المشغّلات حيث يتولّى النظام عملية التسجيل استجابةً للأحداث التي تسجّل اهتمامك بها على الإصدار 16 من Android (المستوى 36 من واجهة برمجة التطبيقات) والإصدارات الأحدث.

يتناول هذا الدليل المواضيع التالية:

أنواع الملفات الشخصية المتوافقة

تتيح واجهة برمجة التطبيقات ProfilingManager جمع عدة أنواع من الملفات الشخصية لتتمكّن من استهداف مشاكل محدّدة في أداء تطبيقك. يمكنك ضبط الطلبات مباشرةً باستخدام واجهات برمجة التطبيقات الخاصة بالمنصة أو باستخدام أدوات إنشاء AndroidX Core:

  • سجلّات تتبُّع النظام: يتم تسجيلها باستخدام PROFILING_TYPE_SYSTEM_TRACE أو SystemTraceRequestBuilder.
    • وهي مفيدة لتشخيص حالات التقطّع وتحليل وقت الاستجابة وتصحيح أخطاء الأداء العام.
  • لقطات لأجزاء من الذاكرة في Java: يتم التقاطها باستخدام PROFILING_TYPE_JAVA_HEAP_DUMP أو JavaHeapDumpRequestBuilder.
    • تلتقط هذه الأداة لقطة من الرسم البياني وأحجام عناصر كومة الذاكرة المؤقتة في Java لتطبيقك من أجل رصد تسرُّب الذاكرة وتحسين استخدامها.
  • لقطات العناصر المتعدّدة: يتم التقاطها باستخدام PROFILING_TYPE_HEAP_PROFILE أو HeapProfileRequestBuilder.
    • يتتبّع عمليات تخصيص الذاكرة الأصلية (أو Java اختياريًا) بمرور الوقت للمساعدة في تحسين استخدام الذاكرة.
  • أخذ عينات من تسلسل استدعاء الدوال البرمجية: يتم تسجيلها باستخدام PROFILING_TYPE_STACK_SAMPLING أو StackSamplingRequestBuilder.
    • يأخذ عيّنات من حزم تنفيذ سلاسل المحادثات لمساعدتك في فهم تنفيذ الرموز البرمجية وتحليل استخدام وحدة المعالجة المركزية.

دمج ProfilingManager مع وكيل الذكاء الاصطناعي

يمكنك استخدام وكيل ترميز بالذكاء الاصطناعي لدمج ProfilingManager في تطبيقك. على سبيل المثال، يمكنك تشغيل الطلب التالي في وكيل الترميز بالذكاء الاصطناعي لإعداد مجموعة مشغّلات "التطبيق لا يستجيب" (ANR)، مع استبدال </path/to/codebase> بمسار تطبيقك:

Read https://developer.android.com/topic/performance/tracing/profiling-manager/trigger-based-capture
and https://developer.android.com/topic/performance/tracing/profiling-manager/upload-worker
and integrate ProfilingManager ANR trigger collection (TRIGGER_TYPE_ANR) into my
app at </path/to/codebase>, including registering the result listener after app
startup completes and scheduling a WorkManager upload job when a profile is
received.

يمكنك تعديل هذا الطلب لإعداد مُشغِّلات النظام الأخرى (مثل TRIGGER_TYPE_OOM)، أو ضبط عمليات تسجيل الملفات الشخصية المستندة إلى التطبيق باستخدام دليل إنشاء الملفات الشخصية المستندة إلى التطبيق. بعد الدمج، اختبِر الإعداد محليًا باستخدام أوامر تصحيح الأخطاء لإنشاء الملفات الشخصية محليًا، وحلِّل الملفات الشخصية التي تم جمعها باستخدام وكيل الذكاء الاصطناعي.