กําหนดค่าโมดูลฐาน

App Bundle แตกต่างจาก APK ตรงที่คุณไม่สามารถติดตั้งใช้งานในอุปกรณ์ได้ แต่เป็นเพียงรูปแบบการเผยแพร่ที่มีโค้ดและทรัพยากรที่คอมไพล์แล้วทั้งหมดของแอปในอาร์ติแฟกต์การสร้างรายการเดียว ดังนั้นหลังจากอัปโหลด App Bundle ที่ทำ Signing แล้ว Google Play จะมีทุกอย่างที่จำเป็นในการสร้างและทำ Signing APK ของแอป รวมถึงแสดง 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")
}

นอกจากจะให้ฟังก์ชันหลักสำหรับแอปแล้ว โมดูลพื้นฐานยังให้การกำหนดค่าบิลด์และรายการไฟล์ Manifest จำนวนมากที่ส่งผลต่อทั้งโปรเจ็กต์แอปด้วย

การกำหนดค่าบิลด์ของโมดูลฐาน

สำหรับโปรเจ็กต์แอปที่มีอยู่ส่วนใหญ่ คุณไม่จำเป็นต้องเปลี่ยนแปลงอะไรในการกำหนดค่าบิลด์ของโมดูลพื้นฐาน อย่างไรก็ตาม หากคุณกำลังพิจารณาเพิ่มโมดูลฟีเจอร์ลงในโปรเจ็กต์แอป หรือหากก่อนหน้านี้คุณเผยแพร่แอปโดยใช้ APK หลายรายการ คุณควรคำนึงถึงแง่มุมบางอย่างเกี่ยวกับการกำหนดค่าบิลด์ของโมดูลพื้นฐาน

รหัสเวอร์ชันและการอัปเดตแอป

เมื่อใช้ 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 ใหม่ที่สมบูรณ์ เมื่อคุณอัปโหลด App Bundle นั้นไปยัง Google Play ระบบจะสร้างชุด APK ใหม่โดยอิงตามรหัสเวอร์ชันที่โมดูลพื้นฐานระบุ ต่อมาเมื่อผู้ใช้อัปเดตแอป Google Play จะแสดง APK เวอร์ชันอัปเดตทั้งหมดที่ติดตั้งอยู่ในอุปกรณ์ในขณะนั้น กล่าวคือ APK ที่ติดตั้งไว้ทั้งหมดจะได้รับการอัปเดตเป็นรหัสเวอร์ชันใหม่

ข้อควรพิจารณาอื่นๆ

  • App Signing: หากคุณรวมข้อมูลการรับรองไว้ในไฟล์บิลด์ คุณควรรวมไว้ในไฟล์การกำหนดค่าบิลด์ของโมดูลพื้นฐานเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกำหนดค่า Gradle เพื่อรับรองแอป
  • การลดขนาดโค้ด: หากต้องการเปิดใช้การลดขนาดโค้ดสำหรับทั้งโปรเจ็กต์แอป (รวมถึงโมดูลฟีเจอร์) คุณต้องดำเนินการจากไฟล์ build.gradle ของโมดูลพื้นฐาน กล่าวคือ คุณสามารถรวมกฎ ProGuard ที่กำหนดเองไว้ในโมดูลฟีเจอร์ได้ แต่ระบบจะไม่สนใจพร็อพเพอร์ตี้ minifyEnabled ในการกำหนดค่าบิลด์ของโมดูลฟีเจอร์
  • ระบบจะละเว้นบล็อก splits: เมื่อสร้าง App Bundle แล้ว Gradle จะละเว้นพร็อพเพอร์ตี้ในบล็อก android.splits หากต้องการควบคุมประเภท APK การกำหนดค่าที่ App Bundle รองรับ ให้ใช้ android.bundle เพื่อปิดใช้ประเภท APK การกำหนดค่าแทน
  • การกำหนดเวอร์ชันแอป: โมดูลพื้นฐานจะกำหนดรหัสเวอร์ชันและชื่อเวอร์ชันสำหรับโปรเจ็กต์แอปทั้งหมด ดูข้อมูลเพิ่มเติมได้ที่รหัสเวอร์ชันและการอัปเดตแอป

เปิดใช้หรือปิดใช้ APK การกำหนดค่าประเภทต่างๆ อีกครั้ง

โดยค่าเริ่มต้น เมื่อคุณสร้าง App Bundle ระบบจะรองรับการสร้าง APK การกำหนดค่าสำหรับทรัพยากรภาษา ทรัพยากรความหนาแน่นของหน้าจอ และไลบรารี ABI แต่ละชุด การใช้บล็อก android.bundle ในไฟล์ build.gradle ของโมดูลฐานตามที่แสดงด้านล่างจะช่วยให้คุณปิดใช้การรองรับ APK การกำหนดค่าอย่างน้อย 1 ประเภทได้

ดึงดูด

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 จะพิจารณาว่าจะติดตั้งทรัพยากรภาษาใดพร้อมกับแอปโดยอิงตามการเลือกภาษาในการตั้งค่าอุปกรณ์ของผู้ใช้ ลองนึกถึงผู้ใช้ที่เปลี่ยนภาษาเริ่มต้นของระบบหลังจากดาวน์โหลดแอปของคุณแล้ว หากแอปของคุณรองรับภาษานั้น อุปกรณ์จะขอและดาวน์โหลด APK การกำหนดค่าเพิ่มเติมสำหรับทรัพยากรภาษาเหล่านั้นจาก Google Play

สำหรับแอปที่มีเครื่องมือเลือกภาษาภายในแอปพลิเคชันและเปลี่ยนภาษาของแอปแบบไดนามิกโดยไม่ขึ้นอยู่กับการตั้งค่าภาษาในระดับระบบ คุณต้องทำการเปลี่ยนแปลงบางอย่างเพื่อป้องกันไม่ให้แอปขัดข้องเนื่องจากไม่มีทรัพยากร ตั้งค่าพร็อพเพอร์ตี้ android.bundle.language.enableSplit เป็น false หรือพิจารณาใช้การดาวน์โหลดภาษาแบบออนดีมานด์โดยใช้ไลบรารี Play Core ตามที่อธิบายไว้ในดาวน์โหลดทรัพยากรด้านภาษาเพิ่มเติม