وسيطات أدوات قياس الأداء المصغّرة

يمكنك تهيئة سلوك مقاييس الأداء عن طريق تحديد وسيطات مختلفة لسريان الأدوات. ويمكن تطبيقها على تهيئة Gradle أو إضافتها مباشرةً عند تشغيل الأدوات من سطر الأوامر.

لإعداد وسيطات قياس الأداء عند تشغيل مقاييس الأداء من "استوديو Android"، يُرجى اتّباع الخطوات التالية:

1. عدِّل إعدادات التشغيل بالنقر على تعديل واختيار الإعدادات التي تريد تعديلها.

   

   الشكل 1. عدِّل إعدادات التنفيذ.

2. عدِّل وسيطات الأدوات من خلال النقر على بجانب حقل وسيطات القياس.

   

   الشكل 2. عدِّل وسيطة قياس حالة التطبيق.

3. انقر على وأضِف وسيطة قياس حالة التطبيق المطلوبة.

   

   الشكل 3. أضِف وسيطة قياس حالة التطبيق.

additionalTestمخرجDir

تضبط هذه السياسة مكان حفظ تقارير قياس أداء JSON ونتائج المواصفات على الجهاز.

• نوع الوسيطة: سلسلة مسار الملف
• الإعدادات التلقائية على: اختبار الدليل الخارجي لحزمة APK

androidx.standard.dryRunMode.enable

يتيح لك تنفيذ مقاييس الأداء في حلقة واحدة للتحقّق من أنّها تعمل بشكل صحيح. يمكنك استخدامه مع الاختبارات العادية كجزء من التحقق.

• نوع الوسيطة: منطقي
• الإعدادات التلقائية على: false

androidx.average.iterations

يتجاوز أعداد التكرار المستهدف المستندة إلى الوقت للمساعدة في ضمان مقدار ثابت من العمل. وعادةً ما يكون ذلك مفيدًا فقط عندما يتم تفعيل إعداد الملفات التعريفية للمساعدة في ضمان كمية متسقة من العمل ضمن تقرير الملف الشخصي عند مقارنة عمليات تنفيذ أو تشغيل مختلفة. وفي سيناريوهات أخرى، من المحتمل أن يقلل هذا من دقة القياسات أو استقرارها.

• نوع الوسيطة: عدد صحيح
• القيمة التلقائية: غير محدّدة

androidx.measure.junit4.SideEffectRunListener

قد تحصل على نتائج مقياس أداء غير متسقة إذا تم تنفيذ أعمال خلفية غير ذات صلة أثناء تنفيذ المعيار.

لإيقاف العمل في الخلفية أثناء قياس الأداء، اضبط نوع وسيطة قياس الأداء listener على androidx.benchmark.junit4.SideEffectRunListener.

• نوع الوسيطة: سلسلة
• الخيارات المتاحة:
  • androidx.benchmark.junit4.SideEffectRunListener
• القيمة التلقائية: غير محدّدة

androidx.criterion.output.enable

تعمل هذه السياسة على تفعيل كتابة ملف JSON للنتيجة على وحدة تخزين خارجية.

• نوع الوسيطة: منطقي
• الإعدادات التلقائية على: true

androidx.standard.profiling.mode

يسمح هذا الخيار بالتقاط ملفات التتبُّع أثناء تشغيل مقاييس الأداء. راجِع الملف الشخصي على مقياس أداء مصغَّر للاطّلاع على الخيارات المتاحة.

• نوع الوسيطة: سلسلة
• الخيارات المتاحة:
  • MethodTracing
  • StackSampling
  • None
• الإعدادات التلقائية على: None

androidx.measure.suppressErrors

يتم قبول قائمة أخطاء مفصولة بفواصل لتحويلها إلى تحذيرات.

• نوع الوسيطة: قائمة من السلاسل
• الخيارات المتاحة:
  • DEBUGGABLE
  • LOW-BATTERY
  • EMULATOR
  • CODE-COVERAGE
  • UNLOCKED
  • SIMPLEPERF
  • ACTIVITY-MISSING
• الإعدادات التلقائية: قائمة فارغة

androidx.standard.startupMode.enable (متوقف نهائيًا)

ملاحظة: مكتبة مقياس الأداء الفائق هي الأكثر ملاءمة لبدء استخدام تطبيقات قياس أداء التطبيقات.

إعادة ضبط سلوك التكرار ليتوافق مع رمز قياس الأداء أثناء بدء التشغيل يتم تنفيذ المعايير بدون تكرار إحماء 10 قياسات. لتقليل النفقات العامة في مقاييس الأداء الصغرى، يتم إيقاف متوسط التكرار الحلقي.

• نوع الوسيطة: منطقي
• الإعدادات التلقائية على: false