ภาพรวมของการนำส่งฟีเจอร์ Play

โมเดลการแสดงแอปของ Google Play ใช้ Android App Bundle เพื่อสร้างและแสดง APK ที่เพิ่มประสิทธิภาพสำหรับการกำหนดค่าอุปกรณ์ของผู้ใช้แต่ละราย เพื่อให้ผู้ใช้ดาวน์โหลดเฉพาะโค้ดและทรัพยากรที่จำเป็นในการเรียกใช้แอปของคุณ

การนำส่งฟีเจอร์ Play ใช้ความสามารถขั้นสูงของ App Bundle ซึ่งช่วยให้ นำส่งฟีเจอร์บางอย่างของแอปแบบมีเงื่อนไขหรือดาวน์โหลดตามคำขอได้ โดยคุณต้องแยกฟีเจอร์เหล่านี้ออกจากแอปฐานเป็น โมดูลฟีเจอร์ก่อน

การกำหนดค่าบิลด์ของโมดูลฟีเจอร์

เมื่อสร้างโมดูลฟีเจอร์ใหม่โดยใช้ Android Studio ทาง IDE จะใช้ปลั๊กอิน Gradle ต่อไปนี้กับไฟล์ build.gradle ของโมดูล

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

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

สิ่งที่ไม่ควรระบุในการกำหนดค่าบิลด์ของโมดูลฟีเจอร์

เนื่องจากโมดูลฟีเจอร์แต่ละโมดูลขึ้นอยู่กับโมดูลฐาน โมดูลฟีเจอร์จึง รับค่าการกำหนดค่าบางอย่างด้วย ดังนั้นคุณควรละเว้นรายการต่อไปนี้ในไฟล์ build.gradle ของฟีเจอร์โมดูล

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

สร้างความสัมพันธ์กับโมดูลฐาน

เมื่อ Android Studio สร้างโมดูลฟีเจอร์ ระบบจะทำให้โมดูลดังกล่าวมองเห็นได้ ในโมดูลฐานโดยการเพิ่มพร็อพเพอร์ตี้ android.dynamicFeatures ลงในไฟล์ build.gradle ของโมดูลฐาน ดังที่แสดงด้านล่าง

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

นอกจากนี้ Android Studio ยังรวมโมดูลฐานเป็นทรัพยากร Dependency ของโมดูลฟีเจอร์ด้วย ดังที่แสดงด้านล่าง

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

ระบุกฎ ProGuard เพิ่มเติม

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

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

โปรดทราบว่ากฎ ProGuard เหล่านี้จะผสานรวมกับกฎจากโมดูลอื่นๆ (รวมถึงโมดูลฐาน) ในเวลาที่สร้าง ดังนั้นแม้ว่าโมดูลฟีเจอร์แต่ละโมดูลจะระบุกฎชุดใหม่ แต่กฎเหล่านั้นจะมีผลกับโมดูลทั้งหมดในโปรเจ็กต์แอป

ทําให้แอปใช้งานได้

ขณะพัฒนาแอปที่รองรับโมดูลฟีเจอร์ คุณสามารถ ติดตั้งใช้งานแอปกับอุปกรณ์ที่เชื่อมต่อได้ตามปกติโดยเลือก เรียกใช้ > เรียกใช้จากแถบเมนู (หรือโดยคลิกเรียกใช้ ใน แถบเครื่องมือ)

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

1. เลือกเรียกใช้ > แก้ไขการกำหนดค่าจากแถบเมนู
2. จากแผงด้านซ้ายของกล่องโต้ตอบการกำหนดค่าการเรียกใช้/การแก้ไขข้อบกพร่อง ให้เลือกการกำหนดค่าแอป Android ที่ต้องการ
3. ในส่วนฟีเจอร์แบบไดนามิกที่จะติดตั้งใช้งานในแท็บทั่วไป ให้เลือกช่อง ข้างโมดูลฟีเจอร์แต่ละรายการที่คุณต้องการรวมไว้เมื่อ ติดตั้งใช้งานแอป
4. คลิกตกลง

โดยค่าเริ่มต้น Android Studio จะไม่ใช้ App Bundle ในการติดตั้งใช้งานแอป แต่ IDE จะสร้างและติดตั้ง APK ในอุปกรณ์ที่เพิ่มประสิทธิภาพเพื่อความเร็วในการติดตั้งใช้งานแทนที่จะเป็นขนาด APK หากต้องการกำหนดค่า Android Studio ให้สร้างและติดตั้งใช้งาน APK และประสบการณ์แบบใช้งานได้ทันทีจาก App Bundle แทน ให้แก้ไขการกำหนดค่าการเรียกใช้/การแก้ไขข้อบกพร่อง

ใช้โมดูลฟีเจอร์สำหรับการนำส่งแบบกำหนดเอง

ข้อดีเฉพาะของโมดูลฟีเจอร์คือความสามารถในการปรับแต่งวิธีและเวลา ในการดาวน์โหลดฟีเจอร์ต่างๆ ของแอปไปยังอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป ตัวอย่างเช่น หากต้องการลดขนาดการดาวน์โหลดเริ่มต้นของแอป คุณสามารถกำหนดค่าฟีเจอร์บางอย่างให้ดาวน์โหลดเมื่อจำเป็นตามคำขอ หรือตามอุปกรณ์ที่รองรับความสามารถบางอย่างเท่านั้นก็ได้ เช่น ความสามารถในการถ่ายภาพหรือรองรับฟีเจอร์ความจริงเสริม

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

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

• การเข้าสู่ระบบและการสร้างบัญชี
• การเรียกดู Marketplace
• การวางสินค้าเพื่อขาย
• การประมวลผลการชำระเงิน

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

การสร้าง URI สำหรับทรัพยากร

หากต้องการเข้าถึงทรัพยากรที่จัดเก็บไว้ในฟีเจอร์โมดูลโดยใช้ URI ให้ทำดังนี้เพื่อสร้าง URI ทรัพยากรของฟีเจอร์โมดูลโดยใช้ Uri.Builder()

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

ระบบจะสร้างแต่ละส่วนของเส้นทางไปยังทรัพยากรในขณะรันไทม์ เพื่อให้มั่นใจว่าระบบจะสร้างเนมสเปซที่ถูกต้องหลังจากโหลด APK ที่แยกแล้ว

ตัวอย่างวิธีสร้าง URI สมมติว่าคุณมีแอปและ โมดูลฟีเจอร์ที่มีชื่อต่อไปนี้

• ชื่อแพ็กเกจแอป: com.example.my_app_package
• ชื่อแพ็กเกจทรัพยากรของฟีเจอร์: com.example.my_app_package.my_dynamic_feature

หาก resId ในข้อมูลโค้ดด้านบนอ้างอิงถึงทรัพยากรไฟล์ดิบชื่อ "my_video" ในโมดูลฟีเจอร์ โค้ด Uri.Builder() ด้านบนจะแสดงผลดังนี้

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

จากนั้นแอปจะใช้ URI นี้เพื่อเข้าถึงทรัพยากรของโมดูลฟีเจอร์ได้

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

ข้อควรพิจารณาสําหรับโมดูลฟีเจอร์

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

• การติดตั้งโมดูลฟีเจอร์ 50 รายการขึ้นไปในอุปกรณ์เครื่องเดียวผ่านการนำส่งแบบมีเงื่อนไขหรือแบบออนดีมานด์อาจทำให้เกิดปัญหาด้านประสิทธิภาพ โมดูลที่นำส่งเมื่อติดตั้งซึ่งไม่ได้กำหนดค่าเป็นโมดูลที่นำออกได้จะรวมอยู่ในโมดูลฐานโดยอัตโนมัติ และจะนับเป็นโมดูลฟีเจอร์เพียง 1 โมดูลในแต่ละอุปกรณ์
• จำกัดจำนวนโมดูลที่คุณกำหนดค่าเป็นแบบถอดออกได้สำหรับการนำส่งในเวลาติดตั้งไม่เกิน 10 โมดูล ไม่เช่นนั้น เวลาในการดาวน์โหลดและติดตั้งแอปอาจเพิ่มขึ้น
• เฉพาะอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไปเท่านั้นที่รองรับ การดาวน์โหลดและติดตั้งฟีเจอร์ตามต้องการ หากต้องการให้ฟีเจอร์พร้อมใช้งานใน Android เวอร์ชันก่อนหน้า ให้เปิดใช้การผสานเมื่อสร้างโมดูลฟีเจอร์
• เปิดใช้ SplitCompat เพื่อให้แอปมีสิทธิ์เข้าถึงโมดูลฟีเจอร์ที่ดาวน์โหลดมาซึ่งนำส่งตาม ความต้องการ
• โมดูลฟีเจอร์ไม่ควรกำหนดกิจกรรมในไฟล์ Manifest โดยตั้งค่า android:exported เป็น true เนื่องจากไม่มีการรับประกันว่าอุปกรณ์ ได้ดาวน์โหลดโมดูลฟีเจอร์แล้วเมื่อแอปอื่นพยายามเปิดใช้ กิจกรรม นอกจากนี้ แอปควรยืนยันว่าได้ ดาวน์โหลดฟีเจอร์แล้วก่อนที่จะพยายามเข้าถึงโค้ดและทรัพยากรของฟีเจอร์ ดูข้อมูลเพิ่มเติมได้ที่จัดการโมดูลที่ติดตั้ง
• เนื่องจากการนำส่งฟีเจอร์ Play กำหนดให้คุณต้องเผยแพร่แอปโดยใช้ App Bundle โปรดตรวจสอบว่าคุณทราบปัญหาที่ทราบเกี่ยวกับ App Bundle

ข้อมูลอ้างอิงของไฟล์ Manifest ของโมดูลฟีเจอร์

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

แหล่งข้อมูลเพิ่มเติม

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้โมดูลฟีเจอร์ โปรดดูแหล่งข้อมูลต่อไปนี้

บล็อกโพสต์

• ฟีเจอร์ใหม่ที่จะช่วยคุณพัฒนา เผยแพร่ และทำให้ธุรกิจให้เติบโตใน Google Play
• การอัปเดต Android App Bundle ล่าสุด รวมถึง API ภาษาเพิ่มเติม
• Patchwork Plaid  เรื่องราวของการแยกแอปออกเป็นโมดูลย่อยๆ

วิดีโอ

• การนำส่งที่ปรับแต่งได้ด้วย App Bundle และการแชร์บิลด์ทดสอบที่ง่ายดาย
• เครื่องมือใหม่ในการเพิ่มประสิทธิภาพขนาดแอปและเพิ่มจำนวนการติดตั้งใน Google Play

ข้อกำหนดในการให้บริการและความปลอดภัยของข้อมูล

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

ความปลอดภัยของข้อมูล

คลัง Play Core คืออินเทอร์เฟซรันไทม์ของแอปกับ Google Play Store ดังนั้น เมื่อคุณใช้ Play Core ในแอป Play Store จะเรียกใช้กระบวนการของตัวเอง ซึ่งรวมถึงการจัดการข้อมูลตามที่ระบุไว้ในข้อกำหนดในการให้บริการของ Google Play ข้อมูลด้านล่างอธิบายวิธีที่ไลบรารี Play Core จัดการข้อมูลเพื่อ ประมวลผลคำขอที่เฉพาะเจาะจงจากแอป

API ภาษาเพิ่มเติม

การนำส่งฟีเจอร์ Play

แม้ว่าเราจะมุ่งมั่นที่จะสร้างความโปร่งใสมากที่สุดเท่าที่จะทำได้ แต่คุณมีหน้าที่รับผิดชอบแต่เพียงผู้เดียว ในการตัดสินใจว่าจะตอบกลับแบบฟอร์มส่วนความปลอดภัยของข้อมูลของ Google Play ที่เกี่ยวกับการเก็บรวบรวม การแชร์ และแนวทางปฏิบัติด้านการรักษาความปลอดภัยของข้อมูลผู้ใช้ในแอปอย่างไร