كتابة مقياس أداء مصغّر

للتعرّف على كيفية استخدام مكتبة Microbenchmark من خلال إضافة تغييرات إلى код التطبيق، اطّلِع على قسم البدء السريع. للتعرّف على كيفية إكمال عملية إعداد كاملة مع إجراء تغييرات أكثر تعقيدًا على قاعدة بياناتك، اطّلِع على القسم إعداد المشروع بالكامل.

البدء السريع

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

لإجراء تحليل مقارن لمرة واحدة، اتّبِع الخطوات التالية:

1. أضِف المكتبة إلى ملف build.gradle أو build.gradle.kts الخاص بالوحدة:

   Kotlin

   dependencies {
       implementation("androidx.benchmark:benchmark-junit4:1.2.4")
   }

   رائع

   dependencies {
       implementation 'androidx.benchmark:benchmark-junit4:1.2.4'
   }

   استخدِم تبعية implementation بدلاً من تبعية androidTestImplementation. في حال استخدام androidTestImplementation، يتعذّر تشغيل معايير الأداء لأنّه لم يتم دمج بيان المكتبة في بيان التطبيق.

2. عدِّل نوع إصدار debug كي لا يمكن تصحيح الأخطاء فيه:

   Kotlin

   android {
       ...
       buildTypes {
           debug {
               isDebuggable = false
           }
       }
   }

   رائع

   android {
       ...
       buildTypes {
           debug {
               debuggable false
           }
       }
   }

3. غيِّر testInstrumentationRunner إلى AndroidBenchmarkRunner:

   Kotlin

   android {
       ...
       defaultConfig {
           testInstrumentationRunner = "androidx.benchmark.junit4.AndroidBenchmarkRunner"
       }
   }

   رائع

   android {
       ...
       defaultConfig {
           testInstrumentationRunner "androidx.benchmark.junit4.AndroidBenchmarkRunner"
       }
   }

4. أضِف مثيل BenchmarkRule في ملف اختبار في الدليل androidTest لإضافة مقياس الأداء. لمزيد من المعلومات حول كتابة مقاييس الأداء، يُرجى الاطّلاع على مقالة إنشاء فئة اختبارات الأداء الدقيقة.

   يوضّح مقتطف الرمز البرمجي التالي كيفية إضافة مقياس أداء إلى اختبار مزوّد بأدوات قياس الأداء:

   Kotlin

   @RunWith(AndroidJUnit4::class)
   class SampleBenchmark {
       @get:Rule
       val benchmarkRule = BenchmarkRule()
   
       @Test
       fun benchmarkSomeWork() {
           benchmarkRule.measureRepeated {
               doSomeWork()
           }
       }
   }
   SampleBenchmark.kt

   Java

   @RunWith(AndroidJUnit4.class)
   class SampleBenchmark {
       @Rule
       public BenchmarkRule benchmarkRule = new BenchmarkRule();
   
       @Test
       public void benchmarkSomeWork() {
               BenchmarkRuleKt.measureRepeated(
                   (Function1<BenchmarkRule.Scope, Unit>) scope -> doSomeWork()
               );
          }
       }
   }

للتعرّف على كيفية كتابة مقياس أداء، انتقِل إلى إنشاء فئة اختبار أداء صغير.

إعداد المشروع بالكامل

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

ولأنّ مقياس Microمقياس الأداء يشغّل التعليمة البرمجية مباشرةً، فضع الكود الذي تريد قياسه في وحدة Gradle منفصلة واضبط التبعية على تلك الوحدة كما هو موضح في الشكل 1.

لإضافة وحدة Gradle جديدة، يمكنك استخدام معالج الوحدة في "استوديو Android". ينشئ المعالج وحدة تم ضبطها مسبقًا لقياس الأداء، مع إضافة ملف تعريف directory لقياس الأداء وضبط debuggable على false.

1. انقر بزر الماوس الأيمن على مشروعك أو وحدتك في لوحة المشروع في "استوديو Android"، ثم انقر على جديد > وحدة.

2. حدِّد مقياس الأداء في جزء النماذج.

3. اختَر مقياس الأداء المصغَّر كنوع وحدة قياس الأداء.

4. اكتب "مقياس الأداء المصغَّر" لاسم الوحدة.

5. انقر على إنهاء.

بعد إنشاء الوحدة، غيِّر ملف build.gradle أو build.gradle.kts وأضِف androidTestImplementation إلى الوحدة التي تحتوي على الرمز البرمجي لقياس الأداء:

dependencies {
    // The module name might be different.
    androidTestImplementation(project(":benchmarkable"))
}

dependencies {
    // The module name might be different.
    androidTestImplementation project(':benchmarkable')
}

إنشاء فئة اختبار أداء صغير

معايير الأداء هي اختبارات قياس حالة التطبيق العادية. لإنشاء مقياس أداء، استخدِم فئة BenchmarkRule التي تقدّمها المكتبة. لقياس الأنشطة، استخدِم ActivityScenario أو ActivityScenarioRule. لقياس أداء رمز واجهة المستخدم، استخدِم @UiThreadTest.

تعرِض التعليمة البرمجية التالية نموذجًا لمقياس الأداء:

@RunWith(AndroidJUnit4::class)
class SampleBenchmark {
    @get:Rule
    val benchmarkRule = BenchmarkRule()

    @Test
    fun benchmarkSomeWork() {
        benchmarkRule.measureRepeated {
            doSomeWork()
        }
    }
}
SampleBenchmark.kt
    

@RunWith(AndroidJUnit4.class)
class SampleBenchmark {
    @Rule
    public BenchmarkRule benchmarkRule = new BenchmarkRule();

    @Test
    public void benchmarkSomeWork() {
        final BenchmarkState state = benchmarkRule.getState();
        while (state.keepRunning()) {
            doSomeWork();
        }
    }
}
    

إيقاف التوقيت لعملية الإعداد

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

// using random with the same seed, so that it generates the same data every run
private val random = Random(0)

// create the array once and just copy it in benchmarks
private val unsorted = IntArray(10_000) { random.nextInt() }

@Test
fun benchmark_quickSort() {
    // ...
    benchmarkRule.measureRepeated {
        // copy the array with timing disabled to measure only the algorithm itself
        listToSort = runWithTimingDisabled { unsorted.copyOf() }

        // sort the array in place and measure how long it takes
        SortingAlgorithms.quickSort(listToSort)
    }

    // assert only once not to add overhead to the benchmarks
    assertTrue(listToSort.isSorted)
}
SortingBenchmarks.kt
    

private final int[] unsorted = new int[10000];

public SampleBenchmark() {
    // Use random with the same seed, so that it generates the same data every
    // run.
    Random random = new Random(0);

    // Create the array once and copy it in benchmarks.
    Arrays.setAll(unsorted, (index) -> random.nextInt());
}

@Test
public void benchmark_quickSort() {
    final BenchmarkState state = benchmarkRule.getState();

    int[] listToSort = new int[0];

    while (state.keepRunning()) {
        
        // Copy the array with timing disabled to measure only the algorithm
        // itself.
        state.pauseTiming();
        listToSort = Arrays.copyOf(unsorted, 10000);
        state.resumeTiming();
        
        // Sort the array in place and measure how long it takes.
        SortingAlgorithms.quickSort(listToSort);
    }

    // Assert only once, not to add overhead to the benchmarks.
    assertTrue(SortingAlgorithmsKt.isSorted(listToSort));
}
    

حاوِل تقليل مقدار العمل المنجز داخل الجزء measureRepeated وداخل runWithTimingDisabled. يتم تشغيل الرمز البرمجي measureRepeated عدة مرات ويمكن أن يؤثر ذلك في إجمالي الوقت اللازم لتنفيذ الاختبار القياسي. إذا كنت بحاجة إلى التحقّق من بعض نتائج أحد مقاييس الأداء، يمكنك تأكيد النتيجة الأخيرة بدلاً من إجراء ذلك في كلّ تكرار لمقياس الأداء.

تشغيل مقياس الأداء

في Android Studio، يمكنك تنفيذ اختبار الأداء كما تفعل مع أي @Test باستخدام إجراء الفاصل بجانب فئة الاختبار أو الطريقة، كما هو موضّح في الشكل 3.

بدلاً من ذلك، يمكنك تشغيل connectedCheck من سطر الأوامر لإجراء كل الاختبارات من وحدة Gradle المحدّدة:

./gradlew benchmark:connectedCheck

أو اختبار واحد:

./gradlew benchmark:connectedCheck -P android.testInstrumentationRunnerArguments.class=com.example.benchmark.SampleBenchmark#benchmarkSomeWork

نتائج قياس الأداء

بعد إجراء اختبار Microbenchmark بنجاح، يتم عرض المقاييس مباشرةً في Android IDE، ويتوفّر تقرير اختبار أداء كامل بتنسيق JSON يحتوي على مقاييس إضافية ومعلومات عن الجهاز.

تتم أيضًا نسخ تقارير JSON وأي عمليات تتبُّع لإعداد الملفات الشخصية تلقائيًا من الجهاز إلى المضيف. يتم تسجيل هذه الرسائل على الجهاز المضيف في الموقع التالي:

project_root/module/build/outputs/connected_android_test_additional_output/debugAndroidTest/connected/device_id/

يتم تلقائيًا كتابة تقرير JSON على القرص على الجهاز في مجلد الوسائط المشتركة الخارجي لحزمة APK الاختبارية، والذي يقع عادةً في /storage/emulated/0/Android/media/**app_id**/**app_id**-benchmarkData.json.

أخطاء في الإعدادات

ترصد المكتبة الشروط التالية لضمان إعداد مشروعك وبيئة العمل لتحقيق أداء دقيق في الإصدار:

• تم ضبط خيار تصحيح الأخطاء على false.
• يجري استخدام جهاز مادي - المحاكيات غير متوافقة.
• يتم قفل الساعات إذا كان الجهاز مزوّدًا بإذن الوصول إلى الجذر.
• يجب أن يكون مستوى شحن البطارية في الجهاز كافيًا بنسبة لا تقل عن %25.

إذا تعذّر إجراء أيّ من عمليات التحقّق السابقة، يُبلغ مقياس الأداء عن خطأ بهدف تجنّب إجراء قياسات غير دقيقة.

ولمنع أنواع معيّنة من الأخطاء كتحذيرات ومنعها من تعليق مقياس الأداء، عليك تمرير نوع الخطأ في قائمة مفصولة بفواصل إلى وسيطة الأداة androidx.benchmark.suppressErrors.

يمكنك تعيين هذا من نص Gradle البرمجي، كما هو موضح في المثال التالي:

android {
    defaultConfig {
       …
      testInstrumentationRunnerArguments["androidx.benchmark.suppressErrors"] = "DEBUGGABLE,LOW-BATTERY"
    }
}

android {
    defaultConfig {
       …
      testInstrumentationRunnerArguments["androidx.benchmark.suppressErrors"] = "DEBUGGABLE,LOW-BATTERY"
    }
}

يمكنك أيضًا إخفاء الأخطاء من سطر الأوامر:

$ ./gradlew :benchmark:connectedCheck -P andoidtestInstrumentationRunnerArguments.androidx.benchmark.supperssErrors=DEBUGGABLE,LOW-BATTERY

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