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