แจกจ่ายรุ่น App Bundle ให้กับผู้ทดสอบ - Codelab

1. ภาพรวม

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

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

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

สิ่งที่ต้องมี

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

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

1. ลงชื่อเข้าใช้ Firebase
2. ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์ แล้วตั้งชื่อโปรเจ็กต์ของคุณว่า "AppBundlesCodelab" จำรหัสโปรเจ็กต์สําหรับโปรเจ็กต์ Firebase หากคุณไม่ได้แก้ไขรหัสโปรเจ็กต์ Firebase จะกำหนดรหัสที่ไม่ซ้ำกันให้กับโปรเจ็กต์ของคุณโดยอัตโนมัติ
   
   
3. (ไม่บังคับ) เปิดใช้ Google Analytics เมื่อมีข้อความแจ้ง
4. ทำตามขั้นตอนที่เหลือให้เสร็จ แล้วคลิกสร้างโปรเจ็กต์

เพิ่ม App Bundle ลงในโปรเจ็กต์

1. ในคอนโซล Firebase ให้คลิกเพิ่มแอป
   
   
2. เมื่อลงทะเบียนแอป ให้ตรวจสอบว่าใช้ชื่อแพ็กเกจเดียวกันกับแอปที่อัปโหลดไปยังบัญชีนักพัฒนาแอป Google Play

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

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

ลิงก์กับ Google Play

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

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

3. เพิ่ม App Distribution ลงในโปรเจ็กต์

เพิ่มปลั๊กอิน 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. ในไฟล์ 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 = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

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

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

1. เรียกใช้งาน Gradle เวอร์ชัน bundleVariant เพื่อสร้างไฟล์ App Bundle

   $ ./gradlew :base:bundleRelease
   

2. ค้นหาแพ็กเกจในไดเรกทอรีบิลด์ของแอปพลิเคชัน (ตำแหน่งเริ่มต้นคือ app/build/outputs/bundle/release)
3. หากต้องการเผยแพร่รุ่น ให้สร้างเป้าหมาย bundleRelease และ appDistributionUploadRelease ด้วย Wrapper ของ Gradle ของโปรเจ็กต์ ใส่โทเค็น 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
   
   
2. ลงชื่อเข้าใช้ด้วยบัญชี Google และยอมรับคําเชิญให้ทดสอบรุ่นที่เผยแพร่ คุณยังเลือกดาวน์โหลด Firebase App Tester เพื่อป้องกันไม่ให้มีการเพิ่มรุ่นที่ดาวน์โหลดไว้ในโฟลเดอร์ Downloads ของอุปกรณ์ได้อีกด้วย นอกจากนี้ยังแสดงข้อมูลเพิ่มเติมเกี่ยวกับรุ่นต่างๆ ด้วย เช่น ความคืบหน้าของการดาวน์โหลดและเวอร์ชันของรุ่น
   
   
3. แตะดาวน์โหลดในรุ่นเพื่อติดตั้งจาก Play Store
4. เมื่อได้รับข้อความแจ้ง ให้ทำตามขั้นตอนที่เหลือเพื่อเปิดใช้การแชร์แอปภายใน (วิธีการจะแสดงบนอุปกรณ์ทดสอบและคุณต้องดำเนินการเพียงครั้งเดียวเท่านั้น)

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

7. ยินดีด้วย

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

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

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