ملاحظة: للحصول على معلومات حول أوامر Android CLI، راجِع مرجع أوامر Android CLI.
تتكوّن حزمة تطوير البرامج (SDK) لنظام التشغيل Android من حِزم متعددة مطلوبة لتطوير التطبيقات. تسرد هذه الصفحة أهم أدوات سطر الأوامر المتاحة، وهي منظَّمة حسب الحِزم التي يتم توفيرها فيها.
يمكنك تثبيت كل حزمة وتعديلها باستخدام SDK Manager في "استوديو Android" أو أداة سطر الأوامر sdkmanager.
يتم تنزيل جميع الحِزم في دليل حزمة تطوير البرامج (SDK) لنظام التشغيل Android، ويمكنك العثور عليه باتّباع الخطوات التالية:
- في "استوديو Android"، انقر على ملف > بنية المشروع.
- انقر على موقع حزمة SDK في اللوحة اليمنى. يظهر المسار ضمن موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
ضبط متغيرات البيئة
ننصحك بضبط متغيّر البيئة الخاص بـ ANDROID_HOME عند استخدام سطر الأوامر. اضبط أيضًا مسار البحث عن الأوامر ليشمل
ANDROID_HOME/tools وANDROID_HOME/tools/bin وANDROID_HOME/platform-tools للعثور على الأدوات الأكثر شيوعًا. تختلف الخطوات حسب نظام التشغيل، ولكن يمكنك الاطّلاع على كيفية ضبط متغيّرات البيئة للحصول على إرشادات عامة.
أدوات سطر الأوامر في حزمة تطوير البرامج لنظام التشغيل Android
الموقع الجغرافي: android_sdk/cmdline-tools/version/bin/
ملاحظة: تحل حزمة أدوات سطر الأوامر في حزمة تطوير البرامج (SDK) لنظام التشغيل Android، والموجودة في cmdline-tools، محل حزمة أدوات حزمة تطوير البرامج (SDK)، والموجودة في tools. باستخدام الحزمة الجديدة، يمكنك اختيار إصدار أدوات سطر الأوامر الذي تريد تثبيته، ويمكنك تثبيت إصدارات متعددة في الوقت نفسه. باستخدام الحزمة القديمة، يمكنك تثبيت أحدث إصدار من الأدوات فقط. وبالتالي، تتيح لك الحزمة الجديدة الاعتماد على إصدارات محدّدة من أدوات سطر الأوامر بدون أن يتوقف الرمز البرمجي عند إصدار إصدارات جديدة. للحصول على معلومات حول حزمة أدوات SDK المتوقّفة نهائيًا، يمكنك الاطّلاع على ملاحظات إصدار أدوات SDK.
إذا كنت لا تستخدم "استوديو Android"، يمكنك تنزيل حزمة أدوات سطر الأوامر.
apkanalyzer- تقدِّم هذه الأداة إحصاءات عن تركيبة حزمة APK بعد اكتمال عملية التصميم.
avdmanager- تتيح لك إنشاء أجهزة Android الافتراضية (AVD) وإدارتها من سطر الأوامر.
lint- يفحص الرمز البرمجي لمساعدتك في تحديد المشاكل وتصحيحها في ما يتعلّق بجودة بنية الرمز البرمجي.
retrace- بالنسبة إلى التطبيقات التي تم تجميعها باستخدام R8، يفك
retraceترميز تتبُّع تسلسل استدعاء الدوال البرمجية الذي تم تشويشه، ويتم ربطه برمز المصدر الأصلي. sdkmanager- تتيح لك عرض حِزم حزمة تطوير البرامج (SDK) لنظام التشغيل Android وتثبيتها وتحديثها وإلغاء تثبيتها
أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android
الموقع الجغرافي: android_sdk/build-tools/version/
يُرجى الاطّلاع على ملاحظات إصدار أدوات إنشاء حزمة تطوير البرامج (SDK) للحصول على مزيد من المعلومات.
يجب توفُّر هذه الحزمة لإنشاء تطبيقات Android. يتم استدعاء معظم الأدوات في هذه الحزمة من خلال أدوات الإنشاء، وهي غير مخصّصة لك. ومع ذلك، قد تكون أدوات سطر الأوامر التالية مفيدة:
AAPT2- تحلّل موارد Android وتفهرسها وتجمعها في تنسيق ثنائي محسّن لمنصة Android، ثم تحزّم الموارد المجمّعة في ناتج واحد.
apksigner- توقيع حِزم APK والتحقّق مما إذا كان سيتم تأكيد توقيعات حِزم APK بنجاح على جميع إصدارات النظام الأساسي التي تتوافق مع حزمة APK معيّنة
zipalign- تحسين ملفات APK من خلال التأكّد من أنّ جميع البيانات غير المضغوطة تبدأ بمحاذاة معيّنة بالنسبة إلى بداية الملف
ملاحظة: يمكنك استخدام إصدارات متعددة من أدوات الإنشاء لإنشاء تطبيقك لإصدارات مختلفة من Android.
أدوات النظام الأساسي لحزمة تطوير البرامج (SDK) لنظام التشغيل Android
الموقع الجغرافي: android_sdk/platform-tools/
يمكنك الاطّلاع على ملاحظات إصدار أدوات منصة حزمة SDK للحصول على مزيد من المعلومات.
يتم تعديل هذه الأدوات مع كل إصدار جديد من نظام Android الأساسي لتتضمّن ميزات جديدة وتعمل على إصلاح الأخطاء أو تحسين الأدوات، كما أنّ كل تعديل متوافق مع الإصدارات السابقة من النظام الأساسي.
بالإضافة إلى التنزيل من خلال أداة SDK Manager، يمكنك تنزيل "أدوات النظام الأساسي لحزمة تطوير البرامج" هنا.
adb- أداة Android Debug Bridge (adb) هي أداة متعدّدة الاستخدامات تتيح لك إدارة حالة مثيل محاكي أو جهاز يعمل بنظام التشغيل Android. يمكنك أيضًا استخدامها لتثبيت حزمة APK على جهاز.
etc1tool- أداة سطر أوامر تتيح لك ترميز صور PNG وفقًا لمعيار ضغط ETC1 وفك ترميز صور ETC1 المضغوطة مرة أخرى إلى PNG.
fastboot- تومض صورة النظام الأساسي وصور النظام الأخرى على الجهاز. للحصول على تعليمات حول تثبيت الصور، يُرجى الاطّلاع على صور المصنع لأجهزة Nexus وPixel.
logcat- يتم استدعاؤه من خلال adb لعرض سجلات التطبيقات والنظام.
Android Emulator
الموقع الجغرافي: android_sdk/emulator/
يُرجى الاطّلاع على ملاحظات إصدار Android Emulator للحصول على مزيد من المعلومات.
هذه الحزمة مطلوبة لاستخدام "محاكي Android". ويشمل ذلك ما يلي:
emulator- أداة لمحاكاة الأجهزة تستند إلى QEMU ويمكنك استخدامها لتصحيح أخطاء تطبيقاتك واختبارها في بيئة وقت تشغيل Android فعلية.
mksdcard- تساعدك هذه الأداة في إنشاء صورة قرص يمكنك استخدامها مع المحاكي لمحاكاة وجود بطاقة تخزين خارجية، مثل بطاقة SD.
ملاحظة: قبل الإصدار 25.3.0، كانت أدوات المحاكي مضمّنة في حزمة أدوات SDK.
Jetifier
يقرأ Jetifier مكتبة تستخدم فئات Support Library، ويُخرج مكتبة مكافئة تستخدم فئات AndroidX الأحدث.