android run

إنشاء تطبيق Android ونشره وتشغيله على جهاز أو محاكي متصل

الاستخدام

android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM] [--install-options=PARAM] [--type=PARAM] [--use-delta-install]

الخيارات

  • --activity=PARAM: اسم النشاط
  • استبدِل --apks=PARAM بمسارات حِزم APK مفصولة بفواصل.
  • --debug: لتشغيل التطبيق في وضع تصحيح الأخطاء
  • ‫--device=PARAM: الرقم التسلسلي للجهاز
  • ‫-h,--help: يعرض رسالة المساعدة للأمر المحدّد.
  • --install-options=PARAM: خيارات أو علامات إضافية يتم تمريرها إلى عملية تثبيت مدير الحِزم (على سبيل المثال، -g أو -d).
  • ‫--type=PARAM: نوع المكوّن (ACTIVITY، WATCH_FACE، TILE، COMPLICATION، DECLARATIVE_WATCH_FACE، WEAR_WIDGET)
  • ‫--use-delta-install: استخدام التثبيت السريع للتغييرات (يؤدي إلى تسريع التحديثات التزايدية من خلال نقل الرموز والموارد المعدَّلة فقط، والقيمة التلقائية هي true).

خيارات android:

  • استبدِل --sdk=PARAM بمسار حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  • -v,--verbose: لتفعيل الإخراج المطوَّل لتحديد المشاكل وحلّها
  • ‫-V,--version - طباعة معلومات الإصدار والخروج

الوصف

تنشر android run ملف APK واحدًا أو أكثر على جهاز Android أو محاكي Android متصلَين، ثم تشغّل على الفور مكوّن التطبيق المستهدف.

تحديد ما سيتم تنفيذه (--type و--activity)

يؤدي android run تلقائيًا إلى تشغيل النشاط الرئيسي التلقائي المحدّد في بيان التطبيق. يمكنك تجاهل ما يتم تشغيله باستخدام الخيارات التالية:

  • ‫--activity: تحدّد اسم فئة النشاط أو المكوّن المطلوب تشغيله (مطلوب إذا كانت حزمة APK تتضمّن أنشطة متعدّدة قابلة للتشغيل).
  • --type: تحدّد نوع المكوّن الذي سيتم تشغيله بدلاً من نشاط واجهة المستخدم العادي. تشمل القيم المسموح بها ACTIVITY وWATCH_FACE وTILE وCOMPLICATION وDECLARATIVE_WATCH_FACE وWEAR_WIDGET.
  • ‫--debug: يفتح التطبيق في وضع تصحيح الأخطاء وينتظر ربط مصحّح أخطاء من "استوديو Android" أو أداة سطر أوامر.

أمثلة

يمكنك نشر حزمة APK واحدة لتصحيح الأخطاء وتشغيل نشاطها الرئيسي على الجهاز المتصل التلقائي:

android run --apks=app/build/outputs/apk/debug/app-debug.apk

نشر حِزم APK متعدّدة مجزّأة إلى محاكي معيّن:

android run --device=emulator-5554 --apks=base.apk,density-hdpi.apk,lang-en.apk

نشر حزمة APK وتشغيل نشاط معيّن في وضع تصحيح الأخطاء:

android run --debug --activity=.ui.MainActivity --apks=app-debug.apk