bundletool

bundletool เป็นเครื่องมือพื้นฐานที่ Android Studio, ปลั๊กอิน Android Gradle และ Google Play ใช้เพื่อสร้าง Android App Bundle bundletool สามารถแปลง App Bundle เป็น APK ต่างๆ ที่ติดตั้งใช้งานในอุปกรณ์ได้

Android SDK Bundle (ASB) และ APK ของ ASB สร้างขึ้นด้วย bundletool นอกจากนี้ ยังมีให้บริการเป็นเครื่องมือบรรทัดคำสั่งด้วย คุณจึงสร้าง App Bundle และ SDK Bundle ด้วยตนเอง และสร้าง APK ของแอปหรือ APK ของ SDK ที่เปิดใช้รันไทม์ที่ Google Play สร้างฝั่งเซิร์ฟเวอร์ขึ้นมาใหม่ได้

ดาวน์โหลดภาษาbundletool

หากยังไม่ได้ดาวน์โหลด ให้ดาวน์โหลด bundletool จาก ที่เก็บ GitHub

สร้างและทดสอบ App Bundle

คุณใช้ Android Studio หรือbundletoolเครื่องมือบรรทัดคำสั่งเพื่อสร้าง Android App Bundle แล้วทดสอบการสร้าง APK จาก App Bundle นี้ได้

สร้าง App Bundle

ใช้ Android Studio และปลั๊กอิน Android Gradle เพื่อสร้างและลงนามใน Android App Bundle อย่างไรก็ตาม หากใช้ IDE ไม่ได้ เช่น เนื่องจากคุณใช้เซิร์ฟเวอร์บิลด์ต่อเนื่อง คุณก็สร้าง App Bundle จากบรรทัดคำสั่งและลงนามโดยใช้ jarsigner ได้เช่นกัน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้าง App Bundle ด้วย bundletool ได้ที่ สร้าง App Bundle โดยใช้ Bundletool

สร้างชุด APK จาก App Bundle

หลังจากสร้าง Android App Bundle แล้ว ให้ทดสอบวิธีที่ Google Play ใช้เพื่อสร้าง APK และลักษณะการทำงานของ APK เหล่านั้นเมื่อนำไปใช้งานในอุปกรณ์

คุณทดสอบ App Bundle ได้ 2 วิธีดังนี้

• ใช้bundletoolเครื่องมือบรรทัดคำสั่งในเครื่อง
• อัปโหลด Bundle ไปยัง Play Console ผ่าน Google Play โดยใช้แทร็กการทดสอบ

ส่วนนี้จะอธิบายวิธีใช้ bundletool เพื่อทดสอบ App Bundle ในเครื่อง

เมื่อ bundletool สร้าง APK จาก App Bundle ของคุณ ระบบจะรวม APK ที่สร้างขึ้นไว้ในคอนเทนเนอร์ที่เรียกว่าที่เก็บถาวรของชุด APK ซึ่งใช้ส่วนขยายไฟล์ .apks หากต้องการสร้างชุด APK สำหรับการกำหนดค่าอุปกรณ์ทั้งหมดที่แอปของคุณ รองรับจาก App Bundle ให้ใช้คำสั่ง bundletool build-apks ดังที่แสดง

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

หากต้องการติดตั้ง APK ในอุปกรณ์ คุณต้องระบุ ข้อมูลการลงนามของแอปด้วย ดังที่แสดงในคำสั่งต่อไปนี้ หากคุณไม่ได้ระบุข้อมูลการลงนาม bundletool จะพยายามลงนาม APK ด้วยคีย์การแก้ไขข้อบกพร่อง ให้คุณ

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks
--ks=/MyApp/keystore.jks
--ks-pass=file:/MyApp/keystore.pwd
--ks-key-alias=MyKeyAlias
--key-pass=file:/MyApp/key.pwd

ตารางต่อไปนี้อธิบายรายละเอียดเพิ่มเติมเกี่ยวกับแฟล็กและตัวเลือกต่างๆ ที่คุณตั้งค่าได้เมื่อ ใช้คำสั่ง bundletool build-apks

ตารางที่ 1 ตัวเลือกสำหรับคำสั่ง bundletool build-apks

นำ APK ไปใช้ในอุปกรณ์ที่เชื่อมต่อ

หลังจากสร้างชุด APK แล้ว bundletool จะสามารถติดตั้งใช้งานชุดค่าผสม APK ที่ถูกต้องจากชุดนั้นไปยังอุปกรณ์ที่เชื่อมต่อได้

เช่น หากคุณมีอุปกรณ์ที่เชื่อมต่อซึ่งใช้ Android 5.0 (API ระดับ 21) ขึ้นไป bundletool จะพุช APK พื้นฐาน, APK โมดูลฟีเจอร์ และ APK การกำหนดค่าที่จำเป็นต่อการเรียกใช้แอปในอุปกรณ์นั้น หรือหากอุปกรณ์ที่เชื่อมต่อใช้ Android 4.4 (API ระดับ 20) หรือต่ำกว่า bundletool จะค้นหา APK หลายรายการที่เข้ากันได้เพื่อติดตั้งใช้งานในอุปกรณ์

หากต้องการทําให้แอปใช้งานได้จากชุด APK ให้ใช้คําสั่ง install-apks และระบุ เส้นทางของชุด APK โดยใช้ แฟล็ก --apks=/path/to/apks ดังที่แสดงในคําสั่งต่อไปนี้ หากคุณเชื่อมต่ออุปกรณ์หลายเครื่อง ให้ระบุอุปกรณ์เป้าหมายโดยเพิ่มแฟล็ก --device-id=serial-id

bundletool install-apks --apks=/MyApp/my_app.apks

สร้างชุด APK เฉพาะอุปกรณ์

หากไม่ต้องการสร้างชุด APK สำหรับการกำหนดค่าอุปกรณ์ทั้งหมดที่แอป รองรับ คุณสามารถสร้าง APK ที่กำหนดเป้าหมายเป็นการกำหนดค่าของอุปกรณ์ที่เชื่อมต่อเท่านั้น โดยใช้ตัวเลือก --connected-device ดังที่แสดงในคำสั่งต่อไปนี้ หากเชื่อมต่ออุปกรณ์หลายเครื่อง ให้ระบุอุปกรณ์เป้าหมายโดยใส่--device-id=serial-idแฟล็ก

bundletool build-apks --connected-device
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

สร้างและใช้ไฟล์ JSON ของข้อกำหนดอุปกรณ์

bundletool สามารถสร้างชุด APK ที่กำหนดเป้าหมายเป็นอุปกรณ์ ที่กำหนดค่าโดยใช้ไฟล์ JSON หากต้องการสร้างไฟล์ JSON สำหรับ อุปกรณ์ที่เชื่อมต่อเป็นครั้งแรก ให้เรียกใช้คำสั่งต่อไปนี้

bundletool get-device-spec --output=/tmp/device-spec.json

bundletool จะสร้างไฟล์ JSON สำหรับอุปกรณ์ของคุณในไดเรกทอรีของเครื่องมือ จากนั้นคุณจะส่งไฟล์ไปยัง bundletool เพื่อสร้างชุด APK ที่กำหนดเป้าหมายเฉพาะการกำหนดค่าที่อธิบายไว้ในไฟล์ JSON นั้นได้ ดังนี้

bundletool build-apks --device-spec=/MyApp/pixel2.json
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

สร้าง JSON ของข้อกำหนดอุปกรณ์ด้วยตนเอง

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

{
  "supportedAbis": ["arm64-v8a", "armeabi-v7a"],
  "supportedLocales": ["en", "fr"],
  "screenDensity": 640,
  "sdkVersion": 27
}

จากนั้นคุณจะส่ง JSON นี้ไปยังคำสั่ง bundle extract-apks ได้ตามที่อธิบายไว้ ในส่วนก่อนหน้า

แยก APK เฉพาะอุปกรณ์จากชุด APK ที่มีอยู่

หากมีชุด APK อยู่แล้วและต้องการแยกชุดย่อยของ APK ออกจากชุด APK นั้น ซึ่งกำหนดเป้าหมายเป็นการกำหนดค่าอุปกรณ์ที่เฉพาะเจาะจง คุณสามารถใช้คำสั่ง extract-apks และระบุ JSON ของข้อกำหนดอุปกรณ์ได้ดังนี้

bundletool extract-apks
--apks=/MyApp/my_existing_APK_set.apks
--output-dir=/MyApp/my_pixel2_APK_set.apks
--device-spec=/MyApp/bundletool/pixel2.json

วัดขนาดการดาวน์โหลดโดยประมาณของ APK ในชุด APK

หากต้องการวัดขนาดการดาวน์โหลดโดยประมาณของ APK ในชุด APK ตามที่จะแสดงแบบบีบอัดผ่านสาย ให้ใช้คำสั่ง get-size total

bundletool get-size total --apks=/MyApp/my_app.apks

คุณสามารถแก้ไขลักษณะการทำงานของคำสั่ง get-size total ได้โดยใช้แฟล็กต่อไปนี้

ตารางที่ 2 ตัวเลือกสำหรับคำสั่ง get-size total

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ bundletool ได้ที่วิดีโอ App Bundle: การทดสอบ Bundle ด้วย Bundletool และ Play Console