פרויקטים של מפתחים, שכוללים שילובים של Matter, מנוהלים ב-Google Home Developer Console. בדף הזה מוסבר איך להגדיר פרויקט פיתוח חדש ב-Developer Console.
הגבלות
נותנים שם לפרויקט.
כשנותנים שם לפרויקט, מומלץ לבחור שם:
- כולל מידע בסיסי על הפרויקט.
- לא יתבלבל בקלות עם שם של פרויקט אחר.
- יכול לייצג את כל ה integrationבפרויקט.
חשוב לתת שמות עם משמעות. שם כללי כמו project-gamma-798 הוא למעשה "מתחזה" ולא בולט ברשימת פרויקטים אחרים עם שמות כלליים.
כדאי להיעזר בהנחיות הבאות כשנותנים שם לפרויקט:
- שימוש בשם החברה
- להשתמש בסוג הפרויקט או הפעולה בשם
- לא להשתמש במילה 'test' בשם הפרויקט
לדוגמה, acme-smarthome ו-acme-lighting הם שמות ברורים וייחודיים של פרויקטים.
יצירת הפרויקט
פרויקט למפתחים מייצג שילוב אחד או יותר. כשמשתפים פרויקט עם חברי צוות הפיתוח, הבעלים יכולים לאפשר למשתמשים אחרים לנהל את כל השילובים בפרויקט.
השילובים של הסביבה העסקית של Google Smart Home מנוהלים באמצעות Developer Console.
מומלץ ליצור רק פרויקט אחד לכל השילובים של Matter, גם לבדיקה וגם בסביבת הייצור, במיוחד כדי למנוע בעיות בזמן בדיקה עם מזהי ספקים ומזהי מוצרים לבדיקה של Matter.
שיטה 1: יצירת פרויקט חדש
עוברים אל Developer Console:
- בדף Manage projects (ניהול פרויקטים), לוחצים על Create a project (יצירת פרויקט).
- בדף שנתחיל?, לוחצים על יצירת פרויקט.
- מזינים את שם הפרויקט. השם צריך לעמוד בהנחיות למתן שמות לפרויקטים.
- לוחצים על Create new project.
המערכת תפנה אתכם חזרה לדף Home של הפרויקט החדש.
שיטה 2: ייבוא פרויקט קיים מהמסוף של Actions on Google
אפשר לייבא פרויקט Actions on Google קיים ל-Developer Console החדש, אם צריך להוסיף תמיכה ב-Matter לשילוב קיים של Cloud-to-cloud או Local Home SDK.
ההגבלות הבאות חלות על השיטה הזו:
- היבוא הזה הוא חד-כיווני בלבד. אי אפשר לבטל את הפעולה הזו.
- רק הבעלים של הפרויקט יכול לייבא פרויקט Actions on Google קיים. הבעלים הוא מי שיצר את הפרויקט, שאפשר לראות באמצעות הקישור למשתתפים.
- אפשר לערוך את פרופיל החברה של פרויקט שיובא רק במסוף Actions on Google. השינויים שם ישתקפו במסוף הפיתוח של Google Home.
אחרי הייבוא, עדיין תוכלו להשתמש בפרויקט Actions on Google המקורי כדי לנהל שילובים קיימים (כמו Cloud-to-cloud, Local Home ו-App Discovery).
כדי לייבא פרויקט קיים מה-Actions on Google Console, עוברים אל Developer Console:
- לוחצים על Create a Project.
- מזינים שם של פרויקט קיים ב-Actions או בוחרים פרויקט מהרשימה הנפתחת (לדוגמה, בצילום המסך הבא שם הפרויקט הוא 'My matter project').
- לוחצים על ייבוא פרויקט.
תופנו חזרה לפרטי הפרויקט הקיימים ב-Developer Console.
הגדרת רמות יומן
כברירת מחדל, רק יומני השגיאות נשמרים ב-Google Cloud לכל שילוב בפרויקט.
כדי לשמור את כל היומנים ב-Google Cloud לכל שילוב, בוחרים באפשרות All logs בקטע Log level control: Error logs.
ההגדרה הזו חלה על כל השילובים בפרויקט. אפשר לשנות את ההגדרה הזו רק ל-Cloud-to-cloud שילובים. שמירת כל היומנים ב-Google Cloud עשויה לגרום לעלויות נוספות אם תחרגו ממכסת האחסון של היומנים.
מידע נוסף על יומנים זמין במאמר Cloud Logging עבור Matter .
שיתוף פרויקט של מפתח
אתם יכולים להוסיף או להסיר גישה לפרויקט שלכם למשתמשים בצוות באמצעות תפקידים מוגדרים מראש.
בדף Home ב-Developer Console, לוחצים על Members. המערכת תעביר אתכם לדף IAM & Admin > IAM ב-Google Cloud Console.
לחלופין, לוחצים על פרטי הפרויקט ואז על ניהול החברים ב-GCP בקטע חברים שבתחתית המסך.
מבצעים שינויים לפי הצורך בלוח הבקרה Google Cloud Console.
במאמר בקרת גישה לפרויקטים באמצעות IAM מוסבר איך לשנות את הגישה לפרויקט.
אחרי שמוסיפים משתמש לרשימת המשתמשים, הוא יכול לראות את הפרויקט ואת השילובים ב-Developer Console.
בהתאם להגדרות הארגון, יכול להיות שתקבלו שגיאות הרשאה כשתנסו ליצור פרויקטים למפתחים. אם כן, עליכם לפנות לאדמין של Google Cloud ולבקש הרשאות ליצירת פרויקטים לחשבון שלכם.