مكوّن "مساعد Google" الإضافي في "استوديو Android"

يختبر مكوّن "مساعد Google" الإضافي "إجراءات التطبيقات" في "استوديو Android". أثناء التطوير والاختبار، يمكنك استخدام المكوّن الإضافي لإنشاء معاينة لإجراءات التطبيقات في "مساعد Google" لحسابك على Google. ويمكنك بعد ذلك اختبار كيفية تعامل "إجراء التطبيق" مع معلَمات مختلفة قبل إرساله للنشر.

طريقة العمل

يتضمّن المكوّن الإضافي لـ "مساعد Google" "أداة اختبار إجراءات التطبيقات"، وهي ميزة تحلّل ملف اختصارات.xml وتنشئ معاينة لمهام التطبيقات لحساب Google واحد. تمكِّن هذه المعاينات "مساعد Google" من التعرّف على إجراءات التطبيق قبل نشر إصدار الإنتاج من تطبيقك على Google Play Console.

لكل هدف مضمّن في ملف shortcuts.xml، تعرض الأداة كائن JSON-LD مقابلاً وتوفِّر قيم معلَمات تلقائية. يمكنك بعد ذلك تعديل هذه القيم لاختبار إجراءات التطبيق باستخدام مجموعات معلَمات مفيدة والتأكّد من أنّها تؤدي وظائف التطبيق الصحيحة. يتم إنشاء المعاينات وتحديثها وحذفها في أداة الاختبار، ما يتيح لك تكرار إجراءات التطبيق واختبارها في بيئة آمنة.

بعد إنشاء معاينة، يمكنك تشغيل "إجراء في التطبيق" على جهاز الاختبار مباشرةً من نافذة أداة الاختبار. بالنسبة إلى معرّفات BII المتاحة لتشغيل المستخدم، يمكنك استخدام app name مباشرةً في "مساعد Google" على جهازك لتجربة "مهمة التطبيق". على سبيل المثال، يمكنك قول، "Ok Google، أريد بدء التمرين باستخدام تطبيق المثال" لتشغيل "مهمة في التطبيق" تستخدم نصيحة actions.intent.START_EXERCISE.

دعم اللغة

يختلف إنشاء معاينات للغات محددة في أداة الاختبار حسب BII. توفر صفحة كل كائن BII في مرجع الغرض المضمَّن معلومات عن الوظائف المتاحة لذلك BII، مثل ما إذا كانت أداة الاختبار تتيح إنشاء معاينات للغة معينة، وما إذا كانت إجراءات التطبيق متاحة للمستخدمين لتشغيلها.

الحصول على المكوّن الإضافي

يتوفّر مكوّن "مساعد Google" الإضافي في "استوديو Android". للحصول على معلومات حول تثبيت "استوديو Android" واستخدامه، يمكنك الاطّلاع على صفحة استوديو Android.

لتثبيت مكوّن "مساعد Google" الإضافي في "استوديو Android"، يُرجى اتّباع الخطوات التالية:

  1. انتقل إلى ملف > الإعدادات (استوديو Android > الإعدادات المفضّلة على نظام التشغيل macOS).
  2. في قسم المكوّنات الإضافية، انتقِل إلى السوق وابحث عن "مكوّن مساعد Google الإضافي".
  3. ثبِّت الأداة وأعِد تشغيل Android Studio.

يمكنك أيضًا تنزيل المكوّن الإضافي مباشرةً من مستودع Jetbrains العام.

متطلّبات الإعداد

يتطلب استخدام مكوّن "مساعد Google" الإضافي عددًا من خطوات الإعداد للسماح باختبار "مهمة التطبيق" بنجاح. وعلى وجه التحديد، عليك استخدام حساب المستخدم نفسه في "استوديو Android" وعلى جهاز الاختبار وللدخول إلى "وحدة تحكُّم Google Play".

حضِّر بيئة التطوير باستخدام الإعدادات التالية:

  • سجِّل الدخول إلى "استوديو Android" (الإصدار 4.0 أو إصدار أحدث).
  • باستخدام الحساب نفسه، سجِّل الدخول إلى تطبيق Google على جهاز Android التجريبي.
  • باستخدام الحساب نفسه، يمكنك الوصول إلى Play Console إلى حزمة التطبيق التي تم تحميلها ليتم اختبارها.
  • افتح تطبيق Google على جهاز Android الاختباري وأكمِل عملية إعداد "مساعد Google" الأولية.
  • فعِّل مزامنة بيانات الجهاز على جهاز الاختبار.

القيود

تنطبق القيود التالية على مكوّن "مساعد Google" الإضافي:

  • لا يمكن اختبار إجراءات التطبيق التي تتضمّن مستودع بيانات الويب واستدعاء التطبيقات التي تعمل في المقدّمة مباشرةً في أداة الاختبار أو من خلال الأوامر (adb) لتصحيح أخطاء Android. لاختبار إجراءات التطبيقات هذه، عليك أولاً إنشاء معاينة باستخدام أداة الاختبار. بعد ذلك، يمكنك تشغيل "المهام في التطبيقات" من خلال التفاعل مع "مساعد Google" على جهازك الفعلي.
  • المستودع المضمّن لـ actions.intent.OPEN_APP_FEATURE لا يمكن اختبار BII إلا لمدة ست ساعات بعد إنشاء معاينة أو تعديلها. حدِّث معاينة أداة الاختبار أو أنشئ معاينة جديدة لإعادة تعيين الفترة الزمنية التي تبلغ ست ساعات.

إضافة مختبِرين آخرين

يمكنك دعوة مستخدمين إضافيين إلى مشروعك ليتمكّنوا من اختبار عملية دمج "إجراءات التطبيق". ويكون هذا مفيدًا عندما تريد مشاركة المشروع مع أعضاء آخرين في فريق التطوير لديك حتى يتمكنوا جميعًا من الاختبار، أو عند مشاركة مشروعك مع مختبري ضمان الجودة (QA) استعدادًا لإطلاق الإنتاج. يجب إضافة المختبِرين بصفتهم مختبِرين للترخيص على "متجر Google Play"، ومنحهم إمكانية الوصول للقراءة فقط إلى Google Play Console.

لإضافة مختبِرين آخرين، يُرجى اتّباع الخطوات التالية:

  1. سجِّل الدخول إلى Play Console.
  2. اتّبِع التعليمات الواردة في إعداد ترخيص التطبيق في موضوع مركز مساعدة Play Console.

    إضافة مختبِر ترخيص من خلال Google Play Console
    الشكل 1. إضافة مختبِر ترخيص.
  3. إرسال دعوة إلى حساب مختبِر الترخيص على Google كمستخدم في Google Play Console للقراءة فقط.

    1. اختَر المستخدم والأذونات > دعوة مستخدمين جدد > إضافة تطبيق.
    2. في الوصول إلى التطبيق، تأكّد من إزالة مربع الاختيار المشرف (جميع الأذونات).

عليك تسجيل الدخول بشكل منفصل إلى "استوديو Android" باستخدام حساب Google الخاص بهذا المستخدم، وذلك لكل مختبِر تريد تفعيله لاختبار المعاينة. بعد تسجيل الدخول، يمكنك استخدام مكوّن "مساعد Google" الإضافي من أجل إنشاء معاينة للمستخدم المختبِر.

استخدام مكوّن "مساعد Google" الإضافي

يمكنك الوصول إلى أداة اختبار "إجراءات التطبيقات" في "استوديو Android" من خلال الانتقال إلى الأدوات > مساعد Google > أداة اختبار الإجراءات في التطبيقات. عند فتح الأداة، يتغير العرض بناءً على ما إذا كان لديك معاينة نشطة لأداة الاختبار.

إنشاء المعاينات وتعديلها وحذفها

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

تنشئ أداة الاختبار معاينات استنادًا إلى حسابك على Google واسم حزمة التطبيق (رقم تعريف التطبيق)، لتتمكّن من اختبار تطبيقات متعدّدة باستخدام حساب Google نفسه. وما دام معرّف التطبيق مختلفًا من تطبيق إلى آخر، يمكنك مواصلة استخدام حساب Google نفسه في إنشاء المعاينة والاختبار. يمكن لحسابات Google المتعددة التي يمكنها الوصول إلى حزمة التطبيق نفسها استخدام أداة الاختبار لإنشاء معاينات منفصلة لهذا التطبيق.

لإنشاء معاينة، اتّبِع الخطوات التالية في "استوديو Android":

  1. افتح أداة اختبار إجراءات التطبيقات.
  2. يمكنك اختياريًا إدخال اسم التطبيق واللغة لاختبارها. اسم التطبيق واللغة التلقائيان هما test app action وen.
  3. انقر على إنشاء معاينة. راجِع سياسات وبنود خدمة "المهام في التطبيقات" واقبلها إذا طُلب منك ذلك. بعد إنشاء المعاينة، يتم تعديل نافذة أداة الاختبار لعرض معلومات عن مؤشرات BII التي يمكن العثور عليها في ملف shortcuts.xml.

تستخدم أداة الاختبار اسم التطبيق لإنشاء ومحاكاة طلبات "مساعد Google" الخاصة بإجراءات التطبيقات. تستخدم إجراءات التطبيقات التي تم نشرها اسم تطبيقك من "متجر Play" للاستدعاء، ولكن يمكنك استخدام أي اسم استدعاء في أداة الاختبار. مع ذلك، ننصحك باستخدام اسم تطبيقك كاسم لاستدعاء في أداة الاختبار.

يجب أن تتطابق اللغة التي تقدّمها مع لغة "مساعد Google" على جهاز الاختبار، ويمكنك إنشاء معاينة بلغة واحدة فقط في كل مرة. على سبيل المثال، إذا كانت لغة "مساعد Google" هي الإنجليزية (الولايات المتحدة)، يمكنك إدخال en-US ولكن ليس en-** أو en-GB أو en-US, en-GB. يمكنك استخدام لغة جذر، مثل en، لتضمين كل من en-GB وen-US.

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

لتعديل معاينة حالية لمطابقة ملف shortcuts.xml، انقر على الزر تعديل في أداة الاختبار. يمكنك العثور على معلومات عن المعاينة الحالية في قسم إجراء التطبيق التجريبي من نافذة أداة الاختبار.

تهيئة BII

بعد إنشاء معاينة لتطبيقك، يمكنك اختبار قيم معلَمات مختلفة لمعيار BII في المكوّن الإضافي. لكل كائن BII في ملف shortcuts.xml، يعرض المكوّن الإضافي كائن JSON-LD المقابل ويوفر قيم معلَمات تلقائية. يمكنك تعديل هذه القيم التلقائية لاختبار إجراءات التطبيق باستخدام مجموعات من المَعلمات المفيدة والتأكّد من أنّها تؤدي وظائف التطبيق الصحيحة.

عادةً ما تتبع المَعلمات وقيمها البنية schema.org أو schema.googleapis.com للسمات والأوصاف. يمكنك العثور على معلومات حول أي معلَمة BII من خلال الاطّلاع على أوصاف نوع المخطط للمعلَمة ومعلَماتها ذات المستوى الأعلى.

على سبيل المثال، تتوافق سمة actions.intent.CREATE_MONEY_TRANSFER BII مع مَعلمة الغرض moneyTransfer.transferMode. تدرج صفحة schema.googleapis.com لـ MoneyTransfer transferMode كخاصية. السمة transferMode هي وضع نقل، وتتوقّع قيمًا (مثل SendMoney) من النوع FinancialTransferMode العددي.

في أداة الاختبار، يمكنك تقديم أي من التعداد كقيمة transferMode:

  • http://schema.googleapis.com/SendMoney
  • http://schema.googleapis.com/ReceiveMoney

تشغيل إجراءات التطبيق

بعد إنشاء معاينة وضبط منهج BII، يمكنك تنفيذ إجراء تطبيق على جهاز الاختبار مباشرةً من نافذة أداة الاختبار.

لتشغيل إجراء في التطبيق باستخدام أداة الاختبار، نفِّذ ما يلي:

  1. وصِّل جهاز الاختبار.
  2. في قسم اختيار الجهاز المستهدف، اختَر الجهاز الذي تريد تشغيل "إجراء التطبيق" عليه.
  3. في القسم إجراء اختبار التطبيق، انقر على الزر تشغيل إجراء التطبيق.

إنّ إجراءات التطبيقات التي يتم تشغيلها في أداة الاختبار تستخدم الأمر Android Debug Bridge (adb) المعروض. يتضمّن أمر واجهة أوامر adb الذي تم إنشاؤه جميع البيانات الوصفية التي يطلبها تطبيق Google لتنفيذ كائن BII. ويحاكي هذا الأسلوب سلوك إجراء التطبيق بعد أن يستخرج "مساعد Google" المعلومات الرئيسية من طلب البحث.

التسجيل في "استوديو Android"

تتوفر السجلات الخاصة بأداة الاختبار في ملفات سجلات "استوديو Android"، وليس كمخرجات Logcat. تؤدي العمليات التي تعمل مباشرةً على محطة العمل إلى إنشاء سجلات Android Studio. يمكنك استخدامها لتحديد مشاكل عمليات أدوات الاختبار وحلّها مثل إنشاء معاينة أو تحديثها أو حذفها.

للوصول إلى ملفات سجلات "استوديو Android"، انتقِل إلى مساعدة > عرض مستكشف تسجيل الدخول (المساعدة > إظهار أداة البحث عن معلومات تسجيل الدخول على نظام التشغيل macOS).

تتوفّر السجلّات ذات الصلة بـ "إجراءات التطبيق" لتطبيقك في Logcat. تسجِّل Logcat السجلات من الأجهزة الافتراضية أو الفعلية المتصلة بتطبيق "استوديو Android".

للحصول على سجلات "إجراءات التطبيق" على جهازك، يمكنك اتّباع الخطوات التالية:

  1. يمكنك الوصول إلى رسائل سجلّ Logcat بالنقر على Logcat في شريط نوافذ أداة "استوديو Android".
  2. يمكنك البحث عن السجلّات التي تتضمّن ActivityTaskManager.

الحصول على الدعم والمراجع الإضافية

يوفّر مكوّن "مساعد Google" الإضافي روابط إلى المستندات والدروس التطبيقية حول الترميز ومصادر أخرى للتعلّم والحصول على المساعدة باستخدام أداة الاختبار.

يمكنك فتح المساعد في "استوديو Android" من خلال النقر على الأدوات > مساعد Google > المساعدة.

مساعد أداة اختبار الإجراءات في التطبيقات الشكل 2. قسم المساعدة في مكوّن "مساعد Google" الإضافي