عند تطوير "إجراءات التطبيق"، قد تواجه مشاكل في عملية الإعداد أو في أداة اختبار "إجراءات التطبيق". تصف هذه الصفحة بعض المشاكل الشائعة التي قد تواجهك وطرق حلّها.
بنود عامة
الخطأ: تظهر الرسالة "لا يوجد تطبيق لفتح عنوان 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"، اتّبِع الخطوات التالية:
- اختَر تطبيقك في Play Console.
- انتقِل إلى الإعداد > الإعدادات المتقدّمة.
- انقر على علامة التبويب Actions on Google.
- ضَع علامة في المربّع بجانب دمج خدماتي مع "مهام التطبيقات" باستخدام "المهام مع مساعد Google"، واتّبِع التعليمات.
تم إيقاف الزر "قبول" في نموذج "بنود خدمة Play".
قد يعني ذلك أنّ المستخدم الذي سجّل الدخول ليس لديه مستوى الوصول المطلوب لقبول هذه البنود. تأكَّد من أنّ المشرف على ملف Play Console هو من يرسل الطلب للمرة الأولى.
أداة اختبار "مهامّ في التطبيقات"
قبل تجربة أي من الحلول التالية، عليك تحديث إصدار "أداة اختبار إجراءات التطبيق" إلى أحدث إصدار.
لا يمكن للمكوّن الإضافي لأداة اختبار "إجراءات التطبيق" تحديد موقع ملف actions.xml.
تأكَّد من إضافة علامة <meta-data> الصحيحة في ملف AndroidManifest.xml.
لا تتطابق معاينة "إجراء التطبيق" مع ملف actions.xml الحالي.
لا يتم تعديل المعاينة تلقائيًا بشكل ديناميكي مع محتوى ملف actions.xml. بعد تغيير ملف actions.xml يدويًا أو بعد تبديل صيغ الإنشاء في "استوديو Android"، احفظ ملف actions.xml وانقر على تعديل المعاينة في أداة الاختبار.
توقّف مكوّن "أداة اختبار إجراءات التطبيقات" الإضافي عن العمل أو يعرض أخطاء.
أولاً، تأكَّد من تحديث Android Studio إلى أحدث إصدار. إذا ظهر لك الخطأ 403، قد يكون السبب أنّك تشغّل المكوّن الإضافي على حزمة لا تملك أذونات تشغيلها.
إذا استمرّ الخطأ في الظهور، يُرجى إبلاغ Google عنه وإرسال التفاصيل التالية:
- تفاصيل مربّع حوار الخطأ
- سجلات "استوديو Android" انتقِل إلى مساعدة > عرض السجلّ في Finder. يعرض هذا الخيار موقع
idea.logفي Finder. ابحث عن "Submit Actions Request Body:" في ملف السجلّ، والصِق ردود الخادم (يجب أن تظهر نتيجتان للإجراءات).
تُنشئ أداة اختبار "إجراءات التطبيق" UnknownHostException أو أخطاء أخرى في الشبكة.
تتيح لك أداة اختبار "إجراءات التطبيقات" إنشاء معاينة لهذه الإجراءات، ما يتيح لك اختبار عمليات الدمج مع "مساعد Google" باستخدام حساب Google واحد. لإنشاء هذه المعاينات، تتطلّب أداة الاختبار اتصالاً نشطًا بالإنترنت، وإذنًا بالوصول إلى خادم وكيل لنطاقات Google إذا لزم الأمر.
لحلّ مشاكل الشبكة عند تشغيل أداة الاختبار، تحقَّق من المشاكل الشائعة التالية:
- تأكَّد من توفّر اتصال نشط بالإنترنت قبل إنشاء معاينات.
إذا كان اتصالك بالإنترنت نشطًا وكانت شبكتك المحلية تستخدم خادمًا وكيلاً، تحقَّق مما يلي:
- تأكَّد من إعدادات خادم وكيل بيئة التطوير المتكاملة. لمزيد من المعلومات، راجِع تعليمات إعداد الخادم الوكيل في استوديو Android أو IntelliJ.
- إذا كان الخادم الوكيل يتطلّب قائمة تحكّم بالوصول (ACL)، عدِّل قائمة ACL للسماح بنمط عنوان URL هذا:
https://actions.googleapis.com/**.
عند استدعاء "إجراء التطبيق" باستخدام المكوّن الإضافي للاختبار، يقول "مساعد Google": "عذرًا، لم أعثر على ذلك".
قد يظهر هذا الرد لأسباب مختلفة حسب إعداداتك. يُرجى تجربة الخطوات التالية:
- سجِّل الدخول إلى Android Studio وPlay Console وجهاز الاختبار باستخدام حساب Google نفسه.
- فعِّل مزامنة بيانات الجهاز.
- اضبط لغة الجهاز و"مساعد Google" على
en-US. - تأكَّد من أنّ اسم حزمة التطبيق في Google Play Console يتطابق مع اسم الحزمة في تطبيق الاختبار.
- في
urlTemplateتعريف التنفيذ في ملفactions.xml، تأكَّد من أنّ قيمتَيandroid:hostوandroid:schemeتتطابقان مع ما تم تحديده في ملفAndroidManifest. - أزِل جميع عمليات التثبيت السابقة لتطبيقك من جهاز الاختبار، ثم ثبِّت إصدارًا جديدًا.
- احذف المعاينة من أداة اختبار "إجراءات التطبيقات" وأنشئ معاينة جديدة مرة أخرى.
- تحقَّق من أداة Logcat بحثًا عن حالات تعذُّر مرتبطة بتنفيذ الطلبات في "مساعد Google". من المفترض أن ترى هدفًا تم إطلاقه في تطبيقك.
- فعِّل إعداد "معلومات التطبيق من أجهزتك" للحساب.
- افتح "مساعد Google" وتأكَّد من إكمال عملية الإعداد. (يظهر شريط مدى التقدّم في عملية الإعداد عادةً كشريط أزرق في أسفل الشاشة، ولكن قد يختلف شكله في بعض الحالات).
- عند استخدام "مساعد Google" لتفعيل "إجراء تطبيق"، تأكَّد من أنّ اسم التفعيل يطابق المعاينة التي أنشأتها "أداة اختبار إجراءات التطبيقات".
- جرِّب استخدام ميزة إدخال النص بدلاً من الصوت لتجنُّب أي أخطاء في تحويل الصوت إلى نص.
- اضبط إعدادات الإصدار التجريبي بحيث يتطابق
applicationIdتمامًا مع حزمة APK أو AAB التي تم تحميلها إلى Google Play Console. يُرجى العِلم أنّ خصائصapplicationIdSuffixالاختيارية يمكن أن تغيّرapplicationIdالنهائي لعمليات الإنشاء الخاصة ببعض أنواع المنتجات وخيارات الإنشاء. في هذا المثال، قيمةapplicationIdلنكهة المنتج التجريبي هيcom.example.android.architecture.blueprints.master.mockبدلاً منcom.example.android.architecture.blueprints. - اضبط المعاينة لاستخدام اسم استدعاء فريد. جرِّب استخدام كلمة فريدة تقلّل من فرص حدوث تعارض مع التطبيقات الأخرى.
- لتحديد المشاكل عند تحديد وحلّ المشاكل في قاعدة الرموز البرمجية القابلة للمشاركة، حاوِل تشغيل تطبيق اللياقة البدنية النموذجي الذي يستخدم ميزة "إجراءات التطبيقات". تأكَّد من أنّ تطبيق اللياقة البدنية يعمل بشكل كامل. بعد ذلك، أضِف ميزات إضافية بشكل تدريجي إلى هذا التطبيق لمعرفة ما إذا كان بإمكانك تكرار المشاكل.
- في حال استخدام حسابات G Suite، تأكَّد من أنّ المشرف قد فعّل "مساعد Google". ننصحك بإنشاء حساب تجريبي غير تابع لـ G Suite كحل بديل وإعداده كمختبِر مرخَّص من خلال "متجر Play". ومن خلال هذا الحساب، يجب أن يتمكّن المختبِرون من إنشاء معاينات لتطبيقاتهم واختبارها بنجاح على أجهزتهم.
- إذا نزّلت "مساعد Google" كتطبيق منفصل، حاوِل إيقافه بالقوة على جهازك. يمكنك عادةً فرض إيقاف أحد التطبيقات من خلال تطبيق "الإعدادات" على هاتفك.
- إذا لم تنجح أي من هذه الخطوات، يمكنك الإبلاغ عن مشكلة في أداة تتبُّع المشاكل في "إجراءات التطبيقات".