إضافة Google Home لرمز VS

حزمة تطوير البرامج (SDK) لـ    Matter    Cloud-to-cloud Local Home

Google Home Extension for Visual Studio Code تم تصميمها وإنشاؤها من أجل مطوّري Google Home Platform. تمنحك هذه الإضافة إمكانية الوصول إلى Google Assistant Simulator, Google Cloud Logging وHome Graph Viewer وأدوات أخرى لتبسيط عملية تطوير Matter والمنزل المزوّد بأجهزة ذكية.

ميزات إضافة Google Home

محاكي مساعد Google

لاختبار ما إذا كانت أجهزتك المنزلية الذكية تعمل بشكل صحيح مع نظام Google Home ، يمكنك التفاعل مع Assistant Simulator في أي وقت بدون مغادرة VS Code.

Assistant Simulator يتيح لك التحكّم في أجهزتك بسهولة عن طريق كتابة طلباتك، مثلاً "تشغيل الضوء" داخل VS Code، يردّ Assistant Simulator برسائل نصية استنادًا إلى أوامرك، مثلاً "حسنًا، جارٍ تشغيل الضوء" يمكنك الاطّلاع على مقالة استخدام "محاكي مساعد Google" لمزيد من التفاصيل.

العبارات المجمّعة

لاختبار عملية دمج Google Home مثل جهاز آلي، يمكنك إرسال عبارات مجمّعة إلى محاكي مساعد Google عن طريق تشغيل نص برمجي للعبارات. يمكنك الاطّلاع على مقالة تشغيل العبارات المجمّعة لمزيد من التفاصيل.

أدوات تسجيل Matter

يمكن لأدوات تسجيل Matter جمع جميع السجلات المتعلقة بتحديد الأخطاء في Matter، بما في ذلك سجلات Google Home app (GHA) وسجلات "خدمات Google Play" (GMS Core). يمكن عرض السجلات على VS Code باستخدام الفلاتر وعمليات البحث عن الكلمات الرئيسية. يمكن تنزيل السجلات مع معلومات إضافية لتحديد الأخطاء، مثل Android وإصدار التطبيق، وإرسالها إلى Google للإبلاغ عن المشاكل.

Cloud Logging

Cloud Logging يوفر معلومات لتحديد الأخطاء ومقاييس رئيسية لمنحك إحصاءات حول استخدام الإجراء. لتبسيط عملية التطوير، تعرض Google Home Extension رسائل Cloud Logging في الوقت الفعلي بجانب الرمز البرمجي مباشرةً أثناء تحديد المشاكل وحلّها. يمكنك الاطّلاع على مقالة عرض Cloud Logging لمزيد من التفاصيل.

Home Graph Viewer

يتوفّر Home Graph Viewer الآن مباشرةً في Google Home Extension، ما يتيح لك التحقّق من حالة الجهاز في Home Graph داخل VS Code. يمكنك الاطّلاع على مقالة عرض Home Graph وإجراء الاختبارات لمزيد من التفاصيل.

تثبيت إضافة Google Home لـ VS Code

لتثبيت Google Home Extension، اتّبِع الخطوات التالية من داخل VS Code:

1. انقر على رمز الإضافات في شريط الأنشطة.

2. ابحث عن google home ، ثم انقر على تثبيت.

   

يمكنك أيضًا تنزيل Google Home Extension مباشرةً من VS Code Marketplace.

تنزيل Google Home Extension

إعداد إضافة Google Home لـ VS Code

بعد تثبيت Google Home Extension وإعادة تحميل VS Code، عليك تسجيل الدخول واختيار مشروع قبل أن تتمكّن من استخدام Assistant Simulator وعرض Cloud Logging.

تسجيل الدخول باستخدام حساب Google واختيار مشروع على السحابة الإلكترونية

يمكنك تسجيل الدخول إلى حساب المطوّرين من Google Home Extension، ما يمنح VS Code إذن التواصل مع خدمات Google نيابةً عنك.

1. انقر على رمز Google Home في شريط الأنشطة لفتح Google Home Extension.

   

2. انقر على تسجيل الدخول باستخدام حساب Google لفتح صفحة تسجيل الدخول في متصفّحك.

   

3. اختَر الحساب المرتبط بأجهزتك المنزلية الذكية.

4. في صفحة التفويض تسجيل الدخول باستخدام حساب Google ، انقر على السماح.

5. سيتم فتح علامة تبويب متصفّح وسيظهر مربّع حوار فتح Visual Studio Code. انقر على فتح Visual Studio Code للمتابعة.

   

6. ستتم إعادة توجيهك إلى VS Code، حيث يجب منح الإذن لإضافة Google Home بفتح معرّف موارد منتظم (URI). انقر على فتح لإنهاء عملية تسجيل الدخول.

   

7. بعد تسجيل الدخول، ستحمِّل Google Home Extension مشاريعك. بعد اكتمال ذلك، انقر على اختيار مشروع.

   

8. في النافذة المنسدلة البحث عن مشروع واختياره التي تظهر، اختَر مشروع منزلك المزوّد بأجهزة ذكية.

تثبيت أداة Android Debug Bridge (ADB)

لعرض سجلات Matter على هاتف Android ، عليك تثبيت ADB:

1. ثبِّت ADB على جهاز الكمبيوتر.
2. فعِّل خيارات المطوّرين وتحديد الأخطاء عبر USB على هاتف Android.

تثبيت أدوات SoC لأجهزة Matter

لعرض سجلات تحديد الأخطاء من Matter الأجهزة:

1. ستصدِّر معظم أجهزة SoC منافذ تسلسلية، مثل /dev/ttyUSBx على Linux أو /dev/tty.SLAB_USBtoUART أو /dev/tty.usbserial على MacOS. يمكن لـ LogViewer قراءة السجلّ من الجهاز مباشرةً.
2. قد تتطلّب بعض أنواع SoC، مثل NXP أو Silicon Labs، تثبيت أدوات خارجية (مثل JLink). يمكنك الاطّلاع على الأجهزة المتوافقة لمزيد من المعلومات.

استخدام إضافة Google Home لـ VS Code

عرض مصادر المطوّرين

ضمن المساعدة والملاحظات، انقر على البدء والمصادر لفتح صفحة المصادر، حيث يمكنك العثور على معلومات مفيدة لتطويرك باستخدام نظام Google Home.

استخدام "محاكي مساعد Google"

لفتح Assistant Simulator في VS Code، انقر على GOOGLE ASSISTANT SIMULATOR في Side Bar. في مربّع الرسالة ، اكتب طلبك واضغط على Enter.

يمكنك عرض ردود Assistant Simulator، والنقر على الزر بعد طلبك لإعادة إرساله.

تشغيل العبارات المجمّعة

مرِّر مؤشر الماوس فوق شريط قائمة محاكي مساعد Google ، واختَر أحد الخيارات التالية لإعداد النصوص البرمجية:

• انقر على file_upload لفتح النصوص البرمجية الحالية للعبارات.

• انقر على file_download لحفظ السجلّ في نص برمجي *.utterance

  

لبدء إرسال عبارات مجمّعة، اختَر أحد الخيارات التالية:

• انقر على play_arrow لاختيار نص برمجي للعبارات من النافذة المنسدلة.

• افتح ملف *.utterance مباشرةً وانقر على play_arrow.

  

عرض Cloud Logging

ضمن الوصول السريع ، انقر على سجلات Cloud لفتح صفحة سجلات Cloud ، حيث يمكنك العثور على السجلات التابعة لمشروعك الذي اخترته.

يمكن للمستخدمين فلترة السجلات استنادًا إلى درجة الأهمية والنطاق الزمني.

تقتصر السجلات تلقائيًا على 50 صفًا. إذا أراد المستخدم عرض المزيد من السجلات، عليه الانتقال إلى أسفل الصفحة والنقر على المزيد لعرض المزيد من السجلات.

عرض Home Graph وإجراء الاختبارات

ضمن الوصول السريع ، انقر على Home Graph Viewer لفتح لوحة Home Graph Viewer ، حيث يمكنك العثور على الأجهزة التابعة للمشروع الذي اخترته. يمكنك أيضًا النقر على إجراء الاختبار لإجراء اختبارات للجهاز.

سيؤدي ذلك إلى فتح مجموعة الاختبارات في متصفّحك مع اختيار جهازك وجاهزيته للاختبار. انقر على بدء وانتظِر نتائج الاختبار.

يمكنك الاطّلاع على تفاصيل الاختبار وعرض السجلات بعد اكتمال جميع الاختبارات.

استخدام إضافة Google Home لتحديد الأخطاء في Matter

تسجيل الدخول إلى Android

ضمن أدوات تسجيل Matter، انقر على Android السجلات لـ فتح صفحة Android السجلات، واختَر الـ Android الهاتف الذي تريد الاتصال به وابدأ في عرض السجلات.

بعد توصيل هاتف Android، ستتمكّن من الاطّلاع على السجلات سطرًا بسطر. يُرجى العِلم بأنّه يتم فلترة السجلات، ما يعني أنّه يتم عرض السجلات المتعلقة بـ GHA ووحدة Google Play services Matter فقط. يمكنك أيضًا ضبط درجة الأهمية لفلترة السجلات أو البحث عن الكلمة الرئيسية في السجلات.

تسجيل الدخول إلى جهاز Matter

ضمن أدوات تسجيل Matter ، انقر على سجلات الجهاز لفتح صفحة المصادر ، واختَر نوع SoC أولاً:

بعد ذلك، اختَر جهاز Matter:

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

تنزيل جميع سجلات Matter

ضمن الوصول السريع ، انقر على تنزيل السجلات لفتح مربّع الحوار تنزيل السجلات ، واختَر السجلات التي تريد تنزيلها، ثم انقر على حسنًا.

اختَر المجلد لتنزيل السجلات وانقر على حفظ:

بعد ذلك، سيتم حفظ السجلات في المجلد الوجهة:

استخرِج ملف ZIP المحفوظ، وسيظهر معلومات الجهاز وملفات السجلّات.

سيشمل ملف معلومات الجهاز جميع معلومات الإصدار اللازمة لتحديد المشاكل وحلّها.

إرسال ملاحظات

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير باستخدام Google Home Extension، اختَر أحد الخيارات التالية:

• في لوحة المساعدة والملاحظات ، انقر على إرسال ملاحظات لإرسال اقتراحاتك إلينا.
• في لوحة المساعدة والملاحظات، انقر على الإبلاغ عن مشكلة للإبلاغ عن أي مشكلة وجدتها في Google Home Extension

• لقد وفّرنا أيضًا رمز ملاحظات في صفحة المصادر.