Pilot (Fastlane): แนวคิดสำคัญ, TestFlight และการจัดการบิวด์สำหรับโปรเจกต์มือถือ

Pilot (Fastlane) คืออะไร?

Pilot (Fastlane) เป็นส่วนประกอบของระบบนิเวศ Fastlane สำหรับทำงานอัตโนมัติกับ TestFlight — แพลตฟอร์มของ Apple สำหรับการทดสอบเบต้าของแอปพลิเคชันมือถือ Pilot จัดการงานประจำทั้งหมด: อัปโหลดบิวด์ เพิ่มผู้ทดสอบ จัดการกลุ่ม และติดตามสถานะบิวด์

หากไม่มี Pilot กระบวนการกระจายเวอร์ชันเบต้าจะเป็นดังนี้ นักพัฒนาเปิด App Store Connect ด้วยตนเอง เลือกแอป อัปโหลด IPA ผ่าน Xcode Organizer กำหนดค่ากลุ่มผู้ทดสอบ และส่งคำเชิญ TestFlight คือบริการของ Apple สำหรับกระจายเวอร์ชันเบต้าของแอปให้ผู้ทดสอบก่อนเผยแพร่ทางการบน App Store

ตาม App Store Connect Help (2025) ผู้ทดสอบภายนอกต้องผ่านกระบวนการ Beta App Review ก่อนการติดตั้งบิวด์ครั้งแรก — ใช้เวลา 1 ถึง 48 ชั่วโมง Pilot จะติดตามสถานะการตรวจสอบโดยอัตโนมัติและแจ้งทีมเมื่อบิวด์พร้อมสำหรับการกระจายไปยังกลุ่มผู้ทดสอบภายนอก

ใช้ Pilot ในโปรเจกต์ใดก็ตามที่ต้องการส่งบิวด์เบต้าให้ผู้ทดสอบเป็นประจำ — เป็นเครื่องมือมาตรฐานสำหรับไปป์ไลน์ CI/CD ของ iOS ที่รับประกันกระบวนการส่งมอบที่คาดเดาได้

ฟังก์ชันหลักของ Pilot สำหรับ TestFlight

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

การอัปโหลดบิวด์ไปยัง TestFlight

คำสั่ง fastlane pilot upload อัปโหลดไฟล์ IPA ไปยัง App Store Connect และสร้างบิวด์ใหม่ใน TestFlight Pilot จะตรวจสอบความถูกต้องของไฟล์ไบนารี ความเข้ากันได้ของเวอร์ชัน และตัวระบุแอปโดยอัตโนมัติ App Store Connect คือแพลตฟอร์มของ Apple สำหรับจัดการแอปพลิเคชัน รวมถึงการอัปโหลดบิวด์ เมทาดาทา การวิเคราะห์ และรายงานการขาย

หลังอัปโหลด Pilot จะรอให้ Apple ประมวลผลไฟล์ไบนารี — กระบวนการใช้เวลา 5 ถึง 30 นาทีขึ้นอยู่กับขนาดของบิวด์ ระหว่างรอ Pilot จะแสดงแถบความคืบหน้าพร้อมข้อมูลเกี่ยวกับสถานะการประมวลผลปัจจุบัน: Processing, Validating หรือ Ready เมื่อประมวลผลสำเร็จ บิวด์จะพร้อมสำหรับการกำหนดให้กับกลุ่มผู้ทดสอบ

การจัดการกลุ่มผู้ทดสอบ

Pilot รองรับการจัดการทั้งกลุ่มผู้ทดสอบภายในและภายนอก ผู้ทดสอบภายใน คือสมาชิกทีม Apple Developer ของคุณที่เข้าถึงบิวด์ได้ทันทีโดยไม่ต้องผ่าน Beta App Review ผู้ทดสอบภายนอกคือผู้ใช้ที่ได้รับเชิญทางอีเมล ซึ่งต้องได้รับการอนุมัติการตรวจสอบก่อนการติดตั้งครั้งแรก

คำสั่ง fastlane pilot add เพิ่มผู้ทดสอบใหม่ในกลุ่มทางอีเมลหรือ Apple ID Pilot จะส่งคำเชิญโดยอัตโนมัติและตรวจสอบว่าผู้ทดสอบยอมรับคำเชิญหรือไม่ สำหรับการเพิ่มจำนวนมาก คุณสามารถส่งรายการอีเมลจากไฟล์โดยใช้พารามิเตอร์ --testers_file_path ซึ่งสะดวกเมื่อสร้างกลุ่มผู้ทดสอบเริ่มต้นที่มีผู้เข้าร่วมหลายร้อยคน

# การอัปโหลดบิวด์ใหม่ไปยัง TestFlight
fastlane pilot upload --ipa "build/MyApp.ipa"

# การเพิ่มผู้ทดสอบในกลุ่ม
fastlane pilot add --email "tester@company.com" \
      --groups "QA Team"

การติดตั้งและกำหนดค่า Pilot

การกำหนดค่า Pilot ไม่จำเป็นต้องมีไฟล์กำหนดค่าแยกต่างหาก — การตั้งค่าจะถูกส่งผ่าน Appfile (ไฟล์ Fastlane ทั่วไป) หรืออาร์กิวเมนต์บรรทัดคำสั่ง พารามิเตอร์หลักประกอบด้วย apple_id ของแอป, app_identifier, team_id และข้อมูลรับรองสำหรับเข้าถึง App Store Connect API

สำหรับการตรวจสอบสิทธิ์ Pilot ใช้ App Store Connect API Key (วิธีที่แนะนำ) หรือการตรวจสอบสิทธิ์แบบสองปัจจัยของ Apple ID App Store Connect API Key คือคีย์การเข้าถึงที่สร้างขึ้นใน App Store Connect ซึ่งอนุญาตให้โต้ตอบกับ API โดยไม่ต้องป้อนรหัสผ่านและรหัสยืนยันแบบโต้ตอบ

# Appfile — การกำหนดค่าทั่วไปของ Fastlane
app_identifier("com.company.app")
apple_id("developer@company.com")
team_id("TEAM123456")

# ตัวแปรสภาพแวดล้อมสำหรับ Pilot
# APP_STORE_CONNECT_API_KEY_PATH=/path/to/key.p8

พารามิเตอร์ app_identifier กำหนด Bundle Identifier ของแอป ซึ่งต้องตรงกับตัวระบุที่ระบุในโปรเจกต์ Xcode และ App Store Connect พารามิเตอร์ apple_id ใช้สำหรับการตรวจสอบสิทธิ์ในรูปแบบสองปัจจัย และ team_id — สำหรับเลือกทีมพัฒนาหากบัญชีเชื่อมโยงกับหลายทีม Apple Developer

สำหรับ Pilot ทำงาน คุณต้องกำหนดค่า App Store Connect API Key ในสภาพแวดล้อม CI/CD คีย์ถูกสร้างขึ้นใน App Store Connect → Users and Access → Keys → Generate API Key บันทึกไฟล์ .p8 ในความลับของระบบ CI และระบุเส้นทางผ่านตัวแปรสภาพแวดล้อม APP_STORE_CONNECT_API_KEY_PATH หรือพารามิเตอร์ --api_key_path ในคำสั่ง Pilot

คำสั่ง Pilot สำหรับการจัดการบิวด์

ชุดคำสั่ง Pilot ครอบคลุมสถานการณ์ TestFlight ทั้งหมด: การอัปโหลดบิวด์ การจัดการผู้ทดสอบ การดูสถานะ และการติดตามเมทาดาทา แต่ละคำสั่งจะส่งคืนเอาต์พุต JSON ที่มีโครงสร้างสำหรับการประมวลผลเพิ่มเติมในสคริปต์ CI/CD

การดูสถานะบิวด์

คำสั่ง fastlane pilot builds แสดงรายการบิวด์ทั้งหมดของแอปพร้อมเวอร์ชัน สถานะการประมวลผล และวันที่อัปโหลด สถานะบิวด์ สามารถเป็นหนึ่งใน: Processing — Apple กำลังประมวลผลไฟล์ไบนารี, Ready — บิวด์พร้อมสำหรับการกระจาย, Rejected — บิวด์ถูกปฏิเสธเนื่องจากข้อผิดพลาดในการตรวจสอบ

# การดูรายการบิวด์ทั้งหมดใน TestFlight
fastlane pilot builds

# การกำหนดบิวด์ให้กลุ่มผู้ทดสอบ
fastlane pilot distribute --build_number 42 \
      --groups "QA Team" --notify

# การดูข้อมูลเกี่ยวกับบิวด์ที่ระบุ
fastlane pilot build_info --build_number 42

คำสั่ง fastlane pilot distribute กำหนดบิวด์ให้กับกลุ่มผู้ทดสอบที่ระบุและส่งการแจ้งเตือน พารามิเตอร์ --notify เปิดใช้งานการส่งการแจ้งเตือนทางอีเมลไปยังผู้ทดสอบเกี่ยวกับบิวด์ใหม่ที่พร้อมใช้งาน — ซึ่งสำคัญสำหรับการดึงดูดผู้ทดสอบเบต้าในกระบวนการทดสอบและเร่งการตอบกลับ

สำหรับจัดการเมทาดาทาของบิวด์ ให้ใช้พารามิเตอร์ --changelog ซึ่งกำหนดข้อความอธิบายการเปลี่ยนแปลงในเวอร์ชันใหม่ ข้อความนี้จะแสดงให้ผู้ทดสอบเห็นในคำเชิญทดสอบในแอป TestFlight แนะนำให้ระบุการเปลี่ยนแปลงสำคัญ จุดบกพร่องที่แก้ไข และฟีเจอร์ใหม่ในแต่ละบิวด์

การรวม Pilot ในไปป์ไลน์ CI/CD

Pilot ใน CI/CD คือขั้นตอนสุดท้ายของไปป์ไลน์การส่งมอบแอป iOS หลังจาก Gym สร้าง IPA และการทดสอบผ่านแล้ว Pilot จะอัปโหลดบิวด์ไปยัง TestFlight และกระจายไปยังกลุ่มผู้ทดสอบ ช่วยให้ทีม QA ได้รับเวอร์ชันแอปใหม่ภายในไม่กี่นาทีหลังจาก commit ใน repository

ไปป์ไลน์ CI/CD ทั่วไปของ iOS ประกอบด้วยลำดับ: Match (ใบรับรอง), Gym (สร้าง IPA), Pilot (อัปโหลดไปยัง TestFlight และกระจาย) แต่ละขั้นตอนขึ้นอยู่กับขั้นตอนก่อนหน้า เพื่อให้แน่ใจว่ามีเพียงบิวด์ที่ถูกต้องและลงนามแล้วเท่านั้นที่ส่งถึงผู้ทดสอบ

# ไปป์ไลน์ทั้งหมดใน Fastfile
lane :beta do
    match(type: :appstore)
    gym(scheme: "MyApp", export_method: "app-store")
    pilot("build/MyApp.ipa", groups: ["QA", "PM"])
end

พารามิเตอร์ skip_waiting ในคำสั่ง upload อนุญาตให้ไม่รอการประมวลผลไฟล์ไบนารีของ Apple ในงาน CI — Pilot ส่งคำขออัปโหลด รับตัวระบุบิวด์ และสิ้นสุดการทำงาน ซึ่งช่วยเร่งไปป์ไลน์เนื่องจากการประมวลผลอาจใช้เวลาถึง 30 นาที ซึ่งไม่ต้องเสียเวลารอใน CI runner

สำหรับ Pilot ทำงานอย่างถูกต้องใน CI คุณต้องกำหนดค่ารหัส API ของ App Store Connect บันทึกไฟล์คีย์ .p8 ในที่เก็บข้อมูลที่ปลอดภัยของระบบ CI และส่งเส้นทางผ่านตัวแปรสภาพแวดล้อม APP_STORE_CONNECT_API_KEY_PATH Pilot ใช้คีย์นี้ในการตรวจสอบสิทธิ์ใน API โดยไม่ต้องตรวจสอบสิทธิ์แบบสองปัจจัย ซึ่งสำคัญสำหรับสถานการณ์อัตโนมัติ

ปัญหาทั่วไปเมื่อทำงานกับ Pilot

เมื่อใช้ Pilot นักพัฒนามักพบข้อผิดพลาดการตรวจสอบสิทธิ์ การกำหนดค่าแอปไม่ถูกต้อง และปัญหาการประมวลผลไฟล์ไบนารีจากฝั่ง Apple การวินิจฉัยปัญหา Pilot เริ่มต้นด้วยการตรวจสอบสถานะบิวด์ใน App Store Connect ผ่านคำสั่ง pilot builds

ข้อผิดพลาด “Your app is not available for testing in TestFlight” เกิดขึ้นเมื่อแอปไม่ได้กำหนดค่าสำหรับการทดสอบใน App Store Connect วิธีแก้ไข: เปิดส่วน TestFlight ใน App Store Connect เปิดใช้งานการทดสอบสำหรับแอป และตรวจสอบว่า Export Compliance กรอกถูกต้องสำหรับประเภทการเข้ารหัสของคุณ

ข้อผิดพลาด “Missing iOS Distribution signing identity” บ่งชี้ว่าไม่มีใบรับรอง Distribution ใน Keychain วิธีแก้ไข: เรียกใช้ Match เพื่อดาวน์โหลดใบรับรองที่ถูกต้องก่อนเรียก Pilot ใบรับรอง Distribution แตกต่างจาก Development — ใช้สำหรับลงนามบิวด์ที่มีจุดประสงค์เพื่อกระจายผ่าน TestFlight หรือ App Store

เมื่อข้อผิดพลาด “Invalid Provisioning Profile” บิวด์มีโปรไฟล์ไม่ถูกต้องสำหรับวิธีการส่งออกที่เลือก วิธีแก้ไข: ตรวจสอบว่า Gym ใช้ export_method ที่ถูกต้องตรงกับประเภทโปรไฟล์ใน Match หากบิวด์ถูกสร้างด้วยโปรไฟล์ development Pilot จะไม่สามารถอัปโหลดไปยัง TestFlight ได้ — ต้องใช้โปรไฟล์ app-store หรือ ad-hoc