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

במדריך הזה מוסבר איך למצוא את תוצאות הבדיקות שהופעלו בעקבות המדריך Developer Device Platform הרצה במכשיר.

לפני שמתחילים

השלבים האלה מניחים שכבר יצרתם Google Cloud פרויקט, השלמתם את שלבי ההגדרה במדריך למתחילים של Developer Device Platform וביצעתם אימות באמצעות gcloud בטרמינל.

בשורת הפקודה

כדי לראות סיכום בסיסי של תוצאת הבדיקה, מריצים את הפקודה הזו עם מזהה הסשן:

gcloud beta device-run sessions describe SESSION_ID

הפלט שמתקבל נראה כך:

Session SESSION_ID finished with result [FAILED].
Result files are stored at [https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/].
JOB NAME  EXECUTION NAME  EXECUTION RESULT
job-000   all             FAILED: 2 test cases failed, 5 passed
job-001   all             PASS

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

כדי לקבל פרטים נוספים על סשן בדיקה, מוסיפים את --full לפקודה describe שהורצה קודם, כך:

gcloud beta device-run sessions describe SESSION_ID --full

הפלט שמתקבל נראה כך:

name: projects/PROJECT_ID/locations/global/sessions/session-370961e1
sessionConfig:
  displayName: instrumentation-session
  jobConfigs:
  -   action:
      androidInstrumentationTest:
        testInstallable:
          files:
          -   gcsInputFile:
              path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name_test.apk
    allocationConfig:
      deviceConfigs:
      -   actions:
        -   androidInstallPackages:
            installables:
            -   files:
              -   gcsInputFile:
                  path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name.apk
        -   androidLogcat: {}
        requirement:
          deviceId: pa3q-35
    displayName: job-000
  outputDirectoryConfig:
    gcsOutputDirectory:
      path: gs://BUCKET_NAME/automation/sessions
sessionReport:
  endTime: '2026-07-30T03:30:05.838Z'
  id: 6587313f-fdf7-418a-a9b9-b6fa98dff838
  jobReports:
  -   displayName: job-000
    endTime: '2026-07-30T03:30:04.601Z'
    executionReports:
    -   displayName: all
      endTime: '2026-07-30T03:30:02.151Z'
      id: 29b167dd-dde9-4ea9-b2cd-738049083fc9
      outputFiles:
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/logcat.txt
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/instrument.log
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/junit.xml
      result:
        cause:
          summary:
            message: One or more test assertions or test methods failed. Inspect the
              test runner logs and structured test results for details.
            reason: TEST_CASE_FAILURE
            type: CUSTOMER
        resultType: FAILED
      startTime: '2026-07-30T03:29:32.769Z'
      status:
        progressMessages:
        -   2 test cases failed, 5 passed
        statusType: DONE
    id: 7974e37a-2928-4aaf-abba-3a8b6bae853b
    result:
      cause:
        summary:
          message: Job has one or more failed tests. See execution reports for details.
          reason: JOB_HAS_FAILED_TESTS
      resultType: FAILED
    startTime: '2026-07-30T03:28:53.756Z'
    status:
      statusType: DONE
  result:
    cause:
      summary:
        message: Session has one or more failed jobs. See job reports for details.
        reason: SESSION_HAS_FAILED_JOBS
    resultType: FAILED
  startTime: '2026-07-30T03:28:52.702Z'
  status:
    statusType: DONE

בדפדפן אינטרנט

כדי לראות את כל הפרטים, טוענים את כתובת ה-URL של הדלי שמכיל את תוצאות הבדיקה מתוך פלט הבדיקה. הוא אמור להיראות כך: https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/

הסשנים מופיעים בפורמט הנתיב הבא באחסון: gs://BUCKET_NAME/automation/sessions/SESSION_ID/job-000/EXECUTION_ID/

כדי לעיין ביומנים בממשק האינטרנט של מסוף Google Cloud , פועלים לפי השלבים הבאים:

  1. בדפדפן, מוסיפים את שם הפרויקט כמו שמופיע בפקודה gcloud config set project לכתובת ה-URL https://console.cloud.google.com/?project= וטוענים את הדף.
  2. מרחיבים את התפריט בפינה הימנית העליונה.
  3. מחפשים את Cloud Storage.
  4. בתפריט האחסון, בוחרים באפשרות Buckets (מאגרי מידע).
  5. בעמודה הראשונה, לוחצים על שם הפרויקט.
  6. לוחצים על אוטומציה.
  7. לוחצים על Sessions (סשנים).
  8. בשדה Filter (מסנן), מדביקים את מזהה הסשן מריצת הבדיקה האחרונה (ראו את פלט הבדיקה).
  9. לוחצים על שם הסשן שמופיע.
  10. בוחרים באפשרות job-* כדי לראות את junit.xml, שמכיל פרטים מקיפים של התוצאות בכל מקרי הבדיקה.
  11. פותחים את execution-* כדי לראות פירוט של כל רסיס בנפרד. בתוך התיקייה הזו, עוברים אל:
    • ‫instrumentation.log: יומני הגולמיים מבדיקת המכשור של Android.
    • ‫system.log: יומן המערכת (syslog) של iOS בפורמט גולמי, שמכיל יומנים של מכשירים ומסגרות.
    • ‫logcat.txt: קובץ logcat של Android.
    • ‫junit.xml: דוח ה-XML של JUnit שמפרט את תרחישי הבדיקה שעברו או נכשלו.
    • ‫*.ips: יומני קריסה של iOS לצורך אבחון (אם התרחשו קריסות).
  12. כדי להבין את תוצאות הבדיקה, נכנסים לכתובות ה-URL הציבוריות ולכתובות ה-URL שדורשות אימות.

מבנה הקובץ

כדי להבין יותר על שגיאת הבדיקה, אפשר לעיין בקובצי היומן בקטגוריה של Cloud Storage. מבנה הקובץ נראה כך:

-   gs://BUCKET_NAME/automation
  -   inputs/
    -   2026-05-29_10:13.026220_JZTM
      -   app.apk
      -   test.apk
  -   sessions/
    -   SESSION_ID
      -   job-000/
        -   junit.xml
        -   execution-000/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
        -   execution-001/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
      -   job-001/
    -   SESSION_ID

הסבר על התוצאות

קבצי junit.xml שנוצרו בפלט הם קובצי XML רגילים של JUnit. הקבצים האלה מכילים את התוצאות של כל שיטת בדיקה, כך שתוכלו לבדוק את הסטטוס הספציפי של כל שיטת בדיקה (עברה או נכשלה), את זמן הביצוע ואת עקבות השגיאות. אפשר לשלב ולנתח את הקובץ הזה בקלות עם רוב המערכות של אינטגרציה רציפה ופיתוח רציף (CI/CD) ועם כלי דיווח על בדיקות.

מסמכים תומכים

המאמרים הבאים

אפשר לנסות את Device Streaming API, שהוא חלק מ-Developer Device Platform.