ב-Google Home Developer Console יש דף Test שבו אפשר להגדיר בדיקות של השילוב של Matter ולהריץ אותן באמצעות Google Home Test Suite. Test Suite היא אפליקציה נפרדת שמובנית ב-Developer Console ומטפלת בכל בדיקות השילוב.
כדי לבדוק את המכשירים, צריך להגדיר אותם למזהה הספק ולמזהה המוצר של השילוב, ולוודא שהם זמינים ב-Google Home app (GHA) בחשבון שבו נעשה שימוש ב-Developer Console. מידע נוסף זמין במאמר התאמת מכשיר Matter.
אפשר להריץ את Test Suite בקבוצה של מכשירים ששייכים להגדרה ספציפית של פרויקט Matter. חשוב מאוד להריץ את Test Suite בשילובים שלכם כדי לוודא שהכול פועל כמו שצריך.
בדף בדיקה, השילובים של Matter שהושלמו ומוכנים לבדיקה מופיעים בקטע מוכן לבדיקה.
השילובים של Matter שנבדקו מפורטים בקטע נבדקו.
סוגי תוכניות הבדיקה
יש שני סוגים של תוכניות בדיקה:
תוכניות הבדיקה מסוג פיתוח משמשות לבדיקת מכשירים מבוקרים באמצעות Matter. אפשר לערוך אותן, אבל אי אפשר לשלוח אותן לקבלת אישור Matter.
תוכניות הבדיקה מסוג Certification מיועדות במיוחד להסמכת Matter, ואי אפשר לערוך אותן. בחירה באפשרות הזו תיצור גרסה חדשה של השילוב של Matter.
משתמשים ב-Test Suite ב-Developer Console כדי לשלוח את תוצאות הבדיקה לצורך אישור. אם רוצים להריץ את Test Suite לצורכי בדיקה במהלך הפיתוח, אפשר לעיין בגרסה העצמאית בדף Google Home Test Suite.
גרסאות השילוב
כשיוצרים תוכנית בדיקה לצורך אישור, נוצרת גרסה חדשה של השילוב. הגרסה הממוספרת הזו מופיעה בכל רשימות השילובים ב-Developer Console, החל מהכרטיסייה Test ואילך.
אף פעם לא נוצרות גרסאות חדשות מגרסאות ממוספרות אחרות. לדוגמה, תוכנית הבדיקה הראשונה שתיצרו לשילוב תיצור את הגרסה v.1 של השילוב. יצירת תוכנית בדיקה נוספת תיצור גרסה v.2 של השילוב הזה, אבל הגרסה הזו לא תהיה מבוססת על v.1. במקום זאת, הגרסה הזו מבוססת על המכונה ללא גרסה של השילוב, כמו v.1.
הגרסה N/A של השילוב מייצגת את המכונה ללא גרסה של השילוב, שמנוהלת בכרטיסייה Develop.
במילים אחרות, בוחרים באפשרות Matter > Test ב-Developer Console:
- אם לוחצים על בדיקה לגרסה לא רלוונטי של השילוב, נוצרת גרסה חדשה. מספר הגרסה יהיה גבוה ביחידה אחת ממספר הגרסה המדורגת הקיימת.
- אם אין גרסאות ממוספרות, נוצרת הגרסה v.1.
- אם קיימת גרסה v.1, נוצרת גרסה v.2. אם קיימת גרסה v.2, נוצרת גרסה v.3 וכן הלאה.
- אם לוחצים על בדיקה לגרסה ממוספרת של השילוב (לדוגמה, v.1), לא נוצרת גרסה חדשה. במקום זאת, הגרסה v.1 נבדקת שוב.
מידע נוסף זמין במאמר ניהול גרסאות של אינטגרציות.
יצירת תוכנית בדיקה
גרסאות השילוב הן קובץ snapshot של שילוב ללא גרסה. כלומר, כשיוצרים תוכנית בדיקה לצורך אישור, וכתוצאה מכך גרסת שילוב, כל המטא-נתונים שקשורים לשילוב הזה חייבים להיות המידע שבו רוצים להשתמש בשילוב שיושקה.
לפני שיוצרים תוכנית בדיקה לצורך הסמכה, חשוב לוודא ש:
אם לא השלמתם את כל השלבים האלה בשילוב, לא ניתן יהיה לאשר את גרסת השילוב שנוצרה לצורך בדיקת ההסמכה. תצטרכו ליצור גרסה חדשה, כלומר לבצע מחדש את השלבים 'בדיקה', 'ניסוי שדה' ו'אימות'.
תצטרכו גם ליצור גרסה חדשה ולהתחיל מחדש אם תרצו לעדכן את המיתוג לפני שגרסת השילוב תאושר.
כדי ליצור תוכנית בדיקה:
- ברשימת הפרויקטים, לוחצים על פתיחה לצד הפרויקט שרוצים לעבוד איתו.
- בתפריט הניווט בצד ימין של הדף, עוברים אל Matter > בדיקה.
- לוחצים על בדיקה לגרסה N/A של השילוב שרוצים לבדוק. הפעולה הזו יוצרת גרסה חדשה של השילוב.
- בוחרים את סוג הבדיקה: בדיקת פיתוח או בדיקת אישור ולוחצים על בדיקה.
- בוחרים באפשרות Certification test אם מתכוננים לבחינה להסמכה בסביבה העסקית של Google.
- אי אפשר להשתמש בבדיקת פיתוח לצורך אישור.
במסך Configure your test, נותנים שם לבדיקה ולוחצים על Automatically pair device כדי לבחור מכשיר להתאמה.
- במכשיר Android:
1. Make sure you installed GHA to your phone. 1. Connect your phone with a USB cable to the host machine. 1. You must [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging) The `APK` `com.chip.interop.moblysnippet` will automatically download and install. 1. Once your phone is connected, enter the **Pairing code** and **Device name** to auto-pair your device.- במכשיר iOS: צריך להתאים את המכשיר באופן ידני. בקטע אפליקציית Google Home מפורטות הוראות להתאמה ידנית.
- אם יש לכם מכשיר קיים, יכול להיות שתתבקשו לבטל את ההתאמה של המכשיר ולבצע אותה מחדש, או לבצע התאמה של מכשיר חדש.
לוחצים על הלחצן הבא: תוכנית בדיקה.
בדף Create a test plan, בקטע Test suites, בוחרים את חבילות הבדיקה שרוצים להריץ.
כדי לצאת מהדף Test Suite, לוחצים על חזרה אל Developer Center.
הרצת תוכנית הבדיקה
בדף Test Suite, בקטע Create a test plan, לוחצים על Run Test. הדף Test environment מופיע, עם הסטטוס והיומנים של כל הבדיקות.
תוצאות הבדיקה יופיעו בסיום הבדיקות. הסטטוס של כל הרצת חבילת הבדיקה מופיע לידה (עברה, נכשלה).
בחלונית Logs מוצג הסטטוס של כל הרצת בדיקה בנפרד.
כדי לבדוק מחדש את תוכנית הבדיקה מהדף Test environment, לוחצים על Retest בחלק העליון אחרי השלמת הבדיקה.
בסיום:
- לוחצים על סיום כדי לעבור לדף היסטוריית הבדיקות.
- לוחצים על Submit כדי לשלוח את תוצאות הבדיקה לצורך אישור.
הצגה ופירוש של תוצאות הבדיקה
בדף Test history ב-Test Suite, אפשר ללחוץ על Retest לתוכנית הבדיקה הרצויה בקטע Test plans כדי להציג את תוצאות הבדיקה הקודמות של תוכנית הפיתוח או של תוכנית הבדיקה לצורך אישור שלא נשלחה. תועברו לדף Test Environment שבו יוצגו התוצאות של הבדיקה.
כדי להציג את דוח תוצאות הבדיקה של תוכנית אישור שנשלחה, לוחצים על תוצאות בקטע שמור לצורך אישור.
אפשר לגשת לתוצאות הבדיקה של גרסת השילוב גם מהכרטיסייה Test ב-Developer Console. לוחצים על View (הצגה) כדי להציג את Test history (היסטוריית הבדיקות) של כל גרסה של השילוב שמופיעה בדף הזה. תועברו לדף Test history (היסטוריית הבדיקות) ב-Test Suite.
סטטוסים של מסוף
הסטטוסים הבאים של מסוף Google מופיעים בשלב הבדיקה:
| Section | סטטוס | תיאור | דרישה | מה לעשות עכשיו |
|---|---|---|---|---|
| מוכן לבדיקה | מוכן | הגרסה הזו של integration מוכנה לבדיקה. | לא רלוונטי | בודקים את הגרסה הזו של integration. |
| נבדק | מוכן | הגרסה הזו של integration נבדקה וניתן לשלוח אותה לניסוי שדה או להסמכה. |
הגרסה נבדקה ונשמרה. כל תרחישי הבדיקה שנכשלו צריכים לכלול נימוקים לבדיקה של Google. |
בודקים שוב, אם רוצים. |
בודקים שוב.
הסמכה
אם צריך לבצע בדיקה חוזרת לצורך אישור, צריך להתאים את המכשיר אחרי שמתחילים לבצע את הבדיקה החוזרת.
פיתוח
אם צריך לבדוק שוב במהלך הפיתוח, אפשר להשתמש במכשיר הקיים בלי לבצע התאמה מחדש.
פתרון בעיות
מכשיר שהוקצה לא מופיע בחבילת הבדיקות
אם התאמתם מכשיר עם מזהה ספק (VID) ומזהה מוצר (PID) לבדיקה, אבל הוא לא מופיע כשאתם מנסים לבדוק את המכשיר באמצעות חבילת הבדיקות ב-Developer Console, סביר להניח שהסיבה לכך היא שימוש באותה שילוב של VID ו-PID לבדיקה בכמה שילובים.
כדי לפתור את הבעיה, מסירים את כל המכשירים לבדיקה מ-Developer Console ומתאימים שוב את המכשיר שרוצים לבדוק.
כדי לוודא שביצעתם התאמה למכשיר הנכון, תוכלו להגדיר את פרטי היצרן והדגם (ערכים של CHIP_DEVICE_CONFIG_DEVICE_*) של המכשיר לערכים ייחודיים בקושחת הבדיקה.
למידע נוסף, ראו פרטי המכשיר.
אימות ה-VID/PID של המכשיר
כדי להתחיל לפתח את השילוב עם Google, צריך ליצור פרויקט ושילוב במסוף Google Home.
ערך ה-VID/PID שהמכשיר משדר צריך להתאים לערך ה-VID/PID שהוזן בפרויקט Developer Console.
- מזהי הווידאו
0xFFF1–0xFFF4שמורים לבדיקה. אפשר להשתמש בהם לבדיקות בקרה ובדיקות הזמנות ראשוניות בסיסיות, אבל אי אפשר להשתמש בהם בשלבים הבאים של הפיתוח:
באמצעות אפליקציה להנדסת Bluetooth, כמו nRF Connect for Mobile, אפשר לראות את ה-VID/PID של מכשיר ה-beacon בשדה Service Data.
בצילום המסך הזה מגרסת Android של nRF Connect, אפשר לראות שה-VID/PID מופיע כ-5A23FFFE החל מהבית הרביעי בשדה Service Data. המשמעות היא VID 5A23 ו-PID FFFE – שניהם בפורמט little endian.
באפליקציית ה-BLE הערכים מוצגים ב-little endian,אבל ערכי ה-VID/PID שמזינים בפרויקט Developer Console הם ב-big endian.
מוודאים שהערכים והפורמט הנכונים הוכנסו לפרויקט במסוף Actions על סמך מה שמוצג בסורק ה-Bluetooth.
לפי הערכים בצילום המסך לדוגמה, הערכים של VID ו-PID ב-Developer Console יהיו 235A ו-FEFF, בהתאמה.