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

Google Home Extension for Visual Studio Code تم تصميمها وإنشاؤها من أجل مطوّري Google Home Platform. تمنحك هذه الإضافة إمكانية الوصول إلى Google Assistant Simulator و Google Cloud Logging و"عارض قاعدة بيانات Home Graph" وأدوات أخرى لتسهيل عملية تطوير 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

يتوفّر عارض قاعدة بيانات Home Graph الآن مباشرةً في 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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