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

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

الإعدادات العامة

خطأ: ظهور رسالة "لم يتم العثور على تطبيق لفتح عنوان 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. للمتابعة، يُرجى قبول بنود خدمة "المهام مع مساعد Google". تظهر في Google Play Console.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تؤدي أداة اختبار إجراءات التطبيقات إلى حدوث UnknownHostException، أو أخطاء أخرى في الشبكة

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

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

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

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

  • تحقَّق من إعدادات خادم وكيل IDE. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على تعليمات ضبط الخادم الوكيل في استوديو Android أو 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. إذا لم تنجح أي من هذه الخطوات، يمكنك طرح المشكلة في أداة تتبُّع مشاكل إجراءات التطبيق.