หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการเผยแพร่และการทดสอบแอปด้วย 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 App Distribution: appdistribution.firebase.google.com
โซลูชันที่ 3
ลบผู้ทดสอบออกจากส่วน ดูผู้ทดสอบทั้งหมด ของแท็บ ผู้ทดสอบและกลุ่ม ในหน้าการเผยแพร่แอปในคอนโซล 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]"
ตรวจสอบว่าผู้ทดสอบมีสิทธิ์เข้าถึงรุ่นใหม่:
หากส่งคืนออบเจ็กต์ Release ที่ถูกต้อง อาจเป็นไปได้ว่ามีปัญหาในวงจรการใช้งาน View Controller โดยที่กล่องโต้ตอบการแจ้งเตือนถูกโหลดก่อนที่ View จะปรากฏขึ้น
หากไม่มีการส่งคืนรุ่น ผู้ทดสอบของคุณอาจยังไม่เชื่อมโยงกับรุ่นใหม่ ในแดชบอร์ด App Distribution ของคอนโซล Firebase ตรวจสอบให้แน่ใจว่าผู้ทดสอบของคุณรวมอยู่ในการเผยแพร่บิวด์และอยู่ในสถานะ ที่ยอมรับแล้ว
หากผู้ทดสอบของคุณยังคงไม่ได้รับการอัปเดต โปรดขอให้พวกเขาปฏิบัติตามเคล็ดลับด้านล่างเพื่อให้แน่ใจว่าพวกเขายอมรับคำเชิญให้ทดสอบแอปของคุณ และได้ตั้งค่าอุปกรณ์ทดสอบอย่างถูกต้อง:
บนอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้เว็บคลิป Firebase App Distribution อย่าลืมเลือกบัญชี Google ที่คุณใช้ครั้งแรกเมื่อตอบรับคำเชิญให้ทดสอบแอป
ตรวจสอบให้แน่ใจว่ามีการเปิดตัวแอปใหม่ในเว็บคลิป
ตามค่าเริ่มต้น ผู้ทดสอบของคุณจะต้องลงชื่อเข้าใช้บัญชี Google เพียงครั้งเดียวเพื่อเปิดใช้งานการแจ้งเตือนบิลด์ใหม่และติดตั้งบิลด์ใหม่ หากผู้ทดสอบของคุณได้รับแจ้งให้ลงชื่อเข้าใช้อีกครั้งหลังจากปิดและเปิดแอปของคุณอีกครั้ง ให้ปฏิบัติตามเคล็ดลับเหล่านี้เพื่อให้แน่ใจว่าการกำหนดค่า App Distribution ของคุณได้รับการตั้งค่าอย่างถูกต้อง:
ตรวจสอบให้แน่ใจว่าคุณได้เปิดใช้งาน Firebase App Tests API แล้ว สำหรับข้อมูลเพิ่มเติม โปรดดูที่ เปิดใช้งาน App Distribution Tester API
ใต้ ข้อจำกัดคีย์ ตรวจสอบ ให้แน่ใจว่า Firebase App Tests API รวมอยู่ในรายการ API ที่อนุญาต
หากปกติแล้วคุณจะล้าง UserDefaults เมื่อออกจากระบบ แสดงว่าคุณอาจกำลังล้างสถานะผู้ทดสอบอยู่ App Distribution จะจัดเก็บแฟล็กที่ระบุว่าผู้ทดสอบของคุณได้ลงชื่อเข้าใช้แอปแล้วหรือไม่ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ เก็บ GitHub
คำถามที่พบบ่อย
Firebase App Distribution มีขีดจำกัดของผู้ทดสอบดังต่อไปนี้
เพิ่มผู้ทดสอบได้สูงสุด 500 คนในโปรเจ็กต์ Firebase
เพิ่มผู้ทดสอบได้สูงสุด 200 คนในกลุ่ม App Distribution
หากต้องการเพิ่มผู้ทดสอบ โปรดขอ เพิ่มขีดจำกัด โดยไม่มีค่าใช้จ่าย
ผู้ทดสอบมีเวลา 30 วันในการตอบรับคำเชิญให้ทดสอบแอปก่อนที่จะหมดอายุ เมื่อคำเชิญเหลือเวลา 5 วันนับจากวันหมดอายุ การแจ้งการหมดอายุจะปรากฏในคอนโซล Firebase ถัดจากผู้ทดสอบในรุ่นหนึ่ง คุณสามารถต่ออายุคำเชิญได้โดยส่งอีกครั้งผ่านเมนูแบบเลื่อนลงในแถวผู้ทดสอบ
การเผยแพร่แอปจะถูกลบออกจาก App Distribution หากเกิดเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้:
- แอปที่เผยแพร่มีอายุมากกว่า 150 วัน
- คุณปล่อยแอปเกินขีดจำกัด 1,000 รายการ และแอปออกใช้นั้นเก่ากว่าแอปออกล่าสุด 1,000 รายการ
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ App Distribution รองรับการเผยแพร่สูงสุด 1,000 รายการ
หลังจากที่แอปถึงหรือเกินขีดจำกัดการหมดอายุ 150 วันหรือขีดจำกัดการเผยแพร่แอป 1,000 รายการ การเผยแพร่จะถูกลบออกจากแดชบอร์ด App Distribution และเว็บแอปผู้ทดสอบ App Distribution หากผู้ทดสอบของคุณติดตั้งรุ่นดังกล่าวแล้ว แอปเวอร์ชันในเครื่องจะยังคงทำงานต่อไป
เพื่อให้แอปใช้งานได้นานขึ้น ให้ใช้คำแนะนำข้อใดข้อหนึ่งต่อไปนี้:
- ก่อนที่รุ่นแอปจะหมดอายุหรือเกินขีดจำกัดรุ่น ให้ดาวน์โหลด IPA และลบรุ่นออกจากแดชบอร์ด App Distribution จากนั้น อัปโหลด IPA อีกครั้งเป็นเวอร์ชันใหม่ไปยัง App Distribution
- ดาวน์โหลดรุ่นและอัปโหลดไปยัง Cloud Storage เพื่อการเก็บถาวรในระยะยาว
การเผยแพร่แอปจะหมดอายุหลังจาก 150 วัน
เมื่อคุณอัปโหลดรุ่นแอปของคุณไปยัง Firebase รุ่นดังกล่าวจะปรากฏใน แดชบอร์ด App Distribution เป็นเวลา 150 วัน นับจากวันที่อัปโหลด หลังจากที่คุณอัปโหลดรุ่นแล้ว คุณสามารถแจกจ่ายให้กับผู้ทดสอบซึ่งติดตั้งรุ่นจากเว็บแอปผู้ทดสอบ App Distribution บนอุปกรณ์ทดสอบของตนได้
เมื่อการเปิดตัวคือ 30 วันนับจากวันหมดอายุ การแจ้งเตือนการหมดอายุของการเปิดตัวแอปจะปรากฏบนรุ่นของคุณในหน้าการเผยแพร่แอปของคอนโซล Firebase และในเว็บแอปผู้ทดสอบการกระจายแอป
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 หากคุณกำลังทดสอบการกระจาย Ad Hoc คุณต้อง ติดตั้งโปรไฟล์ ก่อนจึงจะสามารถทดสอบแอปได้
หากคุณกำลังทดสอบการแจกจ่าย Enterprise คุณสามารถติดตั้งโปรไฟล์ได้ด้วยตนเอง:
หากคุณยังไม่ได้ลงชื่อเข้าใช้ Google และยอมรับคำเชิญ
ภายใต้ ทดสอบแอป ให้เลือกแอปที่คุณต้องการทดสอบ
ที่ด้านขวาบนของหน้าแอป ให้แตะ mobile_screen_share
ทำตามคำแนะนำที่แสดงเพื่อติดตั้งโปรไฟล์ Firebase
หากต้องการลบบัญชีผู้ทดสอบ App Distribution และข้อมูลที่เกี่ยวข้อง ให้ทำตามขั้นตอนเหล่านี้ตามลำดับ:
ไปที่ https://appdistribution.firebase.google.com และลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณ
ที่มุมขวาบน คลิก
( จัดการบัญชี )ลบบัญชี .
ทางเลือก: ใน การอนุญาตบัญชี Google ของคุณ ให้เพิกถอนการเข้าถึงจาก Firebase App Distribution โปรดทราบว่าการเพิกถอนการเข้าถึงโดยไม่ลบบัญชี App Distribution ก่อน จะไม่ ลบบัญชีหรือข้อมูลผู้ทดสอบของคุณ