یادداشت‌های انتشار «استودیو Android» برای «پلاتفرم»

«استودیو Android برای پلاتفرم» (ASfP) محیط توسعه یکپارچه رسمی برای توسعه پلاتفرم Android است. این صفحه جدیدترین ویژگی‌ها، بهبودهای مختص پلاتفرم، و بهبودهای کیفی موجود در ASfP را خلاصه می‌کند.

ویژگی‌های پلاتفرم ۲۰۲۶ (Rabbit | 2026.2 و Panda 2 | 2025.3.2)

نسخه‌های اخیر ASfP که بر پایه پلاتفرم IntelliJ 2026.2 ساخته شده است، بهبودهای عمده‌ای در راه‌اندازی پروژه و قابلیت اطمینان راه‌اندازی، یکپارچه‌سازی ساخت Soong، قابلیت‌های عامل هوش مصنوعی، مدیریت دستگاه مجازی Cuttlefish، عیب‌یابی ترکیبی C،‏ C++‎، و Rust، و آزمایش پلاتفرم ارائه می‌دهد.

راه‌اندازی پروژه، الگوها، و عملکرد همگام‌سازی

• معماری پروژه Workspace Model: ساخت پروژه به میاناهای برنامه‌سازی کاربردی IntelliJ Workspace Model منتقل شده است که راه‌اندازی اولیه پروژه را ساده‌تر می‌کند و پایداری IDE را در درخت‌های منبع بزرگ AOSP بهبود می‌بخشد.
• راه‌اندازی فوری با عکس‌های آنی مدل پروژه: ASfP اکنون مدل پروژه شما را از عکس‌های آنی در راه‌اندازی ذخیره و بازیابی می‌کند، که تأخیرهای نمایه‌سازی اولیه زائد را هنگام باز کردن مجدد فضاهای کاری بزرگ AOSP حذف می‌کند.
• الگوهای پروژه قابل‌هم‌رسانی (وارد کردن و صادر کردن):
  • وارد کردن از الگو: با انتخاب کردن وارد کردن از الگو و اشاره کردن به فایل YAML مشترک .asfp-project، پروژه جدید AOSP را در دستیار راه‌اندازی راه‌اندازی کنید.
  • صادر کردن به الگو: پیکربندی پروژه‌تان را با هم‌تیمی‌ها هم‌رسانی کنید با کلیک راست کردن روی برگه ویرایشگر .asfp-project (یا از منو ASfP > پروژه) و انتخاب کردن صادر کردن به الگو.
• گزینه‌های دستیار راه‌اندازی بهبودیافته: متغیرهای محیطی ساخت سفارشی را پیکربندی کنید و کامپایل جزئی Soong (SOONG_PARTIAL_COMPILE) را مستقیماً درطول ایجاد پروژه فعال کنید.
• حالت‌های همگام‌سازی انعطاف‌پذیر:
  • همگام‌سازی جزئی: همگام‌سازی کردن ماژول‌ها یا دایرکتوری‌های خاص بدون اجرای همگام‌سازی کامل مخزن.
  • همگام‌سازی بدون ساخت: ساختار پروژه IDE و ریشه‌های ماژول را به‌سرعت و بدون راه‌اندازی ساخت Soong بازآوری کنید.
  • همگام‌سازی و ساخت کامل: راه‌اندازی همگام‌سازی ترکیبی پروژه و ساخت کامل Soong در یک کنش واحد.
• دامنه‌های جستجوی بهینه‌سازی‌شده و پشتیبانی از پیوند نمادین: محتوای داخل دایرکتوری out/ و IMLهای تولیدشده gen به‌طور خودکار از دامنه‌های جستجوی پروژه مستثنی می‌شوند تا جستجوی فایل و نماد سریع و بدون نویز باقی بماند. ‫ASfP همچنین از ریشه‌های منبع پیوند نمادین در مخازن AOSP پشتیبانی می‌کند.

هوش مصنوعی ویرایشگر، Android.bp ساخت، و استقرار در ویرایشگر

• نمادهای حاشیه ساختن، اجرا کردن، و اشکال‌زدایی در Android.bp: هر واحد نام‌گذاری‌شده در Android.bp شامل یک نماد حاشیه ساختن در کنار name: است، درحالی‌که واحدهای آزمایشی (*_test و *_test_host) و واحدهای android_app شامل یک نماد حاشیه اجرا کردن برای اجرا کردن یا اشکال‌زدایی اهداف مستقیماً از ویرایشگر هستند.
• پیکربندی‌های اجرای فلش و استقرار بافتی: پیکربندی‌های اجرای Soong Deploy را از هدف‌های قابل‌استقرار در فایل‌های Android.bp ایجاد و راه‌اندازی کنید، که از استقرار ازطریق adb، دستورگان‌های پوسته سفارشی، adevice، یا flashall با قلاب‌های ساخت Soong پیش‌اجرا پشتیبانی می‌کند.
• باز کردن فایل Android.bp مربوطه و هوش ویرایشگر: روی هر فایل یا دایرکتوری منبع کلیک راست کنید و باز کردن فایل Android.bp مربوطه را انتخاب کنید تا به اعلان ماژول آن بروید (زنجیره‌های defaults، الگوهای glob، و پیوندهای نمادین را حل می‌کند). در Android.bp، روی واحد یا srcs مرجع Ctrl+کلیک کنید، نکات راهنمای رونهاد N Usages کلیک‌کردنی را ببینید، و نشانگر را روی دارایی‌ها (ازجمله دارایی‌های target.*، arch.*، و multilib.* محدوده‌دار) نگه دارید تا مستندات درون‌خطی Soong را ببینید.
• پنجره ابزار اختصاصی Soong: همگام‌سازی Soong و پیشرفت ساخت را با نشانگرهای وضعیت تکلیف نظارت کنید، کنش‌های ساخت را راه‌اندازی کنید، و فرمان‌های Soong را از پنجره ابزار Soong اجرا کنید.

مدیریت دستگاه مجازی Cuttlefish و آینه‌سازی چندنمایی

• راه‌اندازی چنددستگاهی در «مدیر دستگاه»: بااستفاده از بررسی محلی AOSP، مستقیماً در مدیر دستگاه، تنظیمات دستگاه مجازی چنددستگاهی Cuttlefish را ایجاد و مدیریت کنید.
• قرینه‌سازی نمایشگر چندصفحه‌ای در پنجره ابزار Cuttlefish: از قرینه‌سازی نمایشگر چندصفحه‌ای Cuttlefish داخلی در پنجره ابزار اختصاصی Cuttlefish استفاده کنید—این پنجره برای توسعه سیستم عامل Android Automotive (AAOS) چندنمایشگری و توسعه خودروی نرم‌افزارمحور (SDV) ساخته شده است.

هوش مصنوعی در «استودیو Android» و «عامل داخلی» برای توسعه پلاتفرم

• عامل داخلی با ابزارهای ساخت و آزمایش Soong: هوش مصنوعی در «استودیو Android» ابزارهای اجرای atest و ساخت Soong ویژه پلاتفرم را در عامل داخلی ادغام می‌کند و به عامل امکان می‌دهد ویرایش‌های چندمرحله‌ای را برنامه‌ریزی کند، هدف‌های Soong را تدوین کند، و آزمایش‌های پلاتفرم atest را با نتایج ساختاری درون‌خطی اجرا کند.
• پشتیبانی از BYOM و Enterprise: بااستفاده از مدل‌های داخلی Gemini،‏ Gemini Code Assist، پروانه‌های Gemini Enterprise، یا با متصل کردن نقاط پایانی مدل سفارشی بااستفاده از مدل خودتان را بیاورید (BYOM) با کلیدهای میانای برنامه‌سازی کاربردی خودتان، به هوش مصنوعی در Android Studio دسترسی پیدا کنید.

اشکال‌زدایی پلاتفرم (زبانه «پیوست» در پنجره ابزار «اشکال‌زدایی» و LLDB)

• زبانه «پیوست سنجاق‌شده» (اجرا > پیوست به فرایند Android):
  • کتابخانه‌های مشترک بارگیری‌شده (کتابخانه‌ها)، شناسه ساخت، و نمادها: قبل‌از پیوست کردن، .so کتابخانه بارگیری‌شده و شناسه‌های ساخت هشت‌کاراکتری ELF را بازرسی کنید. ASfP هر شناسه ساخت را با out/target/product/<device>/symbols (نمایه symbols/.build-id) مطابقت می‌دهد، و درصورت تأیید، نماد علامت تیک را نمایش می‌دهد (نشانگر را روی ردیف تأییدشده نگه دارید تا مسیر .debug حل‌شده را مشاهده کنید) یا اگر نمادها وجود نداشته باشند، نماد هشدار را نمایش می‌دهد.
  • پیوست Java،‏ C++‎، و Rust: عیب‌یاب Java، عیب‌یاب بومی، یا هردو را انتخاب کنید تا برگه‌های عیب‌یابی <process> (<pid>) و <process> (<pid>)-jdwp پیوندشده باز شوند. انتخاب سرویس C++ یا Rust باعث پنهان شدن عیب‌یاب Java می‌شود و عیب‌یابی Java دردسترس نیست، فرایند Java نیست. نمایش داده می‌شود.
  • One-click Root Device and Enable JDWP (روت کردن دستگاه با یک کلیک و فعال کردن JDWP): با Show system processes (نمایش فرایندهای سیستم) فیلتر کنید، روی Root Device (روت کردن دستگاه) کلیک کنید تا adb root (Device is rooted (دستگاه روت شده است)) اجرا شود، یا روی Enable JDWP (فعال کردن JDWP) کلیک کنید تا persist.debug.dalvik.vm.jdwp.enabled=1 تنظیم شود و دستگاه‌های userdebug بازراه‌اندازی شوند.
• بهبودهای اشکال‌زدای LLDB، دیداری‌سازهای Rust، و گذردهی سیگنال ART:
  • جلسه‌های lldb-dap داخلی از نقاط شکست شرطی، نقاط شکست استثنای C++‎ و Rust، مقادیر متغیر درون‌خطی در ویرایشگر، Drop Frame،‏ Step Into هوشمند، و چاپگرهای زیبای Rust خودکار (String،‏ Vec،‏ HashMap،‏ Option) از پیش‌ساخته‌های AOSP پشتیبانی می‌کنند.
  • پیوست کردن LLDB به فرایندهای ART و JNI به‌طور خودکار از سیگنال‌های GC یا بررسی تهی SIGSEGV و SIGBUS ART داخلی بدون توقف‌های کاذب عبور می‌کند.
  • rust-analyzer به‌طور خودکار از prebuilts/rust-toolchain/linux-x86/stable/rust-analyzer (با بازگشت به prebuilts/rust/linux-x86/stable/rust-analyzer) شناسایی می‌شود، و اعلان‌های 'proc-macro' not found جعلی درباره فایل‌های out/soong/.intermediates تولیدشده سرکوب می‌شوند.

آزمایش پلاتفرم و اشکال‌زدایی cc_test و rust_test

• اشکال‌زدایی هدف‌های android_test، cc_test، و rust_test: راه‌اندازی جلسه‌های اشکال‌زدایی از Android.bp یا نمادهای حاشیه روش آزمایش:
  • android_test ماژول‌ها بااستفاده از atest --wait-for-debugger راه‌اندازی می‌شوند و اشکال‌زدای جاوا را پیوست می‌کنند.
  • cc_test، cc_test_host، rust_test، و rust_test_host ماژول مستقیماً تحت LLDB داخلی بااستفاده از ساخت ماژول آزمایش بومی و استقرار با atest (atest --collect-tests-only --disable-teardown) کارهای پیش‌از راه‌اندازی راه‌اندازی می‌شوند.
• الگوهای LLDB دو هدفه host_supported: true و برای هر دستگاه: برای مدول‌های cc_test و rust_test با host_supported: true، هر دو دکمه رادیویی اجرا در: دستگاه و میزبان در پیکربندی‌های Soong Test با کارت‌های تنظیمات LLDB مستقل برای هر هدف، آرگومان‌های برنامه، آرگومان‌های atest، و راه‌اندازی JSON (تنظیمات DAP) فعال هستند.

به‌روزرسانی‌های درون IDE و کیفیت پلاتفرم

• اعلان‌های به‌روزرسانی خودکار در IDE: از ASfP 2026.2.2 Canary 1 شروع می‌شود، ASfP به‌طور خودکار نسخه‌های جدید را در پس‌زمینه بررسی می‌کند و ازطریق کادر گفتگوی به‌روزرسانی‌های Android Studio و افزایه در IDE به شما اطلاع می‌دهد، همراه با دکمه بارگیری برای جدیدترین بسته .deb و دستورالعمل‌های نصب ترمینال. هرزمان خواستید بااستفاده از راهنما > بررسی به‌روزرسانی‌ها، به‌روزرسانی‌ها را بررسی کنید.
• پیوندهای کانال -current-linux.deb پایدار: برای اسکریپت‌های خودکار و راه‌اندازی‌های خط فرمان، جدیدترین بسته‌های «پایدار» و Canary در نشانی‌های وب پایدار دردسترس هستند: https://dl.google.com/android/asfp/asfp-current-linux.deb (پایدار) و https://dl.google.com/android/asfp/asfp-canary-current-linux.deb (Canary).
• تشخیص عدم تطابق نسخه روی دیسک: ASfP تشخیص می‌دهد که نصب .deb زیربنایی روی دیسک درحین اجرای IDE به‌روز شده است و با اعلانی از شما می‌خواهد که به‌طور کامل بازراه‌اندازی کنید.
• بازرسی‌های پیش‌فرض حق نشر AOSP و تعهد: شامل نمایه سرصفحه حق نشر پیش‌فرض AOSP ازپیش پیکربندی‌شده و بازرسی‌های قالب‌بندی پیام تعهد است که برای همیاری‌های پلاتفرم سفارشی‌سازی شده است.
• افزایش تخصیص حافظه پیش‌فرض: حداکثر اندازه پیش‌فرض پشته از ۲۰ گیگابایت به ۳۰ گیگابایت افزایش یافته است تا از درخت‌های منبع بزرگ AOSP پشتیبانی شود.