پلاگین Android Gradle 7.2.0 (مه 2022)

پلاگین Android Gradle 7.2.0 یک نسخه اصلی است که شامل انواع ویژگی ها و بهبودهای جدید است.

7.2.2 (اوت 2022)

این به‌روزرسانی جزئی مربوط به انتشار Patch 2 Android Studio Chipmunk است و شامل رفع اشکال زیر است:

  • شماره 232438924 : AndroidGradlePlugin نسخه 7.2 با استفاده از ASM API API را تغییر می‌دهد.
  • شماره 231037948 : AGP 7.2.0-rc01 :buildSrc:generatePrecompiledScriptPluginAccessors - shadow/bundletool/com/android/prefs/AndroidLocation$AndroidLocationException
7.2.1 (مه 2022)

این به‌روزرسانی جزئی مربوط به انتشار Patch 1 Android Studio Chipmunk است و شامل رفع اشکال زیر است:

  • شماره 230361284 : bundletool پروفایل های خط پایه را به درستی بسته بندی نمی کند

برای مشاهده سایر رفع اشکال‌های موجود در این نسخه، به یادداشت‌های انتشار Android Studio Chipmunk Patch 1 مراجعه کنید.

سازگاری

حداقل نسخه نسخه پیش فرض یادداشت ها
گریدل 7.3.3 7.3.3 برای کسب اطلاعات بیشتر، به روز رسانی Gradle را ببینید.
ابزارهای ساخت SDK 30.0.3 30.0.3 ابزارهای ساخت SDK را نصب یا پیکربندی کنید .
NDK N/A 21.4.7075529 نسخه دیگری از NDK را نصب یا پیکربندی کنید .
JDK 11 11 برای کسب اطلاعات بیشتر، به تنظیم نسخه JDK مراجعه کنید.

هشدار Jetifier و بررسی در Build Analyzer

اگر فایل gradle.properties پروژه شما شامل android.enableJetifier=true باشد، اکنون Build Analyzer یک هشدار نمایش می دهد. این پرچم در نسخه قبلی اندروید استودیو برای فعال کردن AndroidX برای کتابخانه‌هایی که به صورت بومی AndroidX را پشتیبانی نمی‌کنند، معرفی شد. با این حال، اکوسیستم کتابخانه بیشتر به سمت پشتیبانی از AndroidX به صورت بومی حرکت کرده است و احتمالاً دیگر پروژه شما به پرچم Jetifier نیازی ندارد. علاوه بر این، پرچم می تواند به عملکرد ساخت کندتر منجر شود. اگر این اخطار را مشاهده کردید، می توانید یک بررسی در Build Analyzer انجام دهید تا تأیید کنید که آیا پرچم می تواند حذف شود.

پشتیبانی از تجهیزات تست

با شروع اندروید استودیو Chipmunk Beta 1، اندروید استودیو از هر دو نسخه آزمایشی اندروید و جاوا پشتیبانی می کند. برای اطلاعات بیشتر در مورد ویژگی تجهیزات تست و نحوه استفاده از آن در پروژه جاوا، راهنمای Gradle در مورد استفاده از تجهیزات تست {:.external} را ببینید.

برای فعال کردن فیکسچرهای آزمایشی در ماژول کتابخانه Android خود، موارد زیر را به فایل build.gradle در سطح کتابخانه خود اضافه کنید:

android {
  testFixtures {
    enable true
    // enable testFixtures's android resources (disabled by default)
    // androidResources true
  }
}

به‌طور پیش‌فرض، انتشار کتابخانه شما، تجهیزات آزمایشی AAR را با کتابخانه اصلی نیز منتشر می‌کند. فایل Gradle Module Metadata حاوی اطلاعاتی برای Gradle است تا بتواند هنگام درخواست مؤلفه testFixtures ، مصنوع مناسب را مصرف کند.

برای غیرفعال کردن انتشار تجهیزات آزمایشی AAR یک کتابخانه در نوع انتشار، موارد زیر را به فایل build.gradle در سطح کتابخانه خود اضافه کنید:

afterEvaluate {
  components.release.withVariantsFromConfiguration(
    configurations.releaseTestFixturesVariantReleaseApiPublication) { skip() }
  components.release.withVariantsFromConfiguration(
    configurations.releaseTestFixturesVariantReleaseRuntimePublication) { skip() }
}

برای استفاده از تجهیزات تست AAR یک کتابخانه منتشر شده اندروید، می‌توانید از روش کمکی Gradle testFixtures() استفاده کنید.

dependencies {
  testImplementation testFixtures('com.example.company:publishedLib:1.0')
}

به طور پیش‌فرض، lint منابع تجهیزات تست را تجزیه و تحلیل می‌کند. می توانید lint را برای نادیده گرفتن منابع تست فیکسچر به صورت زیر پیکربندی کنید: 

android {
  lint {
    ignoreTestFixturesSources true
  }
}

ریشه های محتوای تکراری پشتیبانی نمی شود

با شروع AGP 7.2، دیگر نمی توانید یک فهرست منبع را در چندین مجموعه منبع به اشتراک بگذارید. به عنوان مثال، شما نمی توانید از منابع تست یکسانی هم برای تست های واحد و هم برای تست های ابزار دقیق استفاده کنید. برای کسب اطلاعات بیشتر، به تغییر تنظیمات تنظیمات منبع پیش فرض مراجعه کنید.