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

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

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

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

Google Assistant Simulator

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

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

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

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

أدوات تسجيل بيانات Matter

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

Cloud Logging

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

عارض الرسم البياني المنزلي

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

تثبيت إضافة 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 وعرض تسجيل الدخول السحابي.

سجّل الدخول باستخدام 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 ASSISTANT SIMULATOR، واختر من الخيارات التالية لإعداد البرامج النصية:

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

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

  

لبدء إرسال العبارات المجمعة، اختر من الخيارات التالية:

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

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

  

عرض تسجيل السحابة

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

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

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

عرض قاعدة بيانات Home Graph وإجراء الاختبارات

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

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

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

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

تسجيل البيانات في Android

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

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

تسجيل جهاز ماتر

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

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

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

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

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

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

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

قم باستخراج ملف zip المحفوظ، وسوف يظهر معلومات الجهاز وملفات السجل.

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

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

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

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

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