หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการแจกจ่ายและทดสอบแอปด้วย App Distribution
การกระจายแอพ
ใช้เคล็ดลับต่อไปนี้เพื่อแก้ไขปัญหาที่คุณอาจพบเมื่อแจกจ่ายแอปให้กับผู้ทดสอบของคุณ
เมื่ออัปโหลดแอป คุณอาจพบข้อผิดพลาดนี้:
"เราไม่พบอีเมลติดต่อสำหรับแอป <app-id>
โปรดไปที่ App Distribution ภายในคอนโซล Firebase เพื่อตั้งค่า"
ตั้งค่าอีเมลติดต่อในคอนโซล Firebase ถ้ามี หากปัญหายังคงอยู่ โปรดติดต่อ ฝ่ายสนับสนุนของ Firebase
หากคุณพบข้อผิดพลาด 400, 409 หรือ 500 ซ้ำๆ ในระหว่างการจัดเตรียม โปรดติดต่อ Firebase Support ให้การสนับสนุนด้วยหมายเลขโปรเจ็กต์ Firebase และตัวระบุแอป
ต่อไปนี้คือตัวอย่างการตอบสนองของเครือข่ายเบราว์เซอร์:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
เมื่อต้องการแก้ไขปัญหานี้ ให้ทำตามขั้นตอนเหล่านี้:
ตรวจสอบขนาดของ IPA ขีดจำกัดขนาดไฟล์สูงสุดสำหรับไบนารีทั้งหมดคือ 2048 MiB ซึ่งมากกว่า 2 GB เล็กน้อย
หากขนาด IPA อยู่ภายในขีดจำกัดขนาดไฟล์และสามารถทำซ้ำได้ ให้ทำตามขั้นตอนเหล่านี้:
ตรวจสอบไฟล์
Info.plist
ของคุณและยืนยันว่าCFBundleDisplayName
มีตัวคั่น<array>
ใดๆ หรือไม่ลบตัวคั่น
<array>
และสร้างแอปของคุณใหม่ การอัปโหลดควรสำเร็จหากคุณยังคงประสบปัญหา โปรดติดต่อ ฝ่ายสนับสนุน Firebase
หากขนาด IPA เกินขีดจำกัดขนาดไฟล์ ให้ทำการเปลี่ยนแปลงที่จำเป็นเพื่อลดขนาดไฟล์
หากการลดขนาดไฟล์ IPA ไม่สามารถแก้ปัญหาได้ โปรดติดต่อ Firebase Support และสอบถามเกี่ยวกับการใช้ Testflight
การติดตั้งและทดสอบแอป
ใช้เคล็ดลับต่อไปนี้เพื่อแก้ไขปัญหาที่ผู้ทดสอบของคุณอาจพบเมื่อติดตั้งและทดสอบแอปของคุณ
เมื่อผู้ใช้สร้างบัญชี Google ผู้ใช้จะได้รับที่อยู่ Gmail โดยอัตโนมัติ
หากผู้ทดสอบไม่มีที่อยู่ Google Workspace หรือ Gmail หรือต้องการใช้ที่อยู่อีเมลอื่นในการลงชื่อเข้าใช้ ขอให้ผู้ทดสอบเชื่อมโยงที่อยู่อีเมลที่ไม่ใช่ Gmail กับบัญชีและใช้อีเมลนั้นในการลงชื่อเข้าใช้
เมื่อเลือกอีเมลสำรอง ผู้ทดสอบต้องปฏิบัติตามหลักเกณฑ์เหล่านี้:
- อย่าใช้ที่อยู่ Gmail
- อย่าใช้ที่อยู่อีเมลที่เชื่อมโยงกับบัญชี Google อื่นแล้ว
- อย่าลืมใช้รหัสผ่านบัญชี Google ของคุณเมื่อลงชื่อเข้าใช้ด้วยที่อยู่อีเมลนี้
สำหรับข้อมูลเพิ่มเติม โปรดดู ลงชื่อเข้าใช้บัญชี Google ของคุณด้วยที่อยู่อีเมลอื่น
หากผู้ทดสอบยอมรับคำเชิญทางอีเมลที่มีที่อยู่อีเมลอื่นนอกเหนือจากที่ส่งคำเชิญ ผู้ทดสอบอาจไม่เห็นแอปหรือรุ่นที่ถูกต้อง
อีเมลที่ผู้พัฒนาส่งคำเชิญและเพิ่มไปยังรุ่นสร้างใหม่ (อีเมล A) อาจแตกต่างจากอีเมลที่ผู้ทดสอบใช้เพื่อตอบรับคำเชิญ (อีเมล B) สิ่งนี้สร้างการเชื่อมโยงเบื้องหลัง เมื่อใดก็ตามที่อีเมล A ถูกเพิ่มในบิลด์ใหม่ อีเมล B ที่ได้รับการเข้าถึงจริงๆ
หากผู้ทดสอบยอมรับคำเชิญทางอีเมลที่มีที่อยู่อีเมลอื่น ให้ทำตามขั้นตอนเหล่านี้เพื่อแก้ไขปัญหา:
ลบผู้ทดสอบออกจากส่วน ดูผู้ทดสอบทั้งหมด ของแท็บ ผู้ทดสอบและกลุ่ม ในหน้าการกระจายแอปของคอนโซล Firebase คำเชิญที่มีอยู่จะถูกลบออก
เชิญผู้ทดสอบอีกครั้งเพื่อทดสอบแอปของคุณ ผู้ทดสอบควรได้รับอีเมลคำเชิญ
ตรวจสอบให้แน่ใจว่าผู้ทดสอบยอมรับคำเชิญที่ใช้ที่อยู่อีเมลเดียวกัน
ผู้ทดสอบอาจไม่ได้รับการแจ้งเตือนทางอีเมลหากเกิดเหตุการณ์ต่อไปนี้:
การแจ้งเตือนทางอีเมลจะถูกส่งไปยังโฟลเดอร์สแปม
ตั้งค่าตัวกรองอีเมลแล้ว
คำเชิญถูกส่งไปยังบัญชีอีเมลหนึ่ง แต่ผู้ทดสอบตอบรับด้วยบัญชีอีเมลอื่น ผู้ทดสอบจะได้รับอีเมลรุ่นใหม่สำหรับบัญชีอีเมลที่ส่งคำเชิญไปในตอนแรก
ผู้ทดสอบได้รับเชิญก่อนหน้านี้ แต่ไม่ยอมรับคำเชิญครั้งแรก หากมีการเพิ่มผู้ทดสอบลงในรุ่นที่ตามมา การกระจายแอปจะไม่ส่งการแจ้งเตือนการเผยแพร่ไปยังผู้ทดสอบนั้นโดยอัตโนมัติ เนื่องจากผู้ทดสอบไม่ยอมรับคำเชิญครั้งแรก
วิธีแก้ปัญหา 1
ขอให้ผู้ทดสอบตรวจสอบโฟลเดอร์สแปมและตัวกรองอีเมลที่ตั้งค่าไว้ในบริการอีเมล
หากผู้ทดสอบยกเลิกการสมัครรับอีเมล ขอให้ผู้ทดสอบดำเนินการดังต่อไปนี้:
- ค้นหาอีเมลที่ผู้ทดสอบได้รับจากแอปก่อนหน้านี้
- คลิก จัดการการตั้งค่าอีเมล ที่ด้านล่าง แล้วคลิก อนุญาตให้สมัครรับอีเมล อีกครั้ง
โซลูชันที่ 2
ลบผู้ทดสอบออกจากส่วน ดูผู้ทดสอบทั้งหมด ของแท็ บผู้ทดสอบและกลุ่ม ในหน้าการกระจายแอปในคอนโซล Firebase การดำเนินการนี้จะลบคำเชิญที่มีอยู่
เชิญผู้ทดสอบอีกครั้งเพื่อทดสอบแอปของคุณ ผู้ทดสอบควรได้รับอีเมลคำเชิญ ตรวจสอบให้แน่ใจว่าผู้ทดสอบยอมรับคำเชิญที่ใช้ที่อยู่อีเมลเดียวกันกับที่ส่งคำเชิญไป
ข้อผิดพลาด Untrusted Enterprise Developer จะปรากฏขึ้นหากคุณไม่เชื่อถือใบรับรองของนักพัฒนาในอุปกรณ์ทดสอบก่อนที่จะเปิดแอป ในแอป การตั้งค่า > หน้าจอ โปรไฟล์และการจัดการอุปกรณ์ เลือกชื่อนักพัฒนาของแอปและเชื่อถือ
ข้อผิดพลาด "ต้องใช้โหมดนักพัฒนาซอฟต์แวร์" ปรากฏขึ้นเมื่อคุณพยายามเปิดแอป iOS ที่จัดเตรียมเฉพาะกิจบน iOS 16 หรือใหม่กว่าโดยไม่ได้เปิดใช้งานโหมดนักพัฒนาซอฟต์แวร์ก่อน
หากต้องการเปิดใช้งานโหมดนักพัฒนาซอฟต์แวร์และแก้ไขข้อผิดพลาดนี้ ให้ทำตามขั้นตอนเหล่านี้:
- บน iPhone ให้เปิดแอปการตั้งค่า จากนั้นแตะ ความเป็นส่วนตัวและความปลอดภัย
- เลื่อนลงไปที่ความปลอดภัย แล้วแตะ โหมดนักพัฒนาซอฟต์แวร์
- แตะแถบเลื่อน โหมดนักพัฒนาซอฟต์แวร์
- แตะ เริ่มต้นใหม่
- หลังจากรีสตาร์ทอุปกรณ์แล้ว ให้ปลดล็อกอุปกรณ์ เปิดโหมดนักพัฒนาซอฟต์แวร์? กล่องโต้ตอบปรากฏขึ้น
- แตะ เปิด ตอนนี้คุณสามารถเปิดแอปและเริ่มการทดสอบได้แล้ว
หากคุณกำลังติดตั้งการกระจายแบบเฉพาะกิจ ข้อความนี้จะปรากฏขึ้นเมื่อผู้พัฒนายังไม่ได้กำหนดค่าแอปให้ทำงานบนอุปกรณ์ทดสอบของคุณ ในการทำให้แอปพร้อมใช้งานสำหรับคุณ ผู้พัฒนาต้องทำตามคำแนะนำใน ลงทะเบียนอุปกรณ์เพิ่มเติม
หากบัญชี Google ของคุณไม่มีสิทธิ์เข้าถึงแอปทดสอบที่คุณติดตั้งไว้ก่อนหน้านี้ (หรือตอบรับคำเชิญ) เป็นไปได้ว่าคุณลงชื่อเข้าใช้บัญชี Google ผิดบัญชี แอปที่คุณมีสิทธิ์เข้าถึงจะเชื่อมโยงกับบัญชี Google ที่คุณใช้เมื่อคุณตอบรับคำเชิญให้ทดสอบแอปในครั้งแรก ลองอีกครั้งโดยลงชื่อเข้าใช้ด้วยบัญชี Google ที่คุณเคยใช้ตอบรับคำเชิญ
เมื่อคุณพบข้อผิดพลาด 403 หมายความว่าบัญชีที่คุณใช้ไม่ได้รับอนุญาตให้ติดตั้งและทดสอบแอป การเข้าถึงจะกำหนดโดยผู้ดูแลระบบของโดเมนบัญชีของคุณใน Google Workspace
หากคุณเชื่อว่าคุณควรมีสิทธิ์ในการติดตั้งและทดสอบแอป โปรดขอให้ผู้ดูแลระบบบัญชี Google Workspace เปลี่ยนการตั้งค่าบัญชี ผู้ดูแลระบบของคุณควรปฏิบัติตามคำแนะนำใน การจัดการการเข้าถึงบริการที่ไม่ได้ควบคุมทีละรายการ
หากคุณมีหลายบัญชี ให้ลองเข้าสู่ระบบด้วยบัญชีอื่นที่ไม่ถูกจำกัดไม่ให้ติดตั้งและทดสอบแอป
เปิดใช้งานการแจ้งเตือนในแอพด้วย App Distribution iOS SDK
ใช้เคล็ดลับต่อไปนี้เพื่อแก้ไขปัญหาที่เกี่ยวข้องกับการเปิดใช้การแจ้งเตือนบิวด์ใหม่ในแอปโดยใช้ App Distribution iOS SDK
หากคุณได้ตั้งค่า App Distribution iOS SDK ในแอพของคุณแล้ว และผู้ทดสอบของคุณไม่ได้รับการแจ้งเตือนในแอพ ตรวจสอบให้แน่ใจว่าแอพของคุณดึงข้อมูลรุ่นใหม่:
เปิดใช้งานโหมดแก้ไขข้อบกพร่องในแอปของคุณ หากต้องการเรียนรู้วิธีการ โปรดดู เอกสารประกอบของ Google Analytics
เรียกใช้แอปของคุณในโปรแกรมจำลองและค้นหาสตริง "[Firebase/AppDistribution]"
ตรวจสอบว่าผู้ทดสอบสามารถเข้าถึงรุ่นใหม่:
หากมีการส่งคืนออบเจกต์การเผยแพร่ที่ถูกต้อง อาจเป็นไปได้ว่ามีปัญหาในวงจรชีวิตของ View Controller ที่กล่องโต้ตอบการแจ้งเตือนถูกโหลดก่อนที่ View จะปรากฏขึ้น
หากไม่มีการส่งคืนรุ่น ผู้ทดสอบของคุณอาจยังไม่เชื่อมโยงกับรุ่นใหม่ ในแดชบอร์ดการเผยแพร่แอปของคอนโซล Firebase ตรวจสอบให้แน่ใจว่าเครื่องทดสอบของคุณรวมอยู่ในการเผยแพร่บิวด์และอยู่ในสถานะ ยอมรับ
หากผู้ทดสอบของคุณยังคงไม่ได้รับการอัปเดต ขอให้พวกเขาทำตามคำแนะนำด้านล่างเพื่อให้แน่ใจว่าพวกเขายอมรับคำเชิญให้ทดสอบแอปของคุณ และตั้งค่าอุปกรณ์ทดสอบอย่างถูกต้อง:
ในอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้คลิปเว็บ Firebase App Distribution อย่าลืมเลือกบัญชี Google ที่คุณใช้ครั้งแรกเมื่อคุณตอบรับคำเชิญให้ทดสอบแอป
ตรวจสอบให้แน่ใจว่ามีการเปิดตัวแอพใหม่ในเว็บคลิป
ตามค่าเริ่มต้น ผู้ทดสอบของคุณจะต้องลงชื่อเข้าใช้บัญชี Google เพียงครั้งเดียวเพื่อเปิดใช้งานการแจ้งเตือนบิวด์ใหม่และติดตั้งบิวด์ใหม่ หากผู้ทดสอบของคุณได้รับแจ้งให้ลงชื่อเข้าใช้อีกครั้งหลังจากปิดและเปิดแอปของคุณใหม่ ให้ทำตามเคล็ดลับเหล่านี้เพื่อให้แน่ใจว่าการกำหนดค่าการเผยแพร่แอปของคุณได้รับการตั้งค่าอย่างถูกต้อง:
ตรวจสอบว่าคุณเปิดใช้ Firebase App Testers API แล้ว สำหรับข้อมูลเพิ่มเติม โปรดดูที่ เปิดใช้งาน App Distribution Tester API
ภายใต้ ข้อจำกัดคีย์ ตรวจสอบ ให้แน่ใจว่า Firebase App Testers API รวมอยู่ในรายการ API ที่อนุญาต
หากโดยทั่วไปคุณล้าง UserDefaults เมื่อออกจากระบบ คุณอาจกำลังล้างสถานะของผู้ทดสอบ App Distribution จะจัดเก็บค่าสถานะที่ระบุว่าผู้ทดสอบของคุณได้ลงชื่อเข้าใช้แอปแล้วหรือไม่ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ เก็บ GitHub
คำถามที่พบบ่อย
Firebase App Distribution มีขีดจำกัดของผู้ทดสอบดังต่อไปนี้:
เพิ่มผู้ทดสอบสูงสุด 500 คนในโครงการ Firebase
เพิ่มผู้ทดสอบได้สูงสุด 200 คนในกลุ่มการกระจายแอป
หากต้องการเพิ่มผู้ทดสอบ ให้ขอ เพิ่มขีดจำกัด โดยไม่มีค่าใช้จ่าย
ผู้ทดสอบมีเวลา 30 วันในการตอบรับคำเชิญให้ทดสอบแอปก่อนที่จะหมดอายุ เมื่อคำเชิญมีอายุ 5 วันนับจากวันหมดอายุ ข้อความแจ้งการหมดอายุจะปรากฏในคอนโซล Firebase ถัดจากผู้ทดสอบในรุ่นที่เผยแพร่ สามารถต่ออายุคำเชิญได้โดยส่งอีกครั้งผ่านเมนูแบบเลื่อนลงในแถวผู้ทดสอบ
ดู การลงทะเบียนอุปกรณ์เพิ่มเติม
การเผยแพร่แอปจะถูกลบออกจากการเผยแพร่แอปหากเกิดเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้:
- การเปิดตัวแอปมีอายุมากกว่า 150 วัน
- คุณเกินขีดจำกัดการเผยแพร่แอป 1,000 รายการ และแอปเผยแพร่นั้นเก่ากว่าการเผยแพร่แอปล่าสุด 1,000 รายการ
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ App Distribution รองรับสูงสุด 1,000 รีลีส
หลังจากที่แอปถึงหรือเกินขีดจำกัดการหมดอายุ 150 วันหรือขีดจำกัดการเผยแพร่แอป 1,000 รายการ การเผยแพร่จะถูกลบออกจากแดชบอร์ดการกระจายแอปและเว็บแอปผู้ทดสอบการเผยแพร่แอป หากผู้ทดสอบของคุณติดตั้งรุ่นแล้ว แอปเวอร์ชันในเครื่องจะยังคงทำงานต่อไป
เพื่อให้การเผยแพร่แอปใช้งานได้นานขึ้น ให้ใช้หนึ่งในคำแนะนำต่อไปนี้:
- ก่อนที่การเผยแพร่แอปจะหมดอายุหรือเกินขีดจำกัดการเผยแพร่ ให้ดาวน์โหลด IPA และลบการเผยแพร่ออกจากแดชบอร์ดการกระจายแอป จากนั้น อัปโหลด IPA อีกครั้งเป็นโครงสร้างใหม่ไปยัง App Distribution
- ดาวน์โหลดรุ่นและอัปโหลดไปยัง Cloud Storage เพื่อการเก็บถาวรในระยะยาว
การเผยแพร่แอปจะหมดอายุหลังจาก 150 วัน
เมื่อคุณอัปโหลดรุ่นของแอปไปยัง Firebase รุ่นนั้นจะปรากฏใน แดชบอร์ดการกระจายแอป เป็นเวลา 150 วัน นับจากวันที่อัปโหลด หลังจากที่คุณอัปโหลดรุ่นแล้ว คุณสามารถแจกจ่ายให้กับผู้ทดสอบซึ่งติดตั้งรุ่นจากเว็บแอปผู้ทดสอบการแจกจ่ายแอปบนอุปกรณ์ทดสอบของพวกเขา
เมื่อการเผยแพร่มีอายุ 30 วันนับจากวันที่หมดอายุ การแจ้งเตือนการหมดอายุของการเผยแพร่แอปจะปรากฏบนรุ่นของคุณในหน้าการเผยแพร่แอปของคอนโซล Firebase และในเว็บแอปผู้ทดสอบการเผยแพร่แอป
การกระจายแอพรองรับสูงสุด 1,000 รีลีส
การกระจายแอปอนุญาตให้เผยแพร่ได้สูงสุด 1,000 รายการต่อแอป เมื่อแอปของคุณถึงขีดจำกัดการเผยแพร่แอป 1,000 รายการ การเผยแพร่แอปจะลบการเผยแพร่ที่เก่าที่สุดที่เกินขีดจำกัดโดยอัตโนมัติ
หากคุณต้องการจัดการการเผยแพร่แอปด้วยตนเอง ให้ใช้ App Distribution REST API เพื่อ แสดงรายการ และ ลบ การเผยแพร่แอปเป็นกลุ่ม
หากคุณมีคำถาม โปรดติดต่อ ฝ่ายสนับสนุน Firebase
โปรไฟล์ Firebase คือโปรไฟล์การกำหนดค่าที่อนุญาตให้ App Distribution ทำสิ่งต่อไปนี้
ลงทะเบียนอุปกรณ์ทดสอบโดยรวบรวม ID อุปกรณ์เฉพาะของอุปกรณ์ (UDID) หากคุณกำลังทดสอบการกระจายแบบเฉพาะกิจ Firebase จะส่งอีเมลถึงนักพัฒนาแอปที่มี UDID ของอุปกรณ์ทดสอบพร้อมกับคำแนะนำเกี่ยวกับวิธีรวมอุปกรณ์ในโปรไฟล์การจัดเตรียมของแอป เพื่อให้สามารถทดสอบรุ่นในอุปกรณ์ของคุณได้
ติดตั้งเว็บคลิป Firebase App Distribution ลงในหน้าจอหลักของอุปกรณ์ เว็บคลิปช่วยให้คุณติดตั้งและเข้าถึงแอปทดสอบทั้งหมดได้ในที่เดียว งานสร้างใหม่ที่คุณได้รับเชิญให้ทดสอบจะถูกเพิ่มลงในเว็บคลิปโดยอัตโนมัติ
สำหรับความช่วยเหลือในการติดตั้งโปรไฟล์การกำหนดค่าบนอุปกรณ์ iOS โปรดดู เอกสารประกอบของ Apple
หากคุณเป็นผู้ทดสอบ คุณสามารถเข้าถึงแอปทดสอบทั้งหมดของคุณด้วย เว็บคลิป Firebase App Distribution ซึ่งจะเพิ่มไปยังหน้าจอหลักของอุปกรณ์ทดสอบโดยอัตโนมัติเมื่อคุณติดตั้งโปรไฟล์ Firebase หากคุณกำลังทดสอบการกระจาย Ad Hoc คุณต้อง ติดตั้งโปรไฟล์ ก่อนจึงจะสามารถทดสอบแอปได้
หากคุณกำลังทดสอบการแจกจ่าย Enterprise คุณสามารถติดตั้งโปรไฟล์ได้ด้วยตนเอง:
หากคุณยังไม่ได้ดำเนินการ ให้ลงชื่อเข้าใช้ Google และตอบรับคำเชิญ
ภายใต้ แอปทดสอบ ให้เลือกแอปที่คุณต้องการทดสอบ
ที่ด้านบนขวาของหน้าแอป ให้แตะ mobile_screen_share
ทำตามคำแนะนำที่แสดงเพื่อติดตั้งโปรไฟล์ Firebase
หากต้องการลบบัญชีผู้ทดสอบ App Distribution และข้อมูลที่เกี่ยวข้อง ให้ทำตามขั้นตอนเหล่านี้ตามลำดับ:
ไปที่ https://appdistribution.firebase.google.com และลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณ
ที่ด้านขวาบน ให้คลิก
( จัดการบัญชี )ลบบัญชี
ไม่บังคับ: ใน สิทธิ์บัญชี Google ของคุณ ให้เพิกถอนการเข้าถึงจาก Firebase App Distribution โปรดทราบว่าการเพิกถอนการเข้าถึงโดยไม่ลบบัญชี App Distribution ของคุณก่อน จะไม่เป็นการ ลบบัญชีหรือข้อมูลผู้ทดสอบของคุณ