Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

בדוק עם ה- CLI של gcloud

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

שלב 1: סביבת SDK המקומית Configure Google Cloud

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

  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

שלב 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. ברגע שבחרת לקבוצת מאפייני מבחן, אתה יכול לקבל בדיקת המעבדה להריץ בדיקות באמצעות 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=11.3

בדוק זכויות מיוחדות

כדי זכאויות מבחן הדורשים זיהוי אפליקציה מפורש, אתה יכול לעשות זאת על ידי קביעה --test-special-entitlements הדגל. Test Lab חותם מחדש על האפליקציה עם מזהה צרור חדש לתמיכה בזכויות מיוחדות, לכן אנא וודא שאין משאבים בקובץ ה- zip שלך המכיל הפניות ישירות לזהות החבילה של האפליקציה.

הודעות Push

לאישור בקשות של התראות דחיפה, משתמשים יכולים ליצור אסימוני אינטרנט JSON באמצעות פרטי מפתח החתימה יחד עם מזהה המפתח - C7FD9DJAA8 ואת מספר הקבוצה - 9CKCGNNUQN. האסימונים שנוצרו יהיו תקפים למשך שעה אחת ויש צורך לרענן אותם כל 60 דקות. קרא עוד על יצירת חיבור בהתבסס-אסימון כדי APNs.

הפעל מבחן משחק לולאה

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

דגלים למבחני לולאת המשחק
--type

נדרש: מציין את סוג מבחן iOS שברצונך להפעיל. אתה יכול להיכנס מבחן סוגים xctest (ברירת מחדל) או game-loop .

--app

נדרש: נתיב מוחלט (GCS או קבצים) בקובץ IPA של האפליקציה שלך. דגל זה תקף רק בעת הפעלת בדיקות לולאת המשחק.

--scenario-numbers

הלולאות (aka תרחישים) שברצונך להריץ באפליקציה שלך. ניתן להזין לולאה אחת, רשימה או לולאות, או טווח לולאות. לולאת ברירת המחדל היא 1.

לדוגמה, --scenario-numbers=1-3,5 ריצות לולאות 1, 2, 3, ו 5.

--device-model

המכשיר הפיזי שברצונך להפעיל מבחן שלך על (לגלות אילו התקנים זמינים שתוכל להשתמש).

--timeout

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

לדוגמה:

  • --timeout=200 כוחות המבחן שלך להפסיק כאשר הוא פועל עד 200 שניות.
  • --timeout=1h מאלצת הבדיקה שלך להפסיק כאשר הוא פועל עד שעה.

לדוגמה, הפקודה הבאה מריצה בדיקת Game Loop שמבצעת לולאות 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, לראות את תיעוד ההפניה .

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

סקריפט פקודות gcloud עם Test Lab

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

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

שלב 5: חקור תוצאות הבדיקה

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

השלב הבא

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