หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการแจกจ่ายและทดสอบแอปด้วย App Distribution
แอพกระจาย
ใช้เคล็ดลับต่อไปนี้เพื่อแก้ไขปัญหาที่คุณอาจพบเมื่อแจกจ่ายแอปให้กับผู้ทดสอบของคุณ
เมื่ออัปโหลดแอป คุณอาจพบข้อผิดพลาดนี้:
"เราไม่พบอีเมลติดต่อสำหรับแอป <app-id>
โปรดไปที่ App Distribution ภายในคอนโซล Firebase เพื่อตั้งค่า"
ตั้งค่าอีเมลติดต่อในคอนโซล Firebase หากมี หากปัญหายังคงอยู่ โปรดติดต่อ ฝ่ายสนับสนุนของ Firebase
หากคุณพบข้อผิดพลาด 400, 409 หรือ 500 ซ้ำๆ ระหว่างการจัดสรร โปรดติดต่อ ฝ่ายสนับสนุนของ Firebase ให้การสนับสนุนด้วยหมายเลขโปรเจ็กต์ 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 และสอบถามเกี่ยวกับการใช้ Testflight
การติดตั้งและทดสอบแอพ
ใช้เคล็ดลับต่อไปนี้เพื่อแก้ไขปัญหาที่ผู้ทดสอบอาจพบเมื่อติดตั้งและทดสอบแอปของคุณ
เมื่อผู้ใช้สร้างบัญชี Google จะได้รับที่อยู่ Gmail โดยอัตโนมัติ
หากผู้ทดสอบไม่มีที่อยู่ Google Workspace หรือ Gmail หรือหากต้องการใช้ที่อยู่อีเมลอื่นในการลงชื่อเข้าใช้ โปรดขอให้ผู้ทดสอบลิงก์ที่อยู่อีเมลที่ไม่ใช่ Gmail กับบัญชีและใช้อีเมลนั้นเพื่อลงชื่อเข้าใช้
เมื่อเลือกอีเมลอื่น ผู้ทดสอบต้องปฏิบัติตามหลักเกณฑ์เหล่านี้:
- อย่าใช้ที่อยู่ Gmail
- อย่าใช้ที่อยู่อีเมลที่เชื่อมโยงกับบัญชี Google อื่นอยู่แล้ว
- อย่าลืมใช้รหัสผ่านบัญชี Google ของคุณเมื่อลงชื่อเข้าใช้ด้วยที่อยู่อีเมลนี้
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ ลงชื่อเข้าใช้บัญชี Google ของคุณด้วยที่อยู่อีเมลอื่น
หากผู้ทดสอบยอมรับคำเชิญทางอีเมลด้วยที่อยู่อีเมลอื่นที่ไม่ใช่คำเชิญที่ส่งไป ผู้ทดสอบอาจไม่เห็นแอปหรือบิลด์ที่ถูกต้อง
อีเมลที่ผู้พัฒนาส่งคำเชิญและเพิ่มไปยังบิลด์ใหม่ (อีเมล A) อาจแตกต่างจากอีเมลที่ผู้ทดสอบใช้เพื่อตอบรับคำเชิญ (อีเมล B) สิ่งนี้จะสร้างลิงค์เบื้องหลัง เมื่อใดก็ตามที่มีการเพิ่มอีเมล A ในบิลด์ใหม่ แท้จริงแล้วอีเมล B นั้นกำลังเข้าถึง
หากผู้ทดสอบยอมรับคำเชิญทางอีเมลด้วยที่อยู่อีเมลอื่น ให้ทำตามขั้นตอนเหล่านี้เพื่อแก้ไขปัญหา:
ลบผู้ทดสอบออกจากแท็บผู้ ทดสอบและกลุ่ม ในหน้าการแจกจ่ายแอปของคอนโซล Firebase คำเชิญที่มีอยู่จะถูกลบออก
เชิญผู้ทดสอบอีกครั้งเพื่อทดสอบแอปของคุณ ผู้ทดสอบควรได้รับอีเมลเชิญ
ตรวจสอบให้แน่ใจว่าผู้ทดสอบยอมรับคำเชิญโดยใช้ที่อยู่อีเมลเดียวกัน
ผู้ทดสอบอาจไม่ได้รับการแจ้งเตือนทางอีเมลหากเกิดสิ่งใดสิ่งหนึ่งต่อไปนี้:
การแจ้งเตือนทางอีเมลจะถูกส่งไปยังโฟลเดอร์สแปม
มีการตั้งค่าตัวกรองอีเมล
คำเชิญถูกส่งไปยังบัญชีอีเมลหนึ่งบัญชี แต่ผู้ทดสอบยอมรับด้วยบัญชีอีเมลอื่น ผู้ทดสอบจะได้รับอีเมลฉบับใหม่สำหรับบัญชีอีเมลที่ส่งคำเชิญไปในตอนแรก
ผู้ทดสอบได้รับเชิญก่อนหน้านี้แต่ไม่ยอมรับคำเชิญเริ่มต้น หากมีการเพิ่มผู้ทดสอบในรุ่นต่อๆ ไป App Distribution จะไม่ส่งการแจ้งเตือนรุ่นโดยอัตโนมัติไปยังผู้ทดสอบนั้น เนื่องจากผู้ทดสอบไม่ยอมรับคำเชิญเริ่มต้น
โซลูชัน 1
ขอให้ผู้ทดสอบตรวจสอบโฟลเดอร์สแปมและตัวกรองอีเมลที่ตั้งค่าไว้ในบริการอีเมล
หากผู้ทดสอบยกเลิกการสมัครรับอีเมล ให้ขอให้ผู้ทดสอบดำเนินการดังต่อไปนี้:
- ค้นหาอีเมลที่ผู้ทดสอบได้รับจากแอปก่อนหน้านี้
- คลิก จัดการการตั้งค่าอีเมล ที่ด้านล่าง และคลิก อนุญาตให้อีเมล สมัครใหม่
โซลูชัน 2
ลบผู้ทดสอบออกจากแท็บผู้ ทดสอบและกลุ่ม ในหน้าการแจกจ่ายแอปในคอนโซล Firebase การดำเนินการนี้จะลบคำเชิญที่มีอยู่
เชิญผู้ทดสอบอีกครั้งเพื่อทดสอบแอปของคุณ ผู้ทดสอบควรได้รับอีเมลเชิญ ตรวจสอบให้แน่ใจว่าผู้ทดสอบยอมรับคำเชิญโดยใช้ที่อยู่อีเมลเดียวกันกับที่ส่งคำเชิญไป
ข้อผิดพลาด Untrusted Enterprise Developer จะปรากฏขึ้นหากคุณไม่เชื่อถือใบรับรองนักพัฒนาในอุปกรณ์ทดสอบก่อนที่จะเปิดแอป ในแอป การตั้งค่า > หน้าจอ การจัดการโปรไฟล์และอุปกรณ์ ให้เลือกชื่อนักพัฒนาแอปและเชื่อถือ
หากคุณกำลังติดตั้งการแจกจ่ายเฉพาะกิจ ข้อความนี้จะปรากฏขึ้นเมื่อนักพัฒนายังไม่ได้กำหนดค่าแอปให้ทำงานบนอุปกรณ์ทดสอบของคุณ เพื่อให้แอปพร้อมใช้งานสำหรับคุณ นักพัฒนาต้องทำตามคำแนะนำใน ลงทะเบียนอุปกรณ์เพิ่มเติม
หากบัญชี 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 เพียงครั้งเดียวเพื่อเปิดใช้งานการแจ้งเตือนบิลด์ใหม่และติดตั้งบิลด์ใหม่ หากผู้ทดสอบได้รับแจ้งให้ลงชื่อเข้าใช้อีกครั้งหลังจากปิดและเปิดแอปอีกครั้ง ให้ทำตามคำแนะนำเหล่านี้เพื่อให้แน่ใจว่าการกำหนดค่า App Distribution ของคุณได้รับการตั้งค่าอย่างถูกต้อง
ตรวจสอบให้แน่ใจว่าคุณได้เปิดใช้งาน 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 ถัดจากผู้ทดสอบในรุ่น สามารถต่ออายุคำเชิญได้โดยส่งใหม่ผ่านเมนูแบบเลื่อนลงในแถวผู้ทดสอบ
การเผยแพร่แอปจะถูกลบออกจาก App Distribution หากเกิดเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้:
- การเปิดตัวแอปมีอายุมากกว่า 150 วัน
- คุณปล่อยแอปเกินขีดจำกัด 1,000 รายการ และการเผยแพร่แอปเก่ากว่า 1,000 รายการล่าสุด
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ App Distribution รองรับรีลีสสูงสุด 1,000 รายการ
หลังจากที่แอปถึงหรือเกินขีดจำกัดการหมดอายุ 150 วันหรือขีดจำกัดการเผยแพร่แอป 1,000 รายการ การเผยแพร่จะถูกลบออกจากแดชบอร์ด App Distribution และเว็บแอปทดสอบ App Distribution หากผู้ทดสอบของคุณติดตั้งรุ่นดังกล่าว แอปเวอร์ชันในเครื่องจะยังคงทำงานต่อไป
หากต้องการให้แอปใช้งานได้นานขึ้น ให้ใช้คำแนะนำข้อใดข้อหนึ่งต่อไปนี้:
- ก่อนที่การเผยแพร่แอปจะหมดอายุหรือเกินขีดจำกัดการเผยแพร่ ให้ดาวน์โหลด IPA และลบการเผยแพร่ออกจากแดชบอร์ดการแจกจ่ายแอป จากนั้น อัปโหลด IPA ใหม่เป็นบิลด์ใหม่ใน App Distribution
- ดาวน์โหลดรุ่นและอัปโหลดไปยัง Cloud Storage เพื่อการเก็บถาวรในระยะยาว
การเปิดตัวแอปจะหมดอายุหลังจาก 150 วัน
เมื่อคุณอัปโหลดรุ่นของแอปไปที่ Firebase รุ่นดังกล่าวจะปรากฏใน หน้าแดชบอร์ดการแจกจ่ายแอป เป็นเวลา 150 วัน นับตั้งแต่วันที่อัปโหลด หลังจากที่คุณอัปโหลดรุ่น คุณสามารถแจกจ่ายให้กับผู้ทดสอบซึ่งติดตั้งรุ่นจากเว็บแอปผู้ทดสอบ App Distribution บนอุปกรณ์ทดสอบของพวกเขา
เมื่อการเปิดตัวคือ 30 วันนับจากวันที่หมดอายุ การแจ้งเตือนการหมดอายุของการเผยแพร่แอปจะปรากฏบนรุ่นของคุณในหน้าการแจกจ่ายแอปของคอนโซล Firebase และในเว็บแอปทดสอบ App Distribution
App Distribution รองรับสูงสุด 1,000 รีลีส
App Distribution อนุญาตให้เผยแพร่ได้สูงสุด 1,000 รายการต่อแอป เมื่อแอปของคุณถึงขีดจำกัดการปล่อยแอป 1,000 รายการ App Distribution จะลบรุ่นที่เก่าที่สุดที่เกินขีดจำกัดโดยอัตโนมัติ
หากคุณต้องการจัดการรุ่นของแอปด้วยตนเอง ให้ใช้ App Distribution REST API เพื่อ แสดงรายการ และ ลบ รุ่นของแอปออกเป็นกลุ่ม
หากคุณมีคำถาม โปรดติดต่อ ฝ่ายสนับสนุนของ Firebase
โปรไฟล์ Firebase เป็นโปรไฟล์การกำหนดค่าที่อนุญาตให้ App Distribution สามารถ:
ลงทะเบียนอุปกรณ์ทดสอบโดยรวบรวม ID อุปกรณ์ที่ไม่ซ้ำกัน (UDID) ของอุปกรณ์ หากคุณกำลังทดสอบการกระจายแบบเฉพาะกิจ Firebase จะส่งอีเมลถึงนักพัฒนาแอปที่มี UDID ของอุปกรณ์ทดสอบ พร้อมด้วยคำแนะนำเกี่ยวกับวิธีการรวมอุปกรณ์ในโปรไฟล์การจัดสรรของแอป เพื่อให้สามารถทดสอบบิลด์บนอุปกรณ์ของคุณได้
ติดตั้งเว็บคลิป Firebase App Distribution ลงในหน้าจอหลักของอุปกรณ์ของคุณ คลิปเว็บช่วยให้คุณติดตั้งและเข้าถึงแอปทดสอบทั้งหมดได้ในที่เดียว บิลด์ใหม่ที่คุณได้รับเชิญให้ทดสอบจะถูกเพิ่มลงในคลิปเว็บโดยอัตโนมัติ
สำหรับความช่วยเหลือในการติดตั้งโปรไฟล์การกำหนดค่าบนอุปกรณ์ iOS ของคุณ โปรดดู เอกสารประกอบของ Apple
หากคุณเป็นผู้ทดสอบ คุณจะเข้าถึงแอปทดสอบทั้งหมดได้ด้วย เว็บคลิป Firebase App Distribution ซึ่งจะเพิ่มลงในหน้าจอหลักของอุปกรณ์ทดสอบโดยอัตโนมัติเมื่อคุณติดตั้งโปรไฟล์ Firebase หากคุณกำลังทดสอบการกระจายแบบเฉพาะกิจ คุณต้อง ติดตั้งโปรไฟล์ ก่อนจึงจะสามารถทดสอบแอปได้
หากคุณกำลังทดสอบการแจกจ่าย Enterprise คุณสามารถติดตั้งโปรไฟล์ได้ด้วยตนเอง:
หากคุณยังไม่ได้ลงชื่อเข้าใช้ Google และยอมรับคำเชิญ
ภายใต้ ทดสอบแอป ให้เลือกแอปที่คุณต้องการทดสอบ
ที่ด้านบนขวาของหน้าแอป ให้แตะ mobile_screen_share
ทำตามคำแนะนำที่แสดงเพื่อติดตั้งโปรไฟล์ Firebase
หากต้องการลบบัญชีผู้ทดสอบ App Distribution และข้อมูลที่เกี่ยวข้อง ให้ทำตามขั้นตอนเหล่านี้ตามลำดับ:
ไปที่ https://appdistribution.firebase.google.com และลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณ
ที่ด้านบนขวา คลิก
( จัดการบัญชี )ลบบัญชี
ไม่บังคับ: ในการ อนุญาตบัญชี Google ของคุณ ให้เพิกถอนการเข้าถึงจาก Firebase App Distribution โปรดทราบว่าการเพิกถอนการเข้าถึงโดยไม่ลบบัญชี App Distribution ก่อน จะไม่ ลบบัญชีหรือข้อมูลผู้ทดสอบของคุณ