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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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