إضافة 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

لاختبار ما إذا كانت أجهزتك المنزلية الذكية تعمل بشكل صحيح مع نظام 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 services (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 في الشريط الجانبي. في مربّع الرسالة ، اكتب طلبك واضغط على Enter.

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

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

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

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

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

  

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

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

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

  

عرض Cloud Logging

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

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

تقتصر السجلات تلقائيًا على 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

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