با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پلاگین Android Gradle (AGP) یک سیستم ساخت پشتیبانی شده برای برنامه های اندروید است و شامل پشتیبانی از کامپایل انواع مختلف منابع و پیوند آنها به یکدیگر به یک برنامه است که می توانید آن را بر روی یک دستگاه اندروید فیزیکی یا شبیه ساز اجرا کنید.
بخش زیر تکامل برنامه ریزی شده DSL و API AGP را شرح می دهد. با معرفی API های جدید در نسخه های پایدار، API های قدیمی به عنوان منسوخ علامت گذاری می شوند. آن APIهای منسوخ شده در نسخه پایدار بعدی از دسترس خارج می شوند. در زیر اطلاعاتی در مورد تغییرات آتی در هر نسخه اصلی AGP خواهید یافت.
رابط‌ها و کلاس‌های قبلی مورد استفاده در Variant API قدیمی اکنون منسوخ شده‌اند.
رابط های DSL جدید پایدار هستند، رابط های قدیمی منسوخ شده اند
رابط‌های DSL که در نسخه‌های 4.1، 4.2 و 7.0 در حال رشد بودند، اکنون پایدار هستند.
همه این رابط ها در آرتیفکت gradle-api قرار دارند.
رابط ها و کلاس های قبلی که در DSL استفاده می شد اکنون منسوخ شده اند.
کلاس های داخلی خصوصی AGP هنوز در دسترس هستند
کلاس‌های داخلی خصوصی از AGP، واقع در دیگر مصنوعات، هنوز در حین کامپایل کردن فایل‌های ساخت قابل دسترسی هستند، اما استفاده از آنها توصیه نمی‌شود ، زیرا ممکن است در هر زمان به روش‌های شکسته تغییر کنند.
AGP 10.0 (2026)
API های قدیمی حذف می شوند
تمام رابط‌ها و کلاس‌های قبلی مورد استفاده در DSL و Variant API قدیمی حذف می‌شوند.
آرتیفکت gradle-api تنها آرتیفکتی است که برای دسترسی به رابط‌ها و کلاس‌های DSL و انواع API نیاز دارید و باید هنگام توسعه افزونه‌ها از آن استفاده کنید.
با استفاده از ابرداده Gradle، که نمودارهای وابستگی متفاوتی را برای کامپایل و زمان اجرا ارائه می‌دهد، تنها آرتیفکت gradle-api در طول کامپایل کردن فایل‌های ساخت در دسترس است.
(آزمایشی) دسترسی به کلاس های خصوصی داخلی AGP حذف شده است
وابستگی به مصنوع gradle اکنون تمام کلاس های داخلی را پنهان می کند و دسترسی کامپایل را فقط به رابط ها و کلاس های موجود در آرتیفکت gradle-api می دهد. این هم بر کامپایل فایل پلاگین و هم بر روی بیلد تأثیر می گذارد.
برای دسترسی به کلاس های داخلی نمی توان به صورت دستی یک وابستگی اضافه کرد.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Android Gradle Plugin DSL/API migration timeline\n\nThe Android Gradle Plugin (AGP) is the supported build system for Android\napplications and includes support for compiling many different types of sources\nand linking them together into an application that you can run on a physical\nAndroid device or an emulator.\n\nThe following section describes the planned evolution of the AGP's DSL and API.\nAs new APIs are introduced in stable releases, old APIs will be marked as\ndeprecated. Those deprecated APIs will then become unavailable in the next\nstable release. Below you will find information about upcoming changes in each\nmajor AGP release.\n\nFor a more detailed log of AGP API deprecations or removals, see the [AGP API\nupdates](/studio/releases/gradle-plugin-api-updates).\n| **Note:** The timeframes mentioned below are estimates and are subject to change.\n\nAGP 9.0 (Second half of 2025)\n-----------------------------\n\n**New Variant APIs are stable, old APIs are deprecated**\n\n- The [Variant APIs](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1 and 4.2 are stable.\n- All of these interfaces are located in the [`gradle-api`](https://maven.google.com/web/index.html#com.android.tools.build:gradle-api) artifact.\n- The previous interfaces and classes used in the old Variant API are now deprecated.\n\n**New DSL interfaces are stable, old ones are deprecated**\n\n- The [DSL interfaces](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1, 4.2 and 7.0 are now stable.\n- All of these interfaces are located in the `gradle-api` artifact.\n- The previous interfaces and classes used in the DSL are now deprecated.\n\n**Private internal AGP classes still accessible**\n\nPrivate internal classes from AGP, located in other artifacts, are still\naccessible during compilation of build files, but it is **not** recommended\nto use them as they may change in breaking ways at any time.\n\nAGP 10.0 (2026)\n---------------\n\n**Old APIs are removed**\n\n- All previous interfaces and classes used in the DSL and the old Variant API are **deleted**.\n- The `gradle-api` artifact is the only artifact you need to access DSL and variant API interfaces and classes, and should be used when developing plugins.\n- Using Gradle metadata, which offers different dependency graphs for compile and runtime, only `gradle-api` artifact is available during compilation of build files.\n\n**(Tentative) Access to private internal AGP classes is removed**\n\nDependency on the\n[`gradle`](https://maven.google.com/web/index.html#com.android.tools.build:gradle)\nartifact now hides all internal classes and gives compilation access only to the\ninterfaces and classes available in the `gradle-api` artifact. This impacts both\nplugin and build file compilation.\n\nIt isn't possible to manually add a dependency to get access to the internal\nclasses.\n| **Important:** We would like your feedback on the removal of internal AGP classes. Please let us know about your use case, including specific examples of what you need access to, by submitting your feedback on this [tracking issue](https://issuetracker.google.com/219002669)."]]
