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

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

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

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

सिस्टम ट्रेस रिकॉर्ड करना

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

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

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

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

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

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

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

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

   

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

   

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

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

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

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

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

   

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

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

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

3. क्विक सेटिंग पैनल में जाकर, सिस्टम ट्रैकिंग टाइल या सिस्टम ट्रैकिंग की सूचना पर टैप करके, ट्रैकिंग बंद करें.

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

   

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

सिस्टम ट्रेस शेयर करें

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

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

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

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

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

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

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

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

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

अलग-अलग ट्रेस फ़ॉर्मैट में बदलना

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

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

ट्रेस शेयर करते समय, रिपोर्ट अपने-आप .perfetto-trace फ़ाइल में Android 10 वर्शन वाले डिवाइस या बाद के वर्शन, या अन्य सभी वर्शन के लिए एक .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 Open Source Project से डाउनलोड किया जा सकता है.