یادداشت‌های انتشار برای رابط خط فرمان اندروید (Android CLI)

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

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

نسخه ۱.۰.۱۶۴۰۶۱۸۳ (سپتامبر ۲۰۲۶)

  • راه‌اندازی سریع‌تر : رابط خط فرمان اندروید (CLI) حدود دو برابر سریع‌تر شروع می‌شود، زیرا کتابخانه دانلودکننده بومی فقط زمانی که استفاده می‌شود بارگذاری می‌شود و دیگر در هر فراخوانی در یک دایرکتوری موقت از حالت فشرده خارج نمی‌شود.
  • کدهای خروج اصلاح‌شده : اکنون دستورات، از جمله create ، run ، install ، describe ، layout ، docs ، info ، skills و update ، در صورت عدم موفقیت، یک کد خروج غیر صفر برمی‌گردانند که این امر اسکریپت‌نویسی و CI را قابل اعتمادتر می‌کند.
  • تنظیم حاشیه‌نویسی صفحه : android screen --annotate پارامترهای تنظیم را برای تشخیص ویژگی خود، از جمله آستانه‌های تشخیص لبه، فیلتر شکل و استراتژی خوشه‌بندی، که در --help مستند شده‌اند، ارائه می‌دهد.
  • گزینه‌های ایجاد پروژه : android create از پرچم‌های --application-id و --namespace و نام گزینه‌های خط فاصله‌دار مانند --min-sdk پشتیبانی می‌کند. الگوی Compose اکنون از مجموعه منبع src/main/kotlin و یک تم Material 3 استفاده می‌کند.
  • شبیه‌ساز بی‌سر : با استفاده از android emulator start --headless یک شبیه‌ساز بدون پنجره را اجرا کنید.
  • قابلیت اطمینان SDK : دستورات android sdk یک قفل بین فرآیندی می‌گیرند تا فراخوانی‌های همزمان با هم تداخل نداشته باشند، مسیر و نسخه بسته‌های نصب شده را تأیید می‌کنند، فایل‌های XML قدیمی را فقط در صورت نیاز به‌روزرسانی می‌کنند و خطاهای واضح‌تری را گزارش می‌دهند.
  • خروجی پیش‌نمایش نوشتن : android studio render-compose-preview مسیر مطلق تصویر رندر شده را چاپ می‌کند و نوشتن را حتی زمانی که --print-semantics استفاده شده باشد، تأیید می‌کند.
  • پشتیبانی از سطح API قدیمی‌تر : رفع مشکلات مربوط به تعامل دستگاه، مانند android layout ، در دستگاه‌هایی که از سطح API 32 و پایین‌تر استفاده می‌کنند.

نسخه ۱.۰.۱۶۲۶۱۴۲۵ (سپتامبر ۲۰۲۶)

  • رفع مشکلات طرح‌بندی : مشکل عدم کارکرد دستور طرح‌بندی در برخی سناریوها برطرف شد. برای بازگشت موقت به رفتار طرح‌بندی قدیمی، export ANDROID_CLI_LAYOUT_V1=1 .

نسخه ۱.۰.۱۶۲۵۱۰۱۷ (سپتامبر ۲۰۲۶)

  • تخلیه طرح‌بندی : android layout اکنون از پرچم --no-idle برای دریافت طرح‌بندی بدون انتظار برای حالت بیکار پشتیبانی می‌کند. android layout همچنین از پرچم --full برای بازگرداندن کل درخت طرح‌بندی بدون فیلتر کردن پشتیبانی می‌کند. به طور پیش‌فرض، layout فقط عناصر تعاملی را برمی‌گرداند.
  • تکمیل پوسته : اسکریپت‌های تکمیل خودکار پوسته را برای Bash و Zsh با استفاده از دستور جدید android completion تولید و نصب کنید.
  • به‌روزرسانی مهارت‌ها : مهارت‌ها را با دستور جدید android skills update به‌روز نگه دارید و چندین مهارت را در یک فراخوانی نصب یا حذف کنید (برای مثال، android skills install <skill1> <skill2> ).
  • فهرست مهارت‌ها بر اساس عامل : android skills list اکنون به صورت پیش‌فرض به نمایش جزئیات، شامل توضیحات مهارت و عامل‌هایی که مهارت در آن‌ها نصب شده است، می‌پردازد. android skills list همچنین از پرچم --agent <agent> برای فهرست کردن تمام مهارت‌های نصب شده برای یک عامل پشتیبانی می‌کند.
  • عملکرد نصب دلتا : تسریع وصله‌گذاری تدریجی APK در android install با استفاده از فراخوانی‌های سیستمی بدون کپی هسته.
  • تشخیص لبه صفحه نمایش : بهبود تشخیص ویژگی و لبه در android screen با استفاده از الگوریتم‌های تشخیص لبه Canny.

نسخه ۱.۰.۱۵۹۸۵۴۸۸ (ژوئیه ۲۰۲۶)

  • دستور نصب اختصاصی : نصب فایل‌های APK با استفاده از دستور android install که قابلیت ارسال تدریجی APK را دارد، نصب‌های افزایشی را بسیار سریع‌تر از adb انجام می‌دهد.
  • اجرای نصب‌های تدریجی : به طور مشابه، از پرچم جدید --use-delta-install در android run برای استقرار سریع‌تر و تدریجی APK در دستگاه‌ها استفاده کنید.
  • مدیریت SDK بین پلتفرمی : پلتفرم‌های غیر میزبان را با استفاده از فلگ جدید --platform <os_arch> در دستورات android sdk ( install ، update ، materialize ) هدف قرار دهید تا اجزا را در معماری‌های سیستم عامل و CPU بررسی، حل و فصل و نصب کنید.
  • بهبودهای رابط خط فرمان مهارت‌ها : زیردستورات android skills ( add ، remove ، list ، find ) گسترش‌یافته با مستندات --help ، بازخورد واضح در صورت عدم وجود مهارت‌ها، و مرحله‌بندی دانلود اتمی امن‌تر با بازگشت خودکار.

نسخه ۱.۰.۱۵۸۵۷۰۳۶ (ژوئیه ۲۰۲۶)

  • پشتیبانی گسترده‌تر از مهارت‌های عامل : با استفاده از نصب android skills install .
  • دانلودکننده بومی با پشتیبانی از پروکسی : منابع شبکه را با استفاده از یک دانلودکننده HTTP بومی با پشتیبانی آماده برای پروکسی‌های شرکتی، به طور قابل اعتمادی دانلود کنید.
  • مدیریت بسته SDK : مدیریت بسته‌های SDK با حذف چند بسته در android sdk remove و وضوح مبتنی بر SHA در android sdk resolve .
  • بهبودهای توصیف و نمایش : خطاهای ساخت Gradle را مستقیماً در خروجی استاندارد در android describe مشاهده کنید و دستگاه‌های خاص را با استفاده از پرچم --device در android screen هدف قرار دهید.
  • قابلیت استفاده از رابط خط فرمان (CLI) و گزارش خطا : پیام‌های خطای واضح‌تر هنگام وارد کردن دستورات ناشناخته یا اهداف ایجاد پروژه نامعتبر، دستورات android emulator بدون حساسیت به حروف بزرگ و کوچک.

نسخه ۱.۰.۱۵۴۹۸۳۵۶ (مه ۲۰۲۶)

  • بارگذاری پویای قالب SDK : قالب‌های پروژه برای android create اکنون به صورت پویا از بسته SDK اندروید دانلود می‌شوند و دیگر در فایل باینری CLI قرار نمی‌گیرند و این امر تضمین می‌کند که پروژه‌های جدید همیشه از جدیدترین قالب‌ها استفاده کنند.
  • سازگاری با مجوز SDK : مجوزهای SDK پذیرفته‌شده که توسط android sdk ذخیره می‌شوند، اکنون با فرمت فایل مورد انتظار ابزارهای قدیمی‌تر Android SDK و افزونه‌های Gradle مطابقت دارند.
  • پشتیبانی از لینک‌های نمادین : پشتیبانی از لینک‌های نمادین در دستورات CLI و عملیات فایل اضافه شده است.
  • استخراج دودویی اتمی : با باز کردن فایل‌های دودویی در یک دایرکتوری موقت قبل از انتقال اتمی آنها به محل مورد نظر، از ایجاد شرایط رقابتی استخراج در حین فراخوانی‌های همزمان چند فرآیندی CLI جلوگیری کنید.
  • پایداری ویندوز : بهبود سازگاری و عملکرد ویندوز در ویندوز ۱۱، در کنار اصلاحاتی برای وضوح مسیر دایرکتوری خانگی.

نسخه ۱.۰.۱۵۴۳۳۴۸۲ (مه ۲۰۲۶)

  • ادغام Antigravity : رابط خط فرمان اندروید و مهارت‌ها اکنون رسماً به عنوان یک بسته اختیاری از منابع در Google Antigravity 2.0 ادغام شده‌اند تا توسعه عامل‌محور شما را ساده‌تر کنند.
  • دستورات اندروید استودیو : از دستور جدید android studio استفاده کنید تا به عامل‌های خود اجازه دهید از قابلیت‌های عمیق و زمینه‌ای اندروید استودیو، از جمله تحلیل کد، جستجوی معنایی و رندرینگ Compose، بهره ببرند.
  • پشتیبانی از سفرها : با استفاده از سفرها، تجربیات حیاتی کاربر را اعتبارسنجی کنید، که توصیفاتی به زبان طبیعی از جریان‌های کاربری هستند که عوامل شما می‌توانند از ترمینال یا در CI/CD اجرا کنند.
  • مهارت‌های جدید اندروید : به کتابخانه مهارت‌های جدید اندروید ، از جمله مهارت‌های مربوط به مهاجرت CameraX، رابط کاربری تطبیقی، AppFunctions و سبک‌های نوشتن، دسترسی پیدا کنید.
  • گزینه‌های بیشتر نصب : با استفاده از ابزارهای مدیریت بسته محبوب، از جمله apt-get ، winget و homebrew ، رابط خط فرمان اندروید (Android CLI) را نصب و به‌روزرسانی کنید. برای جزئیات بیشتر، به گزینه‌های دانلود مراجعه کنید.

نسخه ۰.۷ (آوریل ۲۰۲۶)

اولین انتشار!

،

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

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

نسخه ۱.۰.۱۶۴۰۶۱۸۳ (سپتامبر ۲۰۲۶)

  • راه‌اندازی سریع‌تر : رابط خط فرمان اندروید (CLI) حدود دو برابر سریع‌تر شروع می‌شود، زیرا کتابخانه دانلودکننده بومی فقط زمانی که استفاده می‌شود بارگذاری می‌شود و دیگر در هر فراخوانی در یک دایرکتوری موقت از حالت فشرده خارج نمی‌شود.
  • کدهای خروج اصلاح‌شده : اکنون دستورات، از جمله create ، run ، install ، describe ، layout ، docs ، info ، skills و update ، در صورت عدم موفقیت، یک کد خروج غیر صفر برمی‌گردانند که این امر اسکریپت‌نویسی و CI را قابل اعتمادتر می‌کند.
  • تنظیم حاشیه‌نویسی صفحه : android screen --annotate پارامترهای تنظیم را برای تشخیص ویژگی خود، از جمله آستانه‌های تشخیص لبه، فیلتر شکل و استراتژی خوشه‌بندی، که در --help مستند شده‌اند، ارائه می‌دهد.
  • گزینه‌های ایجاد پروژه : android create از پرچم‌های --application-id و --namespace و نام گزینه‌های خط فاصله‌دار مانند --min-sdk پشتیبانی می‌کند. الگوی Compose اکنون از مجموعه منبع src/main/kotlin و یک تم Material 3 استفاده می‌کند.
  • شبیه‌ساز بی‌سر : با استفاده از android emulator start --headless یک شبیه‌ساز بدون پنجره را اجرا کنید.
  • قابلیت اطمینان SDK : دستورات android sdk یک قفل بین فرآیندی می‌گیرند تا فراخوانی‌های همزمان با هم تداخل نداشته باشند، مسیر و نسخه بسته‌های نصب شده را تأیید می‌کنند، فایل‌های XML قدیمی را فقط در صورت نیاز به‌روزرسانی می‌کنند و خطاهای واضح‌تری را گزارش می‌دهند.
  • خروجی پیش‌نمایش نوشتن : android studio render-compose-preview مسیر مطلق تصویر رندر شده را چاپ می‌کند و نوشتن را حتی زمانی که --print-semantics استفاده شده باشد، تأیید می‌کند.
  • پشتیبانی از سطح API قدیمی‌تر : رفع مشکلات مربوط به تعامل دستگاه، مانند android layout ، در دستگاه‌هایی که از سطح API 32 و پایین‌تر استفاده می‌کنند.

نسخه ۱.۰.۱۶۲۶۱۴۲۵ (سپتامبر ۲۰۲۶)

  • رفع مشکلات طرح‌بندی : مشکل عدم کارکرد دستور طرح‌بندی در برخی سناریوها برطرف شد. برای بازگشت موقت به رفتار طرح‌بندی قدیمی، export ANDROID_CLI_LAYOUT_V1=1 .

نسخه ۱.۰.۱۶۲۵۱۰۱۷ (سپتامبر ۲۰۲۶)

  • تخلیه طرح‌بندی : android layout اکنون از پرچم --no-idle برای دریافت طرح‌بندی بدون انتظار برای حالت بیکار پشتیبانی می‌کند. android layout همچنین از پرچم --full برای بازگرداندن کل درخت طرح‌بندی بدون فیلتر کردن پشتیبانی می‌کند. به طور پیش‌فرض، layout فقط عناصر تعاملی را برمی‌گرداند.
  • تکمیل پوسته : اسکریپت‌های تکمیل خودکار پوسته را برای Bash و Zsh با استفاده از دستور جدید android completion تولید و نصب کنید.
  • به‌روزرسانی مهارت‌ها : مهارت‌ها را با دستور جدید android skills update به‌روز نگه دارید و چندین مهارت را در یک فراخوانی نصب یا حذف کنید (برای مثال، android skills install <skill1> <skill2> ).
  • فهرست مهارت‌ها بر اساس عامل : android skills list اکنون به صورت پیش‌فرض به نمایش جزئیات، شامل توضیحات مهارت و عامل‌هایی که مهارت در آن‌ها نصب شده است، می‌پردازد. android skills list همچنین از پرچم --agent <agent> برای فهرست کردن تمام مهارت‌های نصب شده برای یک عامل پشتیبانی می‌کند.
  • عملکرد نصب دلتا : تسریع وصله‌گذاری تدریجی APK در android install با استفاده از فراخوانی‌های سیستمی بدون کپی هسته.
  • تشخیص لبه صفحه نمایش : بهبود تشخیص ویژگی و لبه در android screen با استفاده از الگوریتم‌های تشخیص لبه Canny.

نسخه ۱.۰.۱۵۹۸۵۴۸۸ (ژوئیه ۲۰۲۶)

  • دستور نصب اختصاصی : نصب فایل‌های APK با استفاده از دستور android install که قابلیت ارسال تدریجی APK را دارد، نصب‌های افزایشی را بسیار سریع‌تر از adb انجام می‌دهد.
  • اجرای نصب‌های تدریجی : به طور مشابه، از پرچم جدید --use-delta-install در android run برای استقرار سریع‌تر و تدریجی APK در دستگاه‌ها استفاده کنید.
  • مدیریت SDK بین پلتفرمی : پلتفرم‌های غیر میزبان را با استفاده از فلگ جدید --platform <os_arch> در دستورات android sdk ( install ، update ، materialize ) هدف قرار دهید تا اجزا را در معماری‌های سیستم عامل و CPU بررسی، حل و فصل و نصب کنید.
  • بهبودهای رابط خط فرمان مهارت‌ها : زیردستورات android skills ( add ، remove ، list ، find ) گسترش‌یافته با مستندات --help ، بازخورد واضح در صورت عدم وجود مهارت‌ها، و مرحله‌بندی دانلود اتمی امن‌تر با بازگشت خودکار.

نسخه ۱.۰.۱۵۸۵۷۰۳۶ (ژوئیه ۲۰۲۶)

  • پشتیبانی گسترده‌تر از مهارت‌های عامل : با استفاده از نصب android skills install .
  • دانلودکننده بومی با پشتیبانی از پروکسی : منابع شبکه را با استفاده از یک دانلودکننده HTTP بومی با پشتیبانی آماده برای پروکسی‌های شرکتی، به طور قابل اعتمادی دانلود کنید.
  • مدیریت بسته SDK : مدیریت بسته‌های SDK با حذف چند بسته در android sdk remove و وضوح مبتنی بر SHA در android sdk resolve .
  • بهبودهای توصیف و نمایش : خطاهای ساخت Gradle را مستقیماً در خروجی استاندارد در android describe مشاهده کنید و دستگاه‌های خاص را با استفاده از پرچم --device در android screen هدف قرار دهید.
  • قابلیت استفاده از رابط خط فرمان (CLI) و گزارش خطا : پیام‌های خطای واضح‌تر هنگام وارد کردن دستورات ناشناخته یا اهداف ایجاد پروژه نامعتبر، دستورات android emulator بدون حساسیت به حروف بزرگ و کوچک.

نسخه ۱.۰.۱۵۴۹۸۳۵۶ (مه ۲۰۲۶)

  • بارگذاری پویای قالب SDK : قالب‌های پروژه برای android create اکنون به صورت پویا از بسته SDK اندروید دانلود می‌شوند و دیگر در فایل باینری CLI قرار نمی‌گیرند و این امر تضمین می‌کند که پروژه‌های جدید همیشه از جدیدترین قالب‌ها استفاده کنند.
  • سازگاری با مجوز SDK : مجوزهای SDK پذیرفته‌شده که توسط android sdk ذخیره می‌شوند، اکنون با فرمت فایل مورد انتظار ابزارهای قدیمی‌تر Android SDK و افزونه‌های Gradle مطابقت دارند.
  • پشتیبانی از لینک‌های نمادین : پشتیبانی از لینک‌های نمادین در دستورات CLI و عملیات فایل اضافه شده است.
  • استخراج دودویی اتمی : با باز کردن فایل‌های دودویی در یک دایرکتوری موقت قبل از انتقال اتمی آنها به محل مورد نظر، از ایجاد شرایط رقابتی استخراج در حین فراخوانی‌های همزمان چند فرآیندی CLI جلوگیری کنید.
  • پایداری ویندوز : بهبود سازگاری و عملکرد ویندوز در ویندوز ۱۱، در کنار اصلاحاتی برای وضوح مسیر دایرکتوری خانگی.

نسخه ۱.۰.۱۵۴۳۳۴۸۲ (مه ۲۰۲۶)

  • ادغام Antigravity : رابط خط فرمان اندروید و مهارت‌ها اکنون رسماً به عنوان یک بسته اختیاری از منابع در Google Antigravity 2.0 ادغام شده‌اند تا توسعه عامل‌محور شما را ساده‌تر کنند.
  • دستورات اندروید استودیو : از دستور جدید android studio استفاده کنید تا به عامل‌های خود اجازه دهید از قابلیت‌های عمیق و زمینه‌ای اندروید استودیو، از جمله تحلیل کد، جستجوی معنایی و رندرینگ Compose، بهره ببرند.
  • پشتیبانی از سفرها : با استفاده از سفرها، تجربیات حیاتی کاربر را اعتبارسنجی کنید، که توصیفاتی به زبان طبیعی از جریان‌های کاربری هستند که عوامل شما می‌توانند از ترمینال یا در CI/CD اجرا کنند.
  • مهارت‌های جدید اندروید : به کتابخانه مهارت‌های جدید اندروید ، از جمله مهارت‌های مربوط به مهاجرت CameraX، رابط کاربری تطبیقی، AppFunctions و سبک‌های نوشتن، دسترسی پیدا کنید.
  • گزینه‌های بیشتر نصب : با استفاده از ابزارهای مدیریت بسته محبوب، از جمله apt-get ، winget و homebrew ، رابط خط فرمان اندروید (Android CLI) را نصب و به‌روزرسانی کنید. برای جزئیات بیشتر، به گزینه‌های دانلود مراجعه کنید.

نسخه ۰.۷ (آوریل ۲۰۲۶)

اولین انتشار!