แจกจ่ายแอป Android ให้กับผู้ทดสอบโดยใช้ Firebase CLI

APK AAB

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

ก่อนจะเริ่ม

หากคุณยังไม่ได้ เพิ่ม Firebase ในโครงการ Android ของคุณ

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

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

ขั้นตอนที่ 1. สร้างแอปของคุณ

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

ขั้นตอนที่ 2 แจกจ่ายแอปของคุณให้กับผู้ทดสอบ

หากต้องการเผยแพร่แอปของคุณให้กับผู้ทดสอบ ให้อัปโหลดไฟล์ของแอปโดยใช้ Firebase CLI:

1. ติดตั้งหรืออัปเดตเป็นเวอร์ชันล่าสุดของ Firebase CLI (เราแนะนำให้ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI เฉพาะสำหรับระบบปฏิบัติการของคุณ) อย่าลืม ลงชื่อเข้าใช้ และทดสอบว่าคุณสามารถเข้าถึงโครงการของคุณได้
   หมายเหตุ: หากคุณใช้ Firebase CLI ในสภาพแวดล้อม CI คุณยังสามารถตรวจสอบสิทธิ์ด้วย บัญชีบริการ หรือโดยใช้ login:ci
2. ใน หน้าการแจกจ่ายแอป ของคอนโซล Firebase เลือกแอปที่คุณต้องการแจกจ่าย จากนั้นคลิก เริ่มต้น ใช้งาน

3. เรียกใช้คำสั่ง appdistribution:distribute เพื่ออัปโหลดแอปของคุณและแจกจ่ายให้กับผู้ทดสอบ ใช้พารามิเตอร์ต่อไปนี้เพื่อกำหนดค่าการกระจาย:

   appdistribution:กระจายตัวเลือก
   --app	จำเป็น : รหัสแอป Firebase ของแอปของคุณ คุณสามารถค้นหา App ID ได้ในคอนโซล Firebase ใน หน้าการตั้งค่าทั่วไป --app 1:1234567890:android:0a1b2c3d4e5f67890
   --token	โทเค็นการรีเฟรชที่พิมพ์เมื่อคุณตรวจสอบสิทธิ์สภาพแวดล้อม CI ด้วย Firebase CLI (อ่าน ใช้ CLI กับระบบ CI สำหรับข้อมูลเพิ่มเติม) --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	บันทึกประจำรุ่นสำหรับบิลด์นี้ คุณสามารถระบุบันทึกประจำรุ่นได้โดยตรง: --release-notes "Text of release notes" หรือระบุเส้นทางไปยังไฟล์ข้อความธรรมดา: --release-notes-file "/path/to/release-notes.txt"
   --testers --testers-file	ที่อยู่อีเมลของผู้ทดสอบที่คุณต้องการเชิญ คุณสามารถระบุผู้ทดสอบเป็นรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาคได้: --testers "[e-mail], [e-mail], [e-mail]" หรือคุณสามารถระบุเส้นทางไปยังไฟล์ข้อความธรรมดาที่มีรายการที่อยู่อีเมลที่คั่นด้วยเครื่องหมายจุลภาค: --testers-file "/path/to/testers.txt"
   --groups --groups-file	กลุ่มผู้ทดสอบที่คุณต้องการเชิญ (ดูที่ จัดการผู้ทดสอบ ) ระบุกลุ่มโดยใช้ นามแฝงกลุ่ม ซึ่งคุณสามารถค้นหาได้ในคอนโซล Firebase คุณสามารถระบุกลุ่มเป็นรายการที่คั่นด้วยเครื่องหมายจุลภาค: --groups "qa-team, trusted-testers" หรือคุณสามารถระบุพาธไปยังไฟล์ข้อความธรรมดาที่มีรายชื่อกลุ่มที่คั่นด้วยเครื่องหมายจุลภาค: --groups-file "/path/to/groups.txt"
   --debug	แฟล็กที่คุณสามารถรวมไว้เพื่อพิมพ์เอาต์พุตบันทึกแบบละเอียด

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

   firebase appdistribution:distribute test.apk  \
       --app 1:1234567890:android:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt
   

   นอกจากการแจกจ่ายรุ่นต่างๆ คุณยังสามารถใช้ appdistribution:testers:add และ appdistribution:testers:remove เพื่อเชิญผู้ทดสอบใหม่หรือนำผู้ทดสอบที่มีอยู่ออกจากโปรเจ็กต์ Firebase เมื่อเพิ่มผู้ทดสอบลงในโปรเจ็กต์ Firebase แล้ว คุณจะเพิ่มผู้ทดสอบลงในแต่ละรุ่นได้ เมื่อคุณนำผู้ทดสอบออกแล้ว พวกเขาจะไม่มีสิทธิ์เข้าถึงรุ่นต่างๆ ในโปรเจ็กต์ของคุณอีกต่อไป โปรดทราบว่าผู้ทดสอบที่เพิ่งลบออกจะยังสามารถเข้าถึงรุ่นของคุณต่อไปได้ในช่วงเวลาหนึ่ง

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

   firebase appdistribution:testers:add [e-mail] [e-mail]
   
   firebase appdistribution:testers:remove [e-mail] [e-mail]
   

   อีเมลผู้ทดสอบต้องคั่นด้วยช่องว่าง คุณยังสามารถระบุผู้ทดสอบโดยใช้ --file /path/to/testers.txt

เมื่อคุณเผยแพร่บิลด์ บิลด์จะพร้อมใช้งานในแดชบอร์ดการแจกจ่ายแอปของคอนโซล Firebase เป็นเวลา 150 วัน (5 เดือน) เมื่อบิลด์มีอายุ 30 วันนับจากหมดอายุ การแจ้งการหมดอายุจะปรากฏในคอนโซลและรายการบิลด์ของผู้ทดสอบในอุปกรณ์ทดสอบ

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

ผู้ทดสอบมีเวลา 30 วันในการยอมรับคำเชิญให้ทดสอบแอปก่อนที่จะหมดอายุ เมื่อคำเชิญหมดอายุ 5 วัน การแจ้งการหมดอายุจะปรากฏในคอนโซล Firebase ถัดจากผู้ทดสอบในรุ่น สามารถต่ออายุคำเชิญได้โดยส่งใหม่โดยใช้เมนูแบบเลื่อนลงในแถวผู้ทดสอบ