แจกจ่ายชุดแอปให้กับผู้ทดสอบ - 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 ให้คลิก เพิ่มแอป

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

    รูปภาพ2.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 ) ให้เพิ่มปลั๊กอิน 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 ) ให้เพิ่มปลั๊กอินการกระจายแอปลงในบล็อก 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 Gradle เพื่อสร้างไฟล์ App Bundle ของคุณ:
    $ ./gradlew :base:bundleRelease
  2. ค้นหาบันเดิลในไดเรกทอรีบิลด์ของแอปพลิเคชันของคุณ (ตำแหน่งเริ่มต้นคือ app/build/outputs/bundle/release )
  3. หากต้องการแจกจ่ายรุ่น ให้สร้างเป้าหมาย 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

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

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

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

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

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

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

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

7. ยินดีด้วย!

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

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

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