הגדרת המודול הבסיסי

חבילת אפליקציה שונה מ-APK בכך שאי אפשר לפרוס אותה במכשיר. זהו פורמט פרסום שכולל את כל הקוד והמשאבים המקומפלים של האפליקציה בקובץ build אחד. לכן, אחרי שאתם מעלים את ה-App Bundle החתום, ל-Google Play יש את כל מה שצריך כדי ליצור את קובצי ה-APK של האפליקציה, לחתום עליהם ולהציג אותם למשתמשים.

שנתחיל?

ברוב הפרויקטים של האפליקציות לא נדרש מאמץ רב כדי לתמוך בקובצי Android App Bundle. הסיבה לכך היא שהמודול שכולל קוד ומשאבים ל-APK הבסיסי של האפליקציה הוא מודול האפליקציה הרגיל, שאתם מקבלים כברירת מחדל כשאתם יוצרים פרויקט חדש של אפליקציה ב-Android Studio. כלומר, המודול שמחיל את הפלאגין application, כמו שמוצג בקטע הקוד הבא, על קובץ ה-build.gradle שלו מספק את הקוד והמשאבים לפונקציונליות הבסיסית של האפליקציה.

מגניב

// The standard application plugin creates your app's base module.
plugins {
 id 'com.android.application'
}

Kotlin

plugins {
    // The standard application plugin creates your app's base module.
    id("com.android.application")
}

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

תצורת ה-build של המודול הבסיסי

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

קוד גרסה ועדכונים לאפליקציה

כשמשתמשים בקובצי Android App Bundle, לא צריך יותר לנהל קודי גרסאות של כמה קובצי APK שמעלים ל-Google Play. במקום זאת, אתם מנהלים רק קוד גרסה אחד במודול הבסיסי של האפליקציה, כמו שמוצג בהמשך:

// In your base module build.gradle file
android {
    defaultConfig {
        …
        // You specify your app's version code only in the base module.
        versionCode 5
        versionName "1.0"
    }
}

אחרי שמעלים את ה-App Bundle, מערכת Google Play משתמשת בקוד הגרסה במודול הבסיס כדי להקצות את אותו קוד גרסה לכל חבילות ה-APK שנוצרות מה-App Bundle הזה. כלומר, כשמכשיר מוריד ומתקין את האפליקציה, כל קובצי ה-APK המפוצלים של האפליקציה הזו חולקים את אותו קוד גרסה.

כשרוצים לעדכן את האפליקציה עם קוד או משאבים חדשים, צריך לעדכן את קוד הגרסה במודול הבסיס של האפליקציה וליצור חבילת אפליקציה חדשה ומלאה. כשמעלים את ה-App Bundle ל-Google Play, המערכת יוצרת קבוצה חדשה של חבילות APK על סמך קוד הגרסה שצוין במודול הבסיס. לאחר מכן, כשמשתמשים מעדכנים את האפליקציה, מערכת Google Play מספקת להם גרסאות מעודכנות של כל קובצי ה-APK שמותקנים כרגע במכשיר. כלומר, כל חבילות ה-APK המותקנות מתעדכנות לקוד הגרסה החדש.

דברים נוספים שכדאי לזכור

  • חתימת אפליקציה: אם אתם כוללים פרטי חתימה בקובצי ה-build, אתם צריכים לכלול אותם רק בקובץ תצורת ה-build של מודול הבסיס. מידע נוסף זמין במאמר בנושא הגדרת Gradle לחתימה על האפליקציה.
  • כיווץ קוד: אם רוצים להפעיל כיווץ קוד לכל פרויקט האפליקציה (כולל המודולים של התכונות), צריך לעשות את זה מהקובץ build.gradle של מודול הבסיס. כלומר, אפשר לכלול כללי ProGuard בהתאמה אישית במודול של תכונות, אבל המערכת מתעלמת מהמאפיין minifyEnabled בתצורות ה-build של המודול.
  • המערכת מתעלמת מהבלוק splits: כשיוצרים App Bundle, ‏Gradle מתעלם מהמאפיינים בבלוק android.splits. אם אתם רוצים לקבוע באילו סוגים של קובצי APK להגדרות ה-App Bundle שלכם יתמוך, אתם יכולים להשתמש ב-android.bundle כדי להשבית סוגים של קובצי APK להגדרות.
  • ניהול גרסאות של האפליקציה: מודול הבסיס קובע את קוד הגרסה ואת שם הגרסה של כל פרויקט האפליקציה. מידע נוסף זמין במאמר קוד גרסה ועדכונים לאפליקציות.

הפעלה מחדש או השבתה של סוגים של קובצי APK להגדרות אישיות

כברירת מחדל, כשיוצרים App Bundle, הוא תומך ביצירת קובצי APK של הגדרות אישיות לכל קבוצה של משאבי שפה, משאבי צפיפות מסך וספריות ABI. באמצעות הבלוק android.bundle בקובץ build.gradle של מודול הבסיס, כמו שמוצג בהמשך, אפשר להשבית את התמיכה בסוג אחד או יותר של חבילות APK להגדרות אישיות:

מגניב

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Kotlin

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

טיפול בשינויים בשפה

מערכת Google Play קובעת אילו משאבי שפה להתקין עם האפליקציה, על סמך השפה שנבחרה בהגדרות המכשיר של המשתמש. נניח שמשתמש משנה את שפת המערכת שמוגדרת כברירת מחדל אחרי שהוא כבר הוריד את האפליקציה. אם האפליקציה תומכת בשפה הזו, המכשיר מבקש ומוריד מ-Google Play קובצי APK נוספים של הגדרות אישיות בשביל משאבי השפה האלה.

באפליקציות שכוללות כלי לבחירת שפה בתוך האפליקציה ומשנות באופן דינמי את השפה של האפליקציה, בלי קשר להגדרת השפה ברמת המערכת, צריך לבצע כמה שינויים כדי למנוע קריסות בגלל משאבים חסרים. צריך להגדיר את המאפיין android.bundle.language.enableSplit לערך false, או להטמיע הורדות של שפות לפי דרישה באמצעות ספריית Play Core, כפי שמתואר במאמר הורדת משאבי שפה נוספים.