مروری بر رابط خط فرمان اندروید (CLI)

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

برای مثال، یک عامل یا اسکریپت می‌تواند از رابط خط فرمان (CLI) برای انجام وظایفی مانند موارد زیر استفاده کند:

• خودکارسازی محیط و راه‌اندازی SDK اندروید
• پروژه‌های جدید را از قالب‌ها داربست‌بندی کنید
• مدیریت دستگاه‌های مجازی، نصب APKها، و بررسی صفحات نمایش زنده دستگاه و سلسله مراتب رابط کاربری مستقیماً از ترمینال شما
• برای تجزیه و تحلیل کد معنایی، رندر پیش‌نمایش Compose و جستجوی نسخه وابستگی، به نمونه‌های در حال اجرای Android Studio متصل شوید.
• اپلیکیشن خود را با Journeys تست کنید

رابط خط فرمان اندروید (Android CLI) همچنین به نمایندگان شما امکان دسترسی به مهارت‌های اندروید و پایگاه دانش تخصصی اندروید را می‌دهد تا اطمینان حاصل شود که پروژه‌های شما از الگوها و بهترین شیوه‌های توصیه‌شده توسط اندروید استفاده می‌کنند.

برای شرح کامل دستورات و گزینه‌های Android CLI، به مرجع دستورات Android CLI مراجعه کنید.

نصب رابط خط فرمان اندروید (CLI)

برای نصب رابط خط فرمان اندروید (CLI) مراحل زیر را دنبال کنید:

1. رابط خط فرمان اندروید را دانلود کنید .

2. برای اطمینان از اینکه از آخرین نسخه استفاده می‌کنید، Android CLI را به‌روزرسانی کنید:

   android update
   

برای بررسی اینکه آیا Android CLI از قبل روی دستگاه شما نصب شده است یا خیر، which android یا command -v android را اجرا کنید: اگر مسیری را برگرداند، پس نصب شده است.

برای نمایندگان تنظیم کنید

برای کمک به اپراتورها در درک و استفاده از Android CLI، android init اجرا کنید تا مهارت android-cli نصب شود.

android init

داده‌های جمع‌آوری‌شده

رابط خط فرمان اندروید (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 emulator برای ویندوز در حال حاضر غیرفعال است.
• دانلود رابط خط فرمان اندروید (Android CLI) از طریق پاورشل ویندوز (Windows PowerShell) در حال حاضر پشتیبانی نمی‌شود.

پیکربندی رابط خط فرمان اندروید (CLI)

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

• macOS و لینوکس : ~/.androidrc
• ویندوز : %USERPROFILE%\.androidrc

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

برای مثال، برای اینکه رابط خط فرمان اندروید (Android CLI) هر بار به طور پیش‌فرض از یک SDK اندروید خاص استفاده کند، فلگ --sdk را به فایل خود اضافه کنید:

--sdk=<path-to-sdk>

گزینه‌های جهانی

اینها پرچم‌های اختیاری هستند که می‌توانید با سایر دستورات CLI اندروید از آنها استفاده کنید.

-h, --help

کاربرد: android <command> -h

توضیحات: نمایش راهنمای ابزار یا دستور خاص مورد نظر.

مثال‌ها:

• android -h
• android create -h

--sdk

کاربرد: android --sdk=<path-to-sdk> <command>

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