คู่มือนี้อธิบายวิธีเตรียม XCTest สำหรับการทดสอบใน Firebase Test Lab
ขั้นตอนที่ 1: กำหนดค่าตำแหน่งข้อมูลที่ได้รับของโปรเจ็กต์
Xcode จะวางอาร์ติแฟกต์ของ iOS ที่คอมไพล์ไว้ รวมถึงการทดสอบที่คุณสร้างในไดเรกทอรี Derived Data คุณเลือกที่จะเก็บตำแหน่งเริ่มต้นสำหรับไดเรกทอรีนั้นได้ไว้ หากต้องการ แต่การเลือกตำแหน่งที่เข้าถึงได้ง่ายขึ้นสำหรับไฟล์ๆ จะสะดวกมากขึ้น โดยเฉพาะในกรณีที่คุณจะทำการทดสอบกับ Test Lab บ่อยครั้ง
- เปิดโปรเจ็กต์ใน Xcode
- ในแถบเมนู macOS ให้เลือก ไฟล์ > การตั้งค่าโปรเจ็กต์...
- เปลี่ยนเมนูแบบเลื่อนลงข้อมูลที่ดึงมาจากตำแหน่งเริ่มต้นเป็นตำแหน่งที่กำหนดเอง
- ในช่องใต้เมนูแบบเลื่อนลง ให้เลือกตำแหน่งที่ Xcode จะแสดงการทดสอบของคุณ (นี่คือ FOLDER_WITH_TEST_OUTPUT ของคุณ)
ขั้นตอนที่ 2: สร้างไฟล์ทดสอบทั่วไป
Test Lab เรียกใช้การทดสอบหน่วยและการทดสอบ UI โดยใช้เฟรมเวิร์ก XCTest หากต้องการเรียกใช้ XCTests ของแอปในอุปกรณ์ Test Lab ให้สร้างแอปนี้สำหรับการทดสอบในอุปกรณ์ iOS ทั่วไป โดยทำดังนี้
- จากเมนูแบบเลื่อนลงของอุปกรณ์ที่ด้านบนของหน้าต่างพื้นที่ทำงาน Xcode ให้เลือก อุปกรณ์ iOS ทั่วไป
- ในแถบเมนู macOS ให้เลือก ผลิตภัณฑ์ > สร้างสำหรับ > การทดสอบ
หรือจะสร้าง XCTest จากบรรทัดคำสั่งก็ได้ ใช้คำสั่งต่อไปนี้ในเทอร์มินัล
โปรเจ็กต์
xcodebuild -project PATH/TO/YOUR_WORKSPACE/YOUR_PROJECT.xcodeproj \ -scheme YOUR_SCHEME \ -derivedDataPath FOLDER_WITH_TEST_OUTPUT \ -sdk iphoneos build-for-testing
พื้นที่ทำงาน
xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \ -scheme YOUR_SCHEME \ -derivedDataPath FOLDER_WITH_TEST_OUTPUT \ -sdk iphoneos build-for-testing
ขั้นตอนที่ 3: ลงนามในการทดสอบและยืนยัน
ตรวจสอบว่าอาร์ติแฟกต์ทั้งหมดในแอปและการทดสอบได้รับการลงนามแล้ว ตัวอย่างเช่น คุณดำเนินการผ่าน Xcode ได้โดยระบุการตั้งค่าการลงชื่อ เช่น โปรไฟล์การจัดสรรและข้อมูลประจำตัว สำหรับข้อมูลเพิ่มเติม โปรดดู Apple Code Signing
ยืนยันลายเซ็นของแอปโดยเรียกใช้
codesign --verify --deep --verbose /path/to/MyApp.app
โดยที่ "MyApp" เป็นชื่อแอปภายในโฟลเดอร์ที่แตกแล้ว ซึ่งจะแตกต่างกันไปตามแต่ละโปรเจ็กต์ เอาต์พุตที่คาดไว้คือMyApp.app: valid on disk
หากคุณใช้ XCUITest อยู่ คุณต้องยืนยันการทดสอบและตัวเรียกใช้โดยเรียกใช้
codesign --verify --deep --verbose /path/to/MyTest-Runner.app
โดยที่ "MyTest" เป็นชื่อตัวเรียกใช้ในโฟลเดอร์ที่แตกไฟล์แล้ว ซึ่งจะแตกต่างกันไปตามแต่ละโปรเจ็กต์ เอาต์พุตที่คาดไว้คือMyTest-Runner.app: valid on disk
ขั้นตอนที่ 4: รวมแอปและทดสอบสำหรับการอัปโหลด
หลังจากสร้างการทดสอบสำเร็จแล้ว ให้บีบอัดเพื่ออัปโหลดไปยัง Test Lab ดังนี้
cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \ zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
นอกจากนี้ คุณยังสามารถรวมการทดสอบเป็นแพ็กเกจโดยการบีบอัดไฟล์ทดสอบด้วยตนเอง ดังนี้
เปิด Finder และไปที่
FOLDER_WITH_TEST_OUTPUT
เปิดโฟลเดอร์ที่มีชื่อโปรเจ็กต์เป็นคํานําหน้า จากนั้นไปที่โฟลเดอร์
Build/Products
ภายในเลือกโฟลเดอร์
Debug-iphoneos
และYOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
จากนั้นบีบอัด
ขั้นตอนที่ 5: (ไม่บังคับ) ทำการทดสอบภายในเครื่อง
ก่อนทำการทดสอบด้วย Test Lab คุณสามารถเรียกใช้ในเครื่องด้วยอุปกรณ์ที่เชื่อมต่อกับ USB เพื่อตรวจสอบคุณภาพลักษณะการทำงาน ดังนี้
xcodebuild test-without-building \ -xctestrun "Derived Data/Build/Products/YOUR_SCHEME.xctestrun" \ -destination id=your-phone-id
ขั้นตอนถัดไป
อัปโหลดและทำการทดสอบในคอนโซล Firebase หรือ gcloud CLI