‫פלאגין של 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 לכיווץ קוד

‫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, האזהרות האלה יהפכו לשגיאות שיגרמו לבעיות ב-build. אפשר לשמור על ההתנהגות של AGP 7.0 על ידי הוספת האפשרות -ignorewarnings לקובץ proguard-rules.pro, אבל לא מומלץ לעשות את זה.

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

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

ב-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 יעביר אוטומטית את הפרויקט שלכם להגדרות החדשות.

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

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

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

בעבר, הייתה אפשרות להוסיף ספריית Native לתיקיית משאבים של Java, ולרשום את התיקייה באמצעות android.sourceSets.main.resources.srcDirs כדי שספריית Native תחולץ ותתווסף לחבילת ה-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.