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

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

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

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

مُحاكي مساعد 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 Extension لـ VS Code

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

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

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

   

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

تنزيل Google Home Extension

إعداد إضافة Google Home Extension لـ 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 Extension لـ 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 Extension لتصحيح أخطاء Matter

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

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

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

تسجيل بيانات أجهزة Matter

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

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

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

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

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

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

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

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

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

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

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

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

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