نمای کلی Android CLI

Android CLI یک میانای خط فرمان است که به شما امکان می‌دهد بااستفاده از هر ابزاری که انتخاب می‌کنید، به‌طور کارآمدتری برای Android بسازید. این گواهینامه شایستگی‌های اصلی توسعه را برای گردش‌های کاری عامل‌محور استاندارد می‌کند و نقطه ورودی به ابزارها، مهارت‌ها، و دانش رسمی‌ای که برای توسعه مؤثرتر نیاز دارید فراهم می‌کند. همچنین می‌تواند CI، نگهداری، و هرگونه خودکارسازی اسکریپت‌شده دیگر را برای ماهیت توسعه Android که به‌طور فزاینده‌ای توزیع‌شده است، ساده کند.

‫Android CLI کل چرخه حیات توسعه را پوشش می‌دهد، از ایجاد پروژه و آزمایش آن در دستگاه گرفته تا نمایه‌سازی عملکرد آن و بررسی نحوه رفتار آن در محیط واقعی. برای مثال، یک عامل یا اسکریپت می‌تواند از 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 را جمع‌آوری می‌کنیم.
  • رد پشته و پیام‌های استثنا، که در آن اطلاعات شناساننده قبل‌از جمع‌آوری ناشناس‌سازی می‌شود تا به حفظ حریم خصوصی کمک کند.

در اینجا چند نمونه از داده‌هایی که جمع‌آوری نمی‌کنیم آورده شده است:

  • هنگام اجرای فرمان، پاسخ‌های CLI را جمع‌آوری نمی‌کنیم.
  • ورودی‌های ایجادشده توسط کاربر یا شناسه‌های خارجی ارسال‌شده به CLI را جمع‌آوری نمی‌کنیم، مانند مختصات خاص Maven، مسیرهای فایل محلی، یا نام‌های پروژه سفارشی. برای مثال، اگر فرمان android create --name=com.company.internal.app اجرا شود، ثبت می‌کنیم که android create بااستفاده از شناسه --name اجرا شده است اما مقدار com.company.internal.app را ذخیره نمی‌کنیم.

برای غیرفعال کردن جمع‌آوری داده، هنگام اجرای فرمان با Android CLI از پرچم --no-metrics استفاده کنید.

بازخورد و مشکلات

اگر با مشکلی مواجه شدید یا می‌خواهید بازخورد ارائه دهید، اشکال را گزارش کنید.

پیکربندی Android CLI

فایل .androidrc ایجاد کنید تا هربار که Android CLI را فراخوانی می‌کنید، پرچم‌ها و گزینه‌ها به‌طور خودکار اعمال شوند. بسته به سیستم‌عاملتان، فایل را در مکان زیر ذخیره کنید:

  • macOS و Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

پرچم‌هایی را که می‌خواهید به‌طور خودکار به فایل اعمال شود اضافه کنید (هر پرچم در یک خط).

برای مثال، برای اینکه Android CLI به‌طور پیش‌فرض هربار از کیت توسعه نرم‌افزار 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>

توضیحات: مسیر کیت توسعه نرم‌افزار Android که می‌خواهید برای فرمان بعدی استفاده کنید. می‌توانید از تنظیم --sdk برای لغو موقت کیت توسعه نرم‌افزار Android پیش‌فرض استفاده کنید، به‌جای اینکه هربار که می‌خواهید تغییر دهید، متغیرهای محیطی سراسری را تغییر دهید. برای بررسی اینکه به‌طور پیش‌فرض از کدام کیت توسعه نرم‌افزار 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 مراجعه کنید.