إضافة وسيطات قياس حالة التطبيق

ضبط سلوك المكتبة باستخدام الأدوات التالية الوسيطة. يمكنك إما إضافتها إلى إعدادات Gradle أو تطبيقها. مباشرة عند تشغيل الأدوات من سطر الأوامر. لضبط هذه لجميع الوسيطات لجميع عمليات تشغيل اختبارات Android Studio وسطر الأوامر، يمكنك إضافتها إلى testInstrumentationRunnerArguments:

android {
    defaultConfig {
        // ...
        testInstrumentationRunnerArguments["androidx.benchmark.dryRunMode.enable"] = "true"
    }
}

يمكنك أيضًا إعداد وسيطات الأدوات عند تشغيل مقاييس الأداء من "استوديو Android". لتغيير الوسيطات، يمكنك إجراء ما يلي:

في حال الاتصال من سطر الأوامر مباشرةً، استخدِم -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