كيفية إضافة ADB و Fastboot إلى PATH على نظام التشغيل Windows

أضف مجلد أدوات منصة Android SDK إلى Pathمتغيرات نظام التشغيل Windows، وبذلك يمكنك تشغيلها adbمن fastbootأي مجلد عمل. لجعل الأوامر متاحة لجميع الحسابات على جهاز الكمبيوتر، أضف المجلد ضمن متغيرات النظام ؛ استخدم متغيرات المستخدم إذا كان حسابك المُسجّل دخولك فقط هو الذي يحتاج إلى الوصول. لستَ بحاجة إلى نسخ الأدوات بجانب كل صورة أو مشروع.

1. قم بتنزيل حزمة أدوات المنصة الرسمية

قم بتنزيل ملف ZIP الخاص بنظام Windows من صفحة أدوات منصة Android SDK من Google . تتضمن الحزمة كلاً adbمن fastboot[اسم الأداة] و[اسم الأداة]، ويشير رابط التنزيل من Google إلى أحدث إصدار. إذا كان Android Studio يدير SDK الخاص بك بالفعل، فيمكنك استخدام مدير SDK الخاص به لضمان بقاء الأدوات في موقع SDK الذي يتم تحديثه.

2. استخرج الملف المضغوط واختر مجلدًا ثابتًا

في مستكشف الملفات، انقر بزر الماوس الأيمن على ملف ZIP الذي تم تنزيله واختر " استخراج الكل " . افتح المجلد المستخرج platform-toolsوتأكد من احتوائه على الملفات المطلوبة adb.exe. fastboot.exeاحتفظ بالمجلد كاملاً؛ فالأدوات تحتاج إلى ملفاتها المصاحبة.

انقل أو انسخ المجلد المستخرج إلى موقع دائم، مثلاً C:\Android\platform-tools. يجب أن يشير مسار النظام (PATH) إلى المجلد الذي يحتوي مباشرةً على الملفين adb.exe، fastboot.exeوليس إلى ملف ZIP أو المجلد الأصل. إذا اخترت موقعًا آخر، فاستخدم المسار نفسه المذكور أدناه. تجنب نقل المجلد بعد التثبيت إلا إذا قمت بتحديث مسار النظام (PATH) أيضًا.

3. افتح إعدادات متغيرات البيئة

اضغط على مفتاح Windows، واكتب " متغيرات البيئة" ، ثم حدد "تحرير متغيرات بيئة النظام" . يمكنك أيضًا الضغط على Windows+ R، ثم Enter SystemPropertiesAdvanced.exe، ثم Enter مرة أخرى.

في نافذة خصائص النظام، ابقَ على علامة التبويب "متقدم" وحدد "متغيرات البيئة" .

4. أضف Platform-Tools إلى قائمة المسار الصحيحة

اختر النطاق الذي يتوافق مع من ينبغي عليه استخدام الأوامر:

• جميع الحسابات على هذا الكمبيوتر: ضمن متغيرات النظام ، حدد Pathوانقر فوق تحرير . قد يطلب نظام التشغيل Windows موافقة المسؤول.
• لحسابك فقط: ضمن متغيرات المستخدم لـ [اسمك] ، حدد Pathوانقر على "تحرير" . عادةً ما يتجنب هذا تغيير الإعدادات على مستوى الجهاز ولا يتطلب صلاحيات المسؤول.

في محرر المسار، انقر فوق "جديد" وأدخل مسار مجلد Platform-Tools بالكامل، على سبيل المثال C:\Android\platform-tools. أضفه كإدخال مستقل؛ لا تستبدل قيمة المسار الموجودة، ولا تحذف الإدخالات الأخرى، ولا تُضف اسم الملف التنفيذي. انقر فوق "موافق" في كل مربع حوار مفتوح لحفظ التغييرات.

5. أعد فتح نافذة طرفية وتحقق من كلا الأمرين

أغلق أي نافذة موجه أوامر أو PowerShell أو Windows Terminal أو نافذة طرفية محرر نصوص كانت مفتوحة بالفعل. افتح نافذة جديدة لتلقي البيئة المحدثة. انتقل إلى مجلد مختلف، مثل المجلد C:\Users\YourName\Documents، ثم شغّل الأمر التالي:

where.exe adb
where.exe fastboot
adb version
fastboot --version

يجب أن يطبع الأمران الأولان المسارات التي تنتهي بـ `.` platform-tools\adb.exeو`.` platform-tools\fastboot.exe. يجب أن تُعيد أوامر الإصدار معلومات الإصدار. يُؤكد تشغيل هذه الأوامر من مجلد مختلف أن نظام ويندوز يستطيع العثور على الأدوات من خلال متغير PATH، وليس فقط لأن نافذة الطرفية مفتوحة في مجلد الأدوات.

إذا لم يتمكن نظام التشغيل Windows من العثور على الأمر

• تأكد من أن إدخال المسار يشير إلى المجلد المحدد الذي يحتوي على الملفات القابلة للتنفيذ؛ يجب ألا يكون هناك علامات اقتباس حول إدخال المسار العادي.
• افتح نافذة طرفية جديدة بعد الحفظ. تحتفظ جلسات الطرفية الحالية بالبيئة التي تم استلامها عند بدء تشغيلها.
• إذا where.exe adbكان النظام يعرض نسخة قديمة من حزمة تطوير البرامج (SDK) أولاً، فقد يكون نظام التشغيل Windows يعثر على تلك النسخة في مسار النظام (PATH) في وقت سابق. قم بتحديث أو إزالة الإدخال القديم فقط إذا كنت تعرف أي حزمة تطوير برامج (SDK) تمتلكه.
• يُسهّل متغير PATH اكتشاف الأوامر؛ فهو لا يُثبّت برنامج تشغيل USB الخاص بالهاتف، ولا يُفعّل تصحيح أخطاء USB، ولا يُدخل الجهاز في وضع مُحمّل الإقلاع. لاستخدام أجهزة ADB، فعّل تصحيح أخطاء USB ووافق على طلب الجهاز. تتطلب أوامر Fastboot عمومًا أن يكون الهاتف في وضع مُحمّل الإقلاع/Fastboot.

يُمرر نظام ويندوز متغيرات البيئة إلى العمليات التي تبدأ حديثًا، وتدعم لوحة تحكم النظام نطاقات المستخدم والنظام الدائمة. راجع وثائق متغيرات البيئة من مايكروسوفت لمعرفة كيفية وراثة العمليات لها، ودليل متغيرات بيئة PowerShell من مايكروسوفت لمعرفة نطاقات ويندوز والإعدادات الدائمة.