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