ملاحظات إصدار أدوات SDK Platform

أداة Android SDK Platform-Tools هي مكوّن لحزمة تطوير البرامج (SDK) لنظام التشغيل Android. ويشمل ذلك أدوات تتفاعل مع نظام Android الأساسي، وبشكل أساسي adb و fastboot. على الرغم من أنّ adb مطلوب لتطوير تطبيقات Android، سيستخدم مطوّرو التطبيقات عادةً نسخة التطبيق التي يتم تثبيتها من خلال "استوديو Android". يُعدّ هذا التنزيل مفيدًا إذا أردت استخدام adb مباشرةً من سطر الأوامر ولم يكن "استوديو YouTube" مثبّتًا. (إذا كان تطبيق "استوديو YouTube" مثبّتًا لديك، ننصحك باستخدام النسخة المثبّتة فقط لأنّ "استوديو YouTube" سيحدّثها تلقائيًا). يجب استخدام أداة fastboot إذا كنت تريد فتح قفل أداة تحميل جهازك وتفليشه باستخدام ملف برمجي جديد للنظام. كانت هذه الحزمة تحتوي في السابق على systrace، ولكن تم إيقافها نهائيًا واستخدام Studio Profiler أو gpuinspector.dev أو Perfetto بدلاً منها.

على الرغم من أنّ بعض الميزات الجديدة في adb وfastboot لا تتوفّر إلا في الإصدارات الأحدث من نظام التشغيل Android، إلا أنّها متوافقة مع الإصدارات القديمة، لذا لن تحتاج سوى إلى أحدث إصدار من "أدوات حزمة تطوير البرامج (SDK) الأساسية" ويجب الإبلاغ عن الأخطاء إذا رصدت استثناءات.

عملية تنزيل

إذا كنت مطوّر تطبيقات Android، عليك الحصول على أحدث إصدار من IDE SDK Platform-Tools من مدير حِزم SDK في Android Studio أو من أداة سطر الأوامر sdkmanager. يضمن ذلك حفظ الأدوات في المكان المناسب مع بقية أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android وتعديلها بسهولة.

إذا كنت تريد فقط أدوات سطر الأوامر هذه، استخدِم الروابط التالية:

• تنزيل حزمة SDK Platform-Tools لنظام التشغيل Windows
• تنزيل حزمة SDK Platform-Tools لأجهزة Mac
• تنزيل حزمة SDK Platform-Tools لنظام التشغيل Linux

على الرغم من أنّ هذه الروابط لا تتغيّر، إلا أنّها تشير دائمًا إلى أحدث إصدار من الأدوات.

إصدارات

35.0.2 (تموز/يوليو 2024)

• adb
  • إصلاح خطأ في الخلفية في mDNS لشاشة العرض المفتوحة يؤدي إلى إيقاف الخادم عند طلب البحث المقتطع المشكلة رقم 294120933
  • إتاحة الخلفية لنظام mDNS في openscreen على نظام التشغيل macOS
  • جعل نظام openscreen mDNS للخلفية تلقائيًا على جميع المنصات
  • إتاحة رصد سرعة USB SuperSpeed+‎ (السرعة الحالية والسرعة المتفق عليها) لأغراض التشخيص
  • إيقاف التشغيل السلس: حرر جميع واجهات USB عند إيقاف التشغيل (جميع أنظمة التشغيل).

35.0.1 (آذار/مارس 2024)

• adb
  • التبديل إلى libusb 1.0.27

35.0.0 (شباط/فبراير 2024)

• adb
  • التبديل إلى libusb كمكتبة تلقائية على نظام التشغيل Linux الطلب رقم 270205252
  • حلّ مشكلة بدء تشغيل adb على المضيفين بدون USB
  • إصلاح تعليق adb بسبب أجهزة USB التي تُبلغ بشكل غير صحيح عن الأوصاف التي لا تبلغ طولها المشكلة رقم 302212871
  • إصلاح رمز الإرجاع adb shell عند إلغاء ربط الجهاز المشكلة رقم 321787891.
• fastboot
  • الحد من الحد الأقصى لحجم قائمة انتظار الحِزم الواردة
  • إزالة المؤثِّرات التي كانت تحدّ في السابق من سرعات التنزيل إلى حوالي 120 ميغابايت/ثانية والآن، أصبح بإمكان Fastboot بيانات الحافلة SuperSpeed+ بسرعة تصل إلى 980 ميغابايت/ثانية، حسب الجهاز.

34.0.5 (تشرين الأول/أكتوبر 2023)

• adb
  • يستخدم adb الآن libusb بشكل تلقائي على نظام التشغيل macOS لحلّ المشكلة رقم 270205252.
  • في السابق، كان adb يستجيب برمز نجاح عند تعذُّر الإقران اللاسلكي. تم حلّ هذه المشكلة من خلال عرض رمز تعذّر (1) وخطأ موجّه للمستخدم (error: protocol fault (couldn't read status message...)). يعرض echo $? الآن 1.
  • تطبيق adb wait-for-disconnect قيد التشغيل الآن لأجهزة غير USB (تصحيح الأخطاء اللاسلكي).
  • تمت إضافة واجهة DbC جديدة لإتاحة استخدام نظام التشغيل ChromeOS باستخدام adb.
• Fastboot
  • تم إصلاح أداة flashall على أجهزة Pixel 3.

34.0.4 (تموز/يوليو 2023)

• adb
  • نشر -a (gListenAll) عندما ينشئ adb نسخة فرعية من خادم مضيف adb (في السابق، كان هذا الخيار يعمل مع adb -a server nodaemon فقط)
  • تسريع عملية الوصول إلى الجذر وإلغاء الوصول إليه
  • إعادة نشر التطبيق Flag(env) guarding clear endpoint (device) feature for OSX usb start. (المشكلة رقم 270205252)
• fastboot
  • ‫Mac: إزالة عمليات إعادة المحاولة في أداة تكرار IO غير الصالحة (تعذُّر الوميض مع LIBUSB_TRANSFER_CANCELLED)
  • Windows: إصلاح "حجم الملف صغير جدًا أو غير صالح" عند استخدام "flashall"
  • جميع الأنظمة الأساسية: إصلاح الخطأ "لم يتم ضبط ANDROID_PRODUCT_OUT" عند استخدام "تحديث"

34.0.1 (آذار/مارس 2023)

• adb
  • نظام التشغيل macOS: تمّ التراجع عن حلّ "الاتصال غير المستقر (كابل MacBook عالي السرعة)" بسبب تعليق adb install (المشكلة رقم 270205252).
• fastboot
  • نظام التشغيل Windows: تم إصلاح الخطأ "mke2fs: اسم جهاز غير قانوني أو غير صحيح أثناء محاولة تحديد حجم نظام الملفات" الذي ظهر في الإصدار 34.0.0 من "أدوات النظام الأساسي" (الطلب رقم 271039230).

34.0.0 RC2 (آذار/مارس 2023)

• تم التحديث مع إصدار معاينة المطوّر 2 لنظام التشغيل Android 14 (لا تتوفّر تحديثات لـ adb وFastboot).

34.0.0 (شباط/فبراير 2023)

• adb
  • تم إصلاح مشكلة إرسال حزم بطول صفر في نظام التشغيل macOS (رقم التتبّع: 208675141).
  • تم حلّ مشكلة عدم ثبات الاتصال (كابل MacBook عالي السرعة): انقطاع الاتصال ببرنامج adb بشكل متكرر.
  • رسالة خطأ محسّنة لأمر adb push مع عدد غير كافٍ من الوسيطات
• fastboot
  • تحسين عملية التفليش: سيتخطّى flashall الآن عمليات إعادة التشغيل إلى مساحة المستخدم إذا أمكن.
  • تم إصلاح حزمة ذات طول صفري لنظام التشغيل macOS (issuetracker: 208675141).
  • تم إصلاح مشكلة وميض recovery.img التي تؤدي إلى ظهور تذييل AVB غير صحيح.

33.0.3 (آب/أغسطس 2022)

• adb
  • لا تحاول إعادة تنفيذ الخطوة adb root إذا تعذّرت المحاولة الأولى.
  • حلّ مشكلة إدخال مكرّر في ميزة "تتبُّع الأجهزة"
  • إضافة فترة استلام (زيادة معدل نقل البيانات في عمليات الاتصال ذات وقت الاستجابة المرتفع)
  • رسائل خطأ أكثر تحديدًا في حالات تعذُّر "أكثر من جهاز"
  • رفض طلبات إعادة التوجيه غير المتوقّعة
  • إصلاح install-multi-package على نظام التشغيل Windows
• Fastboot
  • أزِل e2fsdroid كجزء من أدوات نظام التشغيل في حزمة SDK.
  • اطبع رسالة الإرجاع OemCmdHandler في حال نجاح العملية.

33.0.2 (أيار/مايو 2022)

• fastboot
  • إتاحة القسم vendor_kernel_boot

33.0.1 (آذار/مارس 2022)

• adb
  • إصلاح أعطال mdns في نظام التشغيل Windows
  • إصلاحات على enable-verity/disable-verity على الأجهزة القديمة
  • إصلاحات "تثبيت عدة" على الأجهزة القديمة
  • تحسين إخراج المساعدة لتضمين جميع طرق الضغط المتاحة
• systrace
  • تمّت إزالة الموضوع. استخدِم Studio Profiler/gpuinspector.dev/Perfetto بدلاً من ذلك.

33.0.0 (شباط/فبراير 2022)

• adb
  • إصلاح مشكلة الأعطال التي ظهرت في الإصدار 32.0.0 عند تشغيله بدون أي مَعلمات

32.0.0 (كانون الثاني/يناير 2022)

• adb
  • ملف ثنائي عالمي لأجهزة Apple M1
  • مشكلة معروفة: يتعطّل هذا الإصدار عند تشغيله بدون أي وسيطات.

31 أغسطس 2021 (آب/أغسطس 2021)

• Fastboot
  • إتاحة فلاش vbmeta_vendor.img لاستخدام fastboot flashall / update

31 أبريل 2021 (نيسان/أبريل 2021)

• adb
  • دعم إعادة التوجيه إلى Vock على Linux.
  • إصلاح خطأ في adb track-devices حيث لا تتلقّى الأجهزة تحديثات على الفور من خلال تصحيح الأخطاء اللاسلكي
  • توفير دعم أولي لاكتشاف الأجهزة باستخدام mDNS بدون تثبيت خدمة mDNS بشكلٍ منفصل هذه الميزة غير مفعّلة حاليًا تلقائيًا، ويمكن تفعيلها من خلال ضبط متغيّر البيئة ADB_MDNS_OPENSCREEN على 1 عند بدء تشغيل خادم adb.
• Fastboot
  • لا تفشل في حال تعذّر الحصول على حجم قسم التمهيد.
  • يمكنك استنتاج حالة قفل الجهاز من الموقع بدلاً من تحليل سطر أوامر النواة.

31.0.1 (آذار/مارس 2021)

• adb
  • يمكنك تقليل الفاصل الزمني للحفاظ على اتصال TCP.
  • تحسين الأداء المتزايد للتثبيت
• fastboot
  • إضافة إمكانية دمج اللقطات المضغوطة
  • استعادة ميزة "اختبار أ/ب" القديمة

31.0.0 (شباط (فبراير) 2021)

• adb
  • إيقاف الضغط عند السحب تلقائيًا

30.0.5 (تشرين الثاني/نوفمبر 2020)

• adb
  • تحسين أداء adb push عند نقل العديد من الملفات عبر اتصال بطيء
  • تحسين أداء adb push/pull على نظام التشغيل Windows
  • حلّ adb push --sync باستخدام مدخلات متعددة
  • تحسين أداء عملية تثبيت حِزم apk المتزايدة
  • تحسين التعامل مع الأخطاء لعمليات التثبيت المتزايدة لحِزم APK.

30.0.4 (تموز/يوليو 2020)

• adb
  • إصلاح مشكلة الرجوع إلى تثبيت حِزم apk غير المتزايدة على الأجهزة التي تعمل بإصدار أقدم من Android 11
  • حلّ المشكلة adb install-multi-package
  • إصلاح بعض الأعطال الأخرى المرتبطة بالإقران اللاسلكي باستخدام adb
  • تحسين بعض رسائل الخطأ
• fastboot
  • يمكنك تحسين نتائج وحدة التحكم في أوامر fastboot oem.
  • حلّ مشكلة fastboot flashall على الأجهزة القديمة، مثل Nexus 7

30.0.3 (حزيران (يونيو) 2020)

• adb
  • إصلاح مشكلة تثبيت حِزم APK الموقَّعة باستخدام مخطّط التوقيع بالإصدار 4 على الأجهزة التي تعمل بإصدار أقدم من Android 11
  • إصلاح الأعطال عند المصادقة بدون ADB_VENDOR_KEYS
  • حلّ مشكلة الأعطال عند استخدام adb -H

30.0.2 (حزيران/يونيو 2020)

• adb
  • تحسين عملية الإقران اللاسلكي باستخدام adb
  • إصلاح مشاكل التعليق في adb logcat عند تشغيله قبل توصيل الجهاز.
  • أضِف adb transport-id للسماح للنصوص البرمجية بالانتظار بأمان حتى ينتهي الجهاز من عملية الوصول إلى الجذر أو إلغاء الوصول إلى الجذر أو إعادة التشغيل.

30.0.1 (أيار/مايو 2020)

• adb
  • إيقاف الاتصال التلقائي عبر mdns في adb بشكلٍ تلقائي ويمكن إعادة تفعيل ذلك باستخدام متغيّر البيئة ADB_MDNS_AUTO_CONNECT.
  • تحسين أداء adb install-multi على أجهزة Android 10 أو الإصدارات الأحدث
  • إصلاح مهلة الاتصال عند استخدام adb root/unroot على جهاز متصل عبر بروتوكول النقل المتعدّد (TCP)
  • يُرجى تحديث إتاحة الإقران اللاسلكي.

30.0.0 (نيسان/أبريل 2020)

• adb
  • يمكنك إضافة الدعم الأولي للإقران اللاسلكي.
  • إضافة إمكانية تثبيت حِزم APK بشكل تدريجي
  • تنفيذ الدعم من جهة العميل لضغط adb {push, pull, sync} عند استخدامه مع جهاز Android 11.
  • يمكنك تحسين أداء adb push مع اتصالات ذات وقت الاستجابة السريع.
  • تحسين أداء الدفع/السحب على Windows.

29.0.6 (شباط/فبراير 2020)

• adb
  • إتاحة الحجم/الوقت بتنسيق 64 بت لتطبيق adb ls عند استخدامه مع جهاز Android 11
  • إتاحة الاستماع على ::1 على POSIX
  • لم يعُد من الضروري تثبيت برنامج تشغيل USB لتوفير إمكانية استخدام أجهزة WinUSB التي تنشر وصفًا لـ WinUSB (مطلوب لنظام التشغيل Android 11) من خلال برنامج العميل.
  • إصلاح مشكلة تعليق الجهاز عند استخدام adb install مع عنصر ليس ملفًا

29.0.5 (تشرين الأول/أكتوبر 2019)

• adb
  • تحسين طفيف في الأداء على نظام التشغيل Linux عند استخدام العديد من الربطات المتزامنة
  • أضِف خيار --fastdeploy إلى adb install لإجراء تعديلات تدريجية على حِزم APK أثناء التطوير.

29.0.4 (أيلول/سبتمبر 2019)

• adb
  • تصحيح سريع لانتهاء مهلة تصحيح الأخطاء الأصلي باستخدام LLDB (راجِع المشكلة رقم 134613180). يؤدي ذلك أيضًا إلى إصلاح خطأ مرتبط في أدوات تحليل الأداء في "استوديو Android" الذي يؤدي إلى AdbCommandRejectedException، والذي يمكنك الاطّلاع عليه في ملف idea.log.

29.0.3 (أيلول (سبتمبر) 2019)

• adb
  • تعمل adb forward --list مع أجهزة متعددة متصلة.
  • إصلاح مشكلة انقطاع اتصال الأجهزة بالإنترنت على نظام التشغيل Windows
  • تحسين نص المساعدة ونتائج adb install
  • استعادة السلوك السابق لـ adb connect <host> بدون تحديد المنفذ

29.0.2 (تموز/يوليو 2019)

• adb
  • لإصلاح عطل في سلامة الكوة في Windows
• fastboot
  • إتاحة تنسيق التقسيم للأجهزة القادمة

29.0.1 (حزيران/يونيو 2019)

• adb
  • الإصلاح العاجل لأعطال Windows (https://issuetracker.google.com/134613180)

29.0.0 (حزيران/يونيو 2019)

• adb
  • يعيد "adb reconnect" عملية إعادة ضبط USB على نظام التشغيل Linux.
  • عند الاتصال بخادم adb جديد في نظام التشغيل Linux، يحاول adb إطلاق الإصدار الأحدث بشفافية بدلاً من إنهاء الخادم وبدء خادم أقدم.
  • ينتظر "adb root" حتى تتم إعادة توصيل الجهاز بعد إلغاء ربطه. في السابق، كان من الممكن أن يعرض adb root; adb wait-for-device عن طريق الخطأ على الفور إذا تم تشغيل adb wait-for-device قبل أن يلاحظ adb انقطاع اتصال الجهاز.
• Fastboot
  • إيقاف رسالة خطأ حدثت عند محاولة Fastboot فتح شريط اللمس أو لوحة المفاتيح على نظام التشغيل macOS

28.0.2 (آذار/مارس 2019)

• adb
  • إصلاح عدم ثبات إعادة توجيه منفذ adb shell الذي يؤدي إلى ظهور رسالة الخطأ "تمّت إعادة ضبط الربط بواسطة الخادم"
  • إصلاح المصادقة عبر ADB_VENDOR_KEYS عند إعادة ربط الأجهزة
  • تصحيح المصادقة، عندما لا يتطابق المفتاح الخاص المستخدَم للمصادقة مع المفتاح العام، وذلك من خلال احتساب المفتاح العام من المفتاح الخاص، بدلاً من افتراض تطابقهما
• fastboot
  • إضافة إمكانية استخدام الأقسام الديناميكية
• متطلبات نظام التشغيل Windows المعدَّلة
  • تعتمد أدوات النظام الأساسي الآن على بيئة التشغيل Universal C Runtime الخاصة بنظام Windows، والتي يتم تثبيتها عادةً بشكل تلقائي من خلال تحديث Windows. إذا ظهرت لك أخطاء تشير إلى عدم توفّر مكتبات DLL، قد تحتاج إلى جلب حزمة وقت التشغيل وتثبيتها يدويًا.

28.0.1 (أيلول/سبتمبر 2018)

• adb
  • إتاحة إعادة الاتصال باتصالات بروتوكول النقل (TCP) عند قطع الاتصال، سيحاول adb إعادة الاتصال لمدة تصل إلى 60 ثانية قبل إنهاء الاتصال.
  • إصلاح مخرجات وحدة تحكم يونيكود في نظام التشغيل Windows. (شكرًا للمساهم الخارجي "سبنسر لو"!)
  • تم إصلاح مشكلة إغلاق مُوصِف الملف مرتين، ما يؤدي إلى إغلاق الوصلات عند حدوث adb connect في الوقت نفسه.
  • إصلاح adb forward --list عند استخدامها مع أكثر من جهاز متصل.
• fastboot
  • زيادة مهلة الأوامر إلى 30 ثانية، وذلك من أجل دعم بعض أوامر برنامج التحميل البطيء بشكل أفضل.

28.0.0 (حزيران/يونيو 2018)

• adb:
  • إتاحة التشغيل بدون استخدام ميزة "التحقّق من الصحة" على الأجهزة التي تعمل بنظام Android P، مما يؤدي إلى تحسين معدل نقل البيانات بنسبة تصل إلى %40
  • يمكنك ترتيب الناتج من adb devices حسب نوع الاتصال والرقم التسلسلي للجهاز.
  • يمكنك زيادة عدد الأوامر المُرسَلة إلى مقبس الاستماع للسماح بتنفيذ المزيد من أوامر adb المتزامنة.
  • تحسين إخراج الأخطاء في adb connect
• fastboot:
  • تحسين تنسيق الإخراج، وإضافة وضع إخراج مفصّل (-v)
  • إزالة المحتوى غير المرغوب فيه من نص المساعدة
  • أضِف product.img وodm.img إلى قائمة الأقسام التي تم تركيبها باستخدام fastboot flashall.
  • تجنَّب تعطُّل الأجهزة الجديدة عند استخدام إصدار قديم جدًا من fastboot من خلال السماح لحِزم صور المصنع بطلب توفُّر دعم لأقسام معيّنة.

27.0.1 (كانون الأول/ديسمبر 2017)

• adb: يعالج خطأ العبارة على نظام التشغيل macOS الذي حدث عند توصيل الأجهزة باستخدام USB 3.0.
• Fastboot: على نظام التشغيل Windows، تتم إتاحة حجب بيانات الأجهزة التي تستخدم F2FS (نظام ملفات متوافق مع Flash).

27.0.0 (كانون الأول (ديسمبر) 2017)

• إعادة إصلاح خطأ Fastboot في نظام التشغيل macOS 10.13 الذي تم إصلاحه لأول مرة في الإصدار 26.0.1، ولكن تم إعادة تقديمه في الإصدار 26.0.2

26.0.2 (تشرين الأول/أكتوبر 2017)

• إتاحة ميزة Fastboot على أجهزة Pixel 2

26.0.1 (أيلول/سبتمبر 2017)

• تم حلّ مشاكل التمهيد السريع على نظام التشغيل macOS 10.13 High Sierra (الخطأ 64292422).

26.0.0 (حزيران/يونيو 2017)

• تم تعديلها لتتضمّن إصدار حزمة تطوير البرامج (SDK) النهائي من Android O (المستوى 26 من واجهة برمجة التطبيقات).

25.0.5 (24 نيسان (أبريل) 2017)

• تم إصلاح التحميل الجانبي من Adb للتحديثات الكبيرة على نظام التشغيل Windows، والتي تظهر كـ "std::bad_alloc" (خطأ 37139736).

• تم إصلاح مشاكل adb في بعض جدران الحماية في نظام التشغيل Windows، والتي تظهر على شكل "تعذُّر فتح socketpair لتسجيل النقل" (الخطأ 37139725).

• يتضمّن كلّ من adb --version وfastboot --version الآن مسار التثبيت.

• تم تغيير adb لمنع حلّ localhost لحلّ مشكلة شبكة VPN التي تم ضبطها بشكلٍ خاطئ.

• تم تغيير adb لمنع إعادة ضبط أجهزة USB على Linux، ما قد يؤثر في أجهزة USB الأخرى المُثبَّتة.

25.0.4 (16 آذار/مارس 2017)

• تمت إضافة دعم libusb التجريبي إلى adb لنظامي التشغيل Linux وMac

لاستخدام libusb في الخلفية، اضبط متغيّر البيئة ADB_LIBUSB=true قبل بدء خادم adb جديد. سيُعلمك الأمر الجديد adb host-features باستخدامك لـ libusb أو عدم استخدامه.

لإعادة تشغيل adb باستخدام libusb والتحقّق من نجاح العملية، استخدِم adb kill-server; ADB_LIBUSB=1 adb start-server; adb host-features. يجب أن تتضمن المخرجات "libusb".

في هذا الإصدار، يظلّ التنفيذ القديم غير المستند إلى libusb هو الإعداد التلقائي.

• لم يعُد fastboot يتسبب في تعليق أجهزة MacBook Pro لعام 2016 (الخطأ 231129)

• إصلاح التقاط سطر أوامر Systrace على نظام التشغيل Mac

25.0.3 (16 كانون الأول/ديسمبر 2016)

• تم إصلاح الخطأ Fastboot الذي يتسبب في فشل أجهزة Android Things في فلاش

25.0.2 (12 كانون الأول (ديسمبر) 2016)

• تم تعديله باستخدام الإصدار الثابت من Android N MR1 (المستوى 25 لواجهة برمجة التطبيقات)

25.0.1 (22 تشرين الثاني/نوفمبر 2016)

• تم التحديث مع إصدار إصدار معاينة المطوّر 2 لنظام التشغيل Android N MR1 (واجهة برمجة التطبيقات 25)

25.0.0 (19 تشرين الأول/أكتوبر 2016)

• تم التحديث مع إصدار إصدار معاينة المطوّر 1 لنظام التشغيل Android N MR1 (واجهة برمجة التطبيقات 25)

24.0.4 (14 تشرين الأول/أكتوبر 2016)

• تم تعديله لحلّ المشاكل في ADB وMac OS Sierra