הפעל XCTest

מדריך זה מתאר כיצד להכין XCTest לבדיקה במעבדת הבדיקות של Firebase.

שלב 1 : הגדר את מיקום הנתונים הנגזרים של הפרויקט שלך

Xcode ממקם פריטי iOS מורכבים, כולל כל בדיקות שאתה בונה, בספריית נתונים נגזרים. אפשר לשמור את מיקום ברירת המחדל של ספריה זו, אם תרצה, אבל לעתים קרובות זה מועיל לבחור מקום נגיש יותר עבור הקבצים, במיוחד אם אתה הולך להריץ בדיקות עם Test Lab לעתים קרובות:

  1. פתח את הפרויקט שלך ב-Xcode.
  2. בשורת התפריטים של macOS, בחר קובץ > הגדרות פרויקט...
  3. שנה את התפריט הנפתח נתונים נגזרים ממיקום ברירת מחדל למיקום מותאם אישית .
  4. בשדה שמתחת לתפריט הנפתח, בחר מיקום עבור Xcode להפלט של הבדיקות שלך. (זהו FOLDER_WITH_TEST_OUTPUT שלך)

שלב 2 : בניית קובץ בדיקה גנרי

Test Lab מפעילה בדיקות יחידות ובדיקות ממשק משתמש באמצעות מסגרת XCTest . כדי להפעיל את XCTests של האפליקציה שלך במכשירי Test Lab, בנה אותה לבדיקה במכשיר iOS גנרי:

  1. מהתפריט הנפתח של המכשיר בחלק העליון של חלון סביבת העבודה של Xcode, בחר מכשיר iOS Generic .
  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. לאחר שהבדיקה שלך נבנתה בהצלחה, דחס אותה להעלאה ל-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 _iphoneos DEPLOYMENT_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 .