תרגום של פקודות ודגלים מ-Firebase Test Lab לפלטפורמת מכשירי מפתחים

‫Developer Device Platform (DDP) מחליפה את מסוף Firebase Test Lab הקודם ואת תהליכי העבודה של Test Lab CLI בממשק שורת פקודה (CLI) מאובטח, אחיד ובעל ביצועים גבוהים, שמתמקד ב-Google Cloud: gcloud beta device-run

המדריך הזה מספק תרגומים של שורת הפקודה ומיפויים של דגלים מ-Test Lab (או Flank) ל-DDP. ההנחיות האלה יעזרו לכם להעביר את הבדיקות באופן ידני. במאמר מעבר מ-Firebase Test Lab אל Developer Device Platform מפורטים כלי אוטומציה, יתרונות, הבדלים עיקריים וטיפים להעברה.

העברת פיצול (sharding)

DDP משדרג את הגדרות חלוקת הנתונים על ידי החלפה מקורית של חלוקת הנתונים החכמה והמורכבת של Flank שמבוססת על Cloud Storage, ושל חלוקת הנתונים האחידה של Test Lab.

פיצול אחיד

  • מגדירים את --sharding-option=uniform.
  • מגדירים את --uniform-sharding-count={count} (1-20 למכשירים פיזיים, 1-200 למכשירים וירטואליים; ב-iOS יש רק מכשירים פיזיים).

  • ‫Firebase Test Lab מדור קודם: --num-uniform-shards {N}

  • DDP CLI: --sharding-option=uniform --uniform-sharding-count={N}

חלוקה חכמה למקטעים (sharding)

  • מגדירים את --sharding-option=smart.
  • מגדירים את --smart-sharding-target-duration={duration} (למשל 2m,‏ 10m,‏ 1h; הטווח התקין: 2m עד 1h).
  • מגדירים את --smart-sharding-record-name={record_name} (מצביע על רשומת המעקב של YAML בתוך --bucket-name בקטע automation/smart-sharding/).
  • מגדירים את --smart-sharding-max-shard-count={max_count} (מגבלה מקסימלית אופציונלית: 0-20 למכשירים פיזיים, 0-200 למכשירים וירטואליים; ב-iOS יש רק מכשירים פיזיים).

שימוש במטא-נתונים היסטוריים של תזמון מ-30 הימים האחרונים:

  • ‫Flank מדור קודם:

    max-test-shards: 10
    shard-time: 120
    smart-flank-gcs-path: gs://my-bucket/smart-sharding/timing-record.yaml
    
  • DDP CLI:

    --sharding-option=smart \
    --smart-sharding-max-shard-count=10 \
    --smart-sharding-target-duration=2m \
    --smart-sharding-record-name=timing-record \
    --bucket-name=my-bucket
    

הגדרת YAML דקלרטיבית (--flags-file)

אם אתם משתמשים בהגדרות מורכבות או עובדים בצוותים שמעדיפים לתחזק קבצים עם ניהול גרסאות במקום פקודות ארוכות בטרמינל, gcloud מספק מעבד מקדים אוניברסלי של ארגומנטים ב---flags-file (ראו $ gcloud topic flags-file):

Android

gcloud beta device-run sessions submit instrumentation --flags-file=device-run-flags.yaml

iOS

gcloud alpha device-run sessions submit xctest --flags-file=device-run-flags.yaml

הדוגמה הבאה ממחישה רשימה עם ערכים מרובים ודגלי מילון:

Android

# device-run-flags.yaml
--device:

    -   mediumphone-arm-32
    -   shiba-36
--apps:
    -   app-debug.apk
    -   test-helper.apk
--test: app-debug-androidTest.apk
--bucket-name: my-bucket
--sharding-option: smart
--smart-sharding-target-duration: 2m
--smart-sharding-record-name: timing-record
--paths-to-pull:
    -   /sdcard/screenshots
    -   /sdcard/coverage.ec
--additional-test-options:
  coverage: "true"
  clearPackageData: "true"

iOS

# device-run-flags.yaml
--device:

    -   iphonese3-18-4
    -   iphone16pro-18-3
--test: MyTests.zip
--additional-apps:
    -   helper-app.ipa
--xcode-version: '16.4'
--xctest-timeout: 15m
--other-files-to-push:
  /local/path/test-config.json: com.example.app:/Documents/test-config.json
--paths-to-pull:
    -   com.example.app:/Documents/screenshots
--labels:
  env: staging
  team: mobile-qa

דוגמאות לתרגום פקודות מקצה לקצה

דוגמאות קונקרטיות לתרגומים רגילים ומורכבים מפורטות בהמשך.

דוגמה: הרצת בדיקת אינסטרומנטציה רגילה

‫Firebase CLI מדור קודם:

gcloud firebase test android run \
  --app=app-debug.apk \
  --test=app-debug-androidTest.apk \
  --device model=shiba,version=36 \
  --timeout=5m \
  --num-flaky-test-attempts=2 \
  --directories-to-pull=/sdcard/screenshots \
  --environment-variables key=value

תרגום של DDP CLI:

gcloud beta device-run sessions submit instrumentation \
  --device=shiba-36 \
  --apps=app-debug.apk \
  --test=app-debug-androidTest.apk \
  --instrumentation-timeout=5m \
  --flaky-test-attempts=3 \
  --paths-to-pull=/sdcard/screenshots \
  --additional-test-options key=value

דוגמה: העברת הגדרת YAML מורכבת של Flank

הגדרת Flank מדור קודם:

app: app-debug.apk
test: app-debug-androidTest.apk
device:
  -   model: shiba
    version: 36
shard-time: 120
smart-flank-gcs-path: gs://my-bucket/smart-sharding/timing-record.yaml

תרגום של DDP CLI:

gcloud beta device-run sessions submit instrumentation \
  --device=shiba-36 \
  --apps=app-debug.apk \
  --test=app-debug-androidTest.apk \
  --bucket-name=my-bucket \
  --sharding-option=smart \
  --smart-sharding-target-duration=2m \
  --smart-sharding-record-name=timing-record

אחרי ההרצה ואחזור התוצאות

מכיוון ש-DDP לא מופעל עם ממשק משתמש גרפי לאינטרנט (כמו מסוף Firebase הקודם), מפתחים צריכים לנהל, לתאר ולבדוק את התוצאות ישירות באמצעות ה-CLI או ממשקי API בארכיטקטורת REST פרוגרמטיים:

# 1. List active and completed test sessions
gcloud beta device-run sessions list

# 2. Get a summary and direct Cloud Storage bucket link of a session's results
gcloud beta device-run sessions describe session-number

# 3. Get detailed metadata and print full results
gcloud beta device-run sessions describe session-number --full

# 4. Cancel a running session (replaces console cancellation)
gcloud beta device-run sessions cancel session-number

הפניה למיפוי דגלים

כאן מופיע מיפוי הדגלים להעברת הגדרות הבדיקה מ-Flank או מ-gcloud firebase test android/ios run לפקודות החדשות של DDP,‏ gcloud beta device-run sessions submit instrumentation ו-gcloud alpha device-run sessions submit xctest.

פרמטרים ונכסים עיקריים

פרמטר מדור קודם (Test Lab או Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
צד --project --project דגל גלובלי סטנדרטי של Google Cloud (--project=PROJECT_ID) או הגדרה פעילה של Google Cloud CLI.
--client-details --labels מילון של צמדי key=value לצירוף לסשן הבדיקה.
--other-files --other-files-to-push מילון. קבצי עזר שצריך להעביר למכשיר לפני הרצת הבדיקה. הופך את הסדר הקודם של DEST=SOURCE ל-SOURCE=DEST (SOURCE=DEVICE_PATH ב-Android; ‏SOURCE=BUNDLE_ID:DEVICE_PATH ב-iOS).

הגדרת מכשירים וטירגוט

פרמטר מדור קודם (Test Lab או Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
--device model={M},version={V} --device={M}-{V} מחרוזת חובה שממפה את הדגם ואת גרסת מערכת ההפעלה למחרוזת מזהה אחת של --device. הדגל --device של DDP מקבל כמה מזהי מכשירים שמופרדים בפסיקים (למשל, --device=shiba-34,tokay-36 או --device=iphone16pro-18-3) או כמה דגלי --device, כשכל אחד מהם מציין מזהה מכשיר נפרד (למשל, --device=shiba-34 --device=tokay-36).

בקרה על ביצוע בקשות וחוסר יציבות

פרמטר מדור קודם (Test Lab או Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
--async --async בוליאני. מפות 1:1. כברירת מחדל, הפקודה מופעלת באופן סינכרוני. צריך להעביר את זה כדי לחזור לטרמינל באופן מיידי. יציאה מיד אחרי העלאת הקובץ והדפסת מזהי הפעולה והסשן.
--num-flaky-test-attempts {R} --flaky-test-attempts {A} מספר שלם. מספר הניסיונות המקסימלי להרצה של כל מקטע בדיקה. ממירים את מספר ניסיונות החיבור החוזרים R למגבלת הניסיונות הכוללת A: A = R + 1 (ברירת המחדל היא 1).

פלט ואחסון

פרמטר מדור קודם (Test Lab או Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
--results-bucket --bucket-name מחרוזת. קטגוריה של Cloud Storage שאליה מועלים פריטי בדיקה, כולל קובצי קלט מקומיים, קובצי פלט של בדיקות ורשומות תזמון של חלוקה חכמה לפלחים (ברירת המחדל היא gs://[PROJECT_ID]-devicerun אם לא צוין אחרת).
--results-dir ניהול אוטומטי לא נתמך. נתיבי המשנה מאורגנים באופן אוטומטי ב-Cloud Storage בקטע automation/sessions/{session_id}/.
--directories-to-pull --paths-to-pull רשימה. קבצים או ספריות שצריך להוריד מהמכשיר אחרי הרצת הבדיקה (DEVICE_PATH ב-Android,‏ BUNDLE_ID:DEVICE_PATH ב-iOS).

הגדרת פיצול (sharding)

פרמטר מדור קודם (Test Lab או Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
--num-uniform-shards {N} --sharding-option=uniform --uniform-sharding-count={N} מחרוזת ומספר שלם. הגדרת הדגל המשולב מפעילה את אסטרטגיית הפיצול האחיד ומגדירה את מספר הפיצולים המקסימלי (טווח מספרים חוקי: 1-20 פיזיים, 1-200 וירטואליים; iOS מציעה מכשירים פיזיים בלבד).
צד --max-test-shards {N} --sharding-option=smart --smart-sharding-max-shard-count={N} מחרוזת ומספר שלם. הגדרת הדגל המשולב מפעילה את אסטרטגיית הפיצול החכם ומגדירה את מספר הפיצולים המקסימלי (טווח מספרים חוקי: 0-20 פיזיים, 0-200 וירטואליים; ב-iOS יש רק מכשירים פיזיים).
צד --shard-time {S} --sharding-option=smart --smart-sharding-target-duration={S} חובה מחרוזת. הפעלת חלוקה חכמה לפלחים עם זמן ביצוע מטורגט (למשל, 2m, 10m, 1h). הטווח התקין: 2m עד 1h.
צד --smart-flank-gcs-path --smart-sharding-record-name={name} --bucket-name={bucket} חובה מחרוזת. שם רשומת ה-YAML של הפיצול (לא כולל סיומת הקובץ) בתוך --bucket-name בקטע automation/smart-sharding/ ב-Cloud Storage.

דגלים ספציפיים ל-Android

אתם יכולים להיעזר בטבלה הבאה כדי למפות את הדגלים הקודמים של gcloud firebase test android run ו-Flank Android לדגלים המקבילים החדשים שלהם ב-gcloud beta device-run sessions submit instrumentation:

סוג הבדיקה קבוצת תכונות פרמטר מדור קודם (firebase android / Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
‫Android נפוץ פרמטרים ונכסים עיקריים --app --apps רשימה. אם מסופקים כמה קובצי APK או AAB של אפליקציות, צריך להעביר את כולם אל --apps לפי הסדר שבו הם יותקנו במכשיר. הנתיב יכול להיות מקומי או ב-Cloud Storage‏ (gs://...).
‫Android נפוץ פרמטרים ונכסים עיקריים --additional-apks --apps רשימה. ממזגים ערכים נוספים של רשימות ישירות לרשימה הראשית של --apps.
‫Android נפוץ פרמטרים ונכסים עיקריים --obb-files --other-files-to-push מילון בפורמט SOURCE=DEST. מעבירים קובצי OBB ישירות לנתיב של מכשיר היעד (/sdcard/Android/obb/{package_name}/).
‫Android נפוץ הגדרת מכשירים וטירגוט --device locale={L} --locale={L} מחרוזת. ממפה את הגדרות המכשיר לדגל --locale ברמה העליונה (language-region, למשל --locale=en-US) שצריך להעביר אליו את המכשיר לפני הרצת הבדיקה.
‫Android נפוץ הגדרת מכשירים וטירגוט --device orientation={O} --orientation={O} מחרוזת. מיפוי כיוון המכשיר לדגל --orientation ברמה העליונה (portrait או landscape).
‫Android נפוץ הגדרת מכשירים וטירגוט לא רלוונטי --coordinates מחרוזת. התכונה מדמה קואורדינטות של מיקום GPS במכשיר (למשל, --coordinates=37.4220,-122.0841).
‫Android נפוץ בקרה על ביצוע בקשות וחוסר יציבות --grant-permissions ברירת מחדל אוטומטית אוטומטיות. הרשאות בתחילת ההפעלה ניתנות באופן אוטומטי כברירת מחדל (שווה ערך ל---grant-permissions=all).
‫Android נפוץ פלט ואחסון לא רלוונטי --dumpsys מחרוזת. איסוף מצב המערכת באמצעות dumpsys (ערכים: always, ‏on-failure).
‫Android נפוץ פלט ואחסון לא רלוונטי --bugreport מחרוזת. איסוף bugreport מלא מהמכשיר (ערכים: always, on-failure).
‫Android נפוץ פלט ואחסון --record-video --video מחרוזת. מתי להקליט סרטון של מסך המכשיר במהלך הרצת הבדיקה. הערכים התקינים הם always או on-failure.
Android Instrumentation פרמטרים ונכסים עיקריים --type=instrumentation sessions submit instrumentation מבנה פקודת המשנה קובע את סוג הבדיקה במקום דגל --type.
Android Instrumentation פרמטרים ונכסים עיקריים --test --test חובה מחרוזת. הנתיב לקובץ ה-APK לבדיקה שמכיל בדיקות אינסטרומנטציה, מקומי או ב-Cloud Storage.
Android Instrumentation בקרה על ביצוע בקשות וחוסר יציבות --timeout --instrumentation-timeout משך הזמן (למשל, ‫10m,‏ 20s,‏ 1h). הטווח התקין: 1m עד 3h (ברירת המחדל היא 5m).
Android Instrumentation בקרה על ביצוע בקשות וחוסר יציבות לא רלוונטי --flaky-test-parallel-retry בוליאני. אם לנסות שוב במקביל את הבדיקות שנכשלו (ברירת המחדל היא false להרצה ברצף).
Android Instrumentation בקרה על ביצוע בקשות וחוסר יציבות לא רלוונטי --flaky-test-retry-level מחרוזת. ההגדרה הזו קובעת אם לנסות שוב ברמת ה-shard או ברמת ה-test (ברירת המחדל היא shard).
Android Instrumentation מטרות וכלים להרצת בדיקות --test-runner-class --test-runner-class מחרוזת. המחלקה המלאה של מריץ בדיקות האינסטרומנטציה (למשל, com.foo.MyRunner) שרוצים להשתמש בה. אם לא מציינים מחלקת הרצה, מחלקת ברירת המחדל נקבעת לפי המניפסט של האפליקציה.
Android Instrumentation מטרות וכלים להרצת בדיקות --test-targets --test-targets מילון של יעדי בדיקה או מסנני יעדים להפעלה. כל יעד חייב להיות מוגדר באופן מלא עם שם החבילה או שם המחלקה שתומכים במפתחות כמו package,‏ notPackage,‏ class,‏ notClass,‏ annotation,‏ notAnnotation ו-size. אין תמיכה בפורמטים testfile או notTestfile.
Android Instrumentation מטרות וכלים להרצת בדיקות --use-orchestrator --orchestrator-version אם להשתמש בתזמור בדיקות ל-Android. מקבל את הערך auto (מנהל תזמור ברירת מחדל) או מחרוזת גרסה ספציפית (למשל, 1.6). אפשר לשלוח שאילתה לגבי הגרסאות הזמינות באמצעות gcloud beta device-run software-versions list.
Android Instrumentation מטרות וכלים להרצת בדיקות --environment-variables --additional-test-options מילון של אפשרויות שמועברות לכלי להרצת בדיקות אינסטרומנטציה. פורמטים שנתמכים ב---test-targets לא מותרים כאן.

דגלים ספציפיים ל-iOS

אתם יכולים להיעזר בטבלה הבאה כדי למפות את הדגלים הקודמים של gcloud firebase test ios run ו-Flank ל-iOS לדגלים המקבילים החדשים שלהם ב-gcloud alpha device-run sessions submit xctest:

סוג הבדיקה קבוצת תכונות פרמטר מדור קודם (firebase ios / Flank) פרמטר של יעד DDP פורמט / לוגיקת המרה
iOS נפוץ פרמטרים ונכסים עיקריים --additional-ipas --additional-apps רשימה של קובצי עזר מסוג .ipa שצריך להתקין במכשיר לפני הרצת הבדיקה.
iOS XCTest בלבד פרמטרים ונכסים עיקריים --type=xctest sessions submit xctest מבנה תת-הפקודה קובע את סוג הבדיקה במקום דגל --type (משתמש ב-gcloud alpha).
iOS XCTest בלבד פרמטרים ונכסים עיקריים --test --test חובה מחרוזת. הנתיב לקובץ ה-ZIP שמכיל את האפליקציה ל-iOS ואת קובצי ה-XCTest, באופן מקומי או ב-Cloud Storage.
iOS XCTest בלבד בקרה על ביצוע בקשות וחוסר יציבות --timeout --xctest-timeout משך הזמן (למשל, ‫5m,‏ 15m,‏ 1h). הטווח התקין: 1m עד 1h (ברירת המחדל היא 5m).
iOS XCTest בלבד פלט ואחסון --record-video --video מתי להקליט סרטון: always או on-failure. סרטון אחד מתועד לכל מקרה בדיקה של ממשק המשתמש (iOS מגרסה 17 ואילך).
iOS XCTest בלבד מטרות וכלים להרצת בדיקות --xctestrun-file --xctestrun-file מחרוזת. הנתיב לקובץ .xctestrun בהתאמה אישית, מקומי או ב-Cloud Storage.
iOS XCTest בלבד מטרות וכלים להרצת בדיקות --xcode-version --xcode-version מחרוזת. מזהה הקטלוג או מחרוזת הגרסה של Xcode לשימוש (למשל, xcode-16-4 או 16.4). אפשר לשלוח שאילתה לגבי הגרסאות הזמינות באמצעות gcloud beta device-run software-versions list.

משוב ושאלות

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