בדיקה באמצעות Google Cloud CLI

במדריך הזה מוסבר איך להריץ בדיקת XCTest או בדיקת Game Loop באמצעות gcloud CLI.

שלב 1: מגדירים את סביבת Google Cloud SDK המקומית

1. הורדה של Google Cloud SDK

זה כולל את ה-CLI של gcloud.

2. מוודאים שההתקנה עדכנית וכוללת את הפקודה gcloud firebase:

         gcloud components update

3. מתחברים ל-CLI של gcloud באמצעות חשבון Google:

         gcloud auth login

4. מגדירים את פרויקט Firebase ב-gcloud, כאשר PROJECT_ID הוא מזהה פרויקט Firebase:

        gcloud config set project PROJECT_ID

שלב 2: מריצים את הבדיקה

הפעלת XCTest

1. מעלים את קובץ ה-‎ .zip של הבדיקה על ידי הרצת הפקודה הבאה (אם עדיין לא יצרתם חבילה של האפליקציה, אפשר לעיין במאמר בנושא יצירת חבילה של XCTest):

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

2. בוחרים את המאפיינים לבדיקה.

   ‫Test Lab מאפשרת לכם להריץ בדיקות במגוון גרסאות של iOS, מכשירים, כיווני מסך ואזורים. ההגדרות האלה נקראות מאפייני הבדיקה. כדי לראות את האפשרויות לכל מאפיין (למשל, גרסאות Xcode נתמכות לגרסת ה-iOS של המכשיר), מחליפים את models, versions או locales ב-dimension בפקודה הבאה:

   gcloud firebase test ios dimension list

   כיוון המסך הוא פשוט יותר, כי האפשרויות היחידות שלו הן portrait ו-landscape.

   מעיינים ברשימת מאפייני הבדיקה ובוחרים כמה שילובים שרוצים להריץ עליהם את הבדיקה. בקטע תוכניות תמחור אפשר לראות את המספר המקסימלי של שילובים שאפשר להפעיל בכל יום.

3. אחרי שבוחרים קבוצה של מאפייני בדיקה, אפשר להריץTest Lab את הבדיקות באמצעות הפקודה firebase test ios run. לכל שילוב של מאפייני בדיקה שרוצים לבדוק, מוסיפים דגל --device נפרד:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   יכול להיות שהבדיקה תיכשל בגלל חוסר תאימות בין גרסת Xcode שבה נוצרה הבדיקה לבין גרסת Xcode שמוגדרת כברירת מחדל ב-Test Lab. כדי לציין גרסת Xcode נתמכת לבדיקה, משתמשים בדגל --xcode-version:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   כדי לעזור לכם לזהות ולאתר את מטריצות הבדיקה במסוף Firebase, אתם יכולים להוסיף למטריצת הבדיקה תווית באמצעות הדגל --client-details matrixLabel="<label>" בדוגמה הבאה:

   ‫

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

   ‫

הפעלת בדיקה של Game Loop

מריצים את הפקודה gcloud beta firebase test ios run ומשתמשים בדגלים הבאים כדי להגדיר את הריצה:

לדוגמה, הפקודה הבאה מריצה בדיקת לולאת משחק שמבצעת את הלולאות 1, 4, 6, 7 ו-8 באייפון 8 פלוס:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

מידע נוסף על ה-CLI של gcloud מופיע במאמרי העזרה.

שלב 3 (אופציונלי): הגדרת אוטומציה לבדיקות עתידיות שתיצרו

כתיבת סקריפטים של פקודות gcloud באמצעות Test Lab

אפשר להשתמש בסקריפטים של Shell או בקובצי אצווה כדי להריץ באופן אוטומטי פקודות לבדיקת אפליקציות לנייד, שאחרת הייתם מריצים באמצעות שורת הפקודה של gcloud. סקריפט ה-Bash לדוגמה הזה מריץ XCTest עם זמן קצוב לתפוגה של שתי דקות, ומדווח אם הרצת הבדיקה הושלמה בהצלחה:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

קודי יציאה של סקריפטים

‫Test Lab מספק כמה קודי יציאה שבהם אפשר להשתמש כדי להבין טוב יותר את תוצאות הבדיקות שמריצים באמצעות סקריפטים או קובצי אצווה.

שלב 4: בדיקת תוצאות הבדיקה

כשהבדיקה מתחילה, מקבלים קישור לדף תוצאות הבדיקה. משך הבדיקות יכול להיות כמה דקות, בהתאם למספר ההגדרות השונות שבחרתם ולמשך הזמן הקצוב לתפוגה שהגדרתם לבדיקות. אחרי שהבדיקות יסתיימו, תוכלו לעיין בתוצאות הבדיקה. במאמר ניתוח התוצאות של Firebase Test Lab מוסבר איך לפרש את תוצאות הבדיקה.

השלב הבא

כדי לבדוק אילו אפשרויות בדיקה זמינות לכלל המשתמשים או נמצאות בבטא, אפשר לקרוא את מאמרי העזרה של Google Cloud SDK.