เรียกใช้ 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 Code Signing

   หมายเหตุ: Test Lab จะลงนามแอปอีกครั้งด้วยโปรไฟล์การจัดสรรและใบรับรองของตนเอง

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. หลังจากสร้างการทดสอบสำเร็จแล้ว ให้บีบอัดเพื่ออัปโหลดไปยัง 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