หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการแจกจ่ายและทดสอบแอปด้วย 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 ของคุณก่อน จะไม่เป็นการ ลบบัญชีหรือข้อมูลผู้ทดสอบของคุณ
หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการแจกจ่ายและทดสอบแอปด้วย 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 คำเชิญที่มีอยู่จะถูกลบออก
เชิญผู้ทดสอบอีกครั้งเพื่อทดสอบแอปของคุณ ผู้ทดสอบควรได้รับอีเมลคำเชิญ
ตรวจสอบให้แน่ใจว่าผู้ทดสอบยอมรับคำเชิญที่ใช้ที่อยู่อีเมลเดียวกัน
ผู้ทดสอบอาจไม่ได้รับการแจ้งเตือนทางอีเมลหากเกิดเหตุการณ์ต่อไปนี้:
การแจ้งเตือนทางอีเมลจะถูกส่งไปยังโฟลเดอร์สแปม
ตั้งค่าตัวกรองอีเมลแล้ว
คำเชิญถูกส่งไปยังบัญชีอีเมลหนึ่ง แต่ผู้ทดสอบตอบรับด้วยบัญชีอีเมลอื่น The tester receives new release emails for the email account to which the invitation was originally sent.
The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.
Solution 1
Ask the tester to check their spam folder and any email filters they set in their email service.
If the tester unsubscribed from the emails, ask the tester to do the following:
- Find an email that the tester previously received from the app.
- Click Manage email settings at the bottom and click Allow emails to resubscribe.
Solution 2
Delete the tester from the View all testers section of the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.
Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.
The Untrusted Enterprise Developer error appears if you did not trust the developer certificate on the test device before opening the app. In the Settings app > Profiles & Device Management screen, select the app's developer name and trust it.
The Developer Mode Required error appears when you try to launch an ad hoc-provisioned iOS app on iOS 16 or later without first enabling Developer Mode.
To enable Developer Mode and resolve this error, follow these steps:
- On your iPhone, open the Settings app and then tap Privacy & Security .
- Scroll down to Security and tap Developer Mode .
- Tap the Developer Mode slider.
- Tap Restart .
- After the device restarts, unlock the device. The Turn on Developer Mode? dialog appears.
- Tap Turn On . You can now launch your app and start testing.
If you're installing an Ad Hoc distribution, this message appears when the developer hasn't yet configured their app to run on your test device. To make the app available to you, the developer must complete the instructions in Register additional devices .
If your Google account does not have access to a test app you previously installed (or accepted an invitation for), it's likely that you signed in to the wrong Google account. The apps to which you have access are associated with the Google account you used when you first accepted the invitation to test the app. Try again by signing in with the Google account you previously used to accept the invitation.
When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.
If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .
If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.
Enabling in-app alerts with the App Distribution iOS SDK
Use the following tips to troubleshoot issues that involve enabling in-app new build alerts using the App Distribution iOS SDK.
If you have already set up the App Distribution iOS SDK in your app and your testers aren't receiving in-app alerts, check to make sure your app is fetching new releases:
Enable debug mode in your app. To learn how, see the Google Analytics documentation .
Run your app in a simulator and search for the string "[Firebase/AppDistribution]".
Check that the tester has access to the new release:
If a valid release object is returned, it's likely that there's an issue in the View Controller lifecycle where the alert dialog is loaded before the View appears.
If no release is returned, your tester may not yet be associated with the new release. In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.
If your tester still isn't receiving updates, ask them to follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:
On the test device, sign into the Firebase App Distribution web clip. Remember to select the Google account you first used when you accepted the invitation to test the app.
Make sure that the new app release is available in the web clip.
By default, your testers only need to sign in to their Google account once to enable new build alerts and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:
Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .
Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.
If you typically clear UserDefaults on signing out, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .
Frequently asked questions
Firebase App Distribution has the following tester limits:
Add a maximum of 500 testers to a Firebase project
Add a maximum of 200 testers to an App Distribution group
To add more testers, request a no-cost limit increase .
Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.
See Register additional devices .
App releases are removed from App Distribution if one of the following conditions occurs:
- The app release is older than 150 days.
- You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.
For more information, see App Distribution supports a maximum of 1,000 releases .
After the app reaches or exceeds the 150-day expiration limit or the 1,000 app release limit, the release is removed from the App Distribution dashboard and the App Distribution tester web app. If your tester has installed the release, the local version of the app continues to run.
To keep the app release available longer, use one of the following recommendations:
- Before the app release expires or exceeds the release limit, download the IPA and delete the release from the App Distribution dashboard. Then, re-upload the IPA as a new build to App Distribution.
- Download the release and upload it to Cloud Storage for long-term archiving.
App releases expire after 150 days
When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the App Distribution tester web app on their testing device.
When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the App Distribution page of the Firebase console and in the App Distribution tester web app.
App Distribution supports a maximum of 1,000 releases
App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.
If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.
If you have questions, contact Firebase Support .
The Firebase profile is a configuration profile that allows App Distribution to:
Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends the app developer an email that includes the test device's UDID, along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.
Install a Firebase App Distribution web clip to your device's home screen. The web clip allows you to install and access all your test apps in one place. New builds you're invited to test are automatically added to the web clip.
For help on installing configuration profiles on your iOS device, refer to Apple's documentation .
If you're a tester, you can access all of your test apps with the Firebase App Distribution web clip , which is automatically added to your test device's home screen when you install the Firebase profile. If you're testing an Ad Hoc distribution, you must first install the profile before you can test the app.
If you're testing an Enterprise distribution, you can manually install the profile:
If you haven't already, sign in to Google and accept the invitation.
Under Test apps , select the app you want to test.
In the top right of the app's page, tap mobile_screen_share .
Follow the instructions displayed to install the Firebase profile.
To delete your App Distribution tester account and its associated data, follow these steps in order:
Visit https://appdistribution.firebase.google.com and sign in with your Google account.
In the top-right, click ( Manage account )
Delete account .
Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.