المكوّن الإضافي Google Home لـ Android Studio

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

إشعار أمان

لمنع Android Studio من تخزين الأسرار و كلمات المرور، يُرجى إكمال الخطوات التالية:

1. انقر على ملف، ثم على الإعدادات....
2. في المظهر والسلوك ، وسِّع إعدادات النظام ، ثم انقر على كلمات المرور.
3. اختَر عدم الحفظ، ونسيان كلمات المرور بعد إعادة التشغيل.

الميزات

مُحاكي "مساعد Google"

لاختبار ما إذا كانت أجهزة منزلك الذكي تعمل بشكلٍ سليم مع نظام Google Home ، يمكنك التفاعل مع Assistant Simulator في أي وقت بدون مغادرة Android Studio.

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

عرض Cloud Logging

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

يمكنك عرض السجلّات في الوقت الفعلي أو اختيار نطاق زمني.

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

لا يمكن تحديد ردود Assistant Simulator على عبارة واحدة. على سبيل المثال، يمكن أن يكون الرد أيًا من العبارات التالية:

• تمّ، جارٍ تشغيل ضوءَين.
• بالتأكيد، جارٍ تشغيل ضوءَين.
• تمّ، جارٍ تشغيل ضوءَين.
• حسنًا، جارٍ تشغيل ضوءَين.

لتشغيل الاختبارات الآلية والتحقّق من طريقة عمل عمليات التكامل مع Google مع هذه الردود المختلفة، يمكنك إرسال عبارات مجمّعة إلى Assistant Simulator عن طريق تشغيل النصوص البرمجية للعبارات. بعد حفظ نص برمجي، يمكنك جمع الردود وتشغيل اختبارات متعدّدة على طلباتك.

عارض Home Graph

يتيح لك عارض Home Graph عرض حالة أجهزتك وتشغيل Google Home Test Suite في متصفّحك.

عارض سجلّات Android Debug Bridge ‏ (adb)

عارض سجلّات adb هو أداة لعرض ملفات السجلّات وتحليلها، مثل Matter ملفات سجلّات أجهزة Google Home وسجلّات Android وسجلّات.

تثبيت

لتثبيت Google Home Plugin في Android Studio، اتّبِع الخطوات التالية:

1. نزِّل Android Studio أو حدِّثه. تنزيل "استوديو Android"
2. انتقِل إلى ملف > الإعدادات (Android Studio > الإعدادات المفضّلة على نظام التشغيل MacOS).
3. في قسم الإضافات ، انتقِل إلى Marketplace وابحث عن google home.
4. ثبِّت الأداة وأعِد تشغيل Android Studio.

يمكنك أيضًا تنزيل الإضافة مباشرةً من JetBrains Marketplace.

الإعداد

بعد تثبيت الإضافة، عليك إكمال الخطوات التالية قبل أن تتمكّن من استخدام Assistant Simulator و عرض Cloud Logging:

• تسجيل الدخول باستخدام حساب Google
• اختيار مشروع على السحابة الإلكترونية

تسجيل الدخول باستخدام حساب Google

يمكنك تسجيل الدخول إلى حسابك على المطوّرين من لوحة Google Home، ما يمنح Android Studio إذن التواصل مع خدمات Google نيابةً عنك.

1. انقر على علامة التبويب Google Home في عمود علامات التبويب العمودي على الجانب الأيمن من نافذة Android Studio.

2. بالنسبة إلى تسجيل الدخول باستخدام، انقر على Google لتشغيل المتصفّح.

   

3. اختَر الحساب المرتبط بأجهزة منزلك الذكي.

4. في صفحة التفويض تسجيل الدخول باستخدام حساب Google ، انقر على السماح.

5. أغلِق نافذة المتصفّح، وعُد إلى Android Studio.

يجب أن تكون الآن مسجّلاً الدخول، مع توفّر خيار تسجيل الخروج.

اختيار مشروع على السحابة الإلكترونية

بعد تسجيل الدخول، اختَر مشروعًا من القائمة المنسدلة. لفلترة قائمة المشاريع، اكتب تعبير فلتر ، مثلاً matter، ثم اضغط على Enter.

تحمِّل القائمة المنسدلة المشروع أول 100 مشروع استنادًا إلى الفلتر. يتم الاحتفاظ بالخيارات التي تحدّدها عند الخروج Android Studio.

للحصول على مساعدة بشأن فلاتر المشاريع، يُرجى الرجوع إلى مَعلمات طلب البحث في مرجع Google Cloud.

استخدام "مُحاكي "مساعد Google"

لفتح Assistant Simulator في Android Studio، انقر على لوحة العبارات من لوحة Google Home Plugin.

هناك عدة طرق لإرسال طلبات بحث إلى Assistant Simulator. في ما يلي، سنشرح كل خيار.

كتابة طلبات البحث وجمع الردود

للتفاعل مع Assistant Simulator، اكتب طلب البحث واضغط على Enter.

يمكنك إعادة إرسال طلب بحث بالنقر على cached رمز إعادة الإرسال في نهاية طلب البحث.

بعد إرسال طلب بحث واحد أو أكثر، انقر على cached إعادة التشغيل لإعادة تشغيل طلبات البحث والتحقّق من الردود. تتتبّع لوحة العبارات طلبات البحث والردود في ذاكرة تخزين مؤقتة مخزّنة. لا يضيف خيار إعادة التشغيل سوى الردود الجديدة إلى هذه الذاكرة التخزين المؤقتة الداخلية، ولن يكرّر طلبات البحث في كل مرة تنقر فيها على الزر.

انقر على save حفظ لحفظ طلبات البحث و الردود التي أدخلتها في العبارات لوحة. يتم تحويل تفاعلاتك إلى JSON بالتنسيق التالي:

• ask: طلب البحث.
• answers: مصفوفة من الردود المحتمَلة من Assistant Simulator.

يمكنك تعديل ملف JSON هذا في Android Studio.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

جمع الردود المجمّعة

من لوحة Google Home Plugin، انقر على ملف العبارات لفتح ملفات JSON المحفوظة في علامة تبويب جديدة. بالنسبة إلى اختيار المسار، يمكنك اختيار ملف أو مجلد. إذا اخترت مجلدًا، سيعمل الخياران جمع واختبار على جميع ملفات العبارات .json في هذا المجلد.

يمكنك فتح علامات تبويب متعدّدة للملف نفسه أو ملفات مختلفة، مثلاً lights وlights(1) وplug.

يعرض شريط الحالة نتيجة آخر اختبار (إن أمكن)، ونقطة صفراء أو خضراء للإشارة إلى ما إذا تم جمع الملف، ومسار ملف العبارة .json. بعد النقر على tocجمع، يشغّل Assistant Simulator طلبات البحث. سيتم إعلامك عند جمع رد جديد، ويعرض شريط الحالة عدّادًا أثناء معالجة طلبات البحث.

عند اكتمال الجمع ، يتم تعديل شريط الحالة بعلامة صح خضراء أمام مسار .json، ويتم ملء ملفات العبارات بالردود المحتمَلة.

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

إذا أوقفت عملية الجمع مبكرًا، لن يتم وضع علامة "تم الجمع" على مسار .json.

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

بعد جمع الردود، انقر على switch_left اختبار لإعادة تشغيل طلبات البحث والتحقّق من الردود والسجلّات. عند اختبار العبارات المجمّعة، يتوقّع Assistant Simulator الردود المحفوظة في ملف JSON. إذا عرض الاختبار ردًا لم يتم جمعه، ستتلقّى إشعارًا مشابهًا للرد التالي:

error Expected one of: "Got it, turning on 2 lights."

يشير هذا السيناريو إلى اختبار غير ناجح. بخلاف ذلك، سيشغّل Assistant Simulator كل طلب من طلبات البحث ويعرض ردًا. تظهر علامة صح check check في الـ Status Bar إذا كان الاختبار ناجحًا.

عرض Cloud Logging

لفتح علامة تبويب مشروع في نافذة أداة "سجلّات السحابة الإلكترونية"، انقر على سجلّات السحابة الإلكترونية من لوحة Google Home Plugin. يمكنك فتح علامات تبويب منفصلة لسجلّات السحابة الإلكترونية لكل مشروع من مشاريعك.

عبارات طلب البحث

بالنسبة إلى المشروع الذي اخترته، يمكنك أيضًا فلترة السجلّات باستخدام حقل طلب البحث. على سبيل المثال، لفلترة السجلّات لكلمة رئيسية هي light:

انقر على استخدام لغة طلبات البحث لاستخدام لغة طلبات البحث في Logging.

في ما يلي بعض الأمثلة على طلبات البحث بلغة طلبات البحث لمساعدتك على البدء:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

طلبات البحث عن التاريخ والوقت

إنّ طلب البحث عن السجلّات حسب التاريخ اختياري أيضًا، ويمكن تفعيله بالنقر على بعد وقبل. يمكنك كتابة تنسيق التاريخ والوقت في حقل النص المقدَّم، مثلاً 5/11/22, 12:37 PM، أو يمكنك استخدام أداة اختيار التاريخ calendar_month لاختيار التاريخ، ثم إدخال الوقت في حقل النص.

• لاختيار تاريخ بعد 5/1/22، انقر على بعد ، ثم على رمز التاريخ calendar_month.
• لاختيار تاريخ قبل 5/1/22، انقر على قبل ، ثم على رمز التاريخ calendar_month.
• لاختيار تاريخ بين 5/1/22 و6/30/22، انقر على قبل و بعد ، ثم اختَر التواريخ من رمز التاريخ calendar_month.

انقر على في الوقت الفعلي لجلب سجلّات المشروع المباشرة. انقر على إيقاف لإنهاء خلاصة في الوقت الفعلي.

مستوى الخطورة

يمكنك أيضًا اختيار الحد الأدنى لمستوى الخطورة من القائمة المنسدلة.

نتائج طلب البحث

انقر على cached جلب لإرسال مَعلمات طلب البحث.

بعد تحميل السجلّات، انقر على أي سجلّ chevron_right لتوسيع حمولة JSON الكاملة. انقر مرة أخرى على chevron_left لعرض الرسالة الكاملة.

يمكنك اختياريًا كتابة كلمة رئيسية في مربّع الفلتر لتضييق نطاق نتائج السجلّات. انقر على x لإزالة الفلتر والرجوع إلى نتائج الجلب الأصلية.

عرض Home Graph وتشغيل الاختبارات

لسرد أجهزتك، انقر على Home Graph من Google Home Plugin اللوحة.

انقر على cached إعادة التحميل لعرض اسم الجهاز ورقم تعريف الجهاز ونوع الجهاز لأجهزتك المرتبطة بالمشروع الذي اخترته. يمكنك فتح لوحات متعدّدة Google Home Graph لمشاريع منفصلة.

بعد تحميل الأجهزة، انقر على أي سجلّ chevron_right لتوسيع حمولة JSON الكاملة.

يمكنك أيضًا استخدام توسيع وتصغير لعرض حمولات JSON لأجهزتك وإخفائها.

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

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

عارض سجلّات Android Debug Bridge ‏ (adb)

لفتح علامة تبويب مشروع في نافذة أداة "سجلّات adb"، انقر على الأمر سجلّات adb في شريط أدوات إضافة Google Home (على اليمين). يمكنك فتح علامات تبويب منفصلة لسجلّات adb لكل ملف من ملفات السجلّات. لحذف علامة تبويب، انقر على الـ clear أيقونة.

استخدِم حقل اختيار لاختيار مكوّن تسجيل معيّن لعرضه، والقائمة المنسدلة الخطورة لعرض الإدخالات التي تتضمّن مستوى خطورة السجلّ المطابق فقط.

بالنسبة إلى سجلّ adb الذي اخترته، يمكنك فلترة إدخالات السجلّ باستخدام حقل الفلتر مع المعدِّلات الاختيارية مراعاة حالة الأحرف أو تعبير عادي.

بالإضافة إلى ذلك، يمكنك إجراء ما يلي:

• العثور على إدخالات معيّنة باستخدام حقل بحث والأمرين البحث عن التالي (arrow_downward رمز) والبحث عن السابق (arrow_upward رمز).
• استخدام المعدِّلات الاختيارية مراعاة حالة الأحرف أو تعبير عادي.
• الانتقال إلى السطر للانتقال إلى سطر محدّد (حسب الرقم) في السجلّ.

انقر على مرقَّم لعرض أسطر السجلّ مع إضافة أرقام الأسطر. انقر على أولي لعرض إدخالات السجلّ الأولية.

المراجع والملاحظات

انقر على المراجع للحصول على قائمة بأدوات ومراجع المطوّرين.

لإرسال أفكارك أو ملاحظاتك حول كيفية تحسين تجربة التطوير باستخدام Google Home Plugin، انقر على ملاحظات.