การนำส่งแบบมีเงื่อนไขช่วยให้คุณกำหนดข้อกำหนดการกำหนดค่าอุปกรณ์บางอย่างสำหรับโมดูลฟีเจอร์ที่จะดาวน์โหลดโดยอัตโนมัติระหว่างการติดตั้งแอปได้ เช่น คุณสามารถกำหนดค่าโมดูลฟีเจอร์ที่มีฟังก์ชันการทำงานสำหรับเทคโนโลยีความจริงเสริม (AR) ให้พร้อมใช้งานเมื่อติดตั้งแอปสำหรับอุปกรณ์ที่รองรับ AR เท่านั้น
ปัจจุบันกลไกการนำส่งนี้รองรับการควบคุมการดาวน์โหลดโมดูล ณ เวลาที่ติดตั้งแอปตามการกำหนดค่าอุปกรณ์ต่อไปนี้
- ฟีเจอร์ฮาร์ดแวร์และซอฟต์แวร์ของอุปกรณ์ รวมถึงเวอร์ชัน OpenGL ES
- ประเทศของผู้ใช้
- ระดับ API
- รุ่นอุปกรณ์
- RAM ของอุปกรณ์
- ฟีเจอร์ของระบบ
- ระบบวงจรรวมบนชิป (สำหรับอุปกรณ์ที่มีระดับ API อย่างน้อย 31)
หากอุปกรณ์ไม่เป็นไปตามข้อกำหนดทั้งหมดที่คุณระบุ ระบบจะไม่ดาวน์โหลดโมดูลในเวลาที่ติดตั้งแอป อย่างไรก็ตาม แอปอาจขอดาวน์โหลดโมดูลตามต้องการในภายหลังโดยใช้ Play Core SDK
ก่อนเริ่มต้นใช้งาน โปรดตรวจสอบว่าคุณใช้ Android Studio 3.5 ขึ้นไป ส่วนต่อไปนี้จะแสดงวิธีเพิ่มการรองรับการนำส่งแบบมีเงื่อนไขลงในโมดูลฟีเจอร์
เพิ่มโมดูลใหม่ที่มีตัวเลือกการนำส่งแบบมีเงื่อนไข
วิธีที่ง่ายที่สุดในการสร้างโมดูลฟีเจอร์ใหม่ที่มีการนำส่งแบบมีเงื่อนไขคือการใช้วิซาร์ดโมดูลใหม่ ดังนี้
- หากต้องการเปิดกล่องโต้ตอบโมดูลใหม่ ให้เลือกไฟล์ > ใหม่ > โมดูลใหม่จากแถบเมนู
- ในกล่องโต้ตอบโมดูลใหม่ ให้เลือกโมดูลฟีเจอร์แบบไดนามิก แล้วคลิกถัดไป
- กำหนดค่าโมดูลตามปกติ แล้วคลิกถัดไป
ในส่วนตัวเลือกการดาวน์โหลดโมดูล ให้ทำดังนี้
ระบุชื่อโมดูลโดยใช้อักขระไม่เกิน 50 ตัว แพลตฟอร์มจะใช้ชื่อนี้เพื่อระบุโมดูลให้ผู้ใช้ทราบ เช่น เมื่อยืนยันว่าผู้ใช้ต้องการดาวน์โหลดโมดูลหรือไม่ ด้วยเหตุนี้ โมดูลพื้นฐานของแอปจึงต้องมีชื่อโมดูลเป็นทรัพยากรสตริงที่คุณแปลได้ เมื่อสร้างโมดูลโดยใช้ Android Studio แล้ว IDE จะเพิ่มทรัพยากรสตริงลงในโมดูลพื้นฐานให้คุณ และแทรกรายการต่อไปนี้ในไฟล์ Manifest ของโมดูลฟีเจอร์
<dist:module ... dist:title="@string/feature_title"> </dist:module>ในเมนูแบบเลื่อนลงในส่วนการรวมขณะติดตั้ง ให้เลือกรวมโมดูลเฉพาะเมื่อติดตั้งแอปสำหรับอุปกรณ์ที่มีฟีเจอร์ที่ระบุ ซึ่งจะสร้างโมดูลที่รวมอยู่ในแอปของคุณขณะติดตั้งแอปเฉพาะในอุปกรณ์ที่มีการกำหนดค่าบางอย่างที่คุณระบุได้ เช่น ฟีเจอร์ของอุปกรณ์หรือประเทศ Android Studio จะแทรกข้อมูลต่อไปนี้ในไฟล์ Manifest ของโมดูลเพื่อแสดงตัวเลือกของคุณ
<dist:module ... > <dist:delivery> <dist:install-time> <dist:conditions> <!-- If you specify conditions, as described in the steps below, the IDE includes them here. --> </dist:conditions> </dist:install-time> </dist:delivery> </dist:module>หากต้องการจำกัดการดาวน์โหลดโมดูลโดยอัตโนมัติเฉพาะในบางประเทศหรือระดับ API ขั้นต่ำ ให้คลิกเสร็จสิ้นเพื่อสร้างโมดูลให้เสร็จสมบูรณ์ จากนั้นอ่านส่วนเกี่ยวกับวิธีระบุเงื่อนไขตามประเทศหรือระดับ API ขั้นต่ำ หรือคลิก + ฟีเจอร์ของอุปกรณ์เพื่อเพิ่มฟีเจอร์ที่อุปกรณ์ต้องมีเพื่อดาวน์โหลดโมดูลในเวลาติดตั้ง
ข้าง device-feature ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้จากเมนูแบบเลื่อนลง แล้วระบุค่า
- Name: ช่วยให้คุณระบุฟีเจอร์ฮาร์ดแวร์หรือซอฟต์แวร์ที่อุปกรณ์ต้องมีเพื่อดาวน์โหลดโมดูลในเวลาติดตั้ง ฟีเจอร์ที่การนำส่งแบบมีเงื่อนไขรองรับจะเหมือนกับฟีเจอร์ที่แสดงเป็นค่าคงที่
FEATURE_*โดยPackageManagerหากเลือกตัวเลือกนี้ ให้เริ่มพิมพ์ส่วนใดก็ได้ของค่าคงที่ของฟีเจอร์ เช่น "bluetooth" ในช่องข้างเมนูแบบเลื่อนลง แล้วเลือกคำแนะนำรายการใดรายการหนึ่งที่ปรากฏขึ้น - เวอร์ชัน OpenGL ES: ช่วยให้คุณระบุเวอร์ชัน OpenGL ES ที่อุปกรณ์ต้องใช้เพื่อดาวน์โหลดโมดูล ณ เวลาติดตั้ง หากเลือกตัวเลือกนี้ ให้เริ่มพิมพ์เวอร์ชัน เช่น "0x00030001" ในช่องข้างเมนูแบบเลื่อนลง แล้วเลือกคำแนะนำรายการใดรายการหนึ่งที่ปรากฏขึ้น
- Name: ช่วยให้คุณระบุฟีเจอร์ฮาร์ดแวร์หรือซอฟต์แวร์ที่อุปกรณ์ต้องมีเพื่อดาวน์โหลดโมดูลในเวลาติดตั้ง ฟีเจอร์ที่การนำส่งแบบมีเงื่อนไขรองรับจะเหมือนกับฟีเจอร์ที่แสดงเป็นค่าคงที่
หากต้องการเพิ่มเงื่อนไขหลายรายการตามฟีเจอร์ของอุปกรณ์ที่พร้อมใช้งาน ให้คลิก + ฟีเจอร์ของอุปกรณ์สำหรับเงื่อนไขฟีเจอร์ของอุปกรณ์แต่ละรายการที่ต้องการระบุ
เลือกช่องข้างการรวมหากต้องการให้โมดูลนี้พร้อมใช้งานในอุปกรณ์ที่ใช้ Android 4.4 (ระดับ API 20) และต่ำกว่า และรวมอยู่ใน Multi-APK ซึ่งหมายความว่าคุณสามารถเปิดใช้ลักษณะการทำงานแบบออนดีมานด์สำหรับโมดูลนี้ และปิดใช้การรวมเพื่อละเว้นโมดูลนี้จากอุปกรณ์ที่ไม่รองรับการดาวน์โหลดและติดตั้ง APK แยก Android Studio จะแทรกข้อมูลต่อไปนี้ในไฟล์ Manifest ของโมดูลเพื่อแสดงตัวเลือกของคุณ
<dist:module ...> <dist:fusing dist:include="true | false" /> </dist:module>
เมื่อกำหนดค่าตัวเลือกการดาวน์โหลดโมดูลเสร็จแล้ว ให้คลิกเสร็จสิ้น
โปรดทราบว่าปลั๊กอิน Android Gradle ไม่รองรับการเรียกใช้ lint จากโมดูลฟีเจอร์แบบไดนามิก การเรียกใช้ Lint จากโมดูลแอปพลิเคชันที่เกี่ยวข้องจะเรียกใช้ Lint ในโมดูลฟีเจอร์แบบไดนามิกและรวมปัญหาทั้งหมดไว้ในรายงาน Lint ของแอป
เพิ่มตัวเลือกการนำส่งแบบมีเงื่อนไขลงในโมดูลฟีเจอร์ที่มีอยู่
คุณเพิ่มตัวเลือกการนำส่งแบบมีเงื่อนไขลงในโมดูลฟีเจอร์ที่มีอยู่ได้ผ่านไฟล์ Manifest ของโมดูล อย่างไรก็ตาม คุณควรอ่านเกี่ยวกับความเข้ากันได้ของตัวเลือกการแสดงผลแบบมีเงื่อนไขกับตัวเลือกการแสดงผลอื่นๆ ที่คุณอาจเปิดใช้อยู่แล้วก่อน
ในการเริ่มต้นใช้งาน คุณต้องย้ายข้อมูลไฟล์ Manifest ไปยังองค์ประกอบ <dist:delivery> ใหม่ก่อน ข้อมูลโค้ดด้านล่างแสดงตัวอย่างไวยากรณ์แบบเก่า
<!-- This is the old syntax. -->
<dist:module
dist:title="@string/feature_title" dist:onDemand="true">
<dist:fusing dist:include="true"/>
</dist:module>
ตัวเลือกการแสดงโฆษณาข้างต้นจะระบุไว้ดังนี้
<dist:module
dist:title="@string/feature_title">
<dist:delivery>
<dist:on-demand/>
</dist:delivery>
<dist:fusing dist:include="true"/>
</dist:module>
จากนั้นคุณจะรวมตัวเลือกการนำส่งแบบมีเงื่อนไขตามฟีเจอร์ของอุปกรณ์ได้ดังนี้
<dist:module
dist:title="@string/feature_title">
<dist:delivery>
<dist:on-demand/>
<dist:install-time>
<dist:conditions>
<!-- Requires that the device support AR to download the module at
app install-time. -->
<dist:device-feature dist:name="android.hardware.camera.ar"/>
</dist:conditions>
</dist:install-time>
</dist:delivery>
<dist:fusing dist:include="true"/>
</dist:module>
ส่วนด้านล่างจะกล่าวถึงตัวเลือกอื่นๆ สำหรับการนำส่งแบบมีเงื่อนไข เช่น ตามประเทศหรือระดับ API ขั้นต่ำ
ความเข้ากันได้กับตัวเลือกการดาวน์โหลดโมดูลอื่นๆ
เนื่องจากโมดูลฟีเจอร์มีตัวเลือกมากมายในการกำหนดค่าวิธีนำส่งแต่ละฟีเจอร์ไปยังอุปกรณ์ของผู้ใช้ คุณจึงควรทำความเข้าใจว่าตัวเลือกการนำส่งแบบมีเงื่อนไขได้รับผลกระทบจากการตั้งค่าอื่นๆ อย่างไร ตารางต่อไปนี้สรุปความเข้ากันได้ของการนำส่งแบบมีเงื่อนไขกับตัวเลือกการดาวน์โหลดโมดูลอื่นๆ
| ตัวเลือกการดาวน์โหลดโมดูล | ความเข้ากันได้กับการแสดงโฆษณาแบบมีเงื่อนไข |
|---|---|
กำลังหลอมรวม (<dist:fusing dist:include="true"/>) |
หากโมดูลตั้งค่าตัวเลือกนี้เป็น "จริง" Google Play จะไม่พิจารณาตัวเลือกการนำส่งแบบมีเงื่อนไขที่คุณระบุเมื่อทำให้แอปใช้งานได้ในอุปกรณ์ที่ใช้ API ระดับ 19 หรือต่ำกว่า กล่าวคือ โมดูลฟีเจอร์ที่เปิดใช้การรวมจะรวมอยู่ด้วยเสมอเมื่อติดตั้งสำหรับอุปกรณ์ที่ใช้ระดับ API 19 หรือต่ำกว่า |
เปิดใช้ Instant (<dist:module dist:instant="true"/>) |
โมดูลฟีเจอร์ที่เปิดใช้ Instant ไม่รองรับตัวเลือกการนำส่งแบบมีเงื่อนไข |
ตามความต้องการ (<dist:on-demand/>) |
โดยค่าเริ่มต้น หากคุณระบุตัวเลือกการนำส่งแบบมีเงื่อนไข โมดูลจะพร้อมใช้งานแบบออนดีมานด์ด้วย |
ระบุเงื่อนไขตามประเทศ
นอกจากนี้ การนำส่งแบบมีเงื่อนไขยังช่วยให้คุณระบุประเทศที่ต้องการยกเว้น (หรือรวม) จากการดาวน์โหลดโมดูลในเวลาที่ติดตั้งแอปได้ด้วย การระบุเงื่อนไขนี้อาจเป็นประโยชน์ในกรณีที่โมดูลของคุณใช้วิธีการชำระเงินที่ไม่มีให้บริการในบางภูมิภาค เป็นต้น
ในบริบทนี้ ประเทศของอุปกรณ์มักจะกำหนดโดยที่อยู่สำหรับการเรียกเก็บเงินของผู้ใช้ที่ลงทะเบียนไว้ในบัญชี Google Play
หากต้องการระบุประเทศสำหรับโมดูล ให้ใส่ข้อมูลต่อไปนี้ในไฟล์ Manifest ของโมดูลฟีเจอร์
<dist:conditions>
<!-- Set to "true" to specify countries to exclude from downloading
this module at app install-time. By default, modules are available
for download to all user countries. -->
<dist:user-countries dist:exclude="true">
<!-- Specifies the two-letter CLDR country code for regions that should
not download the module at app install-time. -->
<dist:country dist:code="CN"/>
<dist:country dist:code="HK"/>
</dist:user-countries>
</dist:conditions>
ระบุเงื่อนไขสำหรับระดับ API
การระบุเงื่อนไขตามระดับ API ของอุปกรณ์จะมีประโยชน์ในกรณีที่โมดูลฟีเจอร์ขึ้นอยู่กับ API ที่พร้อมใช้งานในแพลตฟอร์ม Android บางเวอร์ชันเท่านั้น
หากต้องการตั้งค่าเงื่อนไขตามระดับ API ขั้นต่ำหรือสูงสุดของอุปกรณ์ ให้ใส่ข้อมูลต่อไปนี้ในไฟล์ Manifest ของโมดูลฟีเจอร์
<dist:conditions> <!-- Specifies the minimum API level that the device must satisfy in order to download your module at app install-time. The API level you specify must be greater or equal to the module's own minSdkVersion. --> <dist:min-sdk dist:value="21"/> <!-- Specifies the maximum API level that the device cannot exceed in order to download your module at app install-time. The API level you specify must be less than or equal to the module's own maxSdkVersion. --> <dist:max-sdk dist:value="24"/> </dist:conditions>
ระบุเงื่อนไขสำหรับพร็อพเพอร์ตี้อื่นๆ ของอุปกรณ์ (เบต้า)
หากต้องการระบุเงื่อนไขสำหรับพร็อพเพอร์ตี้อื่นๆ ของอุปกรณ์ เช่น ชื่อรุ่น, RAM, ฟีเจอร์ของระบบ และระบบวงจรรวมบนชิป คุณสามารถใช้ไฟล์การกำหนดค่าการกำหนดอุปกรณ์เป้าหมายได้
หากต้องการสร้างไฟล์การกำหนดค่าการกำหนดอุปกรณ์เป้าหมาย โปรดดูเอกสารประกอบสำหรับการกำหนดอุปกรณ์เป้าหมาย
เมื่อสร้างไฟล์การกำหนดค่าแล้ว คุณจะระบุกลุ่มอุปกรณ์สำหรับโมดูลได้โดยใส่ข้อมูลต่อไปนี้ในไฟล์ Manifest ของโมดูลฟีเจอร์
<dist:conditions>
<dist:device-groups>
<dist:device-group dist:name="myCustomGroup1"/>
<dist:device-group dist:name="myCustomGroup2"/>
</dist:device-groups>
</dist:conditions>