פלאגין של Android Gradle 7.0.0 (יולי 2021)

‫פלאגין של Android Gradle 7.0.0 הוא גרסה מרכזית שכוללת מגוון של תכונות ושיפורים חדשים.

תאימות

נדרשת גרסת JDK 11 כדי להריץ AGP 7.0

כשמשתמשים בפלאגין של Android Gradle מגרסה 7.0 כדי לבנות את האפליקציה, נדרש JDK 11 כדי להריץ את Gradle. ‫Android Studio Arctic Fox כולל JDK 11 ומגדיר את Gradle להשתמש בו כברירת מחדל, כך שרוב המשתמשים ב-Android Studio לא צריכים לבצע שינויים בהגדרות של הפרויקטים שלהם.

אם אתם צריכים להגדיר באופן ידני את גרסת ה-JDK שבה משתמש AGP בתוך Android Studio, אתם צריכים להשתמש ב-JDK 11 ומעלה.

כשמשתמשים ב-AGP בלי Android Studio, צריך לשדרג את גרסת ה-JDK על ידי הגדרת משתנה הסביבה JAVA_HOME או -Dorg.gradle.java.home אפשרות שורת הפקודה לתיקיית ההתקנה של JDK 11.

שימו לב שמנהל ה-SDK ומנהל ה-AVD בחבילת SDK Tools שהוצאה משימוש לא פועלים עם JDK 11. כדי להמשיך להשתמש ב-SDK Manager וב-AVD Manager עם AGP 7.0 ואילך, צריך לעבור לגרסאות החדשות של הכלים בחבילת Android SDK Command-Line Tools הנוכחית.

גרסת ה-API של הווריאציות יציבה

ה-Variant API החדש יציב עכשיו. אפשר לראות את הממשקים החדשים בחבילה com.android.build.api.variant, ודוגמאות בפרויקט gradle-recipes ב-GitHub. במסגרת Variant API החדש, אנחנו מציעים מספר קבצים זמניים, שנקראים ארטיפקטים, דרך הממשק Artifacts. אפשר להשיג בבטחה את הארטיפקטים האלה, כמו המניפסט הממוזג, ולהתאים אותם אישית באמצעות פלאגינים וקוד של צד שלישי.

נמשיך להרחיב את Variant API על ידי הוספת פונקציות חדשות והגדלת מספר הארטיפקטים הביניים שאנחנו מספקים להתאמה אישית.

שינויים בהתנהגות של Lint

בקטע הזה מתוארים כמה שינויים בהתנהגות של Lint בפלאגין Android Gradle‏ 7.0.0.

שיפור של כלי ה-lint לתלות של הפרויקט בספריות

הפעלת lint עם checkDependencies = true מהירה יותר עכשיו מבעבר. בפרויקטים של Android שכוללים אפליקציה עם יחסי תלות בספריות, מומלץ להגדיר את checkDependencies ל-true כמו שמוצג בהמשך, ולהריץ את lint באמצעות ./gradlew :app:lint. הפקודה הזו תנתח את כל מודולי התלות במקביל ותפיק דוח יחיד שכולל בעיות מהאפליקציה ומכל יחסי התלות שלה.

// build.gradle
android {
  ...
  lintOptions {
    checkDependencies true
  }
}

// build.gradle.kts
android {
  ...
  lint {
    isCheckDependencies = true
  }
}

משימות Lint יכולות להיות מעכשיו UP-TO-DATE

אם המקורות והמשאבים של מודול לא השתנו, אין צורך להריץ שוב את משימת ניתוח ה-lint של המודול. במקרה כזה, הביצוע של המשימה יופיע כ-UP-TO-DATE בפלט של Gradle. בעקבות השינוי הזה, כשמריצים lint במודול של אפליקציה עם checkDependencies = true, רק מודולים שהשתנו צריכים להריץ את הניתוח שלהם. כתוצאה מכך, אפשר להריץ את Lint אפילו מהר יותר.

גם אם הקלט של משימת הדוח של Lint לא השתנה, אין צורך להריץ אותה. בעיה ידועה שקשורה לכך היא שלא מודפס פלט טקסט של lint ל-stdout כשהמשימה של lint היא UP-TO-DATE (בעיה מס' 191897708).

הפעלת lint במודולים של פיצ'רים דינמיים

‫AGP לא תומך יותר בהרצת lint ממודולים של תכונות דינמיות. אם מריצים את הכלי lint ממודול האפליקציה המתאים, הכלי יפעל על מודולי התכונות הדינמיות שלו ויכלול את כל הבעיות בדוח ה-lint של האפליקציה. בעיה ידועה שקשורה לכך היא שכאשר מריצים את lint עם checkDependencies = true ממודול של אפליקציה, תלויות בספרייה של תכונות דינמיות לא נבדקות אלא אם הן גם תלויות באפליקציה (בעיה מס' 191977888).

הפעלת lint רק בווריאנט ברירת המחדל

ההרצה של ./gradlew :app:lint מריצה עכשיו את lint רק עבור הווריאנט שמוגדר כברירת מחדל. בגרסאות קודמות של AGP, הפקודה lint הופעלה לכל הווריאציות.

אזהרות על מחלקה חסרה ב-R8 shrinker

‫R8 מטפל בצורה מדויקת ועקבית יותר במחלקות חסרות ובאפשרות -dontwarn. לכן, כדאי להתחיל לבדוק את האזהרות על מחלקות חסרות שמופיעות ב-R8.

כש-R8 נתקל בהפניה למחלקה שלא מוגדרת באפליקציה או באחת מהתלויות שלה, הוא מציג אזהרה שמופיעה בפלט של הבנייה. לדוגמה:

R8: Missing class: java.lang.instrument.ClassFileTransformer

האזהרה הזו מציינת שלא נמצאה הגדרת המחלקה java.lang.instrument.ClassFileTransformer במהלך ניתוח הקוד של האפליקציה. בדרך כלל, המשמעות של האזהרה הזו היא שיש שגיאה, אבל יכול להיות שתרצו להתעלם ממנה. שתי סיבות נפוצות להתעלמות מהאזהרה:

1. ספריות שמטרגטות את ה-JVM והמחלקה החסרה הן מסוג ספריית JVM (כמו בדוגמה שלמעלה).

2. אחד מהתלויות שלך משתמש בממשק API שזמין רק בזמן ההידור.

כדי להתעלם מאזהרה על מחלקה חסרה, מוסיפים כלל -dontwarn לקובץ proguard-rules.pro. לדוגמה:

-dontwarn java.lang.instrument.ClassFileTransformer

לנוחותכם, AGP ייצור קובץ שמכיל את כל הכללים שאולי חסרים, ויכתוב אותם לנתיב קובץ כמו הבא: app/build/outputs/mapping/release/missing_rules.txt. מוסיפים את הכללים לקובץ proguard-rules.pro כדי להתעלם מהאזהרות.

ב-AGP 7.0, הודעות על מחלקה חסרה יופיעו כאזהרות, ואפשר להפוך אותן לשגיאות על ידי הגדרת android.r8.failOnMissingClasses = true ב-gradle.properties. ב-AGP 8.0, האזהרות האלה יהפכו לשגיאות שיגרמו לביטול הבנייה. אפשר לשמור על ההתנהגות של AGP 7.0 על ידי הוספת האפשרות -ignorewarnings לקובץ proguard-rules.pro, אבל לא מומלץ לעשות את זה.

הוסר מטמון ה-build של פלאגין של Android Gradle

מטמון ה-build של AGP הוסר ב-AGP 4.1. מטמון ה-build של AGP, שהוצג בעבר ב-AGP 2.3 כדי להשלים את מטמון ה-build של Gradle, הוחלף לחלוטין במטמון ה-build של Gradle ב-AGP 4.1. השינוי הזה לא משפיע על זמן הבנייה.

ב-AGP 7.0, המאפיין android.enableBuildCache, המאפיין android.buildCacheDir והמשימה cleanBuildCache הוסרו.

שימוש בקוד מקור של Java 11 בפרויקט

עכשיו אפשר לקמפל עד קוד מקור של Java 11 בפרויקט של האפליקציה, וכך להשתמש בתכונות שפה חדשות יותר כמו שיטות ממשק פרטיות, אופרטור היהלום למחלקות אנונימיות ותחביר של משתנים מקומיים לפרמטרים של lambda.

כדי להפעיל את התכונה הזו, צריך להגדיר את compileOptions לגרסת Java הרצויה ואת compileSdkVersion ל-30 ומעלה:

// build.gradle
android {
  compileSdkVersion 30
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  // For Kotlin projects
  kotlinOptions {
    jvmTarget = "11"
  }
}

// build.gradle.kts
android {
  compileSdkVersion(30)
  compileOptions {
    sourceCompatibility(JavaVersion.VERSION_11)
    targetCompatibility(JavaVersion.VERSION_11)
  }
  kotlinOptions {
    jvmTarget = "11"
  }
}

ההגדרות של התלות הוסרו

ההגדרות הבאות (או היקפי התלות) הוסרו ב-AGP 7.0:

• ‫compile
  בהתאם לתרחיש השימוש, האפשרות הזו הוחלפה באפשרות api או באפשרות implementation.
  רלוונטי גם לווריאציות *Compile, למשל: debugCompile.
• provided
  הדוח הזה הוחלף על ידי compileOnly.
  הכללים האלה חלים גם על וריאציות *שסופקו, למשל: releaseProvided.
• apk
  הדוח הזה הוחלף על ידי runtimeOnly.
• publish
  הדוח הזה הוחלף על ידי runtimeOnly.

ברוב המקרים, הכלי AGP Upgrade Assistant יעביר אוטומטית את הפרויקט שלכם להגדרות החדשות.

שינוי ב-Classpath כשמבצעים קומפילציה מול פלאגין Android Gradle

אם אתם מבצעים קומפילציה מול פלאגין של Android Gradle, יכול להיות ש-classpath של compile ישתנה. מכיוון ש-AGP משתמש עכשיו בהגדרות api/implementation באופן פנימי, יכול להיות שחלק מהארטיפקטים יוסרו מנתיב המחלקה של ההידור. אם אתם מסתמכים על תלות ב-AGP בזמן ההידור, הקפידו להוסיף אותה כתלות מפורשת.

אין תמיכה בהוספה של ספריות מקוריות לתיקיית משאבי Java

בעבר, הייתה אפשרות להוסיף ספרייה מקומית לתיקיית משאבים של Java, ולרשום את התיקייה באמצעות android.sourceSets.main.resources.srcDirs כדי שהספרייה המקומית תחולץ ותתווסף לחבילת ה-APK הסופית. החל מ-AGP 7.0, זה לא אפשרי והמערכת מתעלמת מספריות Native בתיקיית משאבי Java. במקום זאת, צריך להשתמש בשיטת ה-DSL שמיועדת לספריות Native‏, android.sourceSets.main.jniLibs.srcDirs. למידע נוסף, אפשר לעיין במאמר בנושא הגדרת קבוצות של מקורות.

בעיות מוכרות

בקטע הזה מתוארות בעיות מוכרות שקיימות בפלאגין של Android Gradle‏ ‎7.0.0.

חוסר תאימות לפלאגין Kotlin Multiplatform בגרסה 1.4.x

‫פלאגין של Android Gradle בגרסה 7.0.0 תואם לפלאגין של Kotlin Multiplatform בגרסה 1.5.0 ואילך. בפרויקטים שבהם נעשה שימוש בתמיכה ב-Kotlin Multiplatform, צריך לעדכן ל-Kotlin 1.5.0 כדי להשתמש ב-Android Gradle Plugin 7.0.0. כפתרון עקיף, אפשר לשנמך את הפלאגין של Android Gradle לגרסה 4.2.x, אבל לא מומלץ לעשות את זה.

מידע נוסף זמין במאמר KT-43944.

פלט ה-lint חסר

אם משימת ה-lint עדכנית, לא מודפס פלט טקסט של lint ל-stdout (בעיה מספר 191897708). מידע נוסף זמין במאמר שינויים בהתנהגות של lint. הבעיה הזו תוקנה ב-Android Gradle Plugin 7.1.

לא כל התלויות בספריית התכונות הדינמיות נבדקות על ידי Lint

כשמריצים את lint עם checkDependencies = true ממודול של אפליקציה, לא נבדקים יחסי תלות של ספריות של תכונות דינמיות, אלא אם הם גם יחסי תלות של האפליקציה (בעיה מספר 191977888). כפתרון עקיף, אפשר להריץ את משימת ה-lint בספריות האלה. מידע נוסף זמין במאמר שינויים בהתנהגות של lint.