יצירת פרויקט פיתוח

פרויקטים של מפתחים, שכוללים שילובים של 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, הוא למעשה "מוסווה", והוא לא יבלוט ברשימה של פרויקטים אחרים עם שם גנרי.

כשאתם נותנים שם לפרויקט, כדאי להביא בחשבון את ההנחיות הבאות:

  • צריך להשתמש בשם החברה שלך
  • יש לציין את סוג הפרויקט או הפעולה בשם
  • אסור להזין את המילה test בשם הפרויקט.

לדוגמה, acme-smarthome ו-acme-lighting הם שמות ברורים וייחודיים של פרויקטים.

יצירת הפרויקט

פרויקט מפתח מייצג נכס integrationאחד או יותר. כשמשתפים פרויקט עם החברים בצוות הפיתוח, הבעלים יכולים לאפשר למשתמשים אחרים לנהל את כל הנכסים מסוג integrationבפרויקט.

הסביבה העסקית של הבית החכם integrationשל Google מנוהלת באמצעות Developer Console החדש. יש שתי שיטות להגדיר פרויקטים ב-Developer Console:

  1. יוצרים פרויקט חדש.
  2. מייבאים פרויקט קיים ממסוף Actions on Google.

מומלץ ליצור רק פרויקט אחד לכל השילובים של Matter, גם לבדיקה וגם לסביבת הייצור, כדי למנוע בעיות בבדיקה של מזהי ספקים לבדיקה ומזהי מוצרים של Matter.

שיטה 1: יצירת פרויקט חדש

עוברים אל Developer Console:

כניסה אל Developer Console

  1. בדף Manage projects, לוחצים על Create a project.
  2. בדף Get started (תחילת העבודה), לוחצים על Create project.
  3. מזינים את שם הפרויקט שתואם להנחיות למתן שמות לפרויקט.
  4. לוחצים על Create new project (יצירת פרויקט חדש).

תועברו חזרה אל דף הבית של הפרויקט החדש.

שיטה 2: ייבוא פרויקט קיים ממסוף Actions on Google

אם צריך להוסיף תמיכה של Matter לשילוב קיים של Cloud-to-cloud או Local Home, אפשר לייבא פרויקט קיים של Actions on Google אל Developer Console החדש.

ההגבלות הבאות חלות על השיטה הזו:

  • הייבוא הזה הוא חד-כיווני בלבד. אי אפשר לבטל את הפעולה הזו.
  • רק בעלי הפרויקט יכולים לייבא פרויקט 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:

כניסה אל Developer Console

  1. לוחצים על Create a Project.
  2. מזינים שם של פרויקט קיים ב-Actions או בוחרים פרויקט מהרשימה הנפתחת (לדוגמה, בצילום המסך הבא, שם הפרויקט הוא 'My Matter project').
  3. לוחצים על Import project.

תועברו חזרה לפרטי הפרויקט הקיים ב-Developer Console.

מרכז המפתחים של Google Home
תחילת העבודה

הגדרת רמות ביומן

כברירת מחדל, רק יומני שגיאות נשמרים ב-Google Cloud לכל שילוב בפרויקט.

כדי לשמור את כל היומנים ב-Google Cloud לכל שילוב, בוחרים באפשרות All Logs (כל היומנים) בקטע Log level control: Error logs.

רמות היומן של הפרויקט ב-Google Home Developer Center

ההגדרה הזו חלה על כל השילובים בפרויקט. אי אפשר להגדיר אותו לכל שילוב. שמירת כל היומנים ב-Google Cloud עלולה להיות כרוכה בעלות נוספת אם תהיה חריגה מנפח האחסון של היומן.

למידע נוסף על יומנים, ראו Cloud Logging עבור Mater.

שיתוף פרויקט פיתוח

אתם יכולים להשתמש ב תפקידים מוגדרים מראש כדי להוסיף או להסיר את הגישה לפרויקט בין המשתמשים בצוות.

  1. בדף הבית של Developer Console, לוחצים על Members (חברים) ועוברים לדף IAM & Admin > IAM ב-Google Cloud Console.

    לחלופין, לוחצים על Project details ואז על Manage members in GCP בקטע Members למטה.

  2. מבצעים שינויים לפי הצורך דרך מרכז הבקרה של Google Cloud Console.

במאמר בקרת גישה לפרויקטים עם IAM מוסבר איך משנים את הרשאות הגישה לפרויקט.

אחרי הוספת הפרויקט לרשימת המשתמשים, המשתמש יכול לצפות בפרויקט ובכל האינטגרציות ב-Developer Console.

בהתאם להגדרת הארגון שלכם, יכול להיות שיהיו שגיאות בהרשאות כשתנסו ליצור פרויקטים למפתחים. אם כן, עליכם לפנות לאדמין ב-Google Cloud ולבקש הרשאות ליצירת פרויקטים בחשבון.