‫Android Gradle Plugin 7.1.0 (ינואר 2022)

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

תאימות

אפשר עכשיו לשמור במטמון את המשימה של ניתוח Lint

התוסף AndroidLintAnalysisTask תואם עכשיו למטמון ה-build של Gradle. אם מפעילים את מטמון ה-build על ידי הגדרת org.gradle.caching=true בקובץ gradle.properties, משימת הניתוח של lint תקבל את הפלט שלה ממטמון ה-build כשזה אפשרי.

משימת הניתוח של lint היא לעיתים קרובות צוואר הבקבוק הגדול ביותר כשמריצים lint באמצעות Android Gradle plugin, ולכן הפעלת מטמון הבנייה משפרת את מהירות הבנייה כשמריצים lint במצבים רבים. לדוגמה, אם יש לכם פרויקט עם כמה מודולים ואתם מנקים את ספריית ה-build לפני שמריצים את lint בשרת CI, אתם אמורים לראות שיפור משמעותי בביצועים.

מודולים של C/C++‎ יכולים עכשיו להפנות למודולים אחרים של C/C++‎ באותו פרויקט

עכשיו אפשר להגדיר מודול Gradle Android עם קוד C/C++ כך שיפנה לקובצי כותרות ולקוד ספרייה במודול Gradle אחר. הפרוטוקול Prefab משמש להעברת הכותרות והספריות בין מודולי Gradle.

דרישות

• מודול השימוש צריך להיות CMake ולא ndk-build. כדי לתמוך ב-ndk-build, יהיה צורך בעדכון NDK בעתיד. מודול הפרסום יכול להיות CMake או ndk-build.

• במודול הצרכן צריך להפעיל את prefab בקובץ build.gradle.

android {
  buildFeatures {
    prefab true
  }
}

• במודול publishing צריך להפעיל את prefabPublishing בקובץ build.gradle.

android {
  buildFeatures {
    prefabPublishing true
  }
}

• במודול הצרכן צריך להוסיף הפניה למודול הפרסום על ידי הוספת שורה בקטע dependencies בקובץ build.gradle. לדוגמה:

dependencies {
  implementation project(':mylibrary')
}

• מודול הפרסום צריך לחשוף חבילה באמצעות קטע prefab. לדוגמה:

android {
  prefab {
    mylibrary {
      libraryName "libmylibrary"
      headers "src/main/cpp/include"
    }
  }
}

• בקובץ CMakeLists.txt של המודול שמשתמש בחבילה, יכול להיות שיהיה שימוש ב-find_package() כדי לאתר את החבילה שפורסמה על ידי המודול שיוצר את החבילה. לדוגמה:

find_package(mylibrary REQUIRED CONFIG)
target_link_libraries(
  myapplication
  mylibrary::mylibrary)

• צריך לצרף קובץ STL אחד לכל האפליקציה. לכן, לדוגמה, גם מודולים של צריכה וגם מודולים של פרסום יכולים להשתמש ב-STL משותף של C++‎.

   android {
      defaultConfig {
        externalNativeBuild {
          cmake {
            arguments '-DANDROID_STL=c++_shared'
          }
        }
      }
    }

הסבר נוסף על הגדרת צרכנים ומפיקים של AAR מקוריים באמצעות AGP מופיע במאמר בנושא תלות מקורית ב-AGP.

הגדרות המאגר בקובץ settings.gradle

כשיוצרים פרויקט חדש ב-Android Studio Bumblebee, הקובץ build.gradle ברמה העליונה מכיל את הבלוק plugins, ואחריו קוד לניקוי ספריית ה-build:

plugins {
    id 'com.android.application' version '7.1.0-beta02' apply false
    id 'com.android.library' version '7.1.0-beta02' apply false
    id 'org.jetbrains.kotlin.android' version '1.5.30' apply false
}
task clean(type: Delete) {
  delete rootProject.buildDir
}

ההגדרות של מאגר המידע שהיו בעבר בקובץ build.gradle ברמה העליונה נמצאות עכשיו בקובץ settings.gradle:

pluginManagement {
  repositories {
    gradlePluginPortal()
    google()
    mavenCentral()
  }
}
dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}
rootProject.name = 'GradleManagedDeviceTestingNew'
include ':app'

קובץ build.gradle ברמת המודול לא השתנה. לכן, משתמשים בקובץ build.gradle ברמה העליונה ובקובץ settings.gradle כדי להגדיר תצורות של build שחלות על כל המודולים בפרויקט, או על המאגרים והתלות שחלים על Gradle עצמו. משתמשים בקובץ build.gradle ברמת המודול כדי להגדיר תצורות של build שספציפיות למודול מסוים בפרויקט.

שיפור בכלי לכיווץ משאבים

‫Android Studio Bumblebee כולל כלי משופר להקטנת נפח המשאבים, שעוזר להקטין את נפח האפליקציה.

תמיכה באפליקציות עם תכונות דינמיות

היישום שמוגדר כברירת מחדל של כלי הכיווץ של משאבי Android עודכן ב-Android Gradle Plugin 7.1.0-alpha09. ההטמעה החדשה תומכת בהקטנת אפליקציות באמצעות תכונות דינמיות.

הקטנות נוספות של גודל האפליקציה (ניסיוני)

ההטמעה החדשה של כלי להקטנת משאבים יכולה להקטין עוד יותר את הגודל של האפליקציה המוקטנת. הכלי משנה את טבלת המשאבים כדי להסיר משאבי ערך שלא נעשה בהם שימוש והפניות למשאבי קבצים שלא נעשה בהם שימוש. הכלי החדש למחיקת משאבים יכול למחוק משאבי קבצים שלא נעשה בהם שימוש באופן מלא, וכך להקטין עוד יותר את גודל האפליקציה. ההתנהגות הזו עדיין לא מופעלת כברירת מחדל, אבל אפשר להפעיל אותה כדי לנסות אותה. לשם כך, צריך להוסיף את האפשרות הניסיונית android.experimental.enableNewResourceShrinker.preciseShrinking=true לקובץ gradle.properties של הפרויקט.

אם נתקלתם בבעיות בכלי החדש לצמצום משאבים או בדגל הניסיוני, אתם מוזמנים לדווח עליהן. כדי לאבחן בעיות, או כפתרון זמני, אפשר לחזור להטמעה הקודמת על ידי הוספת android.enableNewResourceShrinker=false לפרויקט gradle.properties. הכלי החדש להקטנת קבצים מחליף משאבים לא בשימוש שמבוססים על קבצים בקבצים מינימליים שונים במקצת מאלה של הכלי הקודם להקטנת קבצים, אבל לא צפוי שתהיה לכך השפעה על זמן הריצה.

ההטמעה הישנה מתוכננת להסרה בגרסה 8.0.0 של Android Gradle Plugin.

פרסום וריאציות של גרסת Build

‫Android Gradle plugin מגרסה 7.1.0 ואילך מאפשר לכם להגדיר אילו וריאציות של build לפרסם במאגר Apache Maven. ‫AGP יוצר רכיב עם וריאנט בנייה אחד או יותר על סמך ה-DSL החדש לפרסום, שבו אפשר להשתמש כדי להתאים אישית פרסום למאגר Maven. בנוסף, בהשוואה לגרסאות קודמות, הגרסה הזו חוסכת עבודה מיותרת כי לא נוצרים רכיבים כברירת מחדל. מידע נוסף זמין בדוגמת הקוד לפרסום.

פרסום קובץ Javadoc JAR

‫AGP מגרסה 7.1.0 ואילך מאפשר ליצור Javadoc ממקורות Java ו-Kotlin ולפרסם קובצי JAR של Javadoc בנוסף לקובצי AAR של פרויקטים של ספריות. קובצי ה-Javadoc מתווספים לקובצי ה-POM ולקובצי Gradle Module Metadata{:.external}. כדי להפעיל את התכונה הזו, מוסיפים את withJavadocJar() ב-singleVariant או ב-multipleVariants. מידע נוסף זמין בדוגמת הקוד של אפשרויות הפרסום.

פרסום של קובץ JAR של מקורות

‫AGP מגרסה 7.1.0 ואילך מאפשר לכם לפרסם קובצי JAR של מקורות Java ו-Kotlin בנוסף לקובצי AAR של פרויקטים של ספריות. המקורות מתווספים לקובצי POM ו-Gradle Module Metadata{:.external}. כדי להפעיל את התכונה הזו, מוסיפים withSourcesJar() בsingleVariant או בmultipleVariants publishing block. מידע נוסף זמין בדוגמת הקוד של אפשרויות הפרסום.

שינוי סמנטי בבלוק Lint

כל שיטות ה-lint שמבטלות את רמת החומרה שצוינה לבעיה – enable, ‏ disable/ignore,‏ informational, ‏ warning, ‏ error,‏ fatal – פועלות עכשיו לפי סדר ההגדרה. לדוגמה, הגדרת בעיה כקריטית ב-finalizeDsl() תבטל עכשיו את ההשבתה שלה ב-DSL הראשי. מידע נוסף זמין במאמרי העזרה בנושא lint{} חסימת הפניות, ותהליך בניית Android ונקודות הרחבה.

תאימות של Safe Args ל-Navigation

ממשקי ה-API של AGP שהפלאגין Navigation Safe Args Gradle תלוי בהם הוסרו. ‫AGP 7.1 לא פועל עם גרסאות 2.4.0-rc1 או 2.4.0 של Navigation Safe Args, אבל הוא פועל עם גרסאות 2.5.0-alpha01 ו-2.4.1. בינתיים, כפתרון עקיף, אפשר להשתמש ב-AGP 7.1 עם גרסת snapshot של Navigation Safe Args, ‏Navigation 2.5.0-SNAPSHOT. כדי להשתמש בגרסת ה-snapshot, פועלים לפי ההוראות לשימוש ב-snapshot עם מזהה build מספר ‎ #8054565.

בנוסף, גרסאות 2.4.1 ו-2.5.0 של Navigation Safe Args לא יפעלו יותר עם AGP 4.2. כדי להשתמש בגרסאות האלה של Safe Args, צריך להשתמש ב-AGP 7.0 ואילך.

השבתת יצירה אוטומטית של רכיבים

החל מ-AGP 8.0, יצירת רכיבים אוטומטית מושבתת כברירת מחדל. בשלב הזה, AGP 7.1 יוצר באופן אוטומטי רכיב לכל וריאציית build, עם אותו שם כמו וריאציית ה-build, ורכיב all שכולל את כל וריאציות ה-build. היצירה האוטומטית של הרכיב הזה תושבת. כדי לעבור להתנהגות החדשה, צריך להשבית ידנית את היצירה האוטומטית של רכיבים על ידי הגדרת android.disableAutomaticComponentCreation ל- true.. מידע נוסף זמין במאמר בנושא שימוש בתוסף Maven Publish.

תאימות של מעקב אחרי ביצועים ב-Firebase

‫AGP 7.1 לא תואם לגרסה 1.4.0 ומטה של Firebase Performance Monitoring Gradle plugin. הכלי AGP Upgrade Assistant לא מעדכן אוטומטית את הפלאגין לגרסה 1.4.1, ולכן אם אתם משתמשים ב-firebase-perf ורוצים לשדרג את AGP לגרסה 7.1, אתם צריכים לבצע את השדרוג הזה באופן ידני.

בעיות מוכרות

בקטע הזה מתוארות בעיות ידועות שקיימות ב-Android Gradle Plugin 7.1.0.

בעיות בבדיקות יחידה של פרויקט אפליקציה שמשתמש בפלאגין Hilt

ה-classpath של בדיקת היחידה מכיל את מחלקות האפליקציה שלא עברו אינסטרומנטציה, מה שאומר ש-Hilt לא מבצע אינסטרומנטציה של מחלקות האפליקציה כדי לטפל בהזרקת תלות (dependency injection) כשמריצים בדיקות יחידה.

הבעיה הזו תיפתר בגרסה 7.1.1. אפשר לעיין בבעיה מספר 213534628.