مدير sdk

sdkmanager هي أداة سطر أوامر تتيح لك عرض وتحديث وإلغاء تثبيت الحزم لحزمة تطوير البرامج (SDK) لنظام التشغيل Android. في حال استخدام Android لن تحتاج إلى استخدام هذه الأداة، ويمكنك بدلاً من ذلك إدارة حِزم SDK من بيئة التطوير المتكاملة (IDE).

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

  1. تنزيل أحدث إصدار من "أدوات سطر الأوامر فقط" الحزمة من صفحة عمليات التنزيل في "استوديو Android" فك ضغط الحزمة.
  2. نقل دليل cmdline-tools غير المضغوط إلى دليل جديد من اختيارك، مثل android_sdk. يمثل هذا الدليل الجديد دليل حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  3. في دليل cmdline-tools غير المضغوط، أنشئ دليل فرعي يسمى latest.
  4. نقل محتوى دليل cmdline-tools الأصلي، بما في ذلك والدليل lib والدليل bin NOTICE.txt وملف source.properties في دليل latest الذي تم إنشاؤه حديثًا. يمكنك الآن استخدام سطر الأوامر من هذا الموقع.

  5. (اختياري) لتثبيت إصدار سابق من أدوات سطر الأوامر، شغِّل الأمر التالي:

    android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
    استبدِل version بالإصدار الذي تريد تثبيته. على سبيل المثال 5.0.

الاستخدام

يمكنك استخدام "sdkmanager" لعرض الحِزم المثبَّتة والمتاحة، ثم تثبيت. والحزم وحزم التحديث. لمزيد من التفاصيل، يُرجى الاطّلاع على الأقسام التالية.

قائمة الحِزم المثبَّتة والمتاحة

لسرد الحِزم المثبَّتة والمتاحة، استخدِم البنية التالية:

sdkmanager --list [options] \
           [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)

يمكنك استخدام الخيار channel لتضمين حزمة من قناة تصل إلى و بما في ذلك channel_id. على سبيل المثال، تحديد قناة إصدار Canary لإدراجها الحزم من كل القنوات.

تثبيت الحِزم

لتثبيت الحزم، استخدم الصيغة التالية:

sdkmanager packages [options]

الوسيطة packages هي مسار بنمط حزمة SDK، كما هو موضَّح مع الأمر --list، ملفوفًا بين علامتَي اقتباس. على سبيل المثال: "build-tools;34.0.0" أو "platforms;android-33"

يمكنك تمرير حزم متعددة تفصل بينها مسافة، ولكن يجب أن يكون كل منها محاطًا بمجموعة خاصة من الاقتباسات. على سبيل المثال، إليك كيفية تثبيت أحدث أدوات المنصة أدوات حزمة تطوير البرامج (SDK) للمستوى 33:

sdkmanager "platform-tools" "platforms;android-33"

بدلاً من ذلك، يمكنك تمرير ملف نصي يحدد جميع الحزم:

sdkmanager --package_file=package_file [options]

الوسيطة package_file هي موقع ملف نصي يُعد كل سطر مسارًا بنمط حزمة SDK لحزمة يجب تثبيتها (بدون علامات اقتباس).

لإلغاء تثبيت الإضافة، أضِف علامة --uninstall:

sdkmanager --uninstall packages [options]
sdkmanager --uninstall --package_file=package_file [options]

لتثبيت CMake أو NDK، استخدم الصيغة التالية:

sdkmanager --install
           ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"]
           [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)

على سبيل المثال، استخدِم الأمر التالي لتثبيت إصدار NDK المحدّد بغض النظر عن القناة التي يعمل عليها حاليًا:

sdkmanager --install "ndk;21.3.6528147" --channel=3 // Install the NDK from the canary channel (or below)
sdkmanager --install "cmake;10.24988404" // Install a specific version of CMake

تحديث كل الحِزَم المثبَّتة

لتعديل جميع الحِزم المثبَّتة، استخدِم البنية التالية:

sdkmanager --update [options]

قبول التراخيص

يجب قبول الترخيص اللازم لكل حزمة لديك. مثبت. تحدث هذه الخطوة أثناء مسار التثبيت عند التثبيت. الحزم من داخل "استوديو Android"

إذا لم يكن "استوديو Android" مثبّتًا لديك أو أنّه مخصّص لخادم CI أو أي جهاز آخر بلا واجهة مستخدم رسومية بدون واجهة مستخدم تصويرية بعد ذلك من سطر الأوامر:

sdkmanager --licenses

يطالبك هذا بقبول أي تراخيص لم يتم قبولها من قبل.

الخيارات

يسرد الجدول التالي الخيارات المتاحة للأوامر المدرجة في القسم السابق:

Option الوصف
--sdk_root=path استخدِم مسار حزمة تطوير البرامج (SDK) المحدَّد بدلاً من حزمة SDK التي تحتوي على هذه الأداة.
--channel=channel_id تضمين الحزم في القنوات بما يصل إلى channel_id متوفّر القنوات هي:

0 (ثابت)، 1 (إصدار تجريبي)، 2 (إصدار تجريبي)، و3 (إصدار Canary).

--include_obsolete تضمين الحزم القديمة في قائمة الحزمة أو تحديثات الحزمة. متاحة للاستخدام مع --list و--update فقط.
--no_https فرض استخدام HTTP بدلاً من HTTPS في جميع الاتصالات
--newer من خلال --list، يمكنك عرض الحِزم الجديدة أو القابلة للتحديث فقط.
--verbose وضع الإخراج المطوّل. تتمّ طباعة الأخطاء والتحذيرات والرسائل الإعلامية.
--proxy={http | socks} الاتصال عبر خادم وكيل من النوع المحدد: إما http ل أو البروتوكولات عالية المستوى مثل HTTP أو FTP socks للخادم الوكيل SOCKS (V4 أو V5).
--proxy_host={IP_address | DNS_address} عنوان IP أو نظام أسماء النطاقات للخادم الوكيل المطلوب استخدامه.
--proxy_port=port_number رقم منفذ الخادم الوكيل المطلوب الاتصال به.