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