sdkmanager
هي أداة سطر أوامر تتيح لك عرض
وتحديث وإلغاء تثبيت الحزم لحزمة تطوير البرامج (SDK) لنظام التشغيل Android. في حال استخدام Android
لن تحتاج إلى استخدام هذه الأداة، ويمكنك بدلاً من ذلك إدارة
حِزم SDK من بيئة التطوير المتكاملة (IDE).
تتوفر أداة sdkmanager
في حزمة
أدوات سطر أوامر حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
لاستخدام "مدير SDK" لتثبيت إصدار من أدوات سطر الأوامر، يُرجى اتّباع الخطوات التالية:
اتبع هذه الخطوات:
- تنزيل أحدث إصدار من "أدوات سطر الأوامر فقط" الحزمة من صفحة عمليات التنزيل في "استوديو Android" فك ضغط الحزمة.
- انقِل الدليل
cmdline-tools
الذي تم فك ضغطه إلى دليل جديد من اختيارك، مثل android_sdk. هذا الدليل الجديد هو دليل حزمة SDK لنظام التشغيل Android. - في دليل
cmdline-tools
غير المضغوط، أنشئ دليل فرعي يسمىlatest
. - نقل محتوى الدليل الأصلي
cmdline-tools
، بما في ذلك الدليلlib
والدليلbin
والملفNOTICE.txt
والملفsource.properties
، إلى الدليلlatest
الذي تم إنشاؤه حديثًا يمكنك الآن استخدام سطر الأوامر من هذا الموقع. (اختياري) لتثبيت إصدار سابق من أدوات سطر الأوامر، نفِّذ الأمر التالي:
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) أو جهاز Linux آخر بدون واجهة مستخدم تصويرية، عليك تنفيذ الخطوات التالية من سطر الأوامر:
sdkmanager --licenses
يطالبك هذا بقبول أي تراخيص لم يتم قبولها من قبل.
الخيارات
يسرد الجدول التالي الخيارات المتاحة للأوامر المدرَجة في القسم السابق:
Option | الوصف |
---|---|
--sdk_root=path
|
استخدِم مسار حزمة تطوير البرامج (SDK) المحدّد بدلاً من حزمة SDK التي تحتوي على هذه الأداة. |
--channel=channel_id
|
يجب تضمين الحِزم في القنوات حتى معرّف القناة المدرَج. في ما يلي القنوات
المتاحة:
|
--include_obsolete
|
تضمين الحزم القديمة في قائمة الحزمة أو تحديثات الحزمة.
متاحة للاستخدام مع --list و--update فقط.
|
--no_https
|
فرض استخدام بروتوكول HTTP بدلاً من HTTPS في جميع عمليات الاتصال |
--newer
|
مع --list ، يمكنك عرض الحِزم الجديدة أو القابلة للتحديث فقط.
|
--verbose
|
وضع الإخراج المطوّل. تتمّ طباعة الأخطاء والتحذيرات والرسائل الإعلامية. |
--proxy={http | socks}
|
يمكنك الاتصال عبر خادم وكيل من النوع المحدَّد: إما http لبروتوكولات
المستوى العالي، مثل HTTP أو FTP، أو
socks لخادم وكيل SOCKS (الإصدار 4 أو الإصدار 5).
|
--proxy_host={IP_address | DNS_address}
|
عنوان IP أو عنوان نظام أسماء النطاقات للخادم الوكيل المطلوب استخدامه |
--proxy_port=port_number
|
رقم منفذ الخادم الوكيل المطلوب الاتصال به. |