เรียกใช้ XCTest

คู่มือนี้อธิบายวิธีเตรียม XCTest สำหรับการทดสอบใน Firebase Test Lab

ขั้นตอนที่ 1: กำหนดค่าตำแหน่งข้อมูลที่ได้มาของโปรเจ็กต์

Xcode จะวางอาร์ติแฟกต์ iOS ที่คอมไพล์แล้ว ซึ่งรวมถึงการทดสอบที่คุณสร้างไว้ในไดเรกทอรี Derived Data คุณสามารถเก็บตำแหน่งเริ่มต้นสำหรับไดเรกทอรีนั้นไว้ได้หากต้องการ แต่การเลือกตำแหน่งที่เข้าถึงได้ง่ายกว่าสำหรับไฟล์มักจะเป็นประโยชน์ โดยเฉพาะอย่างยิ่งหากคุณจะทำการทดสอบด้วย Test Lab บ่อยๆ

1. เปิดโปรเจ็กต์ใน Xcode
2. ในแถบเมนู macOS ให้เลือกไฟล์ > การตั้งค่าโปรเจ็กต์...
3. เปลี่ยนเมนูแบบเลื่อนลงข้อมูลที่ได้มาจากตำแหน่งเริ่มต้นเป็นตำแหน่งที่กำหนดเอง
4. ในช่องใต้เมนูแบบเลื่อนลง ให้เลือกตำแหน่งที่ Xcode จะแสดงผลการทดสอบ (นี่คือ FOLDER_WITH_TEST_OUTPUT ของคุณ)

ขั้นตอนที่ 2: สร้างไฟล์ทดสอบทั่วไป

Test Lab เรียกใช้การทดสอบ Unit Test และการทดสอบ UI โดยใช้เฟรมเวิร์ก XCTest หากต้องการเรียกใช้ XCTest ของแอปในอุปกรณ์ Test Lab ให้สร้างแอปเพื่อทดสอบในอุปกรณ์ iOS ทั่วไป โดยทำดังนี้

1. จากเมนูแบบเลื่อนลงของอุปกรณ์ที่ด้านบนของหน้าต่างพื้นที่ทำงาน Xcode ให้เลือกอุปกรณ์ iOS ทั่วไป
2. ในแถบเมนู macOS ให้เลือกผลิตภัณฑ์ > สร้างสำหรับ > การทดสอบ

หรือจะสร้าง XCTest จากบรรทัดคำสั่งก็ได้ ใช้คำสั่งต่อไปนี้ในเทอร์มินัล

xcodebuild -project PATH/TO/YOUR_WORKSPACE/PROJECT_NAME.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: ลงชื่อเข้าใช้การทดสอบและยืนยัน

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

2. ยืนยันลายเซ็นแอปโดยเรียกใช้ codesign --verify --deep --verbose /path/to/MyApp.app โดยที่ "MyApp" คือชื่อของแอปภายในโฟลเดอร์ที่แตกไฟล์แล้ว ซึ่งจะแตกต่างกันไปในแต่ละโปรเจ็กต์ ผลลัพธ์ที่คาดหวังคือ MyApp.app: valid on disk

3. หากคุณใช้ XCUITest คุณจะต้องยืนยันการทดสอบและรันเนอร์โดยเรียกใช้ codesign --verify --deep --verbose /path/to/MyTest-Runner.app โดยที่ "MyTest" คือชื่อของรันเนอร์ภายในโฟลเดอร์ที่แตกไฟล์แล้ว ซึ่งจะแตกต่างกันไปในแต่ละโปรเจ็กต์ ผลลัพธ์ที่คาดหวังคือ MyTest-Runner.app: valid on disk

ขั้นตอนที่ 4: จัดแพ็กเกจแอปและทดสอบการอัปโหลด

1. หลังจากสร้างการทดสอบสำเร็จแล้ว ให้บีบอัดเป็นไฟล์ ZIP เพื่ออัปโหลดไปยัง Test Lab โดยทำดังนี้

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
   

นอกจากนี้ คุณยังรวมแพ็กเกจการทดสอบได้โดยการบีบอัดไฟล์ทดสอบด้วยตนเอง ดังนี้

1. เปิด Finder แล้วไปที่ FOLDER_WITH_TEST_OUTPUT

2. เปิดโฟลเดอร์ที่มีชื่อโปรเจ็กต์เป็นคำนำหน้า แล้วไปที่โฟลเดอร์ Build/Products ด้านใน

3. เลือกโฟลเดอร์ 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