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

Matter    من السحابة الإلكترونية إلى السحابة الإلكترونية    حزمة تطوير برامج المنزل المحلية

تم تصميم 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 رسائل مسجّلة من Google 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 Extension بفتح معرّف موارد منتظم (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 في الشريط الجانبي. في مربّع الرسالة، اكتب طلب البحث واضغط على Enter.

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

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

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

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

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

  

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

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

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

  

عرض Cloud Logging

ضمن الوصول السريع، انقر على سجلّات Cloud لفتح صفحة سجلّات Cloud، حيث يمكنك العثور على السجلّات التي تنتمي إلى مشروعك المحدّد.

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

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

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

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

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

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

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

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

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

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

تسجيل سجلّات أجهزة Matter

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

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

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

تنزيل جميع سجلات المسائل القانونية

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

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

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

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

سيتضمّن ملف معلومات الجهاز جميع معلومات الإصدار اللازمة لتصحيح الأخطاء.

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

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

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

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