मैक्रोबेंचमार्क मेट्रिक कैप्चर करें

मेट्रिक, आपके मानदंड से निकाली गई मुख्य तरह की जानकारी होती है. इन्हें measureRepeated फ़ंक्शन में List के तौर पर पास किया जाता है. इससे एक साथ कई मेज़र की गई मेट्रिक तय की जा सकती हैं. तुलना करने के लिए, कम से कम एक तरह की मेट्रिक का होना ज़रूरी है.

नीचे दिया गया कोड स्निपेट, फ़्रेम टाइमिंग और कस्टम ट्रेस सेक्शन की मेट्रिक कैप्चर करता है:

Kotlin

benchmarkRule.measureRepeated(
    packageName = TARGET_PACKAGE,
    metrics = listOf(
        FrameTimingMetric(),
        TraceSectionMetric("RV CreateView"),
        TraceSectionMetric("RV OnBindView"),
    ),
    iterations = 5,
    // ...
)

Java

benchmarkRule.measureRepeated(
    TARGET_PACKAGE,     // packageName
    Arrays.asList(      // metrics
        new StartupTimingMetric(),
        new TraceSectionMetric("RV CreateView"),
        new TraceSectionMetric("RV OnBindView"),
    ),
    5,                  // Iterations
    // ...
);

इस उदाहरण में, RV CreateView और RV OnBindView, ट्रैक किए जा सकने वाले उन ब्लॉक के आईडी हैं जिन्हें RecyclerView में तय किया गया है. createViewHolder() तरीके के सोर्स कोड से पता चलता है कि अपने कोड में ट्रैक किए जा सकने वाले ब्लॉक कैसे तय किए जा सकते हैं.

StartupTimingMetric, TraceSectionMetric, FrameTimingMetric, और PowerMetric के बारे में इस दस्तावेज़ में आगे बताया गया है. मेट्रिक की पूरी सूची देखने के लिए, Metric की सबक्लास देखें.

बेंचमार्क के नतीजे, Android Studio में दिखते हैं. जैसा कि पहली इमेज में दिखाया गया है. अगर एक से ज़्यादा मेट्रिक तय की जाती हैं, तो उन सभी को आउटपुट में शामिल किया जाता है.

पहली इमेज. TraceSectionMetric और FrameTimingMetric के नतीजे.

StartupTimingMetric

StartupTimingMetric इन वैल्यू के साथ, ऐप्लिकेशन के स्टार्टअप की टाइमिंग की मेट्रिक कैप्चर करता है:

• timeToInitialDisplayMs: सिस्टम को लॉन्च करने का इंटेंट मिलने से लेकर, डेस्टिनेशन Activity का पहला फ़्रेम रेंडर होने तक का समय.
• timeToFullDisplayMs: सिस्टम को लॉन्च करने का अनुरोध मिलने से लेकर, ऐप्लिकेशन के reportFullyDrawn() तरीके का इस्तेमाल करके पूरी तरह से ड्रॉ होने तक का समय. reportFullyDrawn() कॉल के बाद या उसमें शामिल पहले फ़्रेम को रेंडर करने के बाद, मेज़रमेंट बंद हो जाता है. ऐसा हो सकता है कि यह मेज़रमेंट, Android 10 (एपीआई लेवल 29) और उससे पहले के वर्शन पर उपलब्ध न हो.

StartupTimingMetric, स्टार्टअप के इटरेशन से कम से कम, मीडियन, और ज़्यादा से ज़्यादा वैल्यू दिखाता है. स्टार्टअप में हुए सुधार का आकलन करने के लिए, आपको माध्यिका वैल्यू पर ध्यान देना चाहिए. ऐसा इसलिए, क्योंकि ये वैल्यू स्टार्टअप में लगने वाले सामान्य समय का सबसे सही अनुमान देती हैं. ऐप्लिकेशन स्टार्टअप समय को बेहतर बनाने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन स्टार्टअप समय लेख पढ़ें.

दूसरी इमेज. StartupTimingMetric नतीजे.

FrameTimingMetric

FrameTimingMetric यह बेंचमार्क से जनरेट किए गए फ़्रेम से समय की जानकारी कैप्चर करता है. जैसे, स्क्रोलिंग या ऐनिमेशन. साथ ही, यह इन वैल्यू को आउटपुट करता है:

• frameOverrunMs: इससे पता चलता है कि किसी फ़्रेम को रेंडर करने में कितना समय लगा. पॉज़िटिव नंबर, ड्रॉप किए गए फ़्रेम और दिखने वाले जंक या स्टटर को दिखाते हैं. नेगेटिव नंबर से पता चलता है कि कोई फ़्रेम, तय समयसीमा से कितना पहले रेंडर हुआ. ध्यान दें: यह सुविधा सिर्फ़ Android 12 (एपीआई लेवल 31) और इसके बाद के वर्शन पर उपलब्ध है.
• frameDurationCpuMs: यूज़र इंटरफ़ेस (यूआई) थ्रेड और RenderThread, दोनों पर सीपीयू में फ़्रेम को रेंडर होने में लगने वाला समय.

इन मेज़रमेंट को 50वें, 90वें, 95वें, और 99वें पर्सेंटाइल के डिस्ट्रिब्यूशन में इकट्ठा किया जाता है.

रेंडर होने में ज़्यादा समय लेने वाले फ़्रेम का पता लगाने और उन्हें बेहतर बनाने के तरीके के बारे में ज़्यादा जानने के लिए, रेंडर होने में ज़्यादा समय लगना लेख पढ़ें.

तीसरी इमेज. FrameTimingMetric नतीजे.

TraceSectionMetric

एक्सपेरिमेंट के तौर पर उपलब्ध: यह क्लास एक्सपेरिमेंट के तौर पर उपलब्ध है.

TraceSectionMetric से यह पता चलता है कि दिए गए sectionName से मेल खाने वाला ट्रेस सेक्शन कितनी बार हुआ और इसमें कितना समय लगा. समय के लिए, यह कम से कम, मीडियन, और ज़्यादा से ज़्यादा समय को मिलीसेकंड में दिखाता है. ट्रेस सेक्शन को फ़ंक्शन कॉल trace(sectionName) या Trace.beginSection(sectionName) और Trace.endSection() के बीच के कोड या उनके एसिंक वैरिएंट से तय किया जाता है. यह हमेशा मेज़रमेंट के दौरान कैप्चर किए गए ट्रेस सेक्शन के पहले इंस्टेंस को चुनता है. यह डिफ़ॉल्ट रूप से, आपके पैकेज से सिर्फ़ ट्रेस सेक्शन आउटपुट करता है. आपके पैकेज से बाहर की प्रोसेस को शामिल करने के लिए, targetPackageOnly = false सेट करें.

ट्रेसिंग के बारे में ज़्यादा जानकारी के लिए, सिस्टम ट्रेसिंग की खास जानकारी और कस्टम इवेंट तय करना लेख पढ़ें.

चौथी इमेज. TraceSectionMetric नतीजे.

PowerMetric

एक्सपेरिमेंट के तौर पर उपलब्ध: यह क्लास एक्सपेरिमेंट के तौर पर उपलब्ध है.

PowerMetric से, टेस्ट की अवधि के दौरान पावर कैटगरी में हुए बदलावों का पता चलता है. चुनी गई हर कैटगरी को, मेज़र किए जा सकने वाले सब-कंपोनेंट में बांटा जाता है. साथ ही, न चुनी गई कैटगरी को "न चुनी गई" मेट्रिक में जोड़ा जाता है.

इन मेट्रिक से, पूरे सिस्टम में बैटरी की खपत का पता चलता है. इससे यह पता नहीं चलता कि हर ऐप्लिकेशन में बैटरी की कितनी खपत हुई. ये मेट्रिक, Pixel 6, Pixel 6 Pro, और इसके बाद के वर्शन वाले डिवाइसों पर ही उपलब्ध हैं:

• power<category>Uw: इस कैटगरी में टेस्ट के दौरान, बैटरी की खपत.
• energy<category>Uws: इस कैटगरी में टेस्ट के दौरान, हर यूनिट समय में ट्रांसफ़र की गई ऊर्जा की मात्रा.

कैटगरी में ये शामिल हैं:

• CPU
• DISPLAY
• GPU
• GPS
• MEMORY
• MACHINE_LEARNING
• NETWORK
• UNCATEGORIZED

कुछ कैटगरी, जैसे कि CPU के लिए, यह पता लगाना मुश्किल हो सकता है कि आपके ऐप्लिकेशन ने कितना काम किया और अन्य प्रोसेस ने कितना. इसलिए, गैर-ज़रूरी ऐप्लिकेशन और खातों को हटा दें या उनके इस्तेमाल को सीमित करें.

पांचवीं इमेज. PowerMetric नतीजे.