افزایه Android Gradle نسخه ۷.۲.۰ (مه ۲۰۲۲)

افزایه Android Gradle نسخه ۷.۲.۰ نسخهٔ پخش عمده‌ای است که شامل انواع ویژگی‌های جدید و بهبودها است.

‫۷.۲.۲ (اوت ۲۰۲۲)

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

  • مشکل شماره ۲۳۲۴۳۸۹۲۴: نسخه ۷.۲ افزایه AndroidGradle هنگام استفاده همراه با «میانای برنامه‌سازی کاربردی ASM» باعث ازکارافتادن «میانای برنامه‌سازی کاربردی تبدیل» می‌شود
  • مشکل شماره ۲۳۱۰۳۷۹۴۸: AGP 7.2.0-rc01 :buildSrc:generatePrecompiledScriptPluginAccessors - shadow/bundletool/com/android/prefs/AndroidLocation$AndroidLocationException
‫۷.۲.۱ (مه ۲۰۲۲)

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

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

سازگاری

حداقل نسخه نسخه پیش‌فرض یادداشت‌ها
Gradle ‫۷.۳.۳ ‫۷.۳.۳ برای کسب اطلاعات بیشتر، به‌روزرسانی Gradle را ببینید.
ابزارهای ساخت کیت توسعه نرم‌افزار ‫۳۰.۰.۳ ‫۳۰.۰.۳ «ابزارهای ساخت کیت توسعه نرم‌افزار» را نصب یا پیکربندی کنید.
NDK موجود نیست 21.4.7075529 نسخه دیگری از NDK را نصب یا پیکربندی کنید.
JDK 11 11 برای کسب اطلاعات بیشتر، تنظیم نسخه JDK را ببینید.

هشدار Jetifier و بررسی در «تحلیل‌گر ساخت»

اگر فایل gradle.properties پروژه شما شامل android.enableJetifier=true باشد، «تحلیل‌گر ساخت» اکنون هشداری نمایش می‌دهد. این پرچم در نسخه قبلی Android Studio معرفی شده است تا AndroidX را برای کتابخانه‌هایی که به‌صورت بومی از AndroidX پشتیبانی نمی‌کنند فعال کند. بااین‌حال، بوم‌سازگان کتابخانه عمدتاً به پشتیبانی بومی از AndroidX منتقل شده است و پرچم Jetifier احتمالاً دیگر برای پروژه شما لازم نیست. علاوه‌براین، پرچم می‌تواند منجر به عملکرد ساخت کُندتر شود. اگر این هشدار را دیدید، می‌توانید در «تجزیه‌وتحلیل‌گر ساخت» بررسی کنید تا مطمئن شوید پرچم برداشته می‌شود یا نه.

پشتیبانی از وسایل آزمایشی

از Android Studio Chipmunk Beta 1،‏ Android Studio از هر دو Android و Java test fixtures پشتیبانی می‌کند. برای اطلاعات بیشتر درباره ویژگی وسایل آزمایشی و نحوه استفاده از آن در پروژه Java، راهنمای Gradle درباره استفاده از وسایل آزمایشی{:.external} را ببینید.

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

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

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

برای غیرفعال کردن انتشار «آرایه آرشیو اندروید» (AAR) عناصر آزمایشی کتابخانه در گونه نسخه پخش، مورد زیر را به فایل build.gradle سطح کتابخانه اضافه کنید:

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

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

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

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

android {
  lint {
    ignoreTestFixturesSources true
  }
}

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

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