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

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

بنود عامة

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

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

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

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

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

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

في ما يلي مثال على مرجع مجموعة كيانات تم إيقاف فحص الأخطاء فيه:

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

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

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

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

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

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

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

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

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

أداة اختبار "إجراءات التطبيقات"

قبل محاولة إجراء أي من الإصلاحات التالية، عليك تحديث تثبيت أداة اختبار "إجراءات التطبيق" إلى أحدث إصدار.

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

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

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

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

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

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

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

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

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

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

لحلّ مشاكل الشبكة عند تشغيل أداة الاختبار، يُرجى التحقّق من هذه المشاكل الشائعة:

• تأكَّد من أنّ لديك اتصال بالإنترنت نشط قبل إنشاء المعاينات.

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

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

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

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

1. سجِّل الدخول إلى Android Studio و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. لعزل المشاكل عند تحديد مشاكل قاعدة رموز برمجية قابلة للمشاركة وحلّها، جرِّب تشغيل نموذج تطبيق اللياقة البدنية المتوافق مع "إجراءات التطبيقات". تأكَّد من أنّ تطبيق اللياقة البدنية يعمل بشكل كامل. ثم أضِف ميزات إضافية تدريجيًا إلى هذا التطبيق لمعرفة ما إذا كان بإمكانك تكرار المشاكل.
16. في حال استخدام حسابات G Suite، تأكَّد من أنّ المشرف قد فعّل "مساعد Google". ننصحك بإنشاء حساب تجريبي غير تابع لـ G Suite كحل بديل وإعداده كـ مختبِر مرخَّص من خلال "متجر Google Play". ومن خلال هذا الحساب، من المفترض أن يتمكّن المختبِرون من إنشاء نُسخ حصرية من تطبيقاتهم وإجراء الاختبارات باستخدام هذا الحساب على أجهزتهم بنجاح.
17. إذا نزّلت "مساعد Google" كتطبيق منفصل، حاوِل فرض إيقافه على جهازك. يمكنك عادةً فرض إيقاف تطبيق من خلال "الإعدادات" على هاتفك.
18. إذا لم تنجح أي من هذه الخطوات، يمكنك الإبلاغ عن المشكلة في أداة تتبُّع مشاكل "إجراءات التطبيق".