1. ภาพรวม
ใน 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
- ลงชื่อเข้าใช้ Firebase
- ในคอนโซล Firebase คลิก เพิ่มโครงการ จากนั้นตั้งชื่อโครงการของคุณเป็น "AppBundlesCodelab" จำรหัสโปรเจ็กต์สำหรับโปรเจ็กต์ Firebase ของคุณ หากคุณไม่แก้ไขรหัสโครงการ Firebase จะกำหนดรหัสเฉพาะสำหรับโครงการของคุณโดยอัตโนมัติ
- (ไม่บังคับ) เมื่อได้รับแจ้ง ให้เปิดใช้งาน Google Analytics
- ทำตามขั้นตอนที่เหลือให้เสร็จสิ้น จากนั้นคลิก สร้างโครงการ
เพิ่ม App Bundle ของคุณไปยังโปรเจ็กต์
- ในคอนโซล Firebase คลิก เพิ่มแอป
- เมื่อลงทะเบียนแอปของคุณ ตรวจสอบให้แน่ใจว่าใช้ ชื่อแพ็กเกจเดียวกัน กับแอปที่อัปโหลดไปยังบัญชีนักพัฒนาซอฟต์แวร์ Google Play ของคุณ สุดท้ายให้คลิก ลงทะเบียนแอป
- ทำตามขั้นตอนที่เหลือเพื่อเพิ่มไฟล์การกำหนดค่า Firebase ของแอป (
google-services.json
) ลงในแอปของคุณ โปรดทราบว่าสำหรับ Android App Distribution ไม่มี Firebase SDK ที่จะเพิ่มลงในแอปของคุณ - คลิก ดำเนินการต่อไปยังคอนโซล
เชื่อมโยงไปยัง Google Play
- ในคอนโซล Firebase ให้ไปที่ การตั้งค่าโครงการ
- ในแท็บ การรวมระบบ คลิก ลิงก์ บนการ์ด Google Play
- ปฏิบัติตามคำแนะนำบนหน้าจอเพื่อเปิดใช้งานการผสานรวม App Distribution จากนั้นเลือกแอป Firebase ที่สร้างขึ้นใหม่เพื่อเชื่อมโยงกับ Google Play
เมื่อคุณทำตามขั้นตอนเหล่านี้เสร็จแล้ว แอป Firebase ของคุณจะเชื่อมโยงกับแอปของคุณในบัญชีนักพัฒนาซอฟต์แวร์ Google Play ของคุณตราบใดที่ชื่อแพ็คเกจของแอปตรงกัน
3. เพิ่ม App Distribution ในโครงการของคุณ
เพิ่มปลั๊กอิน Gradle การกระจายแอป
ตอนนี้ คุณจะใช้ Android Studio เพื่อเพิ่ม App Distribution และปลั๊กอิน Gradle ลงในแอปของคุณ
- ในไฟล์ 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 }
- ในไฟล์ 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() } }
- ในไฟล์ Gradle ระดับแอปของคุณ (
android/app/build.gradle.kts
) ให้เพิ่มปลั๊กอิน App Distribution ลงในบล็อกplugins
plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- หากคุณอยู่หลังพร็อกซีของบริษัทหรือไฟร์วอลล์ ให้เพิ่มคุณสมบัติระบบ 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. สร้างและเผยแพร่รุ่น
- รันงาน
bundle Variant
เพื่อสร้างไฟล์ App Bundle:$ ./gradlew :base:bundleRelease
- ค้นหาบันเดิลในไดเรกทอรีบิลด์ของแอปพลิเคชันของคุณ (ตำแหน่งเริ่มต้นคือ
app/build/outputs/bundle/release
) - หากต้องการเผยแพร่ 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
- บนอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้บัญชีอีเมลของผู้ทดสอบแล้วเปิดคำเชิญจาก Firebase
- ลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณและยอมรับคำเชิญเพื่อทดสอบรุ่นที่เผยแพร่ นอกจากนี้ คุณยังดาวน์โหลด Firebase App Tester ได้อีกด้วย ซึ่งจะป้องกันไม่ให้มีการเพิ่มรุ่นที่ดาวน์โหลดลงในโฟลเดอร์
Downloads
ของอุปกรณ์ของคุณ นอกจากนี้ยังแสดงข้อมูลเพิ่มเติมเกี่ยวกับการเผยแพร่ เช่น ความคืบหน้าการดาวน์โหลดและเวอร์ชันการเผยแพร่ - แตะ ดาวน์โหลด ในรุ่นเพื่อติดตั้งจาก Play Store
- เมื่อได้รับแจ้ง ให้ทำตามขั้นตอนที่เหลือเพื่อเปิดใช้งานการแชร์แอปภายใน (คำแนะนำจะแสดงบนอุปกรณ์ทดสอบของคุณและต้องดำเนินการเพียงครั้งเดียว)
เมื่อการดาวน์โหลดเสร็จสิ้น รุ่นของคุณจะปรากฏเป็นทางลัดในหน้าจอหลักของอุปกรณ์ของคุณโดยอัตโนมัติ
7. ขอแสดงความยินดี!
คุณเพิ่งใช้ Firebase App Distribution เพื่ออัปโหลด App Bundle และเผยแพร่รุ่นให้กับผู้ทดสอบ
ขั้นตอนถัดไป
- ไปที่ เอกสาร App Distribution เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับวิธีจัดการผู้ทดสอบสำหรับรุ่นของคุณ
- ดู สร้างและทดสอบ Android App Bundle เพื่อดูข้อมูลเกี่ยวกับเครื่องมืออื่นๆ ที่คุณสามารถใช้เพื่อทำให้แอปใช้งานได้