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

मेट्रिक मुख्य रूप से आपके मानदंडों से ली गई जानकारी होती है. वे 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 शामिल हैं इस दस्तावेज़ में बाद में इस बारे में बताया है.

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

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

Startup समय मेट्रिक

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

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

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

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

फ़्रेम टाइमिंग मेट्रिक

FrameTimingMetric एक मानदंड से बने फ़्रेम से समय की जानकारी कैप्चर करता है, जैसे कि या नीचे दी गई वैल्यू दिखाता है:

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

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

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

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

ट्रेस सेक्शन मेट्रिक

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

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

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

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

पावरमेट्रिक

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

PowerMetric मीडिया आइटम दिए गए डेटा के लिए, आपके टेस्ट के दौरान पावर या ऊर्जा में बदलाव पावर कैटगरी. चुनी गई हर कैटगरी को, मेज़र किए जा सकने वाले सबकॉम्पोनेंट में बांटा जाता है और नहीं चुनी गई कैटगरी "नहीं चुनी गई" में जोड़ दी जाती हैं मेट्रिक के हिसाब से फ़िल्टर करें.

ये मेट्रिक किसी एक ऐप्लिकेशन के हिसाब से इस्तेमाल न किया जाता हो, न कि पूरे सिस्टम में होने वाला उपभोग, और ये सीमित होते हैं Pixel 6, Pixel 6 Pro, और उसके बाद के वर्शन वाले डिवाइसों के लिए:

• power<category>Uw: इस अवधि के दौरान बिजली की खपत इस कैटगरी में टेस्ट करें.
• energy<category>Uws: यह इस कैटगरी में आपके टेस्ट की अवधि.

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

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

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

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