Google is committed to advancing racial equity for Black communities. See how.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

התחל עם מעבדת מבחן Firebase משורת הפקודה gcloud

מעבדת בדיקת Firebase מאפשרת לך לבדוק את אפליקציית iOS שלך במכשירים מרובים דרך ממשק שורת הפקודה gcloud . המשך לקרוא כדי לגלות איך להתחיל.

צור פרויקט Firebase

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

אתה יכול להשתמש במעבדת הבדיקה למספר מוגבל של ביצוע יומיומי לבדיקות בתוכניות הניצוץ והלהבה. כדי להשתמש במעבדת מבחן ללא מגבלות מכסות יומיות, עליך לשדרג לתוכנית Firebase Blaze.

קבע את התצורה של סביבת ה- Google Cloud SDK המקומית שלך

  1. הורד את Google Cloud SDK.
  2. זה כולל את כלי ה- CLI של gcloud.

  3. ודא שההתקנה שלך מעודכנת וכוללת את הפקודה gcloud firebase :
          gcloud components update
  4. היכנס ל- CLI של gcloud באמצעות חשבון Google שלך:
          gcloud auth login
  5. הגדר את פרויקט Firebase שלך ​​ב- gcloud, כאשר PROJECT_ID הוא המזהה של פרויקט Firebase שלך:
         gcloud config set project PROJECT_ID 

בנה XCTests עבור האפליקציה שלך

כדי לבנות את המבחן שלך, השתמש בפקודה הבאה בטרמינל:

פרויקט

xcodebuild -project PATH/TO/YOUR_WORKSPACE .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

לאחר שהבדיקה שלך נבנתה בהצלחה, מיקוד אותה כדי להעלות אותה למעבדת הבדיקה:

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

הרץ את המבחנים שלך

בחר את מידות הבדיקה שלך

מעבדת הבדיקה מאפשרת לך לבצע בדיקות במגוון גרסאות iOS, מכשירים, כיווני מסך ואזורים. תצורות אלה ידועות כמידות הבדיקה . כדי לראות את האפשרויות עבור כל מאפיין, החלף models , versions או locales dimension בפקודה הבאה:

gcloud firebase test ios dimension list

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

עיין ברשימת ממדי הבדיקה ובחר כמה שילובים עליהם תרצה להפעיל את הבדיקה שלך. אם אתה משתמש בתוכניות הניצוץ או הלהבה, אתה יכול להריץ עד 5 שילובים ביום. אם אתה בתוכנית Blaze, אתה יכול להריץ מבחנים על שילובים עם מספר בלתי מוגבל ביום, אך אתה יכול לכלול רק עד 200 שילובים בכל ריצה. למידע נוסף על מגבלות מבחן ותמחור, ראה תכניות תמחור .

הרץ את הבדיקות

לאחר שבחרת קבוצה של ממדי מבחן, תוכל לאפשר למעבדת הבדיקה להריץ את הבדיקות שלך באמצעות הפקודה firebase test ios run . לכל שילוב של מידות הבדיקה עליה תרצה לבדוק, --device דגל --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 המוגדרת כברירת מחדל בה נעשה שימוש במעבדת הבדיקה. כדי לבחור את גרסת ה- Xcode לבדיקות, השתמש בדגל --xcode-version ה- --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=11.3

נתח את תוצאות הבדיקה שלך

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

אוטומציה של בדיקות עתידיות

סקריפט פקודות gcloud עם מעבדת המבחן

אתה יכול להשתמש בסקריפטים של קליפות או בקבצי אצווה כדי להפוך אוטומטית פקודות לבדיקת אפליקציות לנייד, שאחרת היית מפעיל באמצעות שורת הפקודה 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

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

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

קודי יציאה של סקריפטים עבור מעבדת הבדיקה

קוד יציאה הערות
0 כל ההוצאות להורג המבחן עברו.
1 כשל כללי התרחש. הסיבות האפשריות כוללות: שם קובץ שאינו קיים או שגיאת HTTP / רשת.
2 הושלמה בדיקה מכיוון שסופקו פקודות או טענות לא ידועות.
10 מקרי מבחן אחד או יותר (שיעורים נבדקים או שיטות כיתה) בביצוע הבדיקה לא עברו.
15 מעבדת בדיקת Firebase לא הצליחה לקבוע אם מטריצת הבדיקה עברה או נכשלה, בגלל שגיאה בלתי צפויה.
19 מטריצת הבדיקה בוטלה על ידי המשתמש.
20 אירעה שגיאת תשתית בדיקה.

השלב הבא

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