פרויקטים של מפתחים, שכוללים שילובים של Matter, מנוהלים דרך Google Home Developer Console. דף זה מסביר איך מגדירים פרויקט פיתוח חדש ב-Developer Console.
הגבלות
לא ניתן להוסיף את הפונקציונליות Cloud-to-cloud או Local Home SDK לפרויקט באמצעות Developer Console. אם אתם רוצים להוסיף את הפונקציונליות של Matter לשילוב קיים ב-Cloud-to-cloud או Local Home, קודם צריך לייבא פרויקט Actions on Google קיים.
נותנים שם לפרויקט.
כשאתם נותנים שם לפרויקט, מומלץ לכתוב שם:
- כולל כמה פרטים בסיסיים על הפרויקט.
- קל להתבלבל בינו לבין פרויקט אחר.
- יכול לייצג את כל ה- integrationבתוך הפרויקט.
חשוב לתת שמות משמעותיים. שם גנרי כמו project-gamma-798 הוא למעשה "מוסווה", והוא לא יבלוט ברשימת פרויקטים אחרים בעלי שם כללי.
כשאתם נותנים שם לפרויקט, כדאי להביא בחשבון את ההנחיות הבאות:
- שימוש בשם החברה שלך
- יש להשתמש בסוג הפרויקט או הפעולה בשם
- אסור להשתמש במילה 'בדיקה' בשם הפרויקט
לדוגמה, acme-smarthome ו-acme-lighting הם שמות פרויקטים ברורים וייחודיים.
יוצרים את הפרויקט
פרויקט פיתוח מייצג פריט integrationאחד או יותר. כשמשתפים פרויקט עם חברי צוות הפיתוח, הבעלים יכולים לאפשר למשתמשים אחרים לנהל את כל integrationבפרויקט.
מערכות integrationלבית החכם של Google מנוהלות באמצעות Developer Console החדש. יש שתי שיטות להגדרת פרויקטים בDeveloper Console:
מומלץ ליצור פרויקט אחד בלבד לכל השילובים של Matter, גם לבדיקות וגם לסביבת הייצור, במיוחד כדי להימנע מבעיות בבדיקה עם מזהי הספקים ומזהי המוצרים לבדיקה עבור Matter.
שיטה 1: יצירת פרויקט חדש
עוברים אל Developer Console:
- בדף Manage projects לוחצים על Create a project.
- בדף Get started (התחלה), לוחצים על Create Project.
- מזינים את שם הפרויקט, בהתאם להנחיות למתן שמות לפרויקט.
- לוחצים על יצירת פרויקט חדש.
המערכת תפנה אתכם חזרה לדף הבית של הפרויקט החדש.
שיטה 2: מייבאים פרויקט קיים ממסוף Actions on Google
אפשר לייבא פרויקט Actions on Google קיים לממשק Developer Console החדש, אם צריך להוסיף תמיכה ב-Matter לשילוב קיים עם Cloud-to-cloud או Local Home.
המגבלות הבאות חלות על שיטה זו:
- הייבוא הזה הוא חד-כיווני בלבד. לא ניתן לבטל אותה.
- רק הבעלים של הפרויקט יכול לייבא פרויקט Actions on Google קיים. הבעלים הוא מי שיצר את הפרויקט, וניתן לראות אותו באמצעות הקישור Members.
- אפשר לערוך את פרופיל החברה בפרויקט מיובא רק ב-Actions on Google Console. השינויים יבואו לידי ביטוי ב-Google Home Developer Console.
אחרי הייבוא, אפשר להמשיך להשתמש בפרויקט 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 (הפקד ברמת היומן: Error logs).
ההגדרה הזו חלה על כל השילובים בפרויקט. לא ניתן להגדיר אותה לכל שילוב. השמירה של כל היומנים ב-Google Cloud עשויה להיות כרוכה בעלות נוספת במקרה של חריגה מנפח האחסון ביומן.
מידע נוסף על יומנים זמין במאמר Cloud Logging for Matter.
שיתוף פרויקט פיתוח
ניתן לך להוסיף או להסיר גישה לפרויקט בקרב המשתמשים בצוות שלך באמצעות תפקידים מוגדרים מראש.
בדף הבית של Developer Console לוחצים על Members, כדי לעבור לדף IAM & Admin > IAM ב-Google Cloud Console.
לחלופין, לוחצים על Project details ואז על Manage members ב-GCP בקטע Members בתחתית הדף.
מבצעים שינויים לפי הצורך באמצעות מרכז הבקרה Google Cloud Console.
במאמר בקרת גישה לפרויקטים עם IAM תוכלו לקרוא איך משנים את הגישה לפרויקט.
אחרי שהוא נוסף לרשימת המשתמשים, הוא יכול לראות את הפרויקט ואת כל השילובים ב-Developer Console.
בהתאם להגדרות הארגון, ייתכן שתיתקלו בשגיאות בהרשאות במהלך הניסיון ליצור פרויקטים למפתחים. במקרה כזה, עליכם לפנות לאדמין של Google Cloud ולבקש הרשאות ליצירת פרויקטים בחשבון.