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

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

ژنرال

خطا: "هیچ برنامه ای برای باز کردن URL یافت نشد" در اعلان نان تست ظاهر می شود

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

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

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

خطا: "یک مرجع مجموعه موجودی که حاوی شناسه مجموعه نهاد یا فیلتر URL نیست، یافت نشد." در Android Studio ظاهر می شود

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

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

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

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

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

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

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

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

  1. برنامه خود را در Play Console انتخاب کنید.
  2. به Setup > Advanced Settings بروید.
  3. روی تب Actions on Google کلیک کنید.
  4. کادر با عنوان ادغام خدمات من با اقدامات برنامه با استفاده از اقدامات در Google را علامت بزنید و دستورالعمل ها را دنبال کنید.

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

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

ابزار تست App Actions

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

افزونه ابزار تست App Actions نمی تواند فایل actions.xml من را پیدا کند.

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

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

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

افزونه ابزار تست App Actions کار نمی کند یا در حال ایجاد خطا است.

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

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

  • جزئیات گفتگوی خطا
  • گزارش‌های Android Studio. به Help > Show Log in Finder بروید. این مکان idea.log را در Finder به شما نشان می دهد. "Submit Actions Request Body:" را در فایل گزارش جستجو کنید و پاسخ های سرور را جایگذاری کنید (برای اقدامات باید دو نتیجه وجود داشته باشد).

ابزار تست App Actions UnknownHostException یا سایر خطاهای شبکه را ایجاد می کند

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

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

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

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

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

هنگام فراخوانی App Action با افزونه آزمایشی، دستیار می گوید: "متأسفم، نتوانستم آن را پیدا کنم."

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

  1. با همان حساب Google وارد Android Studio، کنسول Play و دستگاه آزمایشی خود شوید.
  2. همگام سازی داده های دستگاه را فعال کنید.
  3. دستگاه و زبان دستیار Google را روی en-US تنظیم کنید.
  4. بررسی کنید که نام بسته برنامه در کنسول Google Play با نام بسته در برنامه آزمایشی مطابقت داشته باشد.
  5. در تعریف تکمیل urlTemplate در فایل actions.xml ، مطمئن شوید که مقادیر android:host و android:scheme با آنچه در فایل AndroidManifest اعلام شده مطابقت دارند.
  6. تمام نصب های قبلی برنامه خود را از دستگاه آزمایشی خود حذف کنید و یک ساخت جدید نصب کنید.
  7. پیش نمایش را از ابزار تست App Actions حذف کنید و دوباره یک پیش نمایش جدید ایجاد کنید.
  8. ابزار Logcat را برای خرابی‌های مربوط به انجام دستیار Google بررسی کنید. باید ببینید که یک intent برای برنامه شما راه اندازی شده است.
  9. تنظیم "اطلاعات برنامه برای دستگاه های خود" را برای حساب فعال کنید .
  10. Google Assistant را باز کنید و مطمئن شوید که راه‌اندازی را کامل کرده‌اید. (معمولاً نوار پیشرفت راه اندازی به صورت نوار آبی در پایین صفحه ظاهر می شود، اما ممکن است در برخی موارد متفاوت به نظر برسد.)
  11. هنگام استفاده از Google Assistant برای راه‌اندازی یک App Action، مطمئن شوید که نام فراخوان با پیش‌نمایش ایجاد شده توسط ابزار تست App Actions مطابقت دارد.
  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 Assistant را به‌عنوان یک برنامه جداگانه دانلود کرده‌اید، سعی کنید به اجبار آن را در دستگاه خود متوقف کنید. معمولاً می‌توانید یک برنامه را از طریق برنامه تنظیمات گوشی خود به اجبار متوقف کنید.
  18. اگر هیچ یک از این مراحل کار نکرد، مشکلی را در ردیاب مشکل App Action مطرح کنید.