تحديد المشاكل وحلّها

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

بنود عامة

خطأ: "لم يتم العثور على تطبيق لفتح عنوان URL" يظهر في إشعار إشعار منبثق

تحقّق من طريقة توفّر المركبة urlTemplate في actions.xml للتأكّد من أنّها بشكل صحيح. في حال استخدام عناوين URL لروابط التطبيقات، تأكّد من أنّه يمكنك تشغيل عنوان URL يدويًا باستخدام ACTION_VIEW وعنوان URL. في حال استخدام عناوين URL مستندة إلى الأهداف، تأكَّد من تم ضبط "نشاطك" بشكل صحيح لبدء استخدام المَعلمات المتوفّرة.

خطأ: "التطبيق غير مثبَّت"

قد يعني هذا الخطأ أنّ <intent-filter> في AndroidManifest.xml. لا يفلتر الملف الرابط لصفحة معيّنة الذي حدّدته في actions.xml. احرص على التحقّق من هذا أولاً قبل تقديم تقرير خطأ.

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

تنتج هذه الحالة عن مشكلة معروفة في الارتباط العلامة <entity-set-reference> يمكنك تجاهل هذه الرسالة بأمان. نتيجة لذلك، أُنشئت مكتبة مات بلوت ليب في يمكنك تعطيل فحص Lint لهذه العلامة عن طريق إضافة tools:ignore="ValidActionsXml" إليه.

إليك مثال على مرجع مجموعة كيانات مع فحص أداة Lint غير مفعّل:

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

خطأ: "موقع جغرافي غير صالح" مستند مخطط الإجراءات عند تحميل حزمة APK

قد يتعذّر تحميل حزمة APK في حال استخدام أداة للتشويش أو التحسين يؤثر في موارد حزمة APK للإصدار. وتتضمّن أدوات مثل ProGuard التي من ملفات الموارد هذه المشكلة.

لحل هذه المشكلة، جرِّب إيقاف الأداة actions.xml في تطبيقك. (على سبيل المثال، باستخدام قائمة مسموح بها).

خطأ: "يحتوي ملف APK نشِط أو مجموعة حزمات تطبيق Android نشِطة على ملف actions.xml. للمتابعة، يجب الموافقة على بنود خدمة "المهام مع مساعد Google". تظهر في Google Play Console

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

1. اختَر تطبيقك في Play Console.
2. الانتقال إلى الإعداد > الإعدادات المتقدمة
3. انقر على علامة التبويب الإجراءات على Google.
4. حدِّد المربع المسمّى دمج خدماتي مع خدمة "مهامّ في التطبيقات" باستخدام "المهام مع مساعد Google". على Google واتّبِع التعليمات.

"قبول" زر الإيقاف/التفعيل في نموذج بنود خدمة Play.

قد يعني ذلك أنّ المستخدم الذي سجّل الدخول لا يملك إذن الوصول المطلوب. المستوى لقبول هذه البنود. تأكَّد من إتمام عملية الإرسال الأولى بواسطة مشرف الملف الشخصي على Play Console.

أداة اختبار "مهامّ في التطبيقات"

قبل محاولة تنفيذ أي من الإصلاحات التالية، يُرجى تحديث عملية تثبيت أداة اختبار "مهامّ في التطبيقات" إلى أحدث إصدار

يتعذّر على المكوّن الإضافي لأداة اختبار "مهامّ في التطبيقات" تحديد موقع ملف actions.xml الخاص بي.

تأكَّد من أنّك أضفت علامة <meta-data> الصحيحة في ملف AndroidManifest.xml.

لا تتطابق معاينة الإجراء في التطبيق مع ملف actions.xml الحالي.

لا يتم تحديث المعاينة بشكل ديناميكي من خلال محتوى ملف actions.xml. بعد تغيير ملف actions.xml يدويًا أو بعد التبديل بين نُسخ الإصدارات في "استوديو Android" وحفظ ملف actions.xml انقر على معاينة التحديث في أداة الاختبار.

توقف المكوّن الإضافي لأداة اختبار "مهامّ في التطبيقات" عن العمل أو يحدث أخطاء.

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

إذا استمرّ ظهور الخطأ، يُرجى الإبلاغ عن الخطأ وإرسال ما يلي. التفاصيل إلى Google:

• تفاصيل مربّع حوار الخطأ
• سجلات "استوديو Android" انتقل إلى مساعدة > عرض تسجيل الدخول الباحث. هذا يظهر لك موقع idea.log في Finder (الباحث). البحث عن "إرسال إجراءات نص الطلب:" في ملف السجل، وألصق استجابات الخادم (هناك يجب أن يكونا نتيجتين للإجراءات).

تنشئ أداة اختبار "الإجراءات في التطبيق" أخطاء UnknownHostException أو أخطاء أخرى في الشبكة.

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

لحلّ مشاكل الشبكة عند تشغيل أداة الاختبار، تحقّق من الأسباب التالية المشكلات:

• يُرجى التأكّد من توفّر اتصال نشط بالإنترنت قبل إنشاء المعاينات.

• إذا كان اتصالك بالإنترنت نشطًا، وكانت شبكتك المحلية تستخدم خادمًا وكيلاً، تحقق مما يلي:

  • تحقَّق من إعدادات الخادم الوكيل لـ IDE. لمزيد من المعلومات، انظر الخادم الوكيل تعليمات الضبط لبرنامج Android Studio أو IntelliJ.
  • إذا كان الوكيل يتطلب قائمة التحكم بالوصول (ACL)، حدّث ACL إلى السماح بنمط عنوان URL هذا: https://actions.googleapis.com/**.

عند استدعاء إجراء التطبيق باستخدام المكوّن الإضافي للاختبار، يقول "مساعد Google": "عذرًا، لم أتمكن من العثور على ذلك".

استنادًا إلى إعداداتك، قد تظهر هذه الاستجابة لأسباب مختلفة. تجربة الخطوات التالية:

1. تسجيل الدخول إلى "استوديو Android" وPlay Console جهاز اختباري باستخدام حساب Google نفسه
2. فعِّل مزامنة بيانات الجهاز.
3. يجب ضبط الجهاز ولغة "مساعد Google" على en-US.
4. تحقق من أن اسم حزمة التطبيق في الملف تتطابق أداة Google Play Console مع اسم الحزمة في التطبيق التجريبي.
5. في تعريف التنفيذ urlTemplateفي ملف actions.xml، تأكَّد من تطابق قيمتَي android:host وandroid:scheme مع تعريفه في ملف AndroidManifest.
6. يجب إزالة جميع عمليات التثبيت السابقة لتطبيقك من الجهاز الاختباري تثبيت إصدار جديد.
7. يمكنك حذف المعاينة من أداة اختبار "مهامّ في التطبيقات" وإنشاء معاينة جديدة مرة أخرى.
8. التحقّق في أداة Logcat من المشاكل المتعلّقة بالتنفيذ لـ "مساعد Google" من المفترض أن تلاحظ هدفًا تم إطلاقه في تطبيقك.
9. تفعيل خيار "معلومات التطبيقات لأجهزتك" الإعداد للحساب.
10. افتح تطبيق "مساعد Google" وتأكَّد من إكمال عملية الإعداد. (عادة ما يكون الإعداد يظهر كشريط أزرق في أسفل الشاشة، ولكن قد تبدو مختلفة في بعض الحالات).
11. عند استخدام "مساعد Google" لتشغيل إجراء في التطبيق، تأكَّد من يتطابق اسم الاستدعاء مع المعاينة التي تم إنشاؤها بواسطة أداة اختبار مهام التطبيق.
12. جرِّب استخدام الإدخال النصي بدلاً من الصوت لتجنّب حدوث أي أخطاء في النص.
13. ضبط الإصدار التجريبي بحيث تتطابق السمة applicationId تمامًا مع حزمة APK أو ملف AAB التي تم تحميلها إلى Google Play Console لاحظ أن بإمكان applicationIdSuffix موقع تغيير آخر applicationId من تنشئ نكهات بعض المنتجات وتبني المتغيرات. في هذا المثال، applicationId لنكهة المنتج الوهمية هي com.example.android.architecture.blueprints.master.mock، بدلاً من com.example.android.architecture.blueprints
14. اضبِط المعاينة لاستخدام اسم استدعاء فريد. حاول استخدام تقلل من فرص التصادم مع التطبيقات الأخرى.
15. لعزل المشاكل عند تحديد المشاكل في قاعدة رموز قابلة للمشاركة وحلّها، جرِّب تشغيل نموذج تطبيق App Actions Fitness. تأكد من أن تطبيق اللياقة البدنية يعمل بشكل كامل. ثم أضف تدريجيًا ميزات إضافية في هذا التطبيق لمعرفة ما إذا كان بإمكانك تكرار المشكلات.
16. في حال استخدام حسابات G Suite، تأكّد من تفعيل "مساعد Google" عن طريق المشرف. ننصح بإنشاء حساب تجريبي غير تابع لخدمة G Suite كحل بديل وإعداده على أنّه مختبِرًا مرخَّصًا من خلال "متجر Play" ومن هذا الحساب، من المفترض أن يكون المُختبِرون قادرين على إنشاء معاينات لتطبيقاتهم اختبار استخدام هذا الحساب على أجهزتهم بنجاح.
17. في حال تنزيل "مساعد Google" كتطبيق منفصل، حاوِل فرض إيقافه على جهازك. يمكنك عادةً فرض إيقاف أحد التطبيقات من خلال تطبيق "الإعدادات" على هاتفك.
18. إذا لم تنجح أي من هذه الخطوات، يمكنك تصعيد مشكلة في أداة تتبُّع المشاكل في "إجراءات التطبيقات"