ضبط سلوك المكتبة باستخدام الأدوات التالية
الوسيطة. يمكنك إما إضافتها إلى إعدادات Gradle أو تطبيقها.
مباشرة عند تشغيل الأدوات من سطر الأوامر. لضبط هذه
لجميع الوسيطات لجميع عمليات تشغيل اختبارات Android Studio وسطر الأوامر، يمكنك إضافتها إلى
testInstrumentationRunnerArguments
:
android {
defaultConfig {
// ...
testInstrumentationRunnerArguments["androidx.benchmark.dryRunMode.enable"] = "true"
}
}
يمكنك أيضًا إعداد وسيطات الأدوات عند تشغيل مقاييس الأداء من "استوديو Android". لتغيير الوسيطات، يمكنك إجراء ما يلي:
- عدِّل إعدادات التشغيل بالنقر على تعديل ثم النقر على
التكوين.
الشكل 1. عدِّل إعدادات التشغيل. - عدِّل وسيطات الأدوات من خلال النقر
الشكل 2. تعديل الأداة الوسيطات
المزيد من
وسيطات قياس حالة التطبيق:
- أضف وسيطة الأداة المطلوبة بالنقر على
الشكل 3. إضافة الأداة المطلوبة الوسيطة.
إضافة ضمن أدوات قياس حالة التطبيق
مَعلمات إضافية
في حال الاتصال من سطر الأوامر مباشرةً، استخدِم -P
android.testInstrumentationRunnerArguments.[name of the argument]
.
./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile
androidx.standard.compilation.enabled
تتيح لك إيقاف التجميع بين كل تكرار لمقياس الأداء. من
بشكل افتراضي، تتم إعادة تثبيت التطبيق المستهدف وإعادة تجميعه بين كل
المعياري، التزامًا بـ CompilationMode
التي تم تمريرها إلى
measureRepeated
يتيح لك إيقاف هذا الخيار تخطي كليهما
والتجميع إذا كنت، على سبيل المثال، ترغب في تجميع البيانات المستهدفة بشكل كامل
التطبيق مرة واحدة قبل تشغيل مجموعة الاختبار وتنفيذ جميع مقاييس الأداء وفقًا لذلك
هذا الهدف المجمّع.
- نوع الوسيطة: منطقية
- الإعدادات التلقائية على:
true
androidx.benchmark.dryRunMode.enable
تتيح لك تنفيذ مقاييس الأداء في حلقة واحدة للتأكّد من عملها بشكل صحيح. ويمكنك استخدامه لإجراء اختبارات عادية كجزء من عملية إثبات الهوية.
- نوع الوسيطة: منطقية
- الإعدادات التلقائية على:
false
androidx.benchmark.enabledRules
تسمح بتشغيل الفلترة بنوع واحد فقط من الاختبارات: إنشاء الملف الشخصي الأساسي أو اختبار مقياس الأداء الكلي يمكن أيضًا استخدام القوائم المفصولة بفواصل.
- نوع الوسيطة: سلسلة
- الخيارات المتاحة:
Macrobenchmark
BaselineProfile
- الإعدادات التلقائية على: غير محدّد
androidx.criterion.junit4.SideEffectRunListener
قد تحصل على نتائج قياس غير متسقة إذا حصلت على عمل في الخلفية غير ذي صلة ويتم تنفيذه أثناء تشغيل مقياس الأداء.
لإيقاف العمل في الخلفية أثناء قياس الأداء، يجب ضبط listener
.
نوع وسيطة قياس حالة التطبيق إلى
androidx.benchmark.junit4.SideEffectRunListener
- نوع الوسيطة: سلسلة
- الخيارات المتاحة:
androidx.benchmark.junit4.SideEffectRunListener
- الإعدادات التلقائية على: غير محدّدة
androidx.standard.fullTracing.enable
تعمل هذه السياسة على تفعيل نقاط تتبُّع androidx.tracing.perfetto
، مثل Jetpack Compose.
وتتبع المقطوعة الموسيقية.
تحتاج إلى إعداد المشروع لتتمكن من تسجيل تتبع المقطوعة الموسيقية عن المعايير لمزيد من المعلومات، يُرجى الاطّلاع على التقاط بيانات تتبُّع باستخدام Jetpack. مقياس الأداء الكلي
- نوع الوسيطة: منطقية
- الإعدادات التلقائية على:
false
androidx.standard.profiling.mode
تسمح بالتقاط ملفات التتبُّع أثناء تشغيل مقاييس الأداء. الخيارات المتاحة هي نظيرها في مكتبة المعايير الصغرى - لمزيد من المعلومات، راجع الأوصاف الموجودة في تقديم مقياس أداء مصغّر
- نوع الوسيطة: سلسلة
- الخيارات المتاحة:
MethodTracing
StackSampling
None
- الإعدادات التلقائية على:
None
androidx.benchmark.startupProfiles.enable
يسمح لك هذا الخيار بإيقاف إنشاء الملفات الشخصية للشركات الناشئة أثناء قياس الأداء.
- نوع الوسيطة: منطقية
- الإعدادات التلقائية على:
true
androidx.standard.suppressErrors
تقبل قائمة الأخطاء المفصولة بفواصل لتحويلها إلى تحذيرات.
- نوع الوسيطة: قائمة بالسلاسل
الخيارات المتاحة:
DEBUGGABLE
يشير الخطأ
DEBUGGABLE
إلى أنّ الحزمة المستهدفة تعمل مع.debuggable=true
في ملف البيان الخاص به، ما يقلل بشكل كبير من وقت التشغيل الأداء لدعم ميزات تصحيح الأخطاء. لتجنب هذا الخطأ، قم بتشغيل مقاييس الأداء معdebuggable=false
. تؤثر الوسيطة التي يمكن تصحيح الأخطاء عليها في سرعة التنفيذ بطرق قد لا تتيحها تحسينات مقياس الأداء إلى تجربة المستخدم الحقيقية أو قد يتراجع أداء الإصدار.LOW-BATTERY
عندما تكون طاقة البطارية منخفضة، تعمل الأجهزة غالبًا على خفض مستوى الأداء لتوفير الطاقة المتبقية. البطارية، عن طريق تعطيل النوى الكبيرة على سبيل المثال. يحدث هذا حتى عندما توصيل الأجهزة. عدم حجب هذا الخطأ إلا إذا تعمّدت ذلك تحليل التطبيق مع انخفاض الأداء.
EMULATOR
يخبرك الخطأ
EMULATOR
بأنّ مقياس الأداء يعمل الذي لا يمثل أجهزة المستخدمين الحقيقية. المحاكي قد لا يتم نقل تحسينات مقياس الأداء إلى تجربة المستخدم الحقيقية. أو قد تتراجع عن الأداء الحقيقي للجهاز. يجب عليك استخدام مخطط قياس الأداء بدلاً من ذلك. يمكنك منع هذا الخطأ بحذر شديد.NOT-PROFILEABLE
يتم تشغيل الحزمة المستهدفة
$packageName
بدون<profileable shell=true>
يجب أن تتوفّر ميزة "إتاحة الملف الشخصي" على نظامَي التشغيل Android 10 وAndroid 11. للسماح لمعيار ماكرو بالتقاط معلومات تعقب تفصيلية من الهدف مثل أقسام تتبُّع النظام المحدّدة في التطبيق المكتبات. يمكنك منع هذا الخطأ بحذر شديد.METHOD-TRACING-ENABLED
يتضمن تشغيل مقياس الأداء الفائق للتطبيق الذي يتم قياسه على تتبع طُرق مفعّلة. يؤدي ذلك إلى تشغيل الجهاز الافتراضي بشكل أبطأ من المعتاد، لذا ننصحك فقط المقاييس من ملفات التتبُّع في المصطلحات النسبية، على سبيل المثال، ويقارن مدى سرعة الجري الأول بالجري الثاني. إيقاف هذه نتائج غير دقيقة إذا قارنت مقاييس الأداء بخيارات تتبع الطرق المختلفة.
الإعدادات التلقائية على: قائمة فارغة
اختبار مخرج إضافي
تضبط هذه السياسة أماكن حفظ تقارير مقياس أداء JSON ونتائج تحديد المواصفات الشخصية. الخاص بك.
- نوع الوسيطة: سلسلة المسار
- الإعدادات التلقائية: اختبار الدليل الخارجي لملف APK
أفلام مُقترَحة لك
- ملاحظة: يظهر نص الرابط عند إيقاف JavaScript
- الوسيطات المتعلّقة بقياس الأداء المصغَّر
- إنشاء ملفات شخصية لمراجعي المحتوى
- مكتبة JankStats