ADB: Android Debug Bridge के साथ काम करने की मूल बातें और लोकप्रिय कमांड

ADB क्या है और इसकी आवश्यकता क्यों है

Android Debug Bridge (ADB) एक क्लाइंट-सर्वर एप्लिकेशन है जो तीन घटकों से बना है: क्लाइंट (कंप्यूटर पर चलता है), सर्वर (कंप्यूटर पर पृष्ठभूमि प्रक्रिया) और डेमन adbd (Android डिवाइस पर ही चलता है)। जब कोई डेवलपर या इंजीनियर स्मार्टफ़ोन को PC से कनेक्ट करता है, ADB एक विश्वसनीय संचार चैनल बनाता है जिसके माध्यम से कमांड, फ़ाइलें और डेटा स्थानांतरित किए जा सकते हैं।

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

ADB समर्थन Android संस्करण 2.1 (API 7) से शुरू होने वाले सभी आधिकारिक Android बिल्ड में निर्मित है। इसके लिए डेवलपर सेटिंग्स में USB डीबगिंग विकल्प चालू होना आवश्यक है। Android 4.2 से शुरू करके, पहली बार कनेक्ट करने पर डिवाइस पुष्टि माँगता है: आपको अपनी RSA कुंजी द्वारा विशिष्ट कंप्यूटर के लिए डीबगिंग की अनुमति देनी होगी।

कंप्यूटर पर ADB स्थापित करना

Windows के लिए — Google Developers की आधिकारिक वेबसाइट से Platform Tools डाउनलोड करें, आर्काइव को C:\adb फ़ोल्डर में निकालें और इस पथ को PATH पर्यावरण चर में जोड़ें। टर्मिनल को पुनरारंभ करने के बाद adb कमांड वैश्विक रूप से उपलब्ध हो जाएगा।

macOS के लिए — सबसे आसान तरीका Homebrew पैकेज मैनेजर के माध्यम से ADB स्थापित करना है: brew install android-platform-tools चलाएँ। सभी निर्भरताएँ स्वचालित रूप से हल हो जाएँगी।

Linux के लिए — Debian / Ubuntu आधारित वितरणों पर: sudo apt install adb। स्थापना के बाद उपयोगकर्ता को plugdev समूह में जोड़ें: sudo usermod -aG plugdev $USER और ADB को USB उपकरणों तक पहुँच प्राप्त करने के लिए पुनः लॉगिन करें।

adb version कमांड से स्थापना की सत्यता जाँचें। यदि आउटपुट Android Debug Bridge का संस्करण संख्या दिखाता है, तो टूल उपयोग के लिए तैयार है।

डिवाइस कनेक्ट करना और बुनियादी कमांड

पहला कनेक्शन हमेशा adb devices कमांड से शुरू होता है। यह कनेक्टेड डिवाइसों और उनकी स्थिति की सूची दिखाता है। यदि डिवाइस unauthorized के रूप में दिखाई देता है, तो स्क्रीन अनलॉक करें और फ़ोन पर डीबगिंग की पुष्टि करें।

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

एप्लिकेशन इंस्टॉल करना — सबसे सामान्य कार्यों में से एक। बस APK फ़ाइल का पथ निर्दिष्ट करें:

adb install C:\apps\myapp.apk

यदि एप्लिकेशन पहले से इंस्टॉल है लेकिन उसे अपडेटेड संस्करण से बदलना है, तो -r (replace) फ़्लैग जोड़ें:

adb install -r C:\apps\myapp-v2.apk

एप्लिकेशन अनइंस्टॉल करना पैकेज नाम से किया जाता है:

adb uninstall com.example.myapp

फ़ाइलें कॉपी करना — adb pull डिवाइस से कंप्यूटर पर फ़ाइल निकालता है, adb push डिवाइस पर फ़ाइल अपलोड करता है:

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

इंटरैक्टिव शेल — adb shell कमांड डिवाइस की कमांड शेल खोलता है। इसके अंदर आप मानक Linux कमांड चला सकते हैं: ls, ps, top, dumpsys, pm, am और अन्य।

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

गतिविधि शुरू करना ADB के माध्यम से आइकन को मैन्युअल रूप से खोजे बिना किसी भी एप्लिकेशन या स्क्रीन को खोलने की अनुमति देता है:

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

लॉग के साथ काम: Logcat

Logcat Android लॉगिंग सिस्टम है जो एप्लिकेशन, सिस्टम सेवाओं और कर्नेल से संदेश एकत्र करता है। डीबगिंग के लिए टूल अपरिहार्य है: लॉग से आप समझ सकते हैं कि एप्लिकेशन क्यों क्रैश हुआ, किस विधि ने अपवाद उत्पन्न किया या कोई विशेष ऑपरेशन कितने समय तक चलता है।

बिना फ़िल्टर के सरल प्रारंभ — adb logcat। लॉग स्ट्रीम अनंत है; रोकने के लिए Ctrl+C दबाएँ। टैग द्वारा संदेशों को फ़िल्टर करने के लिए -s पैरामीटर का उपयोग करें:

adb logcat -s MainActivity:V

लॉगिंग महत्व स्तर (सबसे विस्तृत से गंभीर तक): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal)। टैग और स्तर का संयोजन केवल आवश्यक संदेशों को उजागर करने की अनुमति देता है।

परीक्षण से पहले संचित बफर साफ़ करने के लिए:

adb logcat -c

और लॉग को फ़ाइल में सहेजने के लिए:

adb logcat -d > app_logs.txt

-d (dump) फ़्लैग वर्तमान बफर आउटपुट करता है और टर्मिनल को ब्लॉक किए बिना समाप्त होता है। यह ऑटोमेशन स्क्रिप्ट के लिए सुविधाजनक है।

स्क्रीनशॉट, स्क्रीन रिकॉर्डिंग और उपयोगी डायग्नोस्टिक कमांड

स्क्रीनशॉट adb shell screencap कमांड से लिया जाता है। परिणाम एक फ़ाइल में सहेजा जाता है जिसे बाद में adb pull के माध्यम से निकाला जाता है:

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

दोनों ऑपरेशनों को प्रतिस्थापन और पाइपिंग के साथ एक पंक्ति में जोड़ा जा सकता है। व्यवहार में यह दस्तावेज़ीकरण और परीक्षण रिपोर्ट बनाने में तेज़ी लाता है।

स्क्रीन रिकॉर्डिंग Android 4.4+ (API 19) पर उपलब्ध है। डिफ़ॉल्ट रिकॉर्डिंग अवधि 180 सेकंड है, बिटरेट 4 Mbps है। मुख्य कमांड:

adb shell screenrecord /sdcard/demo.mp4

रिकॉर्डिंग रोकने के लिए Ctrl+C दबाएँ। वीडियो रिज़ॉल्यूशन डिवाइस स्क्रीन रिज़ॉल्यूशन से मेल खाता है लेकिन 1080p से अधिक नहीं होता। बिटरेट बदलने के लिए --bit-rate निर्दिष्ट करें:

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

डायग्नोस्टिक कमांड: adb shell dumpsys सभी सिस्टम सेवाओं की स्थिति आउटपुट करता है। केवल बैटरी जानकारी प्राप्त करने के लिए:

adb shell dumpsys battery

स्थापित पैकेजों की सूची Package Manager के माध्यम से प्राप्त की जा सकती है:

adb shell pm list packages

एप्लिकेशन सेटिंग्स रीसेट करना (सेटिंग्स में डेटा साफ़ करने के समतुल्य):

adb shell pm clear com.example.myapp

ADB की उन्नत क्षमताएँ

Wi-Fi डीबगिंग डिवाइस को USB से कनेक्ट रखने की आवश्यकता को समाप्त करता है। सुनिश्चित करें कि कंप्यूटर और डिवाइस एक ही नेटवर्क पर हैं। पहले adb tcpip 5555 चलाएँ, USB डिस्कनेक्ट करें, फिर IP से कनेक्ट करें:

adb tcpip 5555
adb connect 192.168.1.100:5555

यदि डिवाइस का IP पता अज्ञात है, तो केबल डिस्कनेक्ट करने से पहले adb shell ip addr show wlan0 के माध्यम से पता लगाएँ।

डेटा बैकअप एप्लिकेशन या पूरे सिस्टम का रूट के बिना किया जा सकता है:

adb backup -apk -shared -all -system -f mybackup.ab

बैकअप से पुनर्स्थापना:

adb restore mybackup.ab

इनपुट अनुकरण — adb shell input कमांड टैप, स्वाइप, कुंजी दबाव और टेक्स्ट इनपुट का अनुकरण करने की अनुमति देता है। यह अतिरिक्त फ्रेमवर्क के बिना UI परीक्षण ऑटोमेशन का आधार है:

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

विभिन्न मोड में रीबूट:

adb reboot          # normal reboot
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

फ़ास्टबूट मोड इमेज फ़्लैश करने, बूटलोडर अनलॉक करने और कस्टम रिकवरी स्थापित करने की पहुँच प्रदान करता है।

एकाधिक डिवाइसों के साथ काम

जब एकाधिक डिवाइस या एमुलेटर एक साथ कनेक्टेड हों, ADB को विशिष्ट सीरियल नंबर की आवश्यकता होती है। adb devices कमांड अपने सीरियल नंबर के साथ सभी कनेक्टेड डिवाइस दिखाता है।

किसी विशिष्ट डिवाइस को कमांड संबोधित करने के लिए -s फ़्लैग का उपयोग करें:

adb -s 0123456789ABCD install myapp.apk

यदि केवल एक डिवाइस है, तो फ़्लैग छोड़ा जा सकता है। हालाँकि CI वातावरण में जहाँ एक साथ कई एमुलेटर चल रहे हों, सीरियल नंबर निर्दिष्ट करना अनिवार्य है।

ADB सर्वर को मारना — यदि डिवाइस का पता लगना बंद हो जाता है या त्रुटि देता है, तो सर्वर को पुनरारंभ करने से मदद मिलती है:

adb kill-server
adb start-server

उसके बाद adb devices चलाएँ — सर्वर पुनरारंभ होगा और अनुरोधों को डिवाइस डेमन पर रीडायरेक्ट करेगा।

मुख्य ADB कमांड: संदर्भ तालिका

निष्कर्ष

ADB (Android Debug Bridge) पेशेवर स्तर पर Android के साथ काम करने वाले सभी लोगों के लिए एक मौलिक उपकरण है। बुनियादी एप्लिकेशन स्थापना से लेकर जटिल परीक्षण ऑटोमेशन और डिवाइस पुनर्प्राप्ति तक — ADB कंप्यूटर और स्मार्टफ़ोन या टैबलेट के बीच बातचीत के लगभग हर परिदृश्य को कवर करता है।

इस लेख में वर्णित कमांड में महारत हासिल करके, आप टर्मिनल के माध्यम से आत्मविश्वास से Android डिवाइस का प्रबंधन करने, लॉग का विश्लेषण करने, दस्तावेज़ीकरण के लिए स्क्रीनशॉट लेने, बैकअप करने और विकास प्रक्रिया को गति देने में सक्षम होंगे। नियमित अभ्यास और adb help के आउटपुट का अध्ययन आपको इस शक्तिशाली उपकरण का अनुभवी उपयोगकर्ता बना देगा।