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

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

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

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

הוסרו ממשקי AGP API שהפלאגין Navigation Safe Args Gradle תלוי בהם. ‫AGP 7.1 לא פועל עם Navigation Safe Args בגרסאות 2.4.0-rc1 או 2.4.0, אבל הוא פועל עם גרסאות 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 לא מבצע אינסטרומנטציה של מחלקות האפליקציה כדי לטפל בהזרקת תלות (dependency injection) כשמריצים בדיקות יחידה.

הבעיה הזו תיפתר בגרסה 7.1.1, issue #213534628.