این صفحه ویژگی های جدید معرفی شده در نسخه های پیش نمایش اندروید استودیو را فهرست می کند. ساختهای پیشنمایش دسترسی زودهنگام به جدیدترین ویژگیها و بهبودهای Android Studio را فراهم میکنند. می توانید این نسخه های پیش نمایش را دانلود کنید . اگر در استفاده از نسخه پیشنمایش Android Studio با مشکلی مواجه شدید، به ما اطلاع دهید . گزارش های باگ شما به بهتر شدن Android Studio کمک می کند.
نسخههای قناری حاوی ویژگیهای پیشرو در حال توسعه هستند و به آرامی آزمایش میشوند. در حالی که میتوانید از ساختهای Canary برای توسعه استفاده کنید، توجه داشته باشید که ممکن است ویژگیها اضافه یا تغییر کنند. Release Candidates (RC) نسخه بعدی اندروید استودیو هستند و تقریباً برای انتشار پایدار آماده هستند. مجموعه ویژگی برای نسخه بعدی تثبیت شده است. برای درک نامگذاری نسخه اندروید استودیو، اسامی نسخههای Android Studio را ببینید.
برای آخرین اخبار در مورد نسخههای پیشنمایش Android Studio، از جمله فهرستی از اصلاحات قابلتوجه در هر نسخه پیشنمایش، بهروزرسانیهای انتشار در وبلاگ Android Studio را ببینید.
نسخه های فعلی اندروید استودیو
جدول زیر نسخههای فعلی Android Studio و کانالهای مربوطه را فهرست میکند.
نسخه | کانال |
---|---|
اندروید استودیو Narwhal 3 Feature Drop | 2025.1.3 | پایدار |
پلاگین اندروید Gradle 8.13.0 | پایدار |
اندروید استودیو Narwhal 4 Feature Drop | 2025.1.4 | قناری |
سازگاری با پیش نمایش پلاگین Android Gradle
هر نسخه پیش نمایش اندروید استودیو در کنار نسخه مربوط به پلاگین Android Gradle (AGP) منتشر می شود. نسخه های پیش نمایش Studio باید با هر نسخه پایدار سازگار AGP کار کنند. با این حال، اگر از نسخه پیشنمایش AGP استفاده میکنید، باید از نسخه پیشنمایش مربوطه استودیو استفاده کنید (به عنوان مثال، Android Studio Chipmunk Canary 7 با AGP 7.2.0-alpha07). تلاش برای استفاده از نسخههای متفاوت (مثلاً Android Studio Chipmunk Beta 1 با AGP 7.2.0-alpha07) باعث خرابی همگامسازی میشود که منجر به درخواست برای بهروزرسانی به نسخه مربوطه AGP میشود.
برای گزارش دقیق از حذف و حذف API افزونه Android Gradle، بهروزرسانیهای API پلاگین Android Gradle را ببینید.
آزمایشگاه های استودیو
Studio Labs به شما امکان میدهد جدیدترین ویژگیهای آزمایشی هوش مصنوعی را در نسخه پایدار Android Studio امتحان کنید، بنابراین میتوانید سریعتر پیشنهادات کمک هوش مصنوعی ما را در گردش کار توسعه خود ادغام کنید. برای اطلاعات بیشتر، آزمایشگاههای استودیو را ببینید.
موارد زیر ویژگی هایی هستند که در حال حاضر در Studio Labs موجود هستند.
ویژگی | توضیحات | اسناد |
---|---|---|
نوشتن پیش نمایش تولید | Gemini میتواند بهطور خودکار پیشنمایشهای Compose، از جمله دادههای ساختگی برای پارامترهای پیشنمایش، برای یک composable خاص یا همه فایلهای composable در یک فایل را تولید کند. | ایجاد پیش نمایش نوشتن |
تغییر رابط کاربری | از زبان طبیعی برای بهروزرسانی رابط کاربری برنامه خود مستقیماً از پانل پیشنمایش «نوشتن» استفاده کنید. | تغییر رابط کاربری |
اندروید استودیو Narwhal 4 Feature Drop | 2025.1.4
موارد زیر ویژگی های جدید اندروید استودیو Narwhal 4 Feature Drop | 2025.1.4.
برای اینکه ببینید چه چیزی در این نسخه از اندروید استودیو رفع شده است، به مسائل بسته مراجعه کنید.
Journeys for Android Studio
Journeys for Android Studio با استفاده از زبان طبیعی برای توصیف مراحل و ادعاهای هر آزمون - که سفر نامیده میشود - به شما کمک میکند تا تستهای سرتاسر را برای نوشتن و نگهداری آسان کنید. با استفاده از قابلیتهای بینایی و استدلال Gemini، مراحل نوشته شده به زبان طبیعی به اقداماتی تبدیل میشوند که Gemini در برنامه شما انجام میدهد و نوشتن و درک سفرهای شما را آسان میکند. بهعلاوه، میتوانید ادعاهای پیچیدهتری را بنویسید و توصیف کنید، که Gemini آنها را بر اساس آنچه در دستگاه میبیند ارزیابی میکند تا تشخیص دهد که آیا سفر شما انجام میشود یا ناموفق.
و از آنجایی که Gemini در مورد اقداماتی که باید برای برآورده کردن اهداف انجام شود، توضیح میدهد، سفرها در برابر تغییرات ظریف در چیدمان یا رفتار برنامه شما انعطافپذیرتر هستند و در نتیجه هنگام اجرای نسخههای مختلف برنامه و پیکربندیهای مختلف دستگاه، تستهای پوستهپوسته کمتری انجام میشود.
سفرها را مستقیماً از Android Studio در برابر هر دستگاه Android محلی یا راه دور بنویسید و اجرا کنید. IDE یک تجربه ویرایشگر جدید برای ساخت سفرها و همچنین نتایج غنی ارائه می دهد که به شما کمک می کند استدلال Gemini و اجرای سفر خود را بهتر دنبال کنید.
پشتیبان گیری و همگام سازی

اکنون میتوانید با استفاده از حساب Google یا JetBrains از تنظیمات Android Studio در فضای ذخیرهسازی ابری پشتیبانگیری کنید. این به همگام سازی تنظیمات شما مانند نقشه های کلید، تنظیمات ویرایشگر کد، تنظیمات سیستم و موارد دیگر کمک می کند. برای شروع، یکی از موارد زیر را انجام دهید:
پس از باز کردن یک پروژه در Android Studio، با کلیک کردن روی آواتار در گوشه سمت راست بالای IDE و کلیک کردن روی Sign in وارد حساب Google خود شوید.
- فرمانهای موجود در گفتگوی ظاهر شده را دنبال کنید و مطمئن شوید که کادر مجوز Android Studio برای دسترسی به فضای ذخیرهسازی حساب Google شما را علامت بزنید.
- برای تأیید مجوز Android Studio، دستورالعملها را دنبال کنید.
به Settings > Backup and Sync بروید.
- Google را انتخاب کنید تا از فضای ذخیرهسازی حساب Google خود برای همگامسازی دادههای برنامهتان در سراسر نصبهای Android Studio استفاده کند. از طرف دیگر، میتوانید از یک حساب JetBrains برای همگامسازی دادههای برنامه خود در بین نصبهای IntelliJ و Android Studio استفاده کنید.
- پس از پیروی از فرمانها برای اجازه دادن به Android Studio برای دسترسی به فضای ذخیرهسازی حساب دلخواه خود، به Android Studio بازگردید.
- در صفحه تنظیمات > پشتیبانگیری و همگامسازی ، میتوانید دستههایی از دادههای برنامه را که میخواهید با حساب خود همگامسازی کنید، مرور کنید.
- برای غیرفعال کردن پشتیبانگیری و همگامسازی، علامت کادری را که این ویژگی را فعال میکند بردارید.
اگر قبلاً دادهها را با دستگاه انتخابی خود همگامسازی کردهاید، Android Studio به شما این امکان را میدهد که یا تنظیمات را از حافظه راه دور خود دانلود کنید (این گزینه پیشفرض است) یا تنظیمات محلی خود را آپلود کنید و تنظیمات همگامسازی شده را در حافظه راه دور خود بازنویسی کنید.
راه حل های پیشنهادی برای خرابی ها
در Android Studio Meerkat Feature Drop، اطلاعات Gemini را برای خرابیهای گزارششده در پنجره ابزار App Quality Insights راهاندازی کردیم. اکنون، اندروید استودیو میتواند از Gemini برای تجزیه و تحلیل دادههای خرابی همراه با کد منبع شما برای پیشنهاد رفعهای احتمالی استفاده کند. پس از انتخاب یک خرابی در پنجره ابزار App Quality Insights، به برگه Insights بروید و پس از اینکه Gemini یک بینش برای خرابی ایجاد کرد، بر روی Suggest a fix کلیک کنید. سپس Gemini تغییرات کد پیشنهادی را ایجاد میکند که میتوانید آنها را در یک تب تفاوت ویرایشگر بررسی و قبول کنید.

تنظیم جدید برای باز کردن پروژه های جدید با نمای پروژه
یک تنظیم جدید برای باز کردن پروژه های جدید در نمای پروژه به طور پیش فرض وجود دارد. برای فعال کردن این تنظیمات به File ( Android Studio در macOS) > Settings > Advanced Settings > Project View بروید و Set Project view را به عنوان پیش فرض انتخاب کنید.
ابزار تست پیشنمایش عکس صفحه نگارش
از ابزار Compose Preview Screenshot Testing برای آزمایش UI های Compose خود و جلوگیری از رگرسیون استفاده کنید. ابزار جدید به شما کمک می کند تا گزارش های HTML ایجاد کنید که به شما امکان می دهد هر گونه تغییر در رابط کاربری برنامه خود را به صورت بصری تشخیص دهید. در نوشتن تست پیشنمایش عکس صفحه بیشتر بیاموزید.
بهبود درخت مؤلفه Inspector Layout جاسازی شده
تعامل با درخت مؤلفه در Embedded Layout Inspector به لطف چندین پیشرفت کلیدی اکنون بصری تر و کارآمدتر شده است. این بهروزرسانیها برای سادهسازی گردش کار شما و ارائه بینش واضحتر در مورد ساختارهای Compose UI شما طراحی شدهاند.
- پیمایش افقی : اکنون میتوانید به صورت افقی در درخت مؤلفه پیمایش کنید، که پیمایش و بازرسی طرحبندیهای گسترده یا عمیق تو در تو را بدون از دست دادن زمینه آسانتر میکند.
- پیمایش خودکار در انتخاب : انتخاب یک مورد در درخت مؤلفه اکنون به صورت خودکار نمای افقی و عمودی را اسکرول می کند تا مورد انتخابی به طور منظم در فوکوس قرار گیرد. این تضمین می کند که عنصری که به آن علاقه دارید همیشه جلو و مرکز باشد.
- بصری سازی روابط بهبود یافته : ما خطوط پشتیبانی را در درخت مؤلفه اصلاح کرده ایم تا نشانه های بصری واضح تری برای درک روابط گره ارائه دهیم. خطوط نقطهدار اکنون به وضوح یک رابطه پشته تماس بین والد و گره فرزندش را نشان میدهند و به شما کمک میکنند تا ارتباطات برنامهای را به طور مؤثرتری ردیابی کنید. خطوط جامد همچنان همه روابط استاندارد والد-فرزند را در درخت نشان می دهند.
هدف این پیشرفتها ارائه یک تجربه اشکالزدایی روانتر و کارآمدتر است که به شما امکان میدهد تا به سرعت رابط کاربری خود را درک و اصلاح کنید.

از یک LLM محلی استفاده کنید
Android Studio Narwhal 4 Feature Drop به شما امکان می دهد LLM را انتخاب کنید که ویژگی های هوش مصنوعی IDE را تقویت می کند.

LLM باید روی دستگاه محلی شما باشد، که اگر اتصال اینترنت محدود یا محدودیتهایی در مورد استفاده از مدلهای هوش مصنوعی دارید، یا فقط میخواهید با مدلهای تحقیق منبع باز آزمایش کنید، سودمند است.
یک LLM محلی جایگزینی برای پشتیبانی LLM ساخته شده در Android Studio ارائه می دهد. با این حال، Gemini در اندروید استودیو به طور معمول بهترین تجربه توسعه اندروید را ارائه می دهد زیرا Gemini برای اندروید تنظیم شده است و از تمام ویژگی های Android Studio پشتیبانی می کند. با Gemini، میتوانید مدلهای مختلفی را برای وظایف توسعه اندروید خود انتخاب کنید، از جمله مدل پیشفرض بدون هزینه یا مدلهایی که با یک کلید API پولی Gemini دسترسی دارید.
پشتیبانی از LLM های محلی مستلزم نصب یک ارائه دهنده LLM مانند LM Studio یا Olama بر روی رایانه محلی شما به همراه یک مدل سازگار با انتخاب شما است.
Android SDK Upgrade Assistant اکنون از Android 16 / API 36 پشتیبانی می کند
انتقال از Android 15 / API 35 به Android 16 / API 36 به Android SDK Upgrade Assistant اضافه شده است. برای دریافت کمک برای مهاجرت، به Tools > Android SDK Upgrade Assistant بروید.
پلاگین اندروید Gradle 9.0
پلاگین Android Gradle 9.0 نسخه اصلی جدید AGP است و تغییرات API و رفتار را به همراه دارد.
برای به روز رسانی به پلاگین اندروید Gradle 9.0.0-alpha02 از افزونه Android Gradle Upgrade Assistant در اندروید استودیو Narwhal 4 Feature Drop | 2025.1.4.
دستیار ارتقاء AGP به حفظ رفتارهای موجود هنگام ارتقاء پروژه در صورت لزوم کمک می کند و به شما امکان می دهد پروژه خود را برای استفاده از AGP 9.0 ارتقا دهید، حتی اگر آماده پذیرش همه پیش فرض های جدید در AGP 9.0 نباشید.
سازگاری
حداکثر سطح API Android که افزونه Android Gradle 9.0.0-alpha02 پشتیبانی می کند، سطح API 36 است.
افزونه Android Gradle 9.0.0-alpha02 به Gradle 9.0.0 نیاز دارد.
تغییر رفتار
پلاگین Android Gradle 9.0 دارای رفتارهای جدید زیر است:
رفتار | توصیه |
---|---|
افزونه اندروید Gradle 9.0 به طور پیش فرض از NDK نسخه r28c استفاده می کند. | در نظر بگیرید که نسخه NDK را که می خواهید به طور صریح استفاده کنید، مشخص کنید. |
افزونه Android Gradle 9.0 به طور پیشفرض از مصرفکنندگان یک کتابخانه میخواهد از نسخه SDK کامپایل یکسان یا بالاتر استفاده کنند. | هنگام استفاده از کتابخانه از SDK کامپایل یکسان یا بالاتر استفاده کنید. اگر این امکان پذیر نیست، یا می خواهید به مصرف کنندگان کتابخانه ای که منتشر می کنید زمان بیشتری برای جابجایی بدهید، AarMetadata.minCompileSdk به صراحت تنظیم کنید. |
AGP 9.0 شامل بهروزرسانیهای پیشفرض ویژگیهای Gradle زیر است. این به شما این امکان را می دهد که رفتار AGP 8.13 را هنگام ارتقاء حفظ کنید:
اموال | تابع | از AGP 8.13 به AGP 9.0 تغییر دهید | توصیه |
---|---|---|---|
android.uniquePackageNames | الزام می کند که هر کتابخانه یک نام بسته مجزا داشته باشد. | false → true | نام بسته های منحصر به فرد را برای تمام کتابخانه های پروژه خود مشخص کنید. اگر این امکان پذیر نیست، می توانید این پرچم را در حین مهاجرت غیرفعال کنید. |
android.dependency.useConstraints | استفاده از محدودیت های وابستگی بین پیکربندی ها را کنترل می کند. پیشفرض در AGP 9.0 false است که فقط از محدودیتها در آزمایشهای دستگاه برنامه (AndroidTest) استفاده میکند. با تنظیم این مورد روی true به رفتار 8.13 برمی گردد. | true → false | از محدودیت های وابستگی در همه جا استفاده نکنید مگر اینکه به آنها نیاز داشته باشید. پذیرش پیشفرض جدید این پرچم، بهینهسازیهایی را در فرآیند واردات پروژه امکانپذیر میکند که باید زمان واردات را برای ساختها با بسیاری از زیرپروژههای کتابخانه اندروید کاهش دهد. |
aandroid.enableAppCompileTimeRClass | کامپایل کد در برنامه ها در برابر کلاس R غیر نهایی، کامپایل برنامه ها را با کامپایل کتابخانه ای هماهنگ می کند. این افزایش افزایشی را بهبود می بخشد و راه را برای بهینه سازی عملکرد آینده در جریان پردازش منابع هموار می کند. | false → true | بسیاری از پروژه ها فقط می توانند رفتار جدید را بدون تغییر منبع اتخاذ کنند. اگر از فیلدهای کلاس R در هر جایی که نیاز به ثابت وجود دارد استفاده شود، مانند موارد سوئیچ، Refactor برای استفاده از دستورهای زنجیره ای if. |
android.sdk.defaultTargetSdkToCompileSdkIfUnset | از نسخه SDK کامپایل به عنوان مقدار پیشفرض نسخه SDK هدف در برنامهها و آزمایشها استفاده میکند. قبل از این تغییر، نسخه SDK هدف به طور پیش فرض روی نسخه حداقل SDK خواهد بود. | false → true | نسخه SDK مورد نظر را به صراحت برای برنامه ها و آزمایش ها مشخص کنید. |
android.onlyEnableUnitTestForTheTestedBuildType | فقط اجزای تست واحد را برای نوع ساخت آزمایش شده ایجاد می کند. در پروژه پیشفرض این منجر به یک تست واحد برای اشکالزدایی میشود، که در آن رفتار قبلی اجرای آزمایشهای واحد برای رفع اشکال یا انتشار بود. | false → true | اگر پروژه شما برای اجرای هر دو اشکال زدایی و انتشار به آزمایش نیاز ندارد، هیچ تغییری لازم نیست. |
android.proguard.failOnMissingFiles | اگر هر یک از فایل های نگهداری مشخص شده در AGP DSL روی دیسک وجود نداشته باشد، ساخت با خطا انجام می شود. قبل از این تغییر، اشتباهات تایپی در نام فایل ها منجر به نادیده گرفتن فایل ها می شود. | false → true | هر گونه اعلامیه نامعتبر فایل های محافظ را حذف کنید |
android.r8.optimizedResourceShrinking | به R8 اجازه می دهد تا با در نظر گرفتن کلاس ها و منابع Android با هم، منابع Android کمتری را حفظ کند. | false → true | اگر قوانین حفظ پروژه شما از قبل کامل شده است، نیازی به تغییر نیست. |
android.r8.strictFullModeForKeepRules | به R8 اجازه میدهد با حفظ نکردن سازنده پیشفرض در هنگام نگهداشتن یک کلاس، مقدار کمتری را حفظ کند. یعنی -keep class A دیگر به معنی -keep class A { <init>(); } | false → true | اگر قوانین حفظ پروژه شما از قبل کامل شده است، نیازی به تغییر نیست.-keep class A با -keep class A { <init>(); } در قوانین keep پروژه شما برای هر موردی که نیاز به نگه داشتن سازنده پیش فرض دارید. |
android.defaults.buildfeatures.shaders | کامپایل سایه زن را در همه پروژه های فرعی فعال می کند | true → false | با تنظیم موارد زیر در فایلهای ساخت Gradle پروژهها، کامپایل سایهزن را فقط در زیر پروژههایی فعال کنید که حاوی سایهزنها هستند: android { buildFeatures { shaders = true } } |
ویژگی های حذف شده
پلاگین Android Gradle 9.0 عملکرد زیر را حذف می کند:
- پشتیبانی از اپلیکیشن Wear OS جاسازی شده
AGP 9.0 پشتیبانی از جاسازی برنامههای Wear OS را که دیگر در Play پشتیبانی نمیشوند، حذف میکند. این شامل حذف پیکربندیهایwearApp
وAndroidSourceSet.wearAppConfigurationName
DSL میشود. برای نحوه انتشار برنامه خود در Wear OS به توزیع در Wear OS مراجعه کنید.
DSL تغییر کرد
پلاگین Android Gradle 9.0 دارای تغییرات شکسته DSL زیر است:
- پارامترسازی
CommonExtension
حذف شده است. به خودی خود، این فقط یک تغییر شکستن سطح منبع برای کمک به جلوگیری از تغییرات شکستن سطح منبع در آینده است، اما همچنین به این معنی است که روشهای بلوک DSL باید ازCommonExtension
بهApplicationExtension
،LibraryExension
،DynamicFeatureExtension
وTestExtension
منتقل شوند.
DSL حذف شد
پلاگین Android Gradle 9.0 حذف می کند:
AndroidSourceSet.jni
، زیرا کاربردی نبود.AndroidSourceSet.wearAppConfigurationName
، زیرا مربوط به پشتیبانی از برنامه Wear OS جاسازی شده حذف شده است.BuildType.isRenderscriptDebuggable
، زیرا کاربردی نبود.ComponentBuilder.enabled
ComponentBuilder.enable
جایگزین آن شده است.Installation.installOptions(String)
. با ویژگی تغییرپذیرInstallation.installOptions
جایگزین شده است.VariantBuilder.targetSdk
وtargetSdkPreview
، زیرا در کتابخانه ها معنی نداشتند. به جای آن ازGeneratesApkBuilder.targetSdk
یاGeneratesApkBuilder.targetSdkPreview
استفاده کنید.بلوک
PostProcessing
آزمایشی، اما هرگز تثبیت نشده است.ProductFlavor.setDimension
که با ویژگیdimension
جایگزین می شودVariant.unitTest
، زیرا برای افزونهcom.android.test
قابل اجرا نبود.unitTest
در زیرگروه هایVariantBuilder
کهHasUnitTest
گسترش می دهد در دسترس است.VariantBuilder.enableUnitTest
، زیرا برای افزونهcom.android.test
قابل اجرا نبود.enableUnitTest
در زیرگروه هایVariantBuilder
کهHasUnitTestBuilder
گسترش می دهد در دسترس است.VariantBuilder.unitTestEnabled
به نفع نام مستمرenableUnitTest
در زیرگروههایVariantBuilder
کهHasUnitTestBuilder
گسترش میدهند، حذف میشود.
ویژگی های Gradle حذف شد
ویژگیهای Gradle زیر ابتدا بهعنوان راههایی برای غیرفعال کردن ویژگیهایی که بهطور پیشفرض فعال شده بودند، اضافه شدند.
این ویژگیها بهطور پیشفرض از نسخه AGP 8.0 یا پایینتر غیرفعال شدهاند. این ویژگیها را فقط در پروژههای فرعی فعال کنید که از آنها برای ساخت کارآمدتر استفاده میکنند.
اموال | تابع | جایگزینی |
---|---|---|
android.defaults.buildfeatures.aidl | تدوین AIDL را در همه پروژه های فرعی فعال می کند | با تنظیم ویژگی زیر در فایل های ساخت Gradle پروژه ها، کامپایل AIDL را فقط در زیر پروژه هایی که منابع AIDL وجود دارد، فعال کنید:android { buildFeatures { aidl = true } } |
android.defaults.buildfeatures.renderscript | کامپایل RenderScript را در همه پروژه های فرعی فعال می کند | کامپایل رندر اسکریپت را فقط در پروژه های فرعی که منابع رندر اسکریپت در آن ها وجود دارد با تنظیم ویژگی زیر در فایل های ساخت Gradle آن پروژه ها فعال کنید: android { buildFeatures { renderScript = true } } |
API های حذف شده
پلاگین Android Gradle 9.0 حذف می کند:
- APIهای
BaseExtension.registerTransform
منسوخ و غیرفعال شده، که فقط اجازه کامپایل در برابر آخرین نسخه AGP را می دهد، در حالی که در AGP 4.2 یا پایین تر اجرا می شود.
ویژگی های Gradle اجباری
اگر ویژگی های Gradle زیر را تنظیم کنید AGP 9.0 خطا می دهد.
افزونه Android Gradle بهروزرسانی دستیار پروژههایی را که از این ویژگیها استفاده میکنند به AGP 9.0 ارتقا نمیدهد.
اموال | تابع |
---|---|
android.r8.integratedResourceShrinking | اکنون کوچک شدن منابع همیشه به عنوان بخشی از R8 اجرا می شود، پیاده سازی قبلی حذف شده است. |