ثبّت ملف APK من الماك وصحّح أخطاء Android — مع الطرفية أو بدونها

تختبئ خلف عبارة «تثبيت APK من الماك» مهمّتان مختلفتان تمامًا، ومعظم الأدلة لا تجيب إلا عن واحدة منهما. تجيب هذه الصفحة عن الاثنتين معًا، ثم تتناول ما يتعثّر فيه الناس فعليًا بعد ذلك: قراءة سجل logcat، وجعل macOS يرى الهاتف من الأساس. كل خطوة هنا تعمل بأوامر adb المجرّدة؛ وحيث تُغني الواجهة الرسومية عن عمل حقيقي، نقول بالضبط ماذا تفعل وماذا لا تفعل. مُحدَّث في أغسطس 2026.

أولًا: هل تريد التطبيق على الماك أم على هاتفك؟

نتائج البحث عن هذه العبارة منقسمة إلى نصفين، والنتائج الأولى لا تخدم سوى نصف واحد. فالمقالات التي تجيب بـ «ثبّت BlueStacks / NoxPlayer / LDPlayer» تجيب عن السؤال الأول: تشغيل برامج Android على macOS نفسه. وهذا يحتاج إلى محاكٍ، وعلى أجهزة Apple Silicon تنحصر خياراتك الواقعية في محاكي Android Studio نفسه (مجاني، مع صور نظام arm64) أو المنتجات الشبيهة بـ Google Play Games on PC، لا المحاكيات القديمة العاملة بمعمارية x86.

أما إذا كان أمامك هاتف أو جهاز لوحي على المكتب وملف .apk في مجلد التنزيلات، فلست بحاجة إلى محاكٍ إطلاقًا. أنت بحاجة إلى ADB — أي Android Debug Bridge — وكابل. وهذا هو موضوع بقية هذه الصفحة.

1. تريد تشغيل التطبيق على الماك نفسه ← استخدم محاكيًا؛ ولا ينطبق أي مما يلي.
2. تريد دفع التطبيق إلى جهاز Android حقيقي متصل بالماك ← تابع القراءة.

الخطوة صفر: فعّل تصحيح أخطاء USB (هذا الجزء يتم على الهاتف)

لا يستطيع أي تطبيق على الماك تفعيل هذا الخيار نيابةً عنك — فـ Android يشترط عمدًا تفعيله يدويًا على الجهاز، كما يجب تأكيد أول اتصال من شاشة الهاتف. وأي أداة تدّعي غير ذلك فهي مخطئة.

لا يحتاج macOS إلى أي برامج تشغيل USB، بخلاف Windows. وعندما لا يظهر الجهاز، يكون السبب في الغالب كابلًا مخصصًا للشحن فقط، أو موزّع USB، أو نافذة تفويض لم تُؤكَّد.

1. الإعدادات ← حول الهاتف ← انقر على رقم الإصدار سبع مرات.
2. ارجع إلى الإعدادات ← النظام ← خيارات المطوّرين ← فعّل تصحيح أخطاء USB.
3. وصّل الهاتف بالماك بكابل يدعم نقل البيانات، مباشرةً ودون المرور بموزّع.
4. على الهاتف، وافق على «هل تريد السماح بتصحيح أخطاء USB؟» وفعّل خيار «السماح دائمًا من هذا الكمبيوتر».

طريق الطرفية: adb install

هذه هي الطريقة الكلاسيكية، وتستحق أن تعرفها حتى لو انتهى بك الأمر إلى استخدام واجهة رسومية. ويثبّت 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 داخل التطبيق نفسه، فلا شيء تثبّته إلى جانبه ولا شيء تحدّثه على حدة.

التطبيق مجاني، ولا يتطلب حسابًا، ولا يعرض إعلانات، وجمع بيانات الاستخدام معطّل افتراضيًا. وهو موقَّع ومصدَّق (notarized) من Apple، لذا يُفتح بشكل طبيعي بدلًا من الالتفاف بالنقر بالزر الأيمن ثم «فتح»، وهو ما تفرضه الأدوات غير الموقَّعة المنتشرة على مواقع تجميع التنزيلات.

1. نزّل ملف DMG، واسحب التطبيق إلى مجلد التطبيقات، ثم افتحه.
2. وصّل الهاتف ووافق على طلب تصحيح أخطاء USB (كما في الأعلى).
3. اختر الجهاز، وافتح علامة التبويب التطبيقات، ثم اضغط تثبيت APK أو أفلت ملف .apk مباشرةً على النافذة.
4. تعرض العلامة نفسها الحزم المثبّتة، ويمكنها فتح التطبيق أو سحب ملف APK إلى الماك أو مسح بياناته أو إزالته.

ملفات 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. في الواجهة الرسومية: حدّد كل الأجزاء دفعة واحدة في نافذة اختيار الملفات، أو اسحبها معًا إلى النافذة — يشغّل التطبيق أمر install-multiple نيابةً عنك ويعرض عدد الأجزاء أثناء التثبيت.

قراءة Logcat على الماك بدون Android Studio

يعمل adb logcat جيدًا بمفرده، ولتتبّع انهيار سريع يكفي سطر الأوامر في الغالب. المشكلة في المتابعة الطويلة: سجل Logcat الخام يعني آلاف الأسطر في الدقيقة من كل عملية تعمل على الجهاز.

أما مشهد الأدوات الرسومية هنا فضعيف ومتقادم في معظمه. فأشهر عارضات Logcat على macOS هي مشروع مكتوب بلغة 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 — تسجيل كل شيء في ملف.

عندما لا يرى الماك الجهاز

لا توجد صفحة استكشاف أخطاء جيدة ومحدَّثة خاصة بـ macOS لهذه المشكلة، لذا إليك قائمة الفحص بالترتيب الذي يحلّها فعلًا. وعلى بعض طرازات Samsung وXiaomi وHonor يجب أيضًا تغيير وضع USB من «الشحن فقط» إلى «نقل الملفات» من لوحة الإشعارات قبل أن يتصل ADB.

وإذا أظهر adb devices الرقم التسلسلي مع كلمة unauthorized، فالهاتف متصل وسليم — والناقص فقط هو نافذة التأكيد، أو أنها رُفضت سابقًا. وإبطال التفويضات يجبرها على الظهور من جديد.

1. غيّر الكابل. كابلات USB-C المخصصة للشحن فقط هي السبب الأشيع على الإطلاق.
2. وصّل الجهاز بالماك مباشرةً؛ وتجنّب الموزّعات ومحطات الإرساء ومنافذ الشاشات.
3. adb kill-server ثم adb devices لإعادة تشغيل الخدمة.
4. خيارات المطوّرين ← إبطال تفويضات تصحيح أخطاء USB، ثم افصل الكابل وأعِد توصيله.
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 تقريبًا، ومصدَّق من Apple. ويعتمد تسجيل الشاشة على أداة screenrecord في Android، وهو لا يعمل على بعض أجهزة HONOR وHuawei. وهو أداة لإدارة الأجهزة وقراءة السجلات، لا بديل عن مصحّح الأخطاء في Android Studio — فلا نقاط توقّف ولا فحص للمتغيّرات هنا.

1. على الهاتف: خيارات المطوّرين ← تصحيح الأخطاء لاسلكيًا ← إقران الجهاز باستخدام رمز الإقران.
2. على الماك: adb pair 192.168.1.20:41234 ثم أدخل الرمز المكوّن من ستة أرقام.
3. adb connect 192.168.1.20:5555 للاتصال ومتابعة عمل ADB المعتاد.
4. أو استخدم لوحة «لاسلكي» في التطبيق: افحص الشبكة، اختر الجهاز، وأدخل الرمز.

الأسئلة الشائعة

أدلة أخرى