เผยแพร่ App Bundle ให้กับผู้ทดสอบ - Codelab

1. ภาพรวม

รูปภาพ10.png

ใน Codelab นี้ คุณจะได้เรียนรู้วิธีเผยแพร่ Android App Bundle ให้กับผู้ทดสอบโดยใช้ Firebase App Distribution และปลั๊กอิน Gradle App Distribution เป็นศูนย์กลางสำหรับคุณในการจัดการแอปเวอร์ชันก่อนเผยแพร่และผู้ทดสอบที่คุณเชิญให้เข้าร่วมแต่ละรุ่น

สิ่งที่คุณจะได้เรียนรู้

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

สิ่งที่คุณต้องการ

  • เวอร์ชัน Android Studio ล่าสุด
  • ไฟล์บันเดิลที่ลงนามที่คุณสร้างจาก Android Studio
  • บัญชีนักพัฒนาซอฟต์แวร์ Google Play ที่คุณเป็นเจ้าของหรือผู้ดูแลระบบ
  • แอปของคุณใน Google Play ได้ รับการตั้งค่าบนแดชบอร์ดแอป Google Play และมี สถานะ ดังต่อไปนี้
    • แอปนี้เผยแพร่ไปยังหนึ่งในแทร็กของ Google Play (การทดสอบภายใน การทดสอบแบบปิด การทดสอบแบบเปิด หรือเวอร์ชันที่ใช้งานจริง)
    • การตรวจสอบแอปใน Google Play เสร็จสมบูรณ์และเผยแพร่แอปแล้ว แอปของคุณจะได้รับการเผยแพร่หากคอลัมน์ สถานะแอป แสดงสถานะอย่างใดอย่างหนึ่งต่อไปนี้: การทดสอบภายใน (ไม่ใช่การทดสอบภายในฉบับร่าง) การทดสอบแบบปิด การทดสอบแบบเปิด หรือเวอร์ชันที่ใช้งานจริง
  • ที่อยู่อีเมลที่คุณใช้เป็นผู้ทดสอบเพื่อรับคำเชิญสร้างใหม่จาก Firebase

2. สร้างโปรเจ็กต์ Firebase

  1. ลงชื่อเข้าใช้ Firebase
  2. ในคอนโซล Firebase คลิก เพิ่มโครงการ จากนั้นตั้งชื่อโครงการของคุณเป็น "AppBundlesCodelab" จำรหัสโปรเจ็กต์สำหรับโปรเจ็กต์ Firebase ของคุณ หากคุณไม่แก้ไขรหัสโครงการ Firebase จะกำหนดรหัสเฉพาะสำหรับโครงการของคุณโดยอัตโนมัติ

    image8.png
  3. (ไม่บังคับ) เมื่อได้รับแจ้ง ให้เปิดใช้งาน Google Analytics
  4. ทำตามขั้นตอนที่เหลือให้เสร็จสิ้น จากนั้นคลิก สร้างโครงการ

เพิ่ม App Bundle ของคุณไปยังโปรเจ็กต์

  1. ในคอนโซล Firebase คลิก เพิ่มแอป

    image5.png
  2. เมื่อลงทะเบียนแอปของคุณ ตรวจสอบให้แน่ใจว่าใช้ ชื่อแพ็กเกจเดียวกัน กับแอปที่อัปโหลดไปยังบัญชีนักพัฒนาซอฟต์แวร์ Google Play ของคุณ สุดท้ายให้คลิก ลงทะเบียนแอป
  3. ทำตามขั้นตอนที่เหลือเพื่อเพิ่มไฟล์การกำหนดค่า Firebase ของแอป ( google-services.json ) ลงในแอปของคุณ โปรดทราบว่าสำหรับ Android App Distribution ไม่มี Firebase SDK ที่จะเพิ่มลงในแอปของคุณ
  4. คลิก ดำเนินการต่อไปยังคอนโซล
  1. ในคอนโซล Firebase ให้ไปที่ การตั้งค่าโครงการ

    image2.png
  2. ในแท็บ การรวมระบบ คลิก ลิงก์ บนการ์ด Google Play
  3. ปฏิบัติตามคำแนะนำบนหน้าจอเพื่อเปิดใช้งานการผสานรวม App Distribution จากนั้นเลือกแอป Firebase ที่สร้างขึ้นใหม่เพื่อเชื่อมโยงกับ Google Play

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

3. เพิ่ม App Distribution ในโครงการของคุณ

เพิ่มปลั๊กอิน Gradle การกระจายแอป

ตอนนี้ คุณจะใช้ Android Studio เพื่อเพิ่ม App Distribution และปลั๊กอิน Gradle ลงในแอปของคุณ

  1. ในไฟล์ Gradle ระดับโปรเจ็กต์ของคุณ ( android/build.gradle.kts ) ให้เพิ่มปลั๊กอิน App Distribution Gradle ลงในบล็อก plugins
    plugins {
         //...
    
         // Add the App Distribution Gradle plugin
         id("com.google.firebase.appdistribution") version "4.0.0" apply false
    }
    
  2. ในไฟล์ Settings Gradle ระดับโครงการของคุณ ( android/settings.gradle.kts ) ให้เพิ่มพื้นที่เก็บข้อมูล Maven ของ Google ลงในบล็อก pluginManagement
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. ในไฟล์ Gradle ระดับแอปของคุณ ( android/app/build.gradle.kts ) ให้เพิ่มปลั๊กอิน App Distribution ลงในบล็อก plugins
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. หากคุณอยู่หลังพร็อกซีของบริษัทหรือไฟร์วอลล์ ให้เพิ่มคุณสมบัติระบบ Java ต่อไปนี้ที่เปิดใช้งาน App Distribution เพื่ออัปโหลดการแจกจ่ายของคุณไปยัง Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

ตรวจสอบสิทธิ์โครงการ Firebase ของคุณ

ก่อนที่คุณจะสามารถใช้ปลั๊กอิน Gradle ได้ คุณจะต้องตรวจสอบสิทธิ์โปรเจ็กต์ Firebase ของคุณก่อน สำหรับ Codelab นี้ คุณจะต้องลงชื่อเข้าใช้บัญชี Google โดยใช้ Firebase CLI

รันคำสั่งต่อไปนี้ที่รากของโปรเจ็กต์ Android ของคุณ:

~/your-android-project$ firebase login

เอกสารอ้างอิง มีรายละเอียดเพิ่มเติม

4. กำหนดค่าคุณสมบัติบันเดิลของคุณใน Android Studio

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

ใน app/build.gradle.kts ของคุณ ให้เพิ่มส่วน firebaseAppDistribution และรวมพารามิเตอร์ต่อไปนี้:

  • appID : รหัสแอป Firebase ของแอปของคุณ คุณสามารถค้นหาได้ใน แท็บ ทั่วไป ของ การตั้งค่าโครงการ ของคุณ
  • artifactType : ประเภทไฟล์ของแอปของคุณ ( AAB )
  • testers : ที่อยู่อีเมลของผู้ทดสอบของคุณ สำหรับ Codelab นี้ ให้เพิ่มอีเมลของคุณเองเพื่อทดสอบบิวด์เมื่อมีการเผยแพร่แล้ว

ตัวอย่างเช่น:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

นอกจากนี้ คุณยังแทนที่ค่าที่ตั้งไว้ใน build.gradle.kts ได้ด้วยการส่งอาร์กิวเมนต์บรรทัดคำสั่งในรูปแบบของ -PappDistribution- property-name = property-value

5. สร้างและเผยแพร่รุ่น

  1. รันงาน bundle Variant เพื่อสร้างไฟล์ App Bundle:
    $ ./gradlew :base:bundleRelease
    
  2. ค้นหาบันเดิลในไดเรกทอรีบิลด์ของแอปพลิเคชันของคุณ (ตำแหน่งเริ่มต้นคือ app/build/outputs/bundle/release )
  3. หากต้องการเผยแพร่ Release ให้สร้างเป้าหมาย bundleRelease และ appDistributionUploadRelease ด้วย Gradle Wrapper ของโปรเจ็กต์ของคุณ รวมโทเค็น Firebase (โทเค็นที่คุณได้รับในขั้นตอนที่ 3: เพิ่ม App Distribution ไปยังแอปของคุณ)
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

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

6. ดาวน์โหลดและทดสอบรุ่นของคุณ

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

  1. บนอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้บัญชีอีเมลของผู้ทดสอบแล้วเปิดคำเชิญจาก Firebase

    image6.png
  2. ลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณและยอมรับคำเชิญเพื่อทดสอบรุ่นที่เผยแพร่ นอกจากนี้ คุณยังดาวน์โหลด Firebase App Tester ได้อีกด้วย ซึ่งจะป้องกันไม่ให้มีการเพิ่มรุ่นที่ดาวน์โหลดลงในโฟลเดอร์ Downloads ของอุปกรณ์ของคุณ นอกจากนี้ยังแสดงข้อมูลเพิ่มเติมเกี่ยวกับการเผยแพร่ เช่น ความคืบหน้าการดาวน์โหลดและเวอร์ชันการเผยแพร่

    image9.png
  3. แตะ ดาวน์โหลด ในรุ่นเพื่อติดตั้งจาก Play Store
  4. เมื่อได้รับแจ้ง ให้ทำตามขั้นตอนที่เหลือเพื่อเปิดใช้งานการแชร์แอปภายใน (คำแนะนำจะแสดงบนอุปกรณ์ทดสอบของคุณและต้องดำเนินการเพียงครั้งเดียว)

เมื่อการดาวน์โหลดเสร็จสิ้น รุ่นของคุณจะปรากฏเป็นทางลัดในหน้าจอหลักของอุปกรณ์ของคุณโดยอัตโนมัติ

7. ขอแสดงความยินดี!

คุณเพิ่งใช้ Firebase App Distribution เพื่ออัปโหลด App Bundle และเผยแพร่รุ่นให้กับผู้ทดสอบ

ขั้นตอนถัดไป

  • ไปที่ เอกสาร App Distribution เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับวิธีจัดการผู้ทดสอบสำหรับรุ่นของคุณ
  • ดู สร้างและทดสอบ Android App Bundle เพื่อดูข้อมูลเกี่ยวกับเครื่องมืออื่นๆ ที่คุณสามารถใช้เพื่อทำให้แอปใช้งานได้