‫Android Gradle Plugin 3.4.0 (אפריל 2019)

הגרסה הזו של הפלאגין ל-Android דורשת את הדברים הבאים:

תכונות חדשות

• הגדרות חדשות של תלות בבדיקת lint: ההתנהגות של lintChecks השתנתה, והוצגה הגדרה חדשה של תלות, lintPublish, כדי לתת לכם יותר שליטה על בדיקות ה-lint שנארזות בספריות Android שלכם.

  • ‫lintChecks: זוהי הגדרה קיימת שצריך להשתמש בה לבדיקות Lint שרוצים להריץ רק כשמבצעים build של הפרויקט באופן מקומי. אם השתמשתם בעבר בהגדרת התלות lintChecks כדי לכלול בדיקות lint ב-AAR שפורסם, אתם צריכים להעביר את התלויות האלה להגדרה החדשה lintPublish שמתוארת בהמשך.
  • ‫lintPublish: משתמשים בהגדרה החדשה הזו בפרויקטים של ספריות לבדיקות lint שרוצים לכלול ב-AAR שפורסם, כמו שמוצג בהמשך. כלומר, הפרויקטים שמשתמשים בספרייה שלכם יפעילו גם את בדיקות ה-lint האלה.

  בדוגמת הקוד הבאה נעשה שימוש בשתי הגדרות התלות בפרויקט מקומי של ספריית Android.

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks project(':lint')
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish project(':lintpublish')
  }
          

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks(project(":lint"))
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish(project(":lintpublish"))
      }
          

  • באופן כללי, אמור להיות שיפור במהירות הבנייה של משימות האריזה והחתימה. אם אתם מבחינים בירידה בביצועים שקשורה למשימות האלה, אתם מוזמנים לדווח על באג.

שינויים בהתנהגות

• הוצאה משימוש של הפלאגין של התכונה 'אפליקציות אינסטנט ל-Android' אזהרה: אם אתם עדיין משתמשים בפלאגין com.android.feature כדי לבנות את האפליקציה ללא התקנה, תקבלו אזהרה על הוצאה משימוש בפלאגין Android Gradle 3.4.0. כדי לוודא שתוכלו להמשיך ליצור אפליקציה ללא התקנה בגרסאות עתידיות של הפלאגין, צריך להעביר את האפליקציה ללא התקנה לשימוש בפלאגין של תכונה דינמית. הפלאגין הזה מאפשר גם לפרסם את האפליקציה המותקנת ואת האפליקציה ללא התקנה מתוך קובץ Android App Bundle יחיד.

• הכלי R8 מופעל כברירת מחדל: הכלי R8 משלב את הפעולות הבאות בשלב אחד: desugaring,‏ shrinking,‏ obfuscating,‏ optimizing ו-dexing. התוצאה היא שיפורים משמעותיים בביצועי הבנייה. הגרסה R8 הושקה בתוסף Android Gradle 3.3.0 ועכשיו היא מופעלת כברירת מחדל גם בפרויקטים של אפליקציות וגם בפרויקטים של ספריות Android באמצעות תוסף 3.4.0 ואילך.

בתמונה הבאה מוצגת סקירה כללית של תהליך ההידור לפני שהוצג R8.

עכשיו, עם R8, כל הפעולות האלה – desugaring,‏ shrinking,‏ obfuscating,‏ optimizing ו-dexing ‏ (D8) – מתבצעות בשלב אחד, כפי שמוצג בהמשך.

חשוב לזכור: R8 מיועד לעבוד עם כללי ProGuard הקיימים, כך שסביר להניח שלא תצטרכו לבצע פעולות כלשהן כדי ליהנות מהיתרונות של R8. עם זאת, מכיוון שמדובר בטכנולוגיה שונה מ-ProGuard, שנועדה במיוחד לפרויקטים של Android, יכול להיות שהכיווץ והאופטימיזציה יגרמו להסרת קוד ש-ProGuard לא היה מסיר. לכן, במצב הלא סביר הזה, יכול להיות שתצטרכו להוסיף כללים נוספים כדי שהקוד הזה יישאר בפלט של הבנייה.

אם נתקלתם בבעיות בשימוש ב-R8, כדאי לעיין בתשובות לשאלות הנפוצות בנושא תאימות ל-R8 כדי לבדוק אם יש פתרון לבעיה. אם הפתרון לא מתועד, אפשר לדווח על באג. כדי להשבית את R8, מוסיפים אחת מהשורות הבאות לקובץ gradle.properties של הפרויקט:

      # Disables R8 for Android Library modules only.
      android.enableR8.libraries = false
      # Disables R8 for all modules.
      android.enableR8 = false
      
    

הערה: אם מגדירים את useProguard ל-false בקובץ build.gradle של מודול האפליקציה, פלאגין Android Gradle משתמש ב-R8 כדי לכווץ את קוד האפליקציה עבור סוג ה-build הזה, בלי קשר להשבתה של R8 בקובץ gradle.properties של הפרויקט.

• הוצאנו את ndkCompile משימוש: עכשיו מוצגת שגיאת בנייה אם מנסים להשתמש ב-ndkBuild כדי לקמפל את הספריות המקוריות. במקום זאת, צריך להשתמש ב-CMake או ב-ndk-build כדי להוסיף קוד C ו-C++‎ לפרויקט.

בעיות מוכרות

• בשלב הזה, לא נאכף שימוש נכון בשמות חבילות ייחודיים, אבל בגרסאות מאוחרות יותר של הפלאגין תהיה הקפדה רבה יותר על כך. בגרסה 3.4.0 של הפלאגין Gradle ל-Android, אפשר להוסיף את השורה הבאה לקובץ gradle.properties כדי לבדוק אם הפרויקט כולל שמות חבילות קבילים.

            android.uniquePackageNames = true
            
          

  מידע נוסף על הגדרת שם חבילה באמצעות הפלאגין של Android Gradle זמין במאמר בנושא הגדרת מזהה האפליקציה.