ב-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 בשילובים כדי לוודא שהכול פועל כמו שצריך.
בדף Test, שילובים של Matter שהושלמו ומוכנים לבדיקה מופיעים בקטע Ready to test.
שילובים של Matter שנבדקו מופיעים בקטע Tested.
סוגים של תוכניות בדיקה
אלה סוגי תוכניות הבדיקה שזמינות:
תוכניות בדיקה של פיתוח משמשות לבדיקת השליטה במכשירים באמצעות Matter. אפשר לערוך אותם, אבל אי אפשר לשלוח אותם לאישור של Matter.
תוכניות בדיקה של אישור מיועדות במיוחד לאישור Matter, ואי אפשר לערוך אותן. אם תבחרו באפשרות הזו, תיווצר גרסה חדשה של השילוב עם Matter.
תוכניות הבדיקה של CSA Interop מאפשרות לדלג על שלב הבדיקה ולהשתמש בתוצאות של Connectivity Standards Alliance (Alliance) Interop Test Lab. אפשרות הבדיקה הזו זמינה לכל סוגי המכשירים הנתמכים, והיא האפשרות התקפה היחידה לקבלת אישור Aliro למנעולי דלתות שתואמים ל-Aliro.
משתמשים ב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:
- אם לוחצים על Test בגרסה לא רלוונטי של האינטגרציה, נוצרת גרסה חדשה. מספר הגרסה יהיה גבוה באחד מכל הגרסאות הממוספרות הקיימות.
- אם אין גרסאות ממוספרות, נוצרת גרסה v.1.
- אם גרסה v.1 קיימת, נוצרת גרסה v.2. אם גרסה v.2 קיימת, נוצרת גרסה v.3 וכן הלאה.
- אם לוחצים על Test בגרסה ממוספרת של השילוב (לדוגמה, v.1), לא נוצרת גרסה חדשה. במקום זאת, גרסה v.1 נבדקת שוב.
מידע נוסף מופיע במאמר ניהול גרסאות של אינטגרציות.
יצירת תוכנית בדיקה
גרסאות של אינטגרציה הן תמונת מצב של אינטגרציה ללא גרסה. כלומר, כשיוצרים תוכנית בדיקה לאישור, וכתוצאה מכך גרסת שילוב, כל המטא-נתונים שקשורים לשילוב הזה חייבים להיות המידע שבו רוצים להשתמש בשילוב שיושק.
לפני שיוצרים תוכנית בדיקה לאישור, חשוב לוודא שביצעתם את הפעולות הבאות:
אם לא השלמתם את כל השלבים האלה, לא תוכלו לאשר את גרסת השילוב שיצרתם לבדיקת האישור. תצטרכו ליצור גרסה חדשה, כלומר לבצע מחדש את שלבי הבדיקה, ניסוי השטח והאישור.
תצטרכו גם ליצור גרסה חדשה ולהתחיל מחדש אם תרצו לעדכן את המיתוג לפני שגרסת השילוב תאושר.
כדי ליצור תוכנית בדיקה:
ברשימת הפרויקטים, לוחצים על Open ליד הפרויקט שרוצים לעבוד איתו.
בתפריט הניווט שבצד ימין של הדף, עוברים אל Matter > Test.
לוחצים על Test בגרסה לא רלוונטי של השילוב שרוצים לבדוק. הפעולה הזו יוצרת גרסת אינטגרציה חדשה.
בוחרים סוג בדיקה ולוחצים על בדיקה.
- אם אתם מתכוננים למבחן הסמכה בסביבה העסקית של Google, בחרו באפשרות מבחן הסמכה.
- אי אפשר להשתמש בבדיקת פיתוח לצורך אישור.
בוחרים באפשרות CSA Interop test כדי להשתמש בתוצאות של Alliance Interop Test Lab ולדלג על שלבי הבדיקה וניסוי השטח בתהליך השילוב של Matter. אחרי שבוחרים באפשרות CSA Interop test, מקצים שם מעקב לפרופיל ההגדרות האישיות, ממפים את מזהה המוצר (PID) של המכשיר ולוחצים על Submit כדי להמשיך ישירות אל Certification.
במנעולי דלתות שתואמים ל-Aliro, צריך לבחור באפשרות CSA Interop test כדי לקבל אישור Aliro. אם תבחרו אפשרות בדיקה אחרת, תצטרכו ליצור גרסת שילוב חדשה ולשלוח אותה מחדש.
אם בחרתם באפשרות Certification test או Development test, במסך Configure your test נותנים שם לבדיקה ולוחצים על Automatically pair device כדי לבחור מכשיר להתאמה.
במכשיר Android:
- מוודאים שהאפליקציה GHA מותקנת בטלפון.
- מחברים את הטלפון למכונה המארחת באמצעות כבל USB.
- צריך להפעיל את ניפוי הבאגים ב-USB במכשיר. האפליקציה
APKcom.chip.interop.moblysnippetתוריד ותתקין את עצמה באופן אוטומטי. - אחרי שהטלפון מחובר, מזינים את קוד ההתאמה ואת שם המכשיר כדי להתאים את המכשיר באופן אוטומטי.
במכשיר iOS:
- תצטרכו להתאים בין המכשירים באופן ידני. בקטע אפליקציית Google Home מוסבר איך להתאים ידנית.
- אם יש לכם מכשיר קיים, יכול להיות שתתבקשו לבטל את ההתאמה שלו ולהתאים אותו מחדש, או להתאים מכשיר חדש.
לוחצים על הכפתור הבא: תוכנית בדיקה.
בדף Create a test plan, בקטע Test suites, בוחרים את חבילות המקרים לבדיקה שרוצים להריץ.
כדי לצאת מ-Test Suite, לוחצים על חזרה אל Developer Center.
הרצת תוכנית הבדיקה
ב-Test Suite, בדף Create a test plan, לוחצים על Run Test. מופיע הדף סביבת בדיקה, עם הסטטוס והיומנים של כל הבדיקות.
תוצאות הבדיקה יופיעו כשהבדיקות יסתיימו. הסטטוס של כל הרצה של חבילת מקרים לבדיקה מופיע לידה (Passed, Failed).
בחלונית Logs מוצג הסטטוס של כל ביצוע בדיקה.
כדי לבדוק מחדש תוכנית בדיקה מהדף Test environment, לוחצים על Retest בחלק העליון אחרי שביצוע הבדיקה הסתיים.
בסיום:
- לוחצים על סיום כדי לעבור לדף היסטוריית הבדיקות, או
- לוחצים על Submit כדי לשלוח את תוצאות הבדיקה לאישור.
איך רואים ומפרשים את תוצאות הבדיקה
בדף Test history ב-Test Suite, אפשר לראות את תוצאות הבדיקות הקודמות של תוכנית פיתוח או של תוכנית בדיקה לאישור שלא נשלחה. כדי לעשות את זה, לוחצים על Retest בתוכנית הבדיקה בקטע Test plans. כך תועברו לדף סביבת בדיקה שבו מוצגות תוצאות הבדיקה.
בתוכנית אישור שנשלחה, לוחצים על Results בקטע Saved for certification כדי לראות את דוח תוצאות הבדיקה.
אפשר גם לגשת לתוצאות הבדיקה של גרסת השילוב מהכרטיסייה Test ב-Developer Console. לוחצים על View בשדה Test history של גרסת השילוב שמופיעה בדף, כדי לעבור לדף Test history ב-Test Suite.
סטטוסים של מסוף
בשלב הבדיקה, יכולים להופיע הסטטוסים הבאים ב-Console:
| Section | סטטוס | תיאור | דרישה | מה לעשות עכשיו |
|---|---|---|---|---|
| מוכן לבדיקה | מוכן | הגרסה הזו של integration מוכנה לבדיקה. | לא רלוונטי | בודקים את הגרסה הזו של integration. |
| נבדק | מוכן | הגרסה הזו של integration נבדקה ואפשר לשלוח אותה לField Trial או לאישור. |
הגרסה נבדקה ונשמרה. כל מקרי הבדיקה שנכשלו כוללים הצדקות ש-Google תבדוק. |
בודקים שוב, אם רוצים. |
בדיקה חוזרת
הסמכה
אם אתם צריכים לבצע בדיקה חוזרת לצורך אישור, אתם צריכים להתאים את המכשיר אחרי שאתם מתחילים את הבדיקה החוזרת.
פיתוח
אם אתם צריכים לבדוק שוב את הפיתוח, אתם יכולים להשתמש במכשיר הקיים בלי להתאים אותו שוב.
פתרון בעיות
המכשיר שהוגדר לא מופיע בחבילת המקרים לבדיקה
אם התאמתם מכשיר עם מזהה ספק (VID) ומזהה מוצר (PID) לבדיקה, אבל הוא לא מופיע כשאתם מנסים לבדוק את המכשיר באמצעות חבילת המקרים לבדיקה ב-Developer Console, סביר להניח שהסיבה לכך היא שאתם משתמשים באותו שילוב של VID ו-PID לבדיקה בכמה שילובים.
כדי לפתור את הבעיה, צריך להסיר את כל מכשירי הבדיקה מ-Developer Console ולהתאים שוב את המכשיר שרוצים לבדוק.
כדי לוודא שהתאמתם את המכשיר הנכון, אתם יכולים להגדיר את פרטי היצרן והדגם (ערכי CHIP_DEVICE_CONFIG_DEVICE_*) של המכשיר לערכים ייחודיים בקושחת הבדיקה.
מידע נוסף זמין במאמר פרטי המכשיר.
אימות ה-VID/PID של המכשיר
כדי להתחיל לפתח את השילוב עם Google, צריך ליצור פרויקט ושילוב ב-Google Home Console.
ערך ה-VID/PID שהמכשיר משדר צריך להתאים ל-VID/PID שהוזן בפרויקט Developer Console.
- מזהי ה-VLAN
0xFFF1עד0xFFF4שמורים לבדיקות. אפשר להשתמש בהם לבדיקות בסיסיות של הפעלה ובקרה, אבל לא בשלבי הפיתוח הבאים:
באמצעות אפליקציית Bluetooth להנדסה כמו nRF Connect for Mobile, אפשר לראות את ה-VID/PID של המכשיר שמשדר אותות בשדה 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 Console, על סמך מה שמוצג ברחרחן ה-Bluetooth.
לפי הערכים בצילום המסך לדוגמה, ה-VID וה-PID ב-Developer Console יהיו 235A ו-FEFF, בהתאמה.