แจกจ่ายชุดแอปให้กับผู้ทดสอบ - Codelab

1. ภาพรวม

image10.png

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

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

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

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

  • Android Studio v4.0+
  • ไฟล์บันเดิลที่ลงนามซึ่งคุณสร้างจาก 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 การแจกจ่ายแอปไม่มี Firebase SDK ที่จะเพิ่มลงในแอปของคุณ
  4. คลิก ดำเนินการต่อเพื่อคอนโซล
  1. ในคอนโซล Firebase ให้ไปที่ การตั้งค่าโปรเจ็ กต์ของคุณ

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

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

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

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

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

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

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

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

  1. เรียกใช้คำสั่งต่อไปนี้ที่รูทของโปรเจ็กต์ Android ของคุณ:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. เมื่อคำสั่งพิมพ์ลิงก์การตรวจสอบสิทธิ์ ให้เปิดในเบราว์เซอร์ เมื่อได้รับแจ้ง ให้ลงชื่อเข้าใช้บัญชี Google และให้สิทธิ์เข้าถึงโปรเจ็กต์ Firebase คำสั่ง Gradle พิมพ์โทเค็นการรีเฟรช ซึ่งปลั๊กอิน App Distribution ใช้สำหรับตรวจสอบสิทธิ์กับ Firebase
  3. ตั้งค่าตัวแปรสภาพแวดล้อม FIREBASE_TOKEN เป็นโทเค็นจากขั้นตอนก่อนหน้า:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

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

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

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

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

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

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

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

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

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