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

1. จากเมนูแบบเลื่อนลงของอุปกรณ์ที่ด้านบนของหน้าต่างพื้นที่ทํางาน Xcode ให้เลือกอุปกรณ์ iOS ทั่วไป
2. ในแถบเมนูของ 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: ลงชื่อทดสอบและยืนยัน

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