ב-Google Home Developer Console מוצג דף בדיקה שבו אפשר להגדיר ולהריץ בדיקות על השילוב של 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.
תוכניות הבדיקות להסמכה מיועדות ספציפית להסמכה של Matter ואי אפשר לערוך אותן. בחירה באפשרות הזו תיצור גרסה חדשה של השילוב של Matter.
גרסאות שילוב
כשיוצרים תוכנית לבדיקה לאישור, נוצרת גרסה חדשה של השילוב. הגרסה הממוספרת הזו מופיעה בכל רשימות השילובים ב-Developer Console, מהכרטיסייה 'בדיקה' ואילך.
גרסאות חדשות אף פעם לא נוצרות מגרסאות ממוספרות אחרות. לדוגמה, בתוכנית הבדיקה הראשונה שיוצרים לשילוב, גרסה v.1 נוצרת עבור השילוב הזה. יצירה של תוכנית בדיקה נוספת תגרום ליצירת גרסה v.2 לשילוב הזה, אבל הגרסה הזו לא תתבסס על v.1. במקום זאת, הגרסה הזו מבוססת על המופע של השילוב ללא גרסה, בדומה לגרסה v.1.
גרסת N/A של שילוב מייצגת את המופע של השילוב ללא גרסה, שמנוהל בכרטיסייה פיתוח.
במילים אחרות, ב-Matter > בדיקה ב-Developer Console:
- אם תלחצו על בדיקה של הגרסה לא רלוונטי של השילוב, תיווצר גרסה חדשה. מספר הגרסה יהיה גבוה מאחד מכל הגרסאות הממוספרות הקיימות.
- אם לא קיימות גרסאות ממוספרות, נוצרת גרסה v.1.
- אם קיימת גרסה v.1, נוצרת גרסה v.2. אם גרסה v.2 קיימת, נוצרה גרסה v.3 וכן הלאה.
- אם לוחצים על בדיקה לגרסה ממוספרת של השילוב (לדוגמה, v.1), v.1 נוצרת גרסה חדשה. במקום זאת, גרסה v.1 נבדקת שוב.
מידע נוסף זמין במאמר גרסאות של שילובים.
יצירת תוכנית לבדיקה
גרסאות שילוב הן תמונת מצב של שילוב שאין לו גרסה. כלומר, כשיוצרים תוכנית בדיקה לאישור ורוצים גרסת שילוב, כל המטא-נתונים שקשורים לשילוב הזה צריכים להיות הפרטים שרוצים להשתמש בהם בשילוב שהושק.
לפני שאתם יוצרים תוכנית לבדיקה לקבלת אישור, חשוב לוודא שביצעתם את הפעולות הבאות:
אם לא השלמתם את כל השלבים האלה לצורך השילוב, לא ניתן יהיה לאשר גרסת שילוב שנוצרה לצורך בדיקת אישור. תצטרכו ליצור גרסה חדשה, כלומר לבצע מחדש את השלבים 'בדיקה', 'ניסיון שטח' ו'אישור'.
תצטרכו גם ליצור גרסה חדשה ולהתחיל מחדש אם תרצו לעדכן את המיתוג שלכם לפני שגרסת השילוב תאושר.
כדי ליצור תוכנית לבדיקה:
ברשימת הפרויקטים, לוחצים על Open (פתיחה) ליד הפרויקט שאיתו רוצים לעבוד.
בתפריט הניווט שבצד ימין של הדף, לוחצים על Matter > בדיקה.
לוחצים על בדיקה בגרסה לא רלוונטי של השילוב שרוצים לבדוק. הפעולה הזו יוצרת גרסה חדשה של שילוב.
בוחרים את סוג הבדיקה: בדיקת פיתוח או בדיקת הסמכה.
- אם אתם מתכוננים להסמכה בסביבה העסקית של Google, בחרו באפשרות בחינת הסמכה.
- אי אפשר להשתמש בבדיקת פיתוח לצורך קבלת אישור.
לוחצים על בדיקה. אם מופיע מסך השגיאה No device found (לא נמצא מכשיר), מכשיר לשילוב הזה עדיין לא הוזמן למערכת האקולוגית. למידע נוסף, קראו את המאמר פתרון בעיות בהתאמה.
במסך Configure your test (הגדרת הבדיקה), נותנים שם לבדיקה ובוחרים את המכשירים שרוצים לבדוק מרשימת המכשירים.
לוחצים על הלחצן הבא: תוכנית הבדיקה.
בדף Create a test plan (יצירת תוכנית בדיקה), בקטע test suite בוחרים את חבילות הבדיקה שרוצים להפעיל.
אם אתם רוצים לצאת מ-Test Suite, לוחצים על Return to Developer Center.
הפעלת תוכנית הבדיקה
ב-Test Suite, בדף Create a test plan (יצירת תוכנית בדיקה), לוחצים על Run Test (הפעלת בדיקה). הדף סביבת בדיקה מופיע עם הסטטוס והיומנים של כל הבדיקות.
תוצאות הבדיקה יופיעו לאחר שהבדיקות יסתיימו. הסטטוס של כל הפעלה של חבילת בדיקות מופיע לצידה (עבר, נכשל).
בחלונית יומנים מוצג הסטטוס של כל ביצוע בדיקה בנפרד.
כדי לבדוק מחדש תוכנית בדיקה בדף test הגדרת, לוחצים על Retest בחלק העליון אחרי שמסיימים את ביצוע הבדיקה.
לאחר הסיום:
- לוחצים על סיום כדי לעבור לדף היסטוריית בדיקות, או
- לוחצים על Submit כדי לשלוח את תוצאות הבדיקה לאישור.
הצגה ופירוש של תוצאות הבדיקה
בדף Check history (היסטוריית בדיקות) ב-Test Suite, אפשר לראות בקטע תוכניות בדיקה את תוצאות הבדיקות הקודמות של תוכנית פיתוח או של תוכנית הסמכה שלא נשלחה. כדי לעשות זאת, לוחצים על Retest (בדיקה מחדש) של תוכנית הבדיקה הרצויה. תועברו לדף בדיקת סביבת בדיקה, שבו מוצגות התוצאות של אותה בדיקה.
אם מדובר בתוכנית הסמכה שנשלחה, לוחצים על Results (תוצאות) בקטע Saved forcertification כדי להציג את דוח תוצאות הבדיקה.
אפשר לגשת לתוצאות הבדיקה של גרסת שילוב גם דרך הכרטיסייה Test (בדיקה) דרך Developer Console. לוחצים על View כדי לראות את היסטוריית הבדיקות של כל גרסת שילוב שמופיעה בדף הזה, כדי לעבור לדף היסטוריית בדיקות ב-Test Suite.
סטטוסים של המסוף
בשלב הבדיקה, המערכת מציגה את הסטטוסים הבאים של המסוף:
| 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.
- מזהי VID
0xFFF1—0xFFF4שמורים לבדיקה. אפשר להשתמש בהם לבדיקות בסיסיות ולבדיקות הזמנה בסיסיות, אבל אי אפשר להשתמש בהם בשלבי הפיתוח הבאים:
באמצעות אפליקציה להנדסת Bluetooth כמו nRF Connect for Mobile, אפשר לראות את ה-VID/PID של המכשיר איתות Bluetooth בשדה נתוני שירות.
בצילום המסך הזה מגרסת nRF Connect ל-Android, תוכלו לראות שה-VID/PID רשומים בתור 5A23FFFE החל מהבית הרביעי של השדה Service Data. מציין VID של 5A23 ו-PID של FFFE — שניהם בפורמט endian קטן.
באפליקציית BLE מופיעים הערכים באותיות קטנות, אבל ערכי ה-VID/PID שאתם מזינים בפרויקט Developer Console מופיעים באותיות גדולות.
ודאו שהערכים והפורמט הנכונים הוזנו בפרויקט של מסוף הפעולות, על סמך מה שמוצג ב-Bluetooth sniffer.
לערכים בצילום המסך לדוגמה, ה-VID וה-PID ב-Developer Console יהיו 235A ו-FEFF, בהתאמה.