عیب‌یابی مشکلات

هنگام توسعه «کنش‌های برنامه»، ممکن است با مشکلاتی در راه‌اندازی یا با ابزار آزمایش «کنش‌های برنامه» مواجه شوید. این صفحه برخی‌از مشکلات رایج و راه‌حل‌های آن‌ها را شرح می‌دهد.

عمومی

خطا: «برنامه‌ای برای باز کردن نشانی وب پیدا نشد» در اعلان موقت ظاهر می‌شود

urlTemplate برآورده‌سازی‌تان را در actions.xml بررسی کنید تا مطمئن شوید درست پیکربندی شده است. اگر از نشانی‌های وب App Links استفاده می‌کنید، مطمئن شوید که می‌توانید نشانی وب خود را به‌صورت دستی بااستفاده از ACTION_VIEW و نشانی وب راه‌اندازی کنید. اگر از نشانی‌های وب مبتنی بر هدف استفاده می‌کنید، مطمئن شوید «فعالیت» شما به‌درستی پیکربندی شده باشد تا بااستفاده از پارامترهای ارائه‌شده شروع شود.

خطا: «برنامه نصب نشده است»

این خطا ممکن است به این معنی باشد که <intent-filter> در فایل AndroidManifest.xml شما پیوند عمیقی را که در actions.xml مشخص کرده‌اید فیلتر نمی‌کند. حتماً قبل‌از ثبت اشکال، این مورد را بررسی کنید.

خطای: «مرجع مجموعه نهادی پیدا شد که شناسه مجموعه نهاد و فیلتر نشانی وب ندارد.» در Android Studio ظاهر می‌شود

این وضعیت به‌دلیل مشکل شناخته‌شده خطایاب نحوی برای برچسب <entity-set-reference> ایجاد شده است. می‌توانید با اطمینان این پیام را نادیده بگیرید. به‌عنوان راه‌حل، می‌توانید با افزودن مشخصه tools:ignore="ValidActionsXml" به این برچسب، بررسی lint را برای آن غیرفعال کنید.

در اینجا نمونه‌ای از مرجع مجموعه نهاد با بررسی lint غیرفعال آورده شده است:

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

خطا: «مکان نامعتبر» برای سند طرح‌واره کنش‌ها هنگام بارگذاری APK

اگر از ابزار بهینه‌سازی یا مبهم‌سازی استفاده کنید که بر منابع APK نسخه پخش شما تأثیر بگذارد، ممکن است بارگذاری APK شما ناموفق باشد. ابزارهایی مثل ProGuard که از فایل‌های منبع اجتناب می‌کنند باعث این مشکل نمی‌شوند.

برای حل این مشکل، ابزار را برای فایل actions.xml برنامه‌تان غیرفعال کنید (برای مثال، بااستفاده از فهرست مجاز).

خطا: «یکی از فایل‌های APK یا «دسته‌های برنامه Android» فعال حاوی فایل actions.xml است. برای ادامه، «شرایط خدمات Actions on Google» را بپذیرید.» در «کنسول Google Play» ظاهر می‌شود

ممکن است این خطا را هنگام ایجاد انتشار برنامه در «کنسول Play» ببینید. برای پذیرفتن «شرایط خدمات Actions on Google»، این مراحل را دنبال کنید:

  1. برنامه‌تان را در «کنسول Play» انتخاب کنید.
  2. به راه‌اندازی > تنظیمات پیشرفته بروید.
  3. روی برگه Actions on Google کلیک کنید.
  4. چارگوش با برچسب ادغام سرویس‌هایم با «کنش‌های برنامه» بااستفاده از Actions on Google را علامت بزنید و دستورالعمل‌ها را دنبال کنید.

دکمه «پذیرفتن» در فرم «شرایط خدمات Play» غیرفعال است.

این ممکن است به این معنی باشد که کاربر واردشده به سیستم سطح دسترسی لازم را برای پذیرش آن شرایط ندارد. مطمئن شوید اولین ارسال توسط سرپرست نمایه «کنسول Play» انجام شده باشد.

ابزار آزمایش «کنش‌های برنامه»

قبل‌از امتحان کردن هرکدام از راه‌حل‌های زیر، نسخه نصب‌شده ابزار آزمایش «کارهای برنامه» را به جدیدترین نسخه به‌روز کنید.

افزونه ابزار آزمایش «کنش‌های برنامه» نمی‌تواند فایل actions.xml من را پیدا کند.

مطمئن شوید برچسب <meta-data> صحیح را در فایل AndroidManifest.xml خود اضافه کرده‌اید.

پیش‌نمایش «کنش برنامه» من با فایل actions.xml فعلی من مطابقت ندارد.

پیش‌نمایش شما به‌طور پویا با محتوای فایل actions.xml شما به‌روز نمی‌شود. پس‌از تغییر دادن دستی فایل actions.xml یا پس‌از عوض کردن تنوع‌های ساخت در Android Studio، فایل actions.xml را ذخیره کنید و روی به‌روزرسانی پیش‌نمایش در ابزار آزمایش کلیک کنید.

افزونه ابزار آزمایشی «کنش‌های برنامه» ازکار افتاده است یا خطا ایجاد می‌کند.

ابتدا مطمئن شوید Android Studio را به جدیدترین نسخه به‌روز کرده‌اید. اگر خطای ۴۰۳ دریافت می‌کنید، ممکن است افزونه را روی بسته‌ای اجرا می‌کنید که اجازه اجرا روی آن را ندارید.

اگر خطا همچنان برطرف نشد، لطفاً اشکالی را ثبت کنید و جزئیات زیر را به Google ارسال کنید:

  • جزئیات کادر گفتگوی خطا
  • گزارش‌های «استودیو Android». به راهنما > نمایش گزارش در Finder بروید. این گزینه مکان idea.log را در «یابنده» به شما نشان می‌دهد. در فایل گزارش، «ارسال کنش‌ها بدنه درخواست:» را جستجو کنید و پاسخ‌های سرور را جای‌گذاری کنید (باید دو نتیجه برای کنش‌ها وجود داشته باشد).

ابزار آزمایشی «کنش‌های برنامه» خطای UnknownHostException یا خطاهای شبکه دیگری ایجاد می‌کند

ابزار آزمایشی «کنش‌های برنامه» پیش‌نمایشی از «کنش‌های برنامه» شما ایجاد می‌کند و به شما امکان می‌دهد ادغام‌های «دستیار Google» را با یک «حساب Google» آزمایش کنید. برای ایجاد این پیش‌نمایش‌ها، ابزار آزمایش به اتصال اینترنت فعال و درصورت لزوم، دسترسی پراکسی به دامنه‌های Google نیاز دارد.

برای حل مشکلات شبکه هنگام اجرای ابزار آزمایش، این مشکلات رایج را بررسی کنید:

  • قبل‌از تولید پیش‌نمایش، مطمئن شوید اتصال اینترنت فعالی داشته باشید.
  • اگر اتصال اینترنت شما فعال است و شبکه محلی شما از یک سرور پروکسی استفاده می‌کند، موارد زیر را بررسی کنید:

    • پیکربندی پراکسی IDE را درستی‌سنجی کنید. برای اطلاعات بیشتر، دستورالعمل‌های پیکربندی پراکسی را برای Android Studio یا IntelliJ ببینید.
    • اگر پراکسی شما به فهرست کنترل دسترسی (ACL) نیاز دارد، ACL را به‌روز کنید تا این الگوی نشانی وب مجاز شود: https://actions.googleapis.com/**.

وقتی «کنش برنامه» را با افزونه آزمایشی فراخوانی می‌کنم، «دستیار» می‌گوید: «متأسفم، نتوانستم آن را پیدا کنم».

بسته به تنظیمات شما، این پاسخ ممکن است به دلایل مختلفی ظاهر شود. مراحل زیر را امتحان کنید:

  1. با «حساب Google» یکسان به سیستم Android Studio، «کنسول Play»، و دستگاه آزمایشی‌تان وارد شوید.
  2. همگام‌سازی داده‌های دستگاه را فعال کنید.
  3. زبان دستگاه و «دستیار Google» را روی en-US تنظیم کنید.
  4. بررسی کنید که نام بسته برنامه در «کنسول Google Play» با نام بسته در برنامه آزمایشی مطابقت داشته باشد.
  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» مطابقت داشته باشد. توجه داشته باشید که ویژگی‌های اختیاری applicationIdSuffix می‌تواند applicationId نهایی ساخت‌ها را برای برخی‌از نسخه‌های ویژه محصول و تنوع‌های ساخت تغییر دهد. در این مثال، applicationId برای نسخه ویژه محصول ساختگی com.example.android.architecture.blueprints.master.mock است، به‌جای com.example.android.architecture.blueprints.
  14. پیش‌نمایشتان را برای استفاده از نام فراخوانی منحصربه‌فرد پیکربندی کنید. سعی کنید از کلمه منحصربه‌فردی استفاده کنید که احتمال تداخل با برنامه‌های دیگر را کاهش دهد.
  15. برای جداسازی مشکلات هنگام عیب‌یابی پایگاه کد هم‌رسانی‌پذیر، برنامه تناسب اندام نمونه «کنش‌های برنامه» را اجرا کنید. مطمئن شوید که برنامه «تناسب اندام» به‌طور کامل کار می‌کند. سپس به‌تدریج ویژگی‌های بیشتری را به این برنامه اضافه کنید تا ببینید آیا می‌توانید مشکلات را تکرار کنید.
  16. اگر از حساب‌های G Suite استفاده می‌کنید، مطمئن شوید «دستیار Google» توسط سرپرست روشن شده باشد. توصیه می‌کنیم به‌عنوان راه‌حل موقت، حساب آزمایشی غیر G Suite ایجاد کنید و آن را به‌عنوان آزمایش‌کننده دارای پروانه ازطریق «فروشگاه Play» راه‌اندازی کنید. آزمایش‌کنندگان باید بتوانند از آن حساب برای برنامه‌شان پیش‌نمایش ایجاد کنند و بااستفاده از آن حساب در دستگاهشان با موفقیت آزمایش کنند.
  17. اگر «دستیار Google» را به‌عنوان برنامه‌ای جداگانه بارگیری کرده‌اید، آن را در دستگاهتان به‌اجبار متوقف کنید. معمولاً می‌توانید ازطریق برنامه «تنظیمات» تلفن، برنامه‌ای را به‌اجبار متوقف کنید.
  18. اگر هیچ‌کدام از این مراحل کار نکرد، مشکلی را در ردیاب مشکل «کنش برنامه» مطرح کنید.