ملاحظات إصدار أدوات 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" عند استخدام "update"

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 (رقم التتبّع: 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.0.3 (آب/أغسطس 2021)

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

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

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

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.
  • في نظام التشغيل Linux، عند الاتصال بخادم adb أحدث، بدلاً من إغلاق الخادم وبدء خادم قديم، يحاول 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 المعدَّلة
  • تعتمد أدوات النظام الأساسي الآن على حزمة Windows Universal C Runtime، التي يتم عادةً تثبيتها تلقائيًا من خلال Windows Update. إذا ظهرت لك أخطاء تشير إلى عدم توفّر مكتبات DLL، قد تحتاج إلى جلب حزمة وقت التشغيل وتثبيتها يدويًا.

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

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

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 (نظام الملفات المتوافق مع وحدات الفلاش).

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، والتي تظهر على شكل "تعذُّر فتح زوج مقبس تسجيل النقل" (الخطأ 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