अपने ऐप्लिकेशन में बदलाव करके ट्रेस लॉग जनरेट करें

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

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

ट्रेस लॉग जनरेट करने से पहले, पक्का करें कि आपके ऐप्लिकेशन में ट्रेस लॉग को ऐप्लिकेशन के लिए खास डायरेक्ट्री में सेव करने का लॉजिक जोड़ा गया हो.

अपने ऐप्लिकेशन को इंस्ट्रूमेंट करना

ट्रेस लॉग बनाने के लिए, startMethodTracing() को कॉल करें. इससे सिस्टम, ट्रेसिंग डेटा को लॉग करना शुरू कर देगा.

कॉल में, .trace फ़ाइल का नाम बताया जा सकता है. इसके बाद, सिस्टम इसे पैकेज के हिसाब से बनाई गई डायरेक्ट्री में सेव करता है. यह डायरेक्ट्री, टारगेट डिवाइस पर ऐप्लिकेशन के डेटा को सेव रखने के लिए बनाई जाती है. यह वही डायरेक्ट्री है जो getExternalFilesDir() से मिलती है. साथ ही, यह ज़्यादातर डिवाइसों पर ~/sdcard/ डायरेक्ट्री में मौजूद होती है. इस फ़ाइल में, बाइनरी मेथड ट्रेस डेटा और थ्रेड और मेथड के नामों वाली मैपिंग टेबल होती है. ट्रेसिंग बंद करने के लिए, stopMethodTracing() पर कॉल करें.

यहां दिए गए सैंपल में, sample.trace नाम के ट्रेस लॉग की रिकॉर्डिंग शुरू और बंद की जाती है:

// Starts recording a trace log with the name you provide. For example, the
// following code tells the system to start recording a .trace file to the
// device with the name "sample.trace".
Debug.startMethodTracing("sample")

// The system begins buffering the generated trace data, until your
// application calls stopMethodTracing(), at which time it writes
// the buffered data to the output file.
Debug.stopMethodTracing()

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

अगर stopMethodTracing() को कॉल करने से पहले, सिस्टम बफ़र साइज़ की तय सीमा तक पहुंच जाता है, तो सिस्टम ट्रेस करना बंद कर देता है और कंसोल पर एक सूचना भेजता है. ट्रेस शुरू और बंद करने के तरीके, आपके ऐप्लिकेशन की पूरी प्रोसेस के दौरान काम करते हैं. इसका मतलब है कि अपनी गतिविधि के onCreate(Bundle) तरीके में startMethodTracing() को कॉल किया जा सकता है. साथ ही, उस गतिविधि के onDestroy() तरीके में stopMethodTracing() को कॉल किया जा सकता है.

ध्यान दें कि प्रोफ़ाइलिंग की सुविधा चालू होने पर, आपका ऐप्लिकेशन धीमे काम करता है. इसका मतलब है कि आपको प्रोफ़ाइलिंग डेटा का इस्तेमाल, सटीक समय तय करने के लिए नहीं करना चाहिए. जैसे, "foo() तरीके को लागू होने में 2.5 सेकंड लगते हैं". ट्रेस लॉग में मौजूद समय की जानकारी सिर्फ़ तब काम आती है, जब उसकी तुलना पिछले ट्रेस लॉग से की जाए. इससे यह देखा जा सकता है कि हाल ही में किए गए बदलावों से आपके ऐप्लिकेशन की स्पीड बढ़ी है या कम हुई है.

Android 5.0 (एपीआई लेवल 21) और इसके बाद के वर्शन वाले डिवाइसों पर डिप्लॉय करते समय, सैंपल-आधारित प्रोफ़ाइलिंग का इस्तेमाल किया जा सकता है. इससे, रनटाइम की परफ़ॉर्मेंस पर कम असर पड़ता है. सैंपल प्रोफ़ाइलिंग चालू करने के लिए, startMethodTracingSampling() को कॉल करें. इसके लिए, startMethodTracing() को कॉल न करें. साथ ही, सैंपलिंग के लिए तय किया गया इंटरवल भी बताएं. सिस्टम समय-समय पर सैंपल इकट्ठा करता है. ऐसा तब तक होता है, जब तक आपका ऐप्लिकेशन stopMethodTracing() का इस्तेमाल नहीं करता.

एक से ज़्यादा लॉग सेव करना

अगर आपका ऐप्लिकेशन, ट्रेस लॉग के लिए नया नाम बताए बिना, तरीकों की सूची को कई बार शुरू और बंद करता है, तो डिवाइस पुराने ट्रेस लॉग को नए लॉग से ओवरराइट कर देता है. इसका मतलब है कि वह सिर्फ़ सबसे हाल का ट्रेस लॉग सेव रखता है. अपने डिवाइस पर कई ट्रेस लॉग सेव करने के लिए, हर बार जब आपका ऐप्लिकेशन startMethodTracing() को कॉल करे, तब ट्रेस लॉग का नाम डाइनैमिक तौर पर बदलें. नीचे दिए गए सैंपल में, हर ट्रेस लॉग को नाम देते समय मौजूदा तारीख और समय को शामिल करने के लिए, SimpleDateFormat क्लास का इस्तेमाल किया गया है:

// Uses the SimpleDateFormat class to create a String with
// the current date and time.
val dateFormat: DateFormat = SimpleDateFormat("dd_MM_yyyy_hh_mm_ss", Locale.getDefault())
val logDate: String = dateFormat.format(Date())
// Applies the date and time to the name of the trace log.
Debug.startMethodTracing("sample-$logDate")

डिवाइस पर ट्रेस लॉग ऐक्सेस करना

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

  • Device Explorer का इस्तेमाल करें. डिवाइस एक्सप्लोरर खोलने के लिए, View > Tool Windows > Device Explorer पर क्लिक करें या टूल विंडो बार में मौजूद, Device Explorer बटन पर क्लिक करें. इमेज 1 में दिखाए गए तरीके से, .trace फ़ाइलों को ढूंढा जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन की पैकेज के हिसाब से बनी डायरेक्ट्री पर जाना होगा.

    पहली इमेज. डिवाइस एक्सप्लोरर का इस्तेमाल करके, ट्रेस लॉग ढूंढना.

  • adb pull कमांड का इस्तेमाल करके, फ़ाइल को अपने कंप्यूटर पर कॉपी करें. यहां दिया गया कमांड, डिवाइस से sample.trace नाम के ट्रेस लॉग को आपकी लोकल मशीन की ~/Documents/trace-logs/ डायरेक्ट्री में कॉपी करता है.

    adb pull path-on-device/sample.trace ~/Documents/trace-logs/

इसके बाद, सीपीयू प्रोफ़ाइलर की मदद से ट्रेस फ़ाइल को इंपोर्ट किया जा सकता है.