डिवाइस पर सिस्टम ट्रेस कैप्चर करना

Android 9 (एपीआई लेवल 28) या इसके बाद के वर्शन वाले डिवाइसों में, सिस्टम-लेवल का एक ऐप्लिकेशन होता है. इसे सिस्टम ट्रेस करने वाला टूल कहा जाता है. यह ऐप्लिकेशन, systrace कमांड-लाइन यूटिलिटी की तरह है. हालांकि, इस ऐप्लिकेशन की मदद से, टेस्ट डिवाइस से सीधे ट्रेस रिकॉर्ड किए जा सकते हैं. इसके लिए, डिवाइस को प्लग इन करने और adb से कनेक्ट करने की ज़रूरत नहीं होती. इसके बाद, ऐप्लिकेशन का इस्तेमाल करके, इन ट्रेस के नतीजों को अपनी डेवलपमेंट टीम के साथ शेयर किया जा सकता है.

Android 10 और इसके बाद के वर्शन वाले डिवाइस, ट्रेस को Perfetto फ़ॉर्मैट में रिकॉर्ड करते हैं. वहीं, इससे पहले के वर्शन वाले डिवाइस, ट्रेस को Systrace फ़ॉर्मैट में रिकॉर्ड करते हैं. हमारा सुझाव है कि दोनों फ़ॉर्मैट खोलने और ट्रेस का विश्लेषण करने के लिए, Perfetto ट्रेस व्यूअर का इस्तेमाल करें.

इससे आपके ऐप्लिकेशन में परफ़ॉर्मेंस से जुड़ी गड़बड़ियों को ठीक करते समय, ट्रेस रिकॉर्ड करने में मदद मिलती है. जैसे, ऐप्लिकेशन का धीरे-धीरे चालू होना, ट्रांज़िशन धीमा होना या यूज़र इंटरफ़ेस (यूआई) का रुक-रुककर चलना.

सिस्टम ट्रेस करने की प्रक्रिया को रिकॉर्ड करना

सिस्टम ट्रेस करने वाले टूल की मदद से, क्विक सेटिंग टाइल या ऐप्लिकेशन में मौजूद मेन्यू का इस्तेमाल करके, सिस्टम ट्रेस करने की प्रक्रिया को रिकॉर्ड किया जा सकता है. यहां दिए गए सेक्शन में, इन इंटरफ़ेस का इस्तेमाल करके रिकॉर्डिंग की प्रोसेस को पूरा करने का तरीका बताया गया है.

ध्यान दें: डेवलपमेंट वर्कफ़्लो के तहत, डिवाइस पर मौजूद गड़बड़ी की रिपोर्ट सबमिट की जा सकती है. सिस्टम ट्रेस करने की प्रोसेस पूरी होने के बाद, गड़बड़ी की इस तरह की रिपोर्ट सबमिट करना ज़रूरी है. इस तरह, गड़बड़ी की रिपोर्ट जनरेट करने की प्रोसेस, रिकॉर्ड किए गए ट्रेस में शामिल नहीं होती.

क्विक सेटिंग टाइल का इस्तेमाल करके रिकॉर्ड करना

क्विक सेटिंग टाइल, आम तौर पर उपयोगकर्ता के डिवाइस पर सिस्टम ट्रेस करने की प्रक्रिया को पूरा करने का ज़्यादा आसान तरीका है.

टाइल सेट अप करना

अगर आपने टेस्ट डिवाइस पर पहली बार सिस्टम ट्रेस करने वाले टूल का इस्तेमाल किया है या आपको डिवाइस के क्विक सेटिंग पैनल में सिस्टम ट्रेस करने वाले टूल की टाइल नहीं दिखती है, जैसा कि इमेज 2 में दिखाया गया है, तो सेटअप करने के लिए यह तरीका अपनाएं:

1. डेवलपर के लिए सेटिंग और टूल चालू करें.
2. डेवलपर के लिए सेटिंग और टूल की सेटिंग स्क्रीन खोलें.
3. डीबग करना सेक्शन में, सिस्टम ट्रेस करने वाला टूल चुनें. सिस्टम ट्रेस करने वाला ऐप्लिकेशन खुल जाएगा और ऐप्लिकेशन मेन्यू दिखेगा.

4. ऐप्लिकेशन मेन्यू में जाकर, क्विक सेटिंग टाइल दिखाएं को चालू करें. इसके लिए, इमेज 1 देखें. सिस्टम, क्विक सेटिंग पैनल में सिस्टम ट्रेस करने वाला टूल टाइल जोड़ता है. जैसा कि इमेज 2 में दिखाया गया है:

   

   पहली इमेज. सिस्टम ट्रेस करने वाले ऐप्लिकेशन में, क्विक सेटिंग टाइल दिखाएं स्विच.

   

   इमेज 2. क्विक सेटिंग पैनल में मौजूद, सिस्टम ट्रेस करने वाला टूल टाइल.

   ध्यान दें: डिफ़ॉल्ट रूप से, सिस्टम क्विक सेटिंग पैनल में पहली टाइल के तौर पर, सिस्टम ट्रेस करने वाले टूल की टाइल जोड़ता है. अगर आपको टाइल को किसी दूसरी जगह पर दिखाना है, तो पैनल के एडिट मोड का इस्तेमाल करके टाइल को दूसरी जगह पर ले जाएं.

सिस्टम ट्रेस करने की रिकॉर्डिंग पूरी करना

क्विक सेटिंग पैनल का इस्तेमाल करके, सिस्टम ट्रेस करने की प्रक्रिया रिकॉर्ड करने के लिए, यह तरीका अपनाएं:

1. सिस्टम ट्रेस करने वाला टूल टाइल पर टैप करें. इस पर ट्रेस रिकॉर्ड करें लेबल होता है. इसके बाद, टाइल चालू हो जाती है और आपको लगातार एक सूचना दिखती है. इससे आपको पता चलता है कि सिस्टम, ट्रेस रिकॉर्ड कर रहा है. जैसा कि तीसरे चित्र में दिखाया गया है:

   

   तीसरी इमेज. उपयोगकर्ता के डिवाइस पर सिस्टम ट्रेस करने की प्रक्रिया शुरू होने के बाद दिखने वाली स्थायी सूचना.

2. अपने ऐप्लिकेशन में वे कार्रवाइयां करें जिनकी आपको सिस्टम से जांच करानी है.

   ध्यान दें: सिस्टम ट्रेस करने वाले टूल को बैकग्राउंड में चालू रखकर, उन गड़बड़ियों को रिकॉर्ड किया जा सकता है जिन्हें फिर से जनरेट करना मुश्किल होता है. इसके बाद, गड़बड़ी होने के तुरंत बाद सिस्टम ट्रेस करने वाले टूल को बंद कर दें. सिस्टम ट्रेस करने वाला टूल, डिवाइस की गतिविधि को रोलिंग बफ़र में सेव करता है. इसमें 10 से 30 सेकंड के इवेंट सेव होते हैं.

3. सिस्टम ट्रेस करने की प्रक्रिया को रोकने के लिए, क्विक सेटिंग पैनल में मौजूद सिस्टम ट्रेस करने वाला टूल टाइल पर टैप करें. इसके अलावा, सिस्टम ट्रेस करने की प्रक्रिया से जुड़ी सूचना पर टैप करके भी इसे रोका जा सकता है.

   सिस्टम एक नई सूचना दिखाता है, जिसमें "ट्रेस सेव किया जा रहा है" मैसेज होता है. सेव करने की प्रोसेस पूरी होने पर, सिस्टम सूचना को खारिज कर देता है और तीसरी सूचना दिखाता है. इससे यह पुष्टि होती है कि आपका ट्रेस सेव हो गया है और आप सिस्टम ट्रेस शेयर करने के लिए तैयार हैं. जैसा कि इमेज 4 में दिखाया गया है:

   

   चौथी इमेज. सिस्टम के रिकॉर्ड किए गए ट्रेस को सेव करने के बाद, दिखने वाली सूचना.

ऐप्लिकेशन मेन्यू का इस्तेमाल करके रिकॉर्ड करना

ऐप्लिकेशन मेन्यू में जाकर, सिस्टम ट्रेस करने की प्रक्रिया से जुड़ी कई ऐडवांस सेटिंग कॉन्फ़िगर की जा सकती हैं. साथ ही, सिस्टम ट्रेस करने की प्रक्रिया को शुरू और बंद करने के लिए स्विच भी मिलता है.

सिस्टम ट्रेस करने वाले टूल के ऐप्लिकेशन मेन्यू का इस्तेमाल करके, सिस्टम ट्रेस को रिकॉर्ड करने के लिए, यह तरीका अपनाएं:

1. डेवलपर के लिए सेटिंग और टूल चालू करें.

2. डेवलपर के लिए सेटिंग और टूल की सेटिंग स्क्रीन खोलें. डीबगिंग सेक्शन में, सिस्टम ट्रेस करने वाला टूल चुनें. सिस्टम ट्रेस करने वाला ऐप्लिकेशन खुल जाएगा.

   इसके अलावा, अगर आपने सिस्टम ट्रेस करने वाले टूल की टाइल सेट अप की है, तो सिस्टम ट्रेस करने वाले टूल के ऐप्लिकेशन में जाने के लिए, टाइल को टैप करके रखें.

3. पक्का करें कि डीबग किए जा सकने वाले ऐप्लिकेशन ट्रेस करें को चुना गया हो, ताकि सिस्टम ट्रेस में डीबग करने की सुविधा वाले ऐप्लिकेशन शामिल किए जा सकें.

4. सिस्टम और सेंसर कॉल को ट्रेस करने के लिए, कैटगरी चुनें. साथ ही, केबी में हर सीपीयू के लिए बफ़र साइज़ चुनें. ऐसी कैटगरी चुनें जो आपके टेस्ट किए जा रहे इस्तेमाल के उदाहरण से मेल खाती हों. जैसे, ब्लूटूथ की परफ़ॉर्मेंस की जांच करने के लिए ऑडियो कैटगरी या हीप ऐलोकेशन के लिए मेमोरी कैटगरी.

   ध्यान दें: ये कैटगरी, ऐप्लिकेशन-लेवल की सेटिंग के तौर पर काम करती हैं. इसलिए, क्विक सेटिंग टाइल का इस्तेमाल करते समय भी सिस्टम इन कैटगरी का इस्तेमाल करता है. इसके अलावा, डिवाइस को रीबूट करने पर भी ये सेटिंग बनी रहती हैं.

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

6. ट्रेस रिकॉर्ड करें स्विच को चालू करें. इसे इमेज 5 में हाइलाइट किया गया है. इसके बाद, टाइल चालू हो जाती है और आपको एक सूचना दिखती है. इसमें बताया जाता है कि सिस्टम, ट्रेस रिकॉर्ड कर रहा है. जैसा कि तीसरी इमेज में दिखाया गया है.

   

   पांचवीं इमेज. सिस्टम ट्रेस करने की सेटिंग में मौजूद, ट्रेस रिकॉर्ड करें स्विच.

7. अपने ऐप्लिकेशन में वे कार्रवाइयां करें जिनकी आपको सिस्टम से जांच करानी है.

   ध्यान दें: सिस्टम ट्रेस करने वाले टूल को बैकग्राउंड में चालू रखकर, उन गड़बड़ियों को रिकॉर्ड किया जा सकता है जिन्हें फिर से जनरेट करना मुश्किल होता है. इसके बाद, गड़बड़ी होने के तुरंत बाद सिस्टम ट्रेस करने वाले टूल को बंद कर दें. डिफ़ॉल्ट रूप से, सिस्टम ट्रेस करने वाला टूल, डिवाइस की गतिविधि को रोलिंग बफ़र में सेव करता है. इसमें 10 से 30 सेकंड के इवेंट सेव होते हैं. लॉन्ग ट्रेस चालू होने पर, डिवाइस की गतिविधि को डिवाइस के स्टोरेज में लगातार सेव किया जाता है. ऐसा तब तक किया जाता है, जब तक कि तय की गई सीमा पूरी नहीं हो जाती.

8. ट्रेस रिकॉर्ड करें स्विच को बंद करके, ट्रेस करना बंद करें.

   सिस्टम एक नई सूचना दिखाता है, जिसमें "ट्रेस सेव किया जा रहा है" मैसेज होता है. सेव होने के बाद, सिस्टम सूचना को खारिज कर देता है और तीसरी सूचना दिखाता है. इससे यह पुष्टि होती है कि आपका ट्रेस सेव हो गया है और आप सिस्टम ट्रेस शेयर करने के लिए तैयार हैं. जैसा कि इमेज 4 में दिखाया गया है.

सिस्टम ट्रेस करने की प्रोसेस शेयर करना

सिस्टम ट्रेस करने वाला टूल, सिस्टम ट्रेस करने की प्रक्रिया के नतीजों को कई अलग-अलग वर्कफ़्लो के हिस्से के तौर पर शेयर करने में आपकी मदद करता है. Android 10 (एपीआई लेवल 29) या इसके बाद के वर्शन वाले डिवाइस पर, ट्रेस फ़ाइलें .perfetto-trace फ़ाइल नाम एक्सटेंशन के साथ सेव की जाती हैं. इन्हें Perfetto यूज़र इंटरफ़ेस (यूआई) में खोला जा सकता है. Android के पुराने वर्शन पर चलने वाले डिवाइस पर, ट्रेस फ़ाइलें .ctrace फ़ाइल नाम एक्सटेंशन के साथ सेव की जाती हैं. यह एक्सटेंशन, Systrace फ़ॉर्मैट को दिखाता है.

मैसेज के तौर पर शेयर करना

सिस्टम ट्रेस करने वाले टूल की मदद से, इकट्ठा किए गए ट्रेस को अपने डिवाइस पर मौजूद अन्य ऐप्लिकेशन के साथ शेयर किया जा सकता है. ट्रेस को ईमेल या गड़बड़ी को ट्रैक करने वाले ऐप्लिकेशन के ज़रिए, अपनी डेवलपमेंट टीम को भेजा जा सकता है. इसके लिए, आपको डिवाइस को अपनी डेवलपमेंट मशीन से कनेक्ट करने की ज़रूरत नहीं है.

सिस्टम ट्रेस रिकॉर्ड करने के बाद, डिवाइस पर दिखने वाली सूचना पर टैप करें. यह सूचना, चौथी इमेज में दिखाई गई सूचना जैसी होती है. प्लैटफ़ॉर्म का इंटेंट पिकर दिखता है. इससे, अपनी पसंद के मैसेजिंग ऐप्लिकेशन का इस्तेमाल करके, ट्रेस शेयर किया जा सकता है.

Files ऐप्लिकेशन से शेयर करना

Android 10 (एपीआई लेवल 29) या इसके बाद के वर्शन वाले डिवाइसों पर, ट्रेस Files ऐप्लिकेशन में दिखते हैं. इस ऐप्लिकेशन से ट्रेस शेयर किया जा सकता है.

एडीबी का इस्तेमाल करके रिपोर्ट डाउनलोड करना

adb का इस्तेमाल करके, किसी डिवाइस से सिस्टम ट्रेस भी निकाला जा सकता है. ट्रेस रिकॉर्ड करने के लिए इस्तेमाल किए गए डिवाइस को अपनी डेवलपमेंट मशीन से कनेक्ट करें. इसके बाद, टर्मिनल विंडो में ये कमांड चलाएं:

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

ट्रेस फ़ॉर्मैट को आपस में बदलना

Perfetto ट्रेस फ़ाइलों को Systrace फ़ॉर्मैट में बदला जा सकता है. ज़्यादा जानकारी के लिए, ट्रेस फ़ॉर्मैट के बीच कन्वर्ज़न देखें.

एचटीएमएल रिपोर्ट बनाना

ट्रेस शेयर करते समय, Android 10 या इसके बाद के वर्शन वाले डिवाइसों पर रिपोर्ट .perfetto-trace फ़ाइल में होती है. इसके अलावा, अन्य सभी वर्शन के लिए रिपोर्ट .ctrace फ़ाइल में होती है.

वेब पर आधारित यूज़र इंटरफ़ेस (यूआई) या कमांड लाइन का इस्तेमाल करके, ट्रेस फ़ाइल से एचटीएमएल रिपोर्ट बनाएं.

वेब पर आधारित यूज़र इंटरफ़ेस (यूआई)

ट्रेस फ़ाइल खोलने और रिपोर्ट जनरेट करने के लिए, Perfetto यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करें.

Perfetto फ़ाइल के लिए, ट्रेस फ़ाइल खोलें पर क्लिक करें. Systrace फ़ाइल के लिए, लेगसी यूज़र इंटरफ़ेस (यूआई) की मदद से खोलें पर क्लिक करें. लेगसी यूज़र इंटरफ़ेस (यूआई) का लुक और स्टाइल, Systrace रिपोर्ट जैसा ही है.

कमांड लाइन

ट्रेस फ़ाइल से एचटीएमएल रिपोर्ट जनरेट करने के लिए, टर्मिनल विंडो में ये कमांड चलाएं:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

अगर आपके पास पहले से systrace कमांड-लाइन प्रोग्राम नहीं है, तो इसे GitHub पर Catapult प्रोजेक्ट से या सीधे Android ओपन सोर्स प्रोजेक्ट से डाउनलोड किया जा सकता है.