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

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

على سبيل المثال، يمكن أن يستخدم وكيل أو نص برمجي واجهة سطر الأوامر لتنفيذ مهام مثل ما يلي:

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

تتيح أداة 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 بيانات حول الاستخدام الأساسي للأداة. في ما يلي البيانات التي نجمعها:

  • عمليات استدعاء الأمر 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 emulator لنظام التشغيل Windows غير مفعَّل حاليًا.
  • لا يمكن حاليًا تنزيل واجهة سطر الأوامر لنظام التشغيل Android من Windows PowerShell.

ضبط 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.