‫פלאגין של Android Gradle 7.1.0 (ינואר 2022)

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

תאימות

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

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

משימת הניתוח של כלי לאיתור שגיאות בקוד (lint) היא לעיתים קרובות צוואר הבקבוק הגדול ביותר כשמריצים כלי לאיתור שגיאות בקוד (lint) באמצעות פלאגין של Android Gradle, ולכן הפעלת מטמון ה-build משפרת את מהירות ה-build כשמריצים כלי לאיתור שגיאות בקוד (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. הכלי החדש להקטנת קבצים מחליף משאבים לא בשימוש שמבוססים על קבצים בקבצים מינימליים שונים במקצת מאלה של הכלי הקודם להקטנת משאבים, אבל לא צפויה לכך השפעה על זמן הריצה.

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

פרסום וריאנט build

‫פלאגין של Android Gradle מגרסה 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. מידע נוסף זמין בדוגמת קוד של אפשרויות פרסום.

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

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

תאימות ל-Safe Args לניווט

הוסרו ממשקי AGP API שהפלאגין 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 ומטה של הפלאגין Gradle של מעקב אחר ביצועים ב-Firebase. הכלי AGP Upgrade Assistant לא יעזור לכם לעדכן את הפלאגין לגרסה 1.4.1 באופן אוטומטי, ולכן אם אתם משתמשים ב-firebase-perf ורוצים לשדרג את AGP לגרסה 7.1, תצטרכו לבצע את השדרוג הזה באופן ידני.

בעיות מוכרות

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

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

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

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