إنشاء مشروع مطوِّر

تتم إدارة مشاريع المطوّرين، التي تشمل عمليات دمج 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 اسما مشروع واضحان وفريدان.

إنشاء المشروع

ويمثّل مشروع المطوّر واحدًا أو أكثر من integrations. ومن خلال مشاركة مشروع مع أعضاء فريق التطوير الذي يتعامل معه، يمكن للمالك السماح للمستخدمين الآخرين بإدارة جميع integrationالعناصر في المشروع.

تتم إدارة المنظومة المتكاملة للمنزل المزوّد بأجهزة ذكية من Google integrationباستخدام الإصدار الجديد Developer Console. هناك طريقتان لإعداد المشاريع في Developer Console:

  1. أنشِئ مشروعًا جديدًا.
  2. استيراد مشروع حالي من وحدة تحكّم "المهام مع مساعد Google"

ننصحك بإنشاء مشروع واحد فقط لجميع عمليات دمج Matter، سواء من خلال الاختبار أو الإنتاج، لا سيما لتجنُّب حدوث مشاكل عند إجراء الاختبار باستخدام معرّفات المورّدين ومعرّفات المنتجات لخدمة Matter.

الطريقة 1: إنشاء مشروع جديد

انتقِل إلى "Developer Console":

الانتقال إلى Play Console

  1. في صفحة إدارة المشاريع، انقر على إنشاء مشروع.
  2. في صفحة البدء، انقر على إنشاء مشروع.
  3. أدخِل اسم مشروعك، الذي يجب أن يلتزم بإرشادات تسمية المشروع.
  4. انقر على إنشاء مشروع جديد.

ستتم إعادة توجيهك مرة أخرى إلى الصفحة الرئيسية للمشروع الجديد.

الطريقة 2: استيراد مشروع حالي من وحدة تحكّم "المهام مع مساعد Google"

يمكن استيراد مشروع Actions on Google حالي إلى Developer Console الجديد، إذا كنت بحاجة إلى إضافة دعم Matter إلى عملية دمج Cloud-to-cloud أو Local Home حالية.

تنطبق القيود التالية على هذه الطريقة:

  • عملية الاستيراد هذه تتم في اتجاه واحد فقط. لا يمكن التراجُع عن هذا القرار.
  • يمكن لمالك المشروع فقط استيراد مشروع Actions on Google حالي. المالك هو الشخص الذي أنشأ المشروع، ويمكن عرضه باستخدام رابط الأعضاء.
  • لا يمكن تعديل الملف التعريفي للشركة لمشروع تم استيراده إلا من خلال Actions on Google Console. وستظهر التغييرات التي يتم إجراؤها في وحدة تحكّم المطوّرين في Google Home.

بعد الاستيراد، سيظل بالإمكان استخدام مشروع Actions on Google الأصلي لإدارة عمليات الدمج الحالية (مثل Cloud-to-cloud وLocal Home وApp Discovery).

لاستيراد مشروع حالي من "Actions on Google Console"، انتقِل إلى Developer Console:

الانتقال إلى Play Console

  1. انقر على إنشاء مشروع.
  2. أدخِل اسم مشروع حالي لـ "المهام" أو اختَر مشروعًا من القائمة المنسدلة (على سبيل المثال، في لقطة الشاشة التالية، اسم المشروع هو "مشروع المسألة القانونية").
  3. انقر على استيراد المشروع.

ستتم إعادة توجيهك مرة أخرى إلى تفاصيل المشروع الحالي في Developer Console.

البدء في مركز مطورّي برامج Google Home

ضبط مستويات السجلّ

بشكل تلقائي، يتم حفظ سجلات الأخطاء فقط في Google Cloud لكل عملية دمج في مشروعك.

لحفظ جميع السجلات في Google Cloud لكل عملية دمج، اختَر جميع السجلات في القسم التحكم في مستوى السجلّ: سجلات الخطأ.

مستويات سجلّ مشاريع Google Home في "مركز المطوّرين"

ينطبق هذا الإعداد على جميع عمليات الدمج في مشروعك. لا يمكن ضبطه لكل عملية دمج. قد يؤدي حفظ جميع السجلّات في Google Cloud إلى فرض تكلفة إضافية في حال تجاوز مساحة تخزين السجلّ.

لمزيد من المعلومات حول السجلات، يُرجى الاطّلاع على التسجيل في السحابة الإلكترونية للمسألة القانونية.

مشاركة مشروع مطوِّر

يمكنك إضافة أو إزالة إمكانية الوصول إلى مشروع بين المستخدمين في فريقك باستخدام الأدوار المحددة مسبقًا.

  1. في الصفحة الرئيسية من Developer Console، انقر على الأعضاء، والتي تنقلك إلى إدارة الهوية وإمكانية الوصول والمشرف > صفحة إدارة الهوية وإمكانية الوصول على Google Cloud Console.

    أو انقر على تفاصيل المشروع، ثم انقر على إدارة الأعضاء في Google Cloud Platform في قسم الأعضاء في أسفل الصفحة.

  2. قم بإجراء التغييرات حسب الضرورة باستخدام لوحة التحكم Google Cloud Console.

للحصول على تعليمات حول كيفية تعديل أذونات الوصول إلى مشروع، يُرجى الرجوع إلى التحكّم في الوصول للمشاريع باستخدام "إدارة الهوية وإمكانية الوصول".

بعد إضافته إلى قائمة المستخدمين، يمكن للمستخدم عرض المشروع وأي عمليات دمج في Developer Console.

وفقًا للإعدادات التنظيمية، قد تواجه أخطاء في الأذونات عند محاولة إنشاء مشاريع مطوّرين. في هذه الحالة، تواصَل مع مشرف "Google Cloud" واطلب الحصول على أذونات "منشئ المشروع" لحسابك.