تتم إدارة مشاريع مطوّري البرامج، بما في ذلك عمليات دمج Matter، على Google Home Developer Console الجديدة. توضّح هذه الصفحة طريقة إعداد مشروع جديد لمطوّري البرامج على Developer Console.
القيود
لا يمكن إضافة وظائف الوظيفة Cloud-to-cloud أو Local Home SDK إلى أي مشروع في Developer Console. إذا كنت تريد إضافة وظيفة Matter إلى عملية دمج Cloud-to-cloud أو Local Home حالية، عليك استيراد مشروع Actions on Google حالي أولاً.
تسمية المشروع
عند تسمية مشروعك، من المفيد إنشاء اسم ينطبق عليه ما يلي:
- تتضمّن بعض المعلومات الأساسية عن المشروع.
- لن يتم الخلط بسهولة مع فكرة مشروع آخر.
- يمكن أن يمثل جميع عمليات الدمج في المشروع.
من السهل ابتكار اسم عام، مثل project-gamma-798، ولكن هذا الاسم يحمل "تمويهًا" بشكل فعلي ولن يظهر في قائمة مشاريع أخرى تحمل أسماء عامة.
لضمان إدخال اسم مشروع هادف وفريد، عليك مراعاة هذه الإرشادات عند تسمية مشروعك:
- استخدام اسم شركتك
- استخدم نوع المشروع أو الإجراء في الاسم
- عدم استخدام "test" في اسم المشروع
على سبيل المثال، acme-smarthome أو acme-lighting أسماء مشروعة واضحة وفريدة.
إنشاء المشروع
يمثّل مشروع مطوّر البرامج عملية دمج واحدة أو أكثر. من خلال مشاركة مشروع مع أعضاء فريق التطوير، يمكن للمالك السماح لمستخدمين آخرين بإدارة جميع عمليات الدمج في المشروع.
تتم إدارة عمليات دمج المنظومة المتكاملة للمنازل المزوّدة بأجهزة ذكية من Google باستخدام الإصدار الجديد من Developer Console. هناك طريقتان لإعداد المشاريع في Developer Console:
ننصحك بإنشاء مشروع واحد فقط لجميع عمليات الدمج، بما في ذلك عمليات الاختبار والإنتاج، خاصةً لتجنُّب المشاكل عند الاختبار باستخدام معرّفات المورّدين التجريبية أو معرّفات المنتجات في Matter.
الطريقة 1: إنشاء مشروع جديد
يُرجى الانتقال إلى Developer Console:
- في صفحة إدارة المشاريع، انقر على إنشاء مشروع.
- في صفحة البدء، انقر على إنشاء مشروع.
- أدخِل اسم مشروعك الذي يجب أن يتوافق مع إرشادات تسمية المشروع.
- انقر على إنشاء مشروع جديد.
ستتم إعادة توجيهك إلى الصفحة الرئيسية للمشروع الجديد.
الطريقة 2: استيراد مشروع حالي من وحدة تحكّم "المهام مع مساعد Google"
يمكن استيراد مشروع Actions on Google حالي إلى الإصدار الجديد Developer Console، إذا أردت إضافة دعم Matter إلى عملية دمج Cloud-to-cloud أو Local Home حالية.
تسري القيود التالية على هذه الطريقة:
- عملية الاستيراد هذه باتجاه واحد فقط. ولا يمكن التراجع عن هذا الإجراء.
- يمكن لمالك المشروع فقط استيراد مشروع Actions on Google الحالي. المالك هو الشخص الذي أنشأ المشروع، والذي يمكن عرضه باستخدام رابط "الأعضاء".
- لا يمكن تعديل الملف التعريفي للشركة لمشروع مستورَد إلا في المهام مع مساعد Google. ستظهر التغييرات التي يتم إجراؤها في Google Play Console.
بعد الاستيراد، سيظلّ بإمكانك استخدام مشروع Actions on Google الأصلي لإدارة عمليات الدمج الحالية (مثل Cloud-to-cloud و Local Home وApp Discovery).
لاستيراد مشروع حالي من Actions on Google Console، يُرجى الانتقال إلى Developer Console:
- انقر على إنشاء مشروع.
- أدخِل اسم مشروع إجراءات حالي أو اختَر مشروعًا من القائمة المنسدلة (على سبيل المثال، في لقطة الشاشة أدناه، يكون اسم المشروع هو "مشروعي").
- انقر على استيراد مشروع.
ستتم إعادة توجيهك إلى تفاصيل المشروع الحالية في Developer Console.
ضبط مستويات السجلّ
يتم تلقائيًا حفظ سجلّات الأخطاء فقط في Google Cloud لكل عملية دمج في مشروعك.
لحفظ جميع السجلات في Google Cloud لكل عملية دمج، اختَر كل السجلات في قسم التحكّم على مستوى السجلّ: سجلات الأخطاء.
ينطبق هذا الإعداد على جميع عمليات الدمج في مشروعك. ولا يمكن ضبطه عند الدمج. قد يؤدي حفظ كل السجلّات إلى Google Cloud إلى فرض تكلفة إضافية في حال تجاوز مساحة تخزين السجلّات.
لمعرفة المزيد من المعلومات حول السجلّات، يُرجى الاطِّلاع على Cloud Logging for Matter.
مشاركة مشروع مطوِّر
يمكنك إضافة إذن الوصول إلى مشروع أو إزالته بين المستخدمين في فريقك باستخدام الأدوار المحدَّدة مسبقًا.
في الصفحة الرئيسية من Developer Console، انقر على الأعضاء، وسيتم نقلك إلى صفحة إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول في Google Cloud Console.
أو انقر على تفاصيل المشروع، ثم انقر على إدارة الأعضاء في Google Cloud Platform من قسم الأعضاء في أسفل الصفحة.
يمكنك إجراء التغييرات حسب الضرورة باستخدام لوحة بيانات Google Cloud Console.
للحصول على تعليمات حول كيفية تعديل إمكانية الوصول إلى مشروع معيّن، يمكنك الاطّلاع على مستندات Google Cloud للتحكّم في إمكانية الوصول.
وبعد إضافة المستخدم إلى قائمة المستخدمين، يمكن عرض المشروع وأي عمليات دمج في Developer Console.