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

   หมายเหตุ: 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. หลังจากสร้างการทดสอบเรียบร้อยแล้ว ให้ใส่ไฟล์ลงในไฟล์ 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