מילון מונחים של Developer Device Platform

‫Developer Device Platform ‏(DDP) היא פלטפורמה מסחרית של Google Cloudעם עדיפות לענן, המיועדת לתזמור מרחוק של מכשירים ניידים, לבדיקות אוטומטיות של אצוות ולתהליכי פיתוח סוכני. ‫DDP משלב את התשתית של חוות המכשירים המנוהלים ישירות בסביבה העסקית של Google Cloud . במילון המונחים הזה מופיעה הפניה טכנית לפי סדר אלפביתי של מושגי מפתח, רכיבים ארכיטקטוניים, ממשקי API, פקודות CLI ופרדיגמות תפעוליות שמגדירות את DDP.

ברשימה שבדף הזה מפורטים המונחים הבסיסיים של Developer Device Platform והטכנולוגיות שקשורות אליה. הנה מקורות נוספים להגדרות של מונחי מפתח:


A

סקיל של Agent (סקיל של DDP Agent וסקיל של Migration)

סקיל אג'נטי של DDP

סט פקודות ספציפי למשימה בקוד פתוח, שפורסם בקטע Google CloudSkills ב-GitHub/skills/cloud/developer-device-platform-basics. היכולת DDP Agent Skill מיועדת לעוזרי AI בתכנות כמו Antigravity,‏ ChatGPT ו-Claude Code. היא מאפשרת לסוכנים לשכור מכשירים מרוחקים באופן פרוגרמטי באמצעות Device Streaming API, להפעיל תהליכי רקע להעברת ADB, להריץ פקודות מעטפת, לצלם צילומי מסך של מאגר הנתונים הזמני של הפריימים ולהפעיל חבילות בדיקה אוטומטיות באמצעות ה-CLI של gcloud device-run.

מיומנות העברה

מיומנות למעבר מ-Firebase Test Lab ל-Developer Device Platform, שמציעה מיפוי מפורט של דגלים והבדלים אחרים, וכוללת גרסת טקסט פשוט שמיועדת במיוחד לסוכני AI.

תזמור בדיקות ל-Android

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

קובץ APK set‏ (‎.apks)

פורמט של ארכיון מכווץ שנוצר על ידי bundletool עבור קובצי Android App Bundle‏ (AAB). ‫DDP תומך באופן מובנה בהתקנת קובצי .apks.

AutomationSession Service (DeviceRun API)

מנוע הליבה של DDP להרצת אצווה, שמתארח ב-devicerun.googleapis.com. השירות AutomationSession מקבל קובצי אפליקציה בינאריים וקריטריונים של חומרה בקריאה אחת מאוחדת ל-API. ה-backend מטפל בהקצאת המכשירים, בהקצאת הסביבה, בהפעלת מנהל ההתקן לבדיקה, באיסוף היומנים ובפירוק כפעולה אטומית.


C

מודל Cloud Storage (קטגוריות בבעלות המשתמש)

ארכיטקטורת האחסון של DDP, שבה כל פריטי הקלט (קובצי APK) ותוצאות הפלט של הבדיקה מתארחים בקטגוריות אחסון שבבעלות הפרויקט של המפתח ב-Google Cloud (למשל, gs://<project_id>_devicerun).


D

‫Developer Device Platform ‏(DDP)

פלטפורמת Enterprise שלGoogle Cloudלבדיקת מכשירים שמחוברים לרשת אחרת ולפיתוח אג'נטי לנייד, שמתארחת ב- Google Cloud. ב-DDP יש תשתית מנוהלת של חוות מכשירים שמשולבת באופן מובנה במסוף Google Cloud , ב-IAM, בחיוב ב-Cloud וב-SDK.

Device Catalog API

ממשק אחיד לאיתור מכשירים שתואם ל-AIP ומתארח בכתובת devicerun.googleapis.com לפרויקטים ולמיקומים. קטלוג המכשירים מציג אוסף אחד של מכשירי Android ו-iOS פיזיים ווירטואליים. כל רשומה חושפת מזהה מכשיר אטום ויציב, מפרטי חומרה ואותות בזמן אמת לגבי הקיבולת והזמינות של הצי.

מאפיין קטלוג סוג הנתונים תיאור
name String נתיב המשאב (projects/my-project/locations/global/devices/device-id).
form טיפוסים בני מנייה (enum) סוג החומרה (PHYSICAL או VIRTUAL).
os_version String גרסת מערכת ההפעלה או רמת Android SDK (למשל, 35 או 17.4).
availability הודעה אות קיבולת הצי (HIGH, MEDIUM, LOW, NONE).

Device Run API

השירות המקיף devicerun.googleapis.com שמאחד בדיקות של מכשירים שמחוברים לרשת אחרת, חיפוש בקטלוג ותהליכי עבודה מבוססי-סוכנים לשירות מבוסס-ענן, כמו שמתואר בסקירה הכללית של "הרצה במכשיר".

Device Streaming API

השירות המובנה Google Cloud devicestreaming.googleapis.com שמספק יכולות אינטראקטיביות של סטרימינג ממכשירים שמחוברים לרשת אחרת. Device Streaming API מאפשר למפתחים להעביר בסטרימינג תצוגות של מכשירים בזמן אמת ישירות ל-Android Studio.


E

ביצוע

הרמה הנמוכה ביותר בהיררכיית המשאבים בת שלוש הרמות של "הרצה במכשיר" ב-Developer Device Platform‏ (Session -> Job -> Execution). הפעלה מייצגת ניסיון קונקרטי שנוצר על ידי המערכת בזמן ריצה להריץ חבילת מקרים לבדיקה או פיצול במכשיר שהוקצה, תוך תיעוד של יומני פלט גולמיים, יומני מערכת והקלטות וידאו.


F

Flank

כלי פופולרי בקוד פתוח של צד שלישי להרצת בדיקות בצד הלקוח, שפותח כדי לשפר את ביצוע הבדיקות ואת הפיצול שלהן. ‫DDP כולל באופן מובנה את היכולות העיקריות של Flank, כולל הגדרה מבוססת-YAML, חלוקה חכמה מתקדמת של נתונים היסטוריים וניסיונות חוזרים ממוקדים, כך שאין צורך ב-wrapper חיצוני.


G

gcloud device-run

ממשק שורת הפקודה הראשי של ה-SDK של Google Cloud לפעולות של בדיקת אצווה וסטרימינג של DDP. הוא פועל לפי דפוס gcloud device-run <resource> <verb> שמתמקד במשאבים, ומספק פקודות לשליחת סשנים של בדיקות, לשליחת שאילתות לגבי זמינות המכשיר, לדגימת סטטוס הביצוע ולהורדת תוצאות.


J

משימה

הרמה האמצעית בהיררכיית המשאבים בת שלוש הרמות של "הרצה במכשיר" ב-Developer Device Platform‏ (Session -> Job -> Execution). משימה משלבת הגדרת אוטומציה ספציפית (JobAction, כמו בדיקת אינסטרומנטציה של Android) עם הגדרת מכשיר יעד. משימה אחת מתרחבת באופן אוטומטי לכמה הפעלות כשמופעלים פיצול או ניסיונות חוזרים.


N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

תג סטטוס גישה שמוחזר בקטלוג המכשירים של DDP, שמציין שמנהל הארגון הגביל דגם מכשיר ספציפי או מעבדת שותף (למשל, חומרה של OEM של צד שלישי) באמצעות תגים של Google Cloud Resource Manager או כללי מדיניות של הארגון.


O

קבוצות של תלויות ב-One Platform API

תכונה במישור הבקרה של שירות Google Cloud, שמפעילה באופן אוטומטי את ה-API של ה-backend שתלוי בו. כשמפתח מפעיל DDP API, קבוצות התלויות מופעלות באופן אוטומטי מאחורי הקלעים.


P

תכונות Labs למכשירים תואמים

מעבדות של מכשירים שמחוברים לרשת אחרת, שמופעלות ישירות על ידי שותפי OEM של Google (כמו Samsung,‏ Xiaomi,‏ OPPO,‏ OnePlus,‏ vivo,‏ Transsion) ומשולבות ב-DDP. מעבדות של שותפים מרחיבות את מגוון קטלוג המכשירים, וצריך להפעיל אותן באופן מפורש ברמת הפרויקט במסוףGoogle Cloud .


S

ניסיון חוזר של בדיקה לא יציבה (flaky test) ברצף

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

סוכן שירות (חשבון שירות)

חשבון שירות שמנוהל על ידי Google, שנוצר באופן אוטומטי כשממשקי ה-API של DDP מופעלים בפרויקט ב- Google Cloud . Google Cloud ל-DDP Service Agent יש הרשאות שירות של IAM לקריאה מאובטחת של קובצי קלט בינאריים לבדיקה, לכתיבה של סרטונים ויומני פלט של בדיקות בקטגוריות של Google Cloud Storage שבבעלות המשתמש, לפרסום התראות סטטוס בנושאי Google Cloud Pub/Sub ולתזמון הקצאות חומרה במרכזי נתונים מנוהלים בשם הפרויקט.

שימוש בשירות / הפעלת API

תת-מערכת לניהול שירותים שאחראית על הפעלה והגדרה של ממשקי API בפרויקט. Google Cloud Google Cloud כדי להפעיל את DDP, צריך הרשאות ברמת הפרויקט או את תפקידי השירות devicerun.googleapis.com, ‏devicestreaming.googleapis.com ו-testing.googleapis.com.

אירוע

המאגר ברמה העליונה בהיררכיית המשאבים של "הרצה במכשיר" ב-Developer Device Platform‏ (projects/my-project/locations/global/sessions/session-id). סשן כולל את הבקשה של המשתמש להרצה באצווה, שמכילה משימה אחת או יותר שמופעלות במטריצות של מכשירים או במודולים של Gradle, ומפיק SessionReport נצבר.

ב-Developer Device Platform Device Streaming API, ‏ deviceSession מייצג סשן אחד של סטרימינג ממכשיר שמחובר לרשת אחרת. במקום להריץ סקריפטים באצווה עד לסיום, Device Streaming API שומר מכשיר אחד ופותח חיבור דו-כיווני פעיל, כדי שמהנדס או סוכן AI יוכלו לראות את המסך ולשלוט במכשיר בזמן אמת.

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

מנגנון חכם לחלוקת בדיקות ב-Developer Device Platform הרצה במכשיר (--sharding-option=smart). התכונה "חלוקה חכמה" מנתחת נתונים היסטוריים של ביצוע בדיקות בטווח של עד 30 ימים, עוקבת אחרי זמני הריצה לפי דגם מכשיר ספציפי ומביאה בחשבון את התקורה של הפעלת תזמור בדיקות ל-Android כדי לחלק את חבילות המקרים לבדיקה למקטעים מאוזנים שמטרתם להגיע למשך זמן מסוים.


U

פיצול אחיד

אסטרטגיית הפצה לבדיקה (--sharding-option=uniform --uniform-sharding-count=N) בהרצה במכשיר ב-Developer Device Platform, שמחלקת חבילת מקרים לבדיקה של Android למספר קבוע של פיצולים ($N$) באמצעות הפרמטרים המקוריים -e numShards ו--e shardIndex של AndroidJUnitRunner.