การแก้ปัญหาเกี่ยวกับ App Distribution & คำถามที่พบบ่อย


หน้านี้ให้ความช่วยเหลือในการแก้ปัญหาและคำตอบสำหรับคำถามที่พบบ่อยเกี่ยวกับการเผยแพร่และการทดสอบแอปด้วย 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."
}

หากต้องการแก้ไขปัญหานี้ ให้ทำตามขั้นตอนต่อไปนี้

  1. ยืนยันขนาดของ IPA ขีดจํากัดขนาดไฟล์สูงสุดสําหรับไบนารีทั้งหมดคือ 2048 MiB ซึ่งมากกว่า 2 GB เล็กน้อย

  2. หากขนาด IPA อยู่ภายในขีดจำกัดขนาดไฟล์และสร้างซ้ำได้ ให้ทำตามขั้นตอนต่อไปนี้

    1. ตรวจสอบไฟล์ Info.plist และยืนยันว่า CFBundleDisplayName มีตัวคั่น <array> หรือไม่

    2. นำตัวคั่น <array> ออกแล้วสร้างแอปอีกครั้ง การอัปโหลดควรสำเร็จ

    3. หากยังพบปัญหาอยู่ โปรดติดต่อทีมสนับสนุนของ Firebase

  3. หากขนาด IPA เกินขีดจำกัดขนาดไฟล์ ให้ทำการเปลี่ยนแปลงที่จำเป็นเพื่อลดขนาดไฟล์

  4. หากการลดขนาดไฟล์ IPA ไม่ได้ช่วยแก้ปัญหา ให้ติดต่อทีมสนับสนุน Firebase และสอบถามเกี่ยวกับการใช้ Testflight

การติดตั้งและการทดสอบแอป

ใช้เคล็ดลับต่อไปนี้เพื่อแก้ปัญหาที่ผู้ทดสอบอาจพบเมื่อติดตั้งและทดสอบแอป

เมื่อสร้างบัญชี Google ผู้ใช้จะได้รับที่อยู่ Gmail โดยอัตโนมัติ

หากผู้ทดสอบไม่มีอีเมล Google Workspace หรือ Gmail หรือต้องการใช้อีเมลอื่นในการลงชื่อเข้าใช้ โปรดขอให้ผู้ทดสอบลิงก์อีเมลที่ไม่ใช่ Gmail กับบัญชีและใช้อีเมลดังกล่าวในการลงชื่อเข้าใช้

เมื่อเลือกอีเมลอื่น ผู้ทดสอบต้องปฏิบัติตามหลักเกณฑ์ต่อไปนี้

  • อย่าใช้อีเมล Gmail
  • อย่าใช้อีเมลที่ลิงก์กับบัญชี Google อื่นอยู่แล้ว
  • อย่าลืมใช้รหัสผ่านของบัญชี Google เมื่อลงชื่อเข้าใช้ด้วยอีเมลนี้

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อลงชื่อเข้าใช้บัญชี Google ด้วยอีเมลอื่น

หากผู้ทดสอบตอบรับคําเชิญทางอีเมลด้วยอีเมลอื่นที่ไม่ใช่อีเมลที่ส่งคำเชิญไป ผู้ทดสอบอาจไม่เห็นแอปหรือบิลด์ที่ถูกต้อง

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

หากผู้ทดสอบตอบรับคำเชิญทางอีเมลด้วยอีเมลอื่น ให้ทำตามขั้นตอนต่อไปนี้เพื่อแก้ไขปัญหา

  1. ลบผู้ทดสอบออกจากส่วนดูผู้ทดสอบทั้งหมดของแท็บผู้ทดสอบและกลุ่มในApp Distributionหน้าของFirebaseคอนโซล ระบบจะนำคำเชิญที่มีอยู่ออก

  2. เชิญผู้ทดสอบให้ทดสอบแอปอีกครั้ง ผู้ทดสอบควรได้รับอีเมลคำเชิญ

  3. ตรวจสอบว่าผู้ทดสอบตอบรับคําเชิญด้วยอีเมลเดียวกัน

ผู้ทดสอบอาจไม่ได้รับการแจ้งเตือนทางอีเมลหากเกิดเหตุการณ์อย่างใดอย่างหนึ่งต่อไปนี้

  • ระบบจะส่งการแจ้งเตือนทางอีเมลไปยังโฟลเดอร์จดหมายขยะ

  • ตั้งค่าตัวกรองอีเมลแล้ว

  • ระบบส่งคำเชิญไปยังบัญชีอีเมลบัญชีหนึ่ง แต่ผู้ทดสอบตอบรับด้วยบัญชีอีเมลอื่น ผู้ทดสอบจะได้รับอีเมลเกี่ยวกับรุ่นใหม่สำหรับบัญชีอีเมลที่ส่งคำเชิญไปให้ในตอนแรก

  • ผู้ทดสอบได้รับเชิญก่อนหน้านี้ แต่ไม่ได้ตอบรับคำเชิญครั้งแรก หากเพิ่มผู้ทดสอบในรุ่นต่อๆ ไป App Distributionจะไม่ส่งการแจ้งเตือนรุ่นให้ผู้ทดสอบรายนั้นโดยอัตโนมัติ เนื่องจากผู้ทดสอบรายดังกล่าวไม่ยอมรับคำเชิญครั้งแรก

วิธีแก้ปัญหาที่ 1

  1. ขอให้ผู้ทดสอบตรวจสอบโฟลเดอร์จดหมายขยะและตัวกรองอีเมลที่ตั้งค่าไว้ในบริการอีเมล

  2. หากผู้ทดสอบยกเลิกการสมัครรับอีเมลแล้ว ให้ขอให้ผู้ทดสอบทำดังนี้

    1. ค้นหาอีเมลที่ผู้ทดสอบได้รับจากแอปก่อนหน้านี้
    2. คลิกจัดการการตั้งค่าอีเมลที่ด้านล่าง แล้วคลิกอนุญาตอีเมลเพื่อสมัครรับอีเมลอีกครั้ง

วิธีแก้ปัญหาที่ 2

หากผู้ทดสอบไม่สนใจการแจ้งเตือนทางอีเมลและต้องการเพียงรับคำเชิญให้ใช้แอป ผู้ทดสอบจะดูคำเชิญให้ใช้แอปที่รอดำเนินการได้โดยตรงในFirebase App Distributionเว็บคลิป appdistribution.firebase.google.com

วิธีแก้ปัญหาที่ 3

  1. ลบผู้ทดสอบออกจากส่วนดูผู้ทดสอบทั้งหมดของแท็บผู้ทดสอบและกลุ่มในหน้า App Distribution ในคอนโซล Firebase การดำเนินการนี้จะนําคําเชิญที่มีอยู่ออก

  2. เชิญผู้ทดสอบให้ทดสอบแอปอีกครั้ง ผู้ทดสอบควรได้รับอีเมลคำเชิญ ตรวจสอบว่าผู้ทดสอบตอบรับคำเชิญด้วยอีเมลเดียวกันกับที่ได้รับคำเชิญ

ข้อผิดพลาดนักพัฒนาแอปองค์กรที่ไม่น่าเชื่อถือจะปรากฏขึ้นหากคุณไม่ได้เชื่อถือใบรับรองนักพัฒนาแอปในอุปกรณ์ทดสอบก่อนเปิดแอป ในหน้าจอแอปการตั้งค่า > การจัดการโปรไฟล์และอุปกรณ์ ให้เลือกชื่อนักพัฒนาแอปและเชื่อถือ

ข้อผิดพลาด "ต้องใช้โหมดนักพัฒนาแอป" จะปรากฏขึ้นเมื่อคุณพยายามเปิดแอป iOS ที่เตรียมความพร้อมแบบเฉพาะกิจใน iOS 16 ขึ้นไปโดยไม่เปิดใช้โหมดนักพัฒนาแอปก่อน

หากต้องการเปิดใช้โหมดนักพัฒนาซอฟต์แวร์และแก้ไขข้อผิดพลาดนี้ ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิดแอปการตั้งค่าใน iPhone แล้วแตะความเป็นส่วนตัวและความปลอดภัย
  2. เลื่อนลงไปที่ "ความปลอดภัย" แล้วแตะโหมดนักพัฒนาซอฟต์แวร์
  3. แตะแถบเลื่อนโหมดนักพัฒนาซอฟต์แวร์
  4. แตะรีสตาร์ท
  5. หลังจากอุปกรณ์รีสตาร์ทแล้ว ให้ปลดล็อกอุปกรณ์ กล่องโต้ตอบ "เปิดโหมดนักพัฒนาซอฟต์แวร์ไหม" จะปรากฏขึ้น
  6. แตะเปิด ตอนนี้คุณก็เปิดแอปและเริ่มทดสอบได้แล้ว

หากคุณกำลังติดตั้งการเผยแพร่แบบเฉพาะกิจ ข้อความนี้จะปรากฏขึ้นเมื่อนักพัฒนาแอปยังไม่ได้กำหนดค่าแอปให้ทำงานในอุปกรณ์ทดสอบ หากต้องการให้แอปพร้อมใช้งานสำหรับคุณ นักพัฒนาแอปต้องทําตามวิธีการในลงทะเบียนอุปกรณ์เพิ่มเติม

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

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

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

หากมีบัญชีหลายบัญชี ให้ลองเข้าสู่ระบบด้วยบัญชีอื่นที่ไม่ได้ถูกจํากัดไม่ให้ติดตั้งและทดสอบแอป

การเปิดใช้การแจ้งเตือนในแอปด้วย App Distribution iOS SDK

ใช้เคล็ดลับต่อไปนี้เพื่อแก้ปัญหาเกี่ยวกับการเปิดใช้การแจ้งเตือนเกี่ยวกับบิลด์ใหม่ในแอปโดยใช้ App Distribution iOS SDK

หากคุณตั้งค่า App Distribution iOS SDK ในแอปแล้ว แต่ผู้ทดสอบไม่ได้รับการแจ้งเตือนในแอป ให้ตรวจสอบว่าแอปดึงข้อมูลรุ่นใหม่อยู่หรือไม่ โดยทำดังนี้

  1. เปิดใช้โหมดแก้ไขข้อบกพร่องในแอป ดูวิธีได้ที่เอกสารประกอบของ Google Analytics

  2. เรียกใช้แอปในเครื่องจำลองและค้นหาสตริง "[Firebase/AppDistribution]"

  3. ตรวจสอบว่าผู้ทดสอบมีสิทธิ์เข้าถึงรุ่นใหม่ โดยทำดังนี้

    • หากระบบแสดงออบเจ็กต์การเผยแพร่ที่ถูกต้อง แสดงว่าอาจมีปัญหาในวงจร View Controller ที่โหลดกล่องโต้ตอบการแจ้งเตือนก่อนที่จะมีการแสดง View

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

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

      1. ลงชื่อเข้าใช้เว็บคลิปการแจกจ่ายแอป Firebase ในอุปกรณ์ทดสอบ อย่าลืมเลือกบัญชี Google ที่คุณใช้ครั้งแรกเมื่อยอมรับคำเชิญให้ทดสอบแอป

      2. ตรวจสอบว่ารุ่นใหม่ของแอปพร้อมให้บริการในเว็บคลิป

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

  • ตรวจสอบว่าคุณได้เปิดใช้ Firebase App Testers API แล้ว ดูข้อมูลเพิ่มเติมได้ที่เปิดใช้ App Distribution Tester API

  • ในส่วนการจํากัดคีย์ ให้ตรวจสอบว่า Firebase App Testers API รวมอยู่ในรายการ API ที่อนุญาต

  • หากปกติคุณล้าง UserDefaults เมื่อออกจากระบบ คุณอาจล้างสถานะของผู้ทดสอบ App Distribution จะจัดเก็บ Flag ที่ระบุว่าผู้ทดสอบได้ลงชื่อเข้าใช้แอปแล้วหรือยัง ดูข้อมูลเพิ่มเติมได้ที่ที่เก็บ 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 วันจนถึงวันที่หมดอายุ การแจ้งเตือนการหมดอายุของแอปรุ่นจะปรากฏในรุ่นของคุณในหน้า App Distribution ของคอนโซล Firebase และในเว็บแอปสำหรับเทสเตอร์ App Distribution

App Distribution รองรับรุ่นได้สูงสุด 1,000 รุ่น

App Distribution อนุญาตให้มีรุ่นได้สูงสุด 1,000 รุ่นต่อแอป เมื่อแอปของคุณมีรุ่นถึงขีดจํากัด 1,000 รุ่น App Distribution จะลบรุ่นที่เก่าที่สุดซึ่งเกินขีดจํากัดโดยอัตโนมัติ

หากต้องการจัดการรุ่นของแอปด้วยตนเอง ให้ใช้ App Distribution REST API เพื่อแสดงรายการและลบรุ่นของแอปหลายรายการพร้อมกัน

หากมีข้อสงสัย โปรดติดต่อทีมสนับสนุน Firebase

โปรไฟล์ Firebase คือโปรไฟล์การกําหนดค่าที่อนุญาตให้ App Distribution ทําสิ่งต่อไปนี้ได้

  • ลงทะเบียนอุปกรณ์ทดสอบโดยรวบรวมรหัสอุปกรณ์ที่ไม่ซ้ำกัน (UDID) ของอุปกรณ์ หากคุณกำลังทดสอบการเผยแพร่แบบเฉพาะกิจ Firebase จะส่งอีเมลที่มี UDID ของอุปกรณ์ทดสอบไปให้นักพัฒนาแอป พร้อมวิธีการรวมอุปกรณ์ในโปรไฟล์การจัดสรรของแอปเพื่อให้ทดสอบบิลด์ในอุปกรณ์ได้

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

หากต้องการความช่วยเหลือในการติดตั้งโปรไฟล์การกำหนดค่าในอุปกรณ์ iOS โปรดดูเอกสารประกอบของ Apple

หากคุณเป็นผู้ทดสอบ คุณจะเข้าถึงแอปทดสอบทั้งหมดได้ด้วยFirebase App Distributionเว็บคลิป ซึ่งจะเพิ่มลงในหน้าจอหลักของอุปกรณ์ทดสอบโดยอัตโนมัติเมื่อคุณติดตั้งโปรไฟล์ Firebase หากจะทดสอบการเผยแพร่แบบเฉพาะกิจ คุณต้องติดตั้งโปรไฟล์ก่อนจึงจะทดสอบแอปได้

หากกำลังทดสอบรุ่น Enterprise คุณสามารถติดตั้งโปรไฟล์ด้วยตนเองได้โดยทำดังนี้

  1. ลงชื่อเข้าใช้ Google และยอมรับคําเชิญ หากยังไม่ได้ดำเนินการ

  2. เลือกแอปที่ต้องการทดสอบในส่วนทดสอบแอป

  3. แตะ ที่ด้านขวาบนของหน้าแอป

  4. ทำตามวิธีการที่แสดงเพื่อติดตั้งโปรไฟล์ Firebase

หากต้องการลบApp Distributionบัญชีผู้ทดสอบและข้อมูลที่เกี่ยวข้อง ให้ทำตามขั้นตอนต่อไปนี้

  1. ไปที่ https://appdistribution.firebase.google.com แล้วลงชื่อเข้าใช้ด้วยบัญชี Google

  2. คลิก (จัดการบัญชี) ที่ด้านขวาบน

    ลบบัญชี

  3. ไม่บังคับ: ในสิทธิ์ของบัญชี Google ให้เพิกถอนสิทธิ์เข้าถึงจาก Firebase App Distribution โปรดทราบว่าการเพิกถอนสิทธิ์เข้าถึงโดยไม่ลบบัญชี App Distribution ออกก่อนจะไม่ลบบัญชีหรือข้อมูลของผู้ทดสอบ