‫Android Gradle Plugin 7.0.0 (יולי 2021)

‫Android Gradle plugin 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 Plugin 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 Plugin

מטמון ה-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.
  ההבדל הזה רלוונטי גם לווריאציות של *הידור, לדוגמה: debugCompile.
• provided
  הדוח הזה הוחלף על ידי compileOnly.
  ההנחיות האלה רלוונטיות גם לווריאציות *שסופקו, למשל: releaseProvided.
• apk
  הדוח הזה הוחלף על ידי runtimeOnly.
• publish
  הדוח הזה הוחלף על ידי runtimeOnly.

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

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

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

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

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

בעיות מוכרות

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

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

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

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

פלט ה-lint חסר

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

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

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