كيف تثبّت ADB وfastboot على Windows وMac وLinux

ما هما ADB وfastboot؟

ADB (Android Debug Bridge) يتواصل مع هاتفك أثناء تشغيل أندرويد. تستخدمه لنسخ الملفات وتثبيت التطبيقات وإعادة تشغيل الهاتف في أوضاع أخرى.

Fastboot يتواصل مع أداة الإقلاع في الهاتف. تستخدمه لفتح أداة الإقلاع ولفلاش الصور، مثل صورة الإقلاع التي يعدّلها Magisk.

تأتي الأداتان في حزمة SDK Platform-Tools المجانية من Google. لا تحمّلها إلا من Google، فحزم «Minimal ADB» من المواقع الأخرى قديمة في الغالب، وبعضها جاء مرفقًا ببرمجيات غير مرغوب فيها.

تثبيت ADB وfastboot على Windows

1. حمّل Platform-Tools

   افتح صفحة Platform-Tools من Google، وحمّل SDK Platform-Tools for Windows ووافق على الشروط.

2. فك ضغط الملف

   استخرج ملف zip إلى مسار قصير مثل C:\platform-tools. فالمسارات الطويلة وأسماء المجلدات التي فيها رموز خاصة قد تسبب أخطاء.

3. افتح نافذة أوامر في المجلد

   افتح المجلد في مستكشف الملفات، وانقر شريط العنوان، واكتب cmd واضغط Enter. ستُفتح نافذة موجّه الأوامر (Command Prompt) في ذلك المجلد. وفي PowerShell أو Windows Terminal، ابدأ كل أمر بـ .\، مثل .\adb devices.

4. ثبّت تعريف USB

   يثبّت Windows التعريف تلقائيًا في العادة. وإذا لم يفعل، فثبّت Google USB Driver لهواتف Pixel، أو تعريف USB من الشركة المصنّعة لهاتفك في الماركات الأخرى.

5. اختياري: أضفه إلى PATH

   لتشغيل adb من أي مجلد، ابحث في Windows عن تحرير متغيرات بيئة النظام (Edit the system environment variables)، وافتح متغيرات البيئة، واختر Path، ثم تحرير وأضف C:\platform-tools. افتح نافذة أوامر جديدة بعد ذلك.

تثبيت ADB وfastboot على macOS

أسهل طريقة هي Homebrew:

brew install --cask android-platform-tools

دون Homebrew، حمّل SDK Platform-Tools for Mac من صفحة Platform-Tools من Google، وفك ضغطها، وافتح Terminal في مجلد platform-tools، وابدأ كل أمر بـ ./، مثل ./adb devices. لا تحتاج أجهزة Mac إلى تعريف USB.

تثبيت ADB وfastboot على Linux

توفّر أغلب التوزيعات الأداتين في حزمها:

قد تتأخر هذه الحزم عن إصدارات Google. إذا فشل fastboot مع هاتف أحدث، فحمّل SDK Platform-Tools for Linux من صفحة Platform-Tools من Google، وشغّل ./adb و./fastboot من المجلد بعد فك ضغطه.

إذا ظهرت في adb devices عبارة no permissions، فهذا يعني أن مستخدمك غير مسموح له بالوصول إلى الهاتف عبر USB. وفي Debian وUbuntu، تضيف حزمة android-sdk-platform-tools-common القواعد التي تحل هذه المشكلة. افصل الهاتف وأعد وصله بعد ذلك.

صِل هاتفك

1. فعّل تصحيح أخطاء USB

   فعّل خيارات المطوّر (اضغط رقم الإصدار سبع مرات في الإعدادات ← لمحة عن الهاتف)، ثم فعّل تصحيح أخطاء USB في خيارات المطوّر.

2. صِل الهاتف واسمح للحاسوب

   صِل الهاتف بكابل USB ينقل البيانات، فبعض الكابلات الرخيصة للشحن فقط. ثم نفّذ:

   adb devices
   

   نسخ

   يسألك الهاتف هل تريد السماح بتصحيح أخطاء USB؟. حدّد السماح دائمًا من هذا الكمبيوتر واضغط سماح.

3. تحقق من النتيجة

   نفّذ adb devices مرة أخرى. يجب أن يظهر الرقم التسلسلي لهاتفك ومعه كلمة device. وإذا ظهرت كلمة unauthorized، فافتح قفل شاشة الهاتف ووافق على النافذة.

4. اختبر fastboot

   أعد التشغيل إلى أداة الإقلاع وتحقق من أن fastboot يرى الهاتف:

   adb reboot bootloader
   

   نسخ

   fastboot devices
   

   نسخ

   نفّذ fastboot reboot للعودة إلى أندرويد.

الأوامر التي ستستخدمها مع Magisk

الخطوات الكاملة لعمل الروت موجودة في الدليل الرئيسي: كيف تعمل روت لهاتفك بواسطة Magisk.

أخطاء ADB وfastboot الشائعة

لا يظهر شيء في adb devices. جرّب كابلًا آخر ومنفذ USB آخر، ويُفضَّل منفذ في الحاسوب نفسه لا في موزّع (hub). وعلى الهاتف، اضبط وضع USB على نقل الملفات. وفي Windows، ثبّت تعريف USB من جديد.

يظهر الجهاز بحالة «unauthorized». افتح قفل الهاتف ووافق على نافذة هل تريد السماح بتصحيح أخطاء USB؟. وإذا لم تظهر، فاضغط إبطال تفويضات تصحيح أخطاء USB في خيارات المطوّر وأعد وصل الهاتف.

«'adb' is not recognized as an internal or external command». لا يجد Windows أداة adb. افتح نافذة الأوامر داخل مجلد platform-tools، أو أضفه إلى PATH. وفي PowerShell اكتب .\adb.

«command not found: adb» على Mac أو Linux. شغّل ./adb داخل مجلد platform-tools، أو ثبّت الأدوات بواسطة Homebrew أو مدير الحزم في توزيعتك.

يعمل ADB، لكن fastboot لا يُظهر شيئًا أو يعرض «waiting for any device». تأكد من أن الهاتف يعرض شاشة أداة الإقلاع. وفي Windows، افتح إدارة الأجهزة (Device Manager) والهاتف في أداة الإقلاع: إذا وجدت جهازًا عليه أيقونة تحذير، فحدّث تعريفه واختر Android Bootloader Interface.

«Flashing is not allowed in Lock State». أداة الإقلاع ما زالت مقفلة. افتحها أولًا.

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