अपने Mac से APK इंस्टॉल करें और Android डीबग करें — टर्मिनल के साथ या बिना

"Mac से APK इंस्टॉल करना" वाक्यांश के पीछे दो बिलकुल अलग काम छिपे हैं, और ज़्यादातर गाइड इनमें से सिर्फ़ एक का जवाब देते हैं। यह पेज दोनों का जवाब देता है, और फिर उन चीज़ों को कवर करता है जिन पर लोग असल में बाद में अटकते हैं: logcat पढ़ना, और macOS को फ़ोन दिखाई ही न देना। नीचे दिया हर कदम सादे adb कमांड से काम करता है; जहाँ GUI सचमुच मेहनत बचाता है, वहाँ हम ठीक-ठीक बताते हैं कि वह क्या करता है और क्या नहीं। अगस्त 2026 में अपडेट किया गया।

पहले यह तय करें: ऐप आपको Mac पर चाहिए या फ़ोन पर?

इस वाक्यांश के सर्च नतीजे ठीक बीच से बँटे हुए हैं, और ऊपर आने वाले नतीजे सिर्फ़ एक आधे हिस्से का जवाब देते हैं। जो लेख "BlueStacks / NoxPlayer / LDPlayer इंस्टॉल करें" कहकर जवाब देते हैं, वे पहले सवाल का जवाब दे रहे हैं: यानी Android सॉफ़्टवेयर को खुद macOS पर चलाना। इसके लिए एमुलेटर चाहिए, और Apple Silicon पर आपके व्यावहारिक विकल्प हैं Android Studio का अपना एमुलेटर (मुफ़्त, arm64 सिस्टम इमेज) या Google Play Games on PC जैसी शैली के उत्पाद — पुराने x86 एमुलेटर नहीं।

इसके बजाय अगर आपकी मेज़ पर फ़ोन या टैबलेट रखा है और Downloads में एक .apk फ़ाइल पड़ी है, तो आपको एमुलेटर की ज़रूरत ही नहीं है। आपको चाहिए ADB — यानी Android Debug Bridge — और एक केबल। बाकी पूरा पेज इसी के बारे में है।

1. ऐप को खुद Mac पर चलाना है → एमुलेटर इस्तेमाल करें; नीचे लिखी कोई बात लागू नहीं होती।
2. ऐप को Mac से जुड़े असली Android डिवाइस पर भेजना है → आगे पढ़ते रहें।

शून्य कदम: यूएसबी डीबगिंग चालू करें (यह हिस्सा फ़ोन पर होता है)

कोई भी Mac ऐप आपके लिए यह स्विच नहीं दबा सकता — Android जानबूझकर माँग करता है कि इसे डिवाइस पर हाथ से चालू किया जाए, और पहला कनेक्शन फ़ोन की स्क्रीन पर पुष्टि करना ज़रूरी है। इसके उलट दावा करने वाली कोई भी बात ग़लत है।

Windows के उलट macOS को किसी USB ड्राइवर की ज़रूरत नहीं होती। जब कोई डिवाइस दिखाई नहीं देता, तो वजह लगभग हमेशा सिर्फ़-चार्जिंग वाली केबल, कोई USB हब, या पुष्टि न किया गया अनुमति डायलॉग होती है।

1. सेटिंग → फ़ोन के बारे में → बिल्ड नंबर पर सात बार टैप करें।
2. वापस सेटिंग → सिस्टम → डेवलपर विकल्प में जाएँ और यूएसबी डीबगिंग चालू करें।
3. फ़ोन को डेटा ट्रांसफ़र करने वाली केबल से सीधे Mac में लगाएँ, किसी हब के ज़रिए नहीं।
4. फ़ोन पर "यूएसबी डीबगिंग की अनुमति दें?" को मंज़ूरी दें और "इस कंप्यूटर से हमेशा अनुमति दें" पर टिक लगाएँ।

टर्मिनल वाला रास्ता: adb install

यह क्लासिक तरीका है और जानने लायक है, भले ही आख़िर में आप GUI ही इस्तेमाल करें। Homebrew वही platform-tools बाइनरी इंस्टॉल करता है जो Google देता है।

आम गड़बड़ियाँ, सीधे शब्दों में: INSTALL_FAILED_UPDATE_INCOMPATIBLE का मतलब है कि उस पैकेज नाम वाला ऐप पहले से इंस्टॉल है लेकिन किसी अलग कुंजी से साइन किया गया है — पहले उसे अनइंस्टॉल करें। INSTALL_FAILED_VERSION_DOWNGRADE का हल है -d जोड़ना। "adb: no devices/emulators found" का मतलब है कि ऊपर बताया गया अनुमति वाला कदम पूरा नहीं हुआ।

1. brew install --cask android-platform-tools
2. adb devices — सीरियल के आगे device लिखा होना चाहिए, unauthorized या offline नहीं।
3. adb install -r ~/Downloads/app.apk (-r पहले से मौजूद कॉपी के ऊपर दोबारा इंस्टॉल करता है और डेटा बचाए रखता है)।
4. Success दिखने का इंतज़ार करें; INSTALL_FAILED_ से शुरू होने वाली कोई भी लाइन ही असली एरर मैसेज है।

बिना टर्मिनल वाला रास्ता: APK को विंडो पर खींचकर छोड़ें

अगर आप टर्मिनल में रहने वाले नहीं हैं, तो Homebrew इंस्टॉल, PATH में बदलाव और cd platform-tools की कसरत सिर्फ़ फ़ालतू बोझ है। Super ADB Manager adb और scrcpy सर्वर को ऐप के भीतर ही साथ लाता है, इसलिए साथ में कुछ और इंस्टॉल करने की ज़रूरत नहीं और अलग से कुछ अपडेट रखने की भी नहीं।

यह मुफ़्त है, किसी अकाउंट की ज़रूरत नहीं, कोई विज्ञापन नहीं, और टेलीमेट्री डिफ़ॉल्ट रूप से बंद है। ऐप Apple से साइन और notarize किया हुआ है, इसलिए यह सामान्य रूप से खुलता है — डाउनलोड एग्रीगेटर साइटों पर मिलने वाले बिना-साइन टूल्स की तरह राइट-क्लिक करके Open करने वाला जुगाड़ नहीं करना पड़ता।

1. DMG डाउनलोड करें, ऐप को Applications में खींचें, और खोलें।
2. फ़ोन प्लग करें और यूएसबी डीबगिंग वाले प्रॉम्प्ट को मंज़ूरी दें (ऊपर जैसा ही)।
3. डिवाइस चुनें, ऐप्स टैब खोलें, फिर या तो APK इंस्टॉल करें दबाएँ या .apk को सीधे विंडो पर छोड़ दें।
4. यही टैब इंस्टॉल किए गए पैकेज दिखाता है और उन्हें खोल सकता है, APK को वापस Mac पर खींच सकता है, डेटा साफ़ कर सकता है या अनइंस्टॉल कर सकता है।

स्प्लिट APK: base.apk के साथ कॉन्फ़िग फ़ाइलें

APKMirror से App Bundle के रूप में डाउनलोड की गई या SAI से एक्सपोर्ट की गई कोई भी चीज़ कई फ़ाइलों में आती है — base.apk के साथ split_config.arm64_v8a.apk, split_config.xxhdpi.apk, भाषा वाले स्प्लिट, वग़ैरह। सिर्फ़ base.apk इंस्टॉल करने पर ऐप या तो खुलते ही क्रैश होता है या उसमें कोई रिसोर्स दिखाई नहीं देता।

सभी हिस्से एक ही बिल्ड और एक ही सिग्नेचर के होने चाहिए; अलग-अलग वर्ज़न मिलाने पर इंस्टॉल फेल हो जाता है। अगर आपके पास .xapk या .apks कंटेनर है, तो पहले उसे अनज़िप करें — दोनों ZIP आर्काइव ही हैं — और फिर निकले हुए हिस्सों को एक साथ इंस्टॉल करें।

1. टर्मिनल: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. GUI: फ़ाइल पिकर में सभी हिस्से एक साथ चुनें, या उन्हें एक साथ विंडो पर खींचकर छोड़ें — ऐप आपके लिए install-multiple चलाता है और इंस्टॉल के दौरान हिस्सों की गिनती दिखाता है।

Mac पर बिना Android Studio के logcat पढ़ना

adb logcat अपने आप में ठीक काम करता है, और किसी क्रैश को फटाफट ढूँढने के लिए कमांड लाइन अक्सर काफ़ी है। दिक़्क़त लगातार पढ़ते रहने में आती है: कच्चा logcat डिवाइस की हर प्रोसेस से मिलाकर एक मिनट में हज़ारों लाइनें उगलता है।

यहाँ GUI का दायरा पतला और ज़्यादातर पुराना पड़ चुका है। macOS के सबसे जाने-पहचाने logcat व्यूअर हैं एक दशक पुराना Objective-C प्रोजेक्ट और उसके फ़ोर्क, एक Tcl/Tk टूल, और दो-एक नए टर्मिनल-शैली के Rust यूटिलिटी; एक पेड कमर्शियल विकल्प भी है। ये सब उम्मीद करते हैं कि platform-tools आप खुद इंस्टॉल और मेंटेन करेंगे, और इनमें से ज़्यादातर बिना साइन किए हुए हैं — यानी macOS 13+ पर एक भी लाइन देखने से पहले Gatekeeper से जूझना पड़ेगा।

Super ADB Manager में Logcat टैब चुने हुए डिवाइस से लाइव स्ट्रीम दिखाता है, साथ में प्रायोरिटी फ़िल्टर (सभी / जानकारी+ / चेतावनी+ / त्रुटि / गंभीर), क्रैश, नेटवर्क, सिस्टम और मौजूदा फ़ोरग्राउंड ऐप के लिए तैयार फ़िल्टर, फ़्री-टेक्स्ट सर्च, रंगों से पहचान, ऑटो-स्क्रॉल और क्लियर। एक ईमानदार सीमा: यह व्यू सिर्फ़ आख़िरी 2000 लाइनें मेमोरी में रखता है, इसलिए यह लाइव डीबगिंग विंडो है, लंबे सेशन का आर्काइव नहीं — पूरा रिकॉर्ड चाहिए तो adb logcat को किसी फ़ाइल में रीडायरेक्ट करें।

1. adb logcat -v time — पढ़ने लायक टाइमस्टैम्प।
2. adb logcat *:E — सिर्फ़ एरर और फ़ैटल।
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — किसी एक ऐप का आउटपुट।
4. adb logcat -c — बग दोहराने से पहले बफ़र साफ़ करें।
5. adb logcat -v time > ~/Desktop/session.log — सब कुछ एक फ़ाइल में सहेजें।

जब Mac को डिवाइस दिखाई ही न दे

इसके लिए macOS पर केंद्रित कोई अच्छा और मौजूदा ट्रबलशूटिंग पेज नहीं है, इसलिए यह रही चेकलिस्ट — उसी क्रम में जिस क्रम में यह असल में हल होती है। कुछ Samsung, Xiaomi और Honor मॉडलों पर ADB जुड़ने से पहले सूचना पैनल में USB मोड को "सिर्फ़ चार्जिंग" से बदलकर "फ़ाइल ट्रांसफ़र" भी करना पड़ता है।

अगर adb devices सीरियल के साथ unauthorized शब्द दिखाता है, तो फ़ोन जुड़ा हुआ और ठीक-ठाक है — बस पुष्टि वाला डायलॉग या तो आया नहीं या पहले कभी मना कर दिया गया था। अनुमतियाँ रद्द करने पर वह डायलॉग दोबारा आ जाता है।

1. केबल बदलें। सिर्फ़-चार्जिंग वाली USB-C केबल इसकी सबसे आम वजह है।
2. सीधे Mac में लगाएँ; हब, डॉक और मॉनिटर के पोर्ट छोड़ दें।
3. adb kill-server चलाएँ, फिर डेमन दोबारा शुरू करने के लिए adb devices।
4. डेवलपर विकल्प → यूएसबी डीबगिंग की मंज़ूरी रद्द करें, फिर केबल निकालकर दोबारा लगाएँ।
5. system_profiler SPUSBDataType | grep -i -A4 android — अगर यहाँ कुछ नहीं दिखता, तो समस्या हार्डवेयर या केबल की है, ADB की नहीं।

वायरलेस डीबगिंग और वे डिवाइस जो ADB नहीं बोलते

Android 11 और उसके बाद के वर्ज़न छह अंकों के कोड से Wi-Fi पर पेयरिंग सपोर्ट करते हैं, जो तब सचमुच काम आता है जब USB पोर्ट व्यस्त हो या डिवाइस किसी टेस्ट रिग में लगा हो। फ़ोन पर दिखने वाला पेयरिंग पोर्ट अस्थायी होता है और कनेक्शन पोर्ट से अलग होता है। दोनों मशीनें एक ही सबनेट पर होनी चाहिए — क्लाइंट आइसोलेशन वाला कॉर्पोरेट Wi-Fi इसे पूरी तरह रोक देता है। ऐप में वायरलेस पैनल mDNS के ज़रिए नेटवर्क स्कैन करता है और पेयरिंग कोड लेता है, और जब डिवाइस USB पर जुड़ा हो तो शॉर्टकट → वायरलेस पर स्विच करें पूरा हैंडओवर एक क्लिक में कर देता है।

इससे अलग बात यह है कि हर डिवाइस ADB नहीं बोलता। Kindle और कई कैमरे या मीडिया प्लेयर स्टोरेज सिर्फ़ MTP के ज़रिए दिखाते हैं, और Google ने Android File Transfer बंद कर दिया है, जिसकी सिफ़ारिश अब भी पूरे वेब पर मिलती है। Super ADB Manager में MTP डिवाइस नाम का सेक्शन है जो ऐसे डिवाइसों की फ़ाइलें बिना ADB के ब्राउज़ और ट्रांसफ़र करता है। चेतावनी: ट्रांसफ़र के बीच में डिवाइस निकालने या इजेक्ट करने पर MTP सेशन टूट सकता है, और जारी रखने के लिए दोबारा कनेक्ट करना पड़ता है।

ज़रूरतें और सीमाएँ, साफ़ शब्दों में: वर्ज़न 0.6.0, सिर्फ़ Apple Silicon, macOS 13 Ventura या उससे नया, लगभग 27 MB, notarized। स्क्रीन रिकॉर्डिंग Android के screenrecord पर निर्भर है और कुछ HONOR तथा Huawei डिवाइसों पर काम नहीं करती। यह डिवाइस मैनेजमेंट और लॉग देखने का टूल है, Android Studio के डीबगर का विकल्प नहीं — यहाँ ब्रेकपॉइंट या वेरिएबल जाँचने की सुविधा नहीं है।

1. फ़ोन: डेवलपर विकल्प → वायरलेस डीबगिंग → पेयरिंग कोड से डिवाइस पेयर करें।
2. Mac: adb pair 192.168.1.20:41234 चलाएँ, फिर छह अंकों का कोड डालें।
3. सामान्य ADB काम के लिए जुड़ने हेतु adb connect 192.168.1.20:5555।
4. या ऐप का वायरलेस पैनल इस्तेमाल करें: स्कैन करें, डिवाइस पर टैप करें, कोड टाइप करें।

अक्सर पूछे जाने वाले सवाल

और गाइड