نظرة عامة على واجهة سطر الأوامر في Android

‫Android CLI هي واجهة سطر أوامر تتيح لك إنشاء تطبيقات Android بكفاءة أكبر باستخدام أي أداة من اختيارك. فهي توحّد معايير الكفاءات الأساسية في مجال التطوير لسير العمل الذي يركّز على الوكلاء، وتوفّر نقطة دخول إلى الأدوات والمهارات والمعرفة الرسمية التي تحتاجها للتطوير بشكل أكثر فعالية. ويمكنه أيضًا تبسيط عملية الدمج المستمر والصيانة وأي عمليات أخرى تتم برمجتها آليًا لتناسب الطبيعة المتزايدة لتوزيع تطوير Android.

تغطي واجهة Android CLI دورة حياة التطوير الكاملة، بدءًا من إنشاء مشروع واختباره على جهاز وصولاً إلى تحليل أدائه والتحقيق في كيفية سلوكه في الميدان. على سبيل المثال، يمكن لوكيل أو نص برمجي استخدام واجهة سطر الأوامر لتنفيذ مهام مثل ما يلي:

تتيح واجهة Android CLI أيضًا لوكلائك الوصول إلى مهارات Android وقاعدة معلومات Android المتخصّصة للمساعدة في ضمان تطبيق مشاريعك للأنماط وأفضل الممارسات التي ينصح بها Android.

للحصول على وصف كامل لأوامر Android CLI وخياراتها، يُرجى الاطّلاع على مرجع أوامر Android CLI.

تثبيت Android CLI

لتثبيت Android CLI، اتّبِع الخطوات التالية:

  1. نزِّل Android CLI.

  2. للتأكّد من استخدام أحدث إصدار، يُرجى تحديث Android CLI:

    android update

للتحقّق مما إذا كان Android CLI مثبّتًا على جهازك، شغِّل which android أو command -v android: إذا عرض مسارًا، يعني ذلك أنّه مثبّت.

إعداد الوكلاء

لمساعدة الوكلاء في فهم Android CLI واستخدامها، شغِّل android init لتثبيت مهارة android-cli.

البيانات المجمَّعة

تجمع واجهة Android CLI بيانات حول الاستخدام الأساسي للأداة. في ما يلي البيانات التي نجمعها:

  • عمليات استدعاء الأمر android والأوامر الفرعية، مثل android run وandroid create
  • أسماء الوسيطات أو الخيارات غير الموضعية المستخدَمة، مثل --sdk أو --version.
  • الوسيطات الموضعية وقيم العلامات التي يتم ربطها بمجموعة ثابتة ومحدّدة مسبقًا من خيارات النظام التي تديرها واجهة Android CLI. على سبيل المثال، نجمع أسماء نماذج المحاكاة، مثل medium_phone وlarge_desktop، وأسماء الوكلاء، مثل GEMINI أو CLAUDE أو CODEX.
  • تتبُّع تسلسل استدعاء الدوال البرمجية ورسائل الاستثناء، حيث يتم إخفاء هوية المعلومات التي تكشف الهوية قبل جمعها للمساعدة في ضمان الخصوصية

في ما يلي بعض الأمثلة على البيانات التي لا نجمعها:

  • لا نجمع ردود واجهة سطر الأوامر عند تنفيذ أمر.
  • لا نجمع المدخلات التي ينشئها المستخدم أو المعرّفات الخارجية التي يتم تمريرها إلى واجهة سطر الأوامر، مثل إحداثيات Maven المحدّدة أو مسارات الملفات المحلية أو أسماء المشاريع المخصّصة. على سبيل المثال، إذا تم تنفيذ الأمر android create --name=com.company.internal.app، نسجّل أنّه تم تنفيذ android create باستخدام الوسيطة --name، ولكننا لا نخزّن القيمة com.company.internal.app.

لإيقاف جمع البيانات، استخدِم العلامة --no-metrics عند تشغيل أمر باستخدام Android CLI.

الملاحظات والمشاكل

إذا واجهت أي مشاكل أو أردت تقديم ملاحظات، يُرجى الإبلاغ عن خطأ.

ضبط إعدادات Android CLI

يمكنك إنشاء ملف .androidrc لتطبيق العلامات والخيارات تلقائيًا في كل مرة تستخدم فيها Android CLI. احفظ الملف في الموقع التالي، حسب نظام التشغيل:

  • نظاما التشغيل macOS وLinux: ~/.androidrc
  • نظام التشغيل Windows: %USERPROFILE%\.androidrc

أضِف العلامات التي تريد تطبيقها تلقائيًا على الملف، واحدة في كل سطر.

على سبيل المثال، لضبط Android CLI على استخدام حزمة تطوير برامج (SDK) معيّنة لنظام Android تلقائيًا في كل مرة، أضِف علامة --sdk إلى ملفك:

--sdk=<path-to-sdk>

الخيارات العامّة

هذه علامات اختيارية يمكنك استخدامها مع أوامر Android CLI الأخرى.

-h, --help

الاستخدام: android <command> -h

الوصف: يعرض دليل المساعدة الخاص بالأداة أو الأمر المحدّد.

أمثلة:

  • android -h
  • android create -h

--sdk

الاستخدام: android --sdk=<path-to-sdk> <command>

الوصف: المسار إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android التي تريد استخدامها للأمر التالي. يمكنك استخدام الإعداد --sdk لتجاوز حزمة تطوير البرامج (SDK) التلقائية لنظام Android مؤقتًا بدلاً من تغيير متغيرات البيئة العامة في كل مرة تريد فيها التبديل. لمعرفة حزمة تطوير البرامج (SDK) لنظام Android التي تستخدمها تلقائيًا، شغِّل android info.

مثال: android --sdk=<path/to/sdk> sdk list

-v, --verbose

الاستخدام: android -v <command>

الوصف: تفعيل الناتج المطوَّل حدِّد خيارات -v متعددة لزيادة الإسهاب (على سبيل المثال، -v أو -vv أو -vvv).

-V, --version

الاستخدام: android -V

الوصف: طباعة معلومات الإصدار والخروج

الطلبات

للحصول على وصف كامل لأوامر Android CLI وخياراتها، يُرجى الاطّلاع على مرجع أوامر Android CLI.