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

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

آلية العمل

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

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

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

دعم اللغة

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

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

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

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

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

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

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

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

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

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

القيود

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

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

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

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

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

1. سجِّل الدخول إلى Play Console.

2. اتّبِع التعليمات الواردة ضمن إعداد ترخيص التطبيق في هذه المقالة. موضوع مساعدة Play Console

   

   الشكل 1. إضافة مختبِر ترخيص

   ملاحظة: تمنح هذه الخطوة إذن الوصول إلى معاينة القراءة والكتابة في حساب Google.

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

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

ملاحظة: على المختبِرين قبول الدعوة للوصول إلى المعاينة.

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

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

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

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

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

ملاحظة: استخدِم أداة اختبار "مهامّ في التطبيقات" مع تثبيت إصدارات التطبيق على جهازك من "استوديو Android".

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

ملاحظة: إذا لم تكن لديك معاينة نشطة، يجب إنشاء واحدة قبل يمكنك استخدام المكوّن الإضافي لاختبار إجراء التطبيق.

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

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

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

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

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

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

تنبيه: لا يتم تلقائيًا إجراء التغييرات التي تجريها على ملف short.xml. نشره إلى المعاينة الحالية. يجب تعديل المعاينة في الاختبار. قبل اختبار التغييرات الجديدة.

ضبط ملف تعريف مستخدم بديل

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

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

على سبيل المثال، actions.intent.GET_FOOD_OBSERVATION BII تدعم معلمة الغرض foodObservation.forMeal. تشير رسالة الأشكال البيانية تحتوي صفحة schema.googleapis.com لـ MealType على name باعتبارها الموقع. السمة forMeal هي وسيلة نقل، وهي تتوقّع قيم (مثل MealTypeLunch) للنوع MealType المحتسب.

في جلسة المعمل، أداة اختبار، يمكنك تقديم أي من التعدادات كقيمة foodObservation.forMeal:

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

تفعيل إجراءات التطبيق

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

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

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

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

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

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

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

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

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

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

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

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

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

الشكل 2. قسم المساعدة في مكوّن "مساعد Google" الإضافي