این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

افزونه Google Assistant برای اندروید استودیو، افزونه Google Assistant برای Android Studio، افزونه Google Assistant برای Android Studio، افزونه Google Assistant برای Android Studio

افزونه Google Assistant Action Actions را در Android Studio آزمایش می کند. در طول توسعه و آزمایش، از این افزونه برای ایجاد پیش نمایشی از App Actions خود در Assistant برای حساب Google خود استفاده می کنید. سپس می‌توانید نحوه عملکرد App Action خود را با پارامترهای مختلف قبل از ارسال آن برای استقرار آزمایش کنید.

چگونه کار می کند

افزونه Google Assistant شامل App Actions Test Tool است، قابلیتی که فایل shortcuts.xml شما را تجزیه می کند و پیش نمایشی از App Actions شما را برای یک حساب Google ایجاد می کند. این پیش‌نمایش‌ها دستیار Google را قادر می‌سازد تا قبل از استقرار نسخه تولیدی برنامه شما در کنسول Google Play، اقدامات برنامه شما را تشخیص دهد.

برای هر هدف داخلی (BII) در فایل shortcuts.xml ، ابزار یک شی JSON-LD مربوطه را ارائه می‌کند و مقادیر پارامترهای پیش‌فرض را ارائه می‌کند. سپس می توانید آن مقادیر را تغییر دهید تا App Actions خود را با ترکیب پارامترهای معنی دار آزمایش کنید و اطمینان حاصل کنید که عملکردهای برنامه صحیح را انجام می دهند. پیش‌نمایش‌ها در ابزار تست ایجاد، به‌روزرسانی و حذف می‌شوند و به شما این امکان را می‌دهند که اقدامات برنامه خود را در یک محیط امن تکرار و آزمایش کنید.

پس از ایجاد پیش‌نمایش، می‌توانید مستقیماً از پنجره ابزار تست، یک App Action را در دستگاه آزمایشی خود راه‌اندازی کنید. برای BIIهایی که برای راه‌اندازی کاربر در دسترس هستند، می‌توانید app name مستقیماً در Assistant در دستگاه خود استفاده کنید تا App Action خود را امتحان کنید. برای مثال، می‌توانید بگویید: «Hey Google، تمرین من را با استفاده از Example App شروع کن» تا یک App Action راه‌اندازی شود که از actions.intent.START_EXERCISE BII استفاده می‌کند.

پشتیبانی محلی

ایجاد پیش نمایش برای مناطق خاص در ابزار تست بر اساس BII متفاوت است. صفحه مربوط به هر BII در مرجع هدف داخلی اطلاعاتی را در مورد عملکردهای موجود برای آن BII ارائه می دهد، مانند اینکه آیا ابزار تست از ایجاد پیش نمایش برای یک منطقه خاص پشتیبانی می کند یا خیر، و اینکه آیا App Actions برای فعال کردن کاربران در دسترس است یا خیر.

افزونه را دریافت کنید

افزونه Google Assistant برای اندروید استودیو در دسترس است. برای اطلاعات در مورد نصب و استفاده از اندروید استودیو به صفحه اندروید استودیو مراجعه کنید.

برای نصب افزونه Google Assistant در اندروید استودیو مراحل زیر را دنبال کنید:

به File > Settings ( Android Studio > Preferences در macOS) بروید.
در بخش Plugins ، به Marketplace بروید و "افزونه دستیار Google" را جستجو کنید.
ابزار را نصب کرده و اندروید استودیو را ریستارت کنید.

همچنین می‌توانید این افزونه را مستقیماً از مخزن عمومی Jetbrains دانلود کنید.

الزامات راه اندازی

استفاده از پلاگین Google Assistant به تعدادی مراحل پیکربندی نیاز دارد تا برنامه Action شما با موفقیت آزمایش شود. به ویژه، باید از همان حساب کاربری در Android Studio، در دستگاه آزمایشی خود و برای دسترسی به کنسول Google Play استفاده کنید.

محیط توسعه خود را با تنظیمات زیر آماده کنید:

به اندروید استودیو (نسخه 4.0 یا بالاتر) وارد شوید .
با همان حساب، در دستگاه تست Android خود وارد برنامه Google شوید.
با همان حساب، دسترسی کنسول Play را به بسته برنامه آپلود شده برای آزمایش دریافت کنید.
برنامه Google را در دستگاه تست Android خود باز کنید و مراحل اولیه راه اندازی دستیار را تمام کنید.
همگام سازی داده های دستگاه را در دستگاه آزمایشی خود فعال کنید.

محدودیت ها

افزونه Google Assistant دارای محدودیت های زیر است:

اقدامات برنامه‌ای که موجودی وب و فراخوانی برنامه پیش‌زمینه را در بر می‌گیرد را نمی‌توان مستقیماً در ابزار آزمایش یا با دستورات پل اشکال‌زدایی Android ( adb ) آزمایش کرد. برای آزمایش این برنامه‌ها، ابتدا با استفاده از ابزار تست یک پیش‌نمایش ایجاد کنید. سپس، با تعامل با Google Assistant در دستگاه فیزیکی خود، آن App Actions را فعال کنید.
موجودی درون خطی actions.intent.OPEN_APP_FEATURE BII را فقط می توان برای مدت شش ساعت پس از ایجاد یا به روز رسانی پیش نمایش آزمایش کرد. پیش نمایش ابزار تست را به روز کنید یا یک پیش نمایش جدید برای بازنشانی دوره زمانی شش ساعته ایجاد کنید.

آزمایشگرهای اضافی اضافه کنید

می توانید کاربران بیشتری را به پروژه خود دعوت کنید تا بتوانند ادغام App Actions شما را آزمایش کنند. این زمانی مفید است که می خواهید پروژه را با سایر اعضای تیم توسعه خود به اشتراک بگذارید تا همه آنها بتوانند آزمایش کنند، یا زمانی که پروژه خود را با تسترهای تضمین کیفیت (QA) به اشتراک می گذارید تا برای راه اندازی تولید آماده شوند. آزمایش‌کنندگان باید به‌عنوان آزمایش‌کننده مجوز در فروشگاه Google Play اضافه شوند و به کنسول Google Play دسترسی فقط خواندنی داده شود.

برای افزودن آزمایشگرهای دیگر، این مراحل را دنبال کنید:

به کنسول Play وارد شوید.
دستورالعمل‌های زیر راه‌اندازی مجوز برنامه را در این مبحث راهنمای کنسول Play دنبال کنید.
شکل 1. افزودن یک آزمایش کننده مجوز.
توجه: این مرحله به حساب Google دسترسی پیش‌نمایش خواندن و نوشتن را می‌دهد.
حساب Google آزمایش کننده مجوز را به عنوان یک کاربر فقط خواندنی کنسول Google Play دعوت کنید.
1. کاربر و مجوزها > دعوت از کاربران جدید > افزودن برنامه را انتخاب کنید.
2. در App Access ، مطمئن شوید که کادر تأیید Admin (همه مجوزها) پاک شده است.

برای هر آزمایش‌کننده‌ای که می‌خواهید برای آزمایش پیش‌نمایش فعال کنید، باید جداگانه با حساب Google آن کاربر به Android Studio وارد شوید. پس از ورود به سیستم، از افزونه Google Assistant برای ایجاد پیش نمایش برای کاربر آزمایشی استفاده کنید.

از افزونه Google Assistant استفاده کنید

با رفتن به Tools > Google Assistant > App Actions test tools، به ابزار تست App Actions در Android Studio دسترسی پیدا کنید. وقتی ابزار را باز می‌کنید، نما بر اساس اینکه آیا یک پیش‌نمایش ابزار تست فعال دارید تغییر می‌کند.

ایجاد، به روز رسانی، و حذف پیش نمایش

می توانید از نسخه پیش نویس برنامه برای آزمایش استفاده کنید. برای اطلاعات بیشتر، به تهیه و عرضه نسخه مراجعه کنید. قبل از ارسال برنامه برای بررسی، آن را در حالت پیش نویس آزمایش کنید.

ابزار تست پیش‌نمایش‌هایی را بر اساس حساب Google و نام بسته برنامه ( شناسه برنامه ) شما ایجاد می‌کند، بنابراین می‌توانید چندین برنامه را با یک حساب Google آزمایش کنید. تا زمانی که شناسه برنامه شما برای هر برنامه متفاوت است، می توانید همچنان از همان حساب Google برای ایجاد پیش نمایش و آزمایش استفاده کنید. چندین حساب Google با دسترسی به یک بسته برنامه می توانند از ابزار تست برای ایجاد پیش نمایش جداگانه برای آن برنامه استفاده کنند.

برای ایجاد پیش‌نمایش، در اندروید استودیو مراحل زیر را انجام دهید:

ابزار تست App Actions را باز کنید.
به صورت اختیاری، نام برنامه و منطقه محلی را برای آزمایش وارد کنید. نام پیش‌فرض برنامه و منطقه محلی، test app action و en است.
روی ایجاد پیش نمایش کلیک کنید. در صورت درخواست، خط‌مشی‌ها و شرایط خدمات App Actions را بررسی کرده و بپذیرید. پس از ایجاد پیش‌نمایش، پنجره ابزار تست به‌روزرسانی می‌شود تا اطلاعات مربوط به BIIهای موجود در فایل shortcuts.xml شما را نمایش دهد.

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

محلی که ارائه می‌کنید باید با زبان Google Assistant در دستگاه آزمایشی شما مطابقت داشته باشد، و شما می‌توانید هر بار فقط یک پیش‌نمایش در یک منطقه ایجاد کنید. به عنوان مثال، اگر زبان دستیار شما انگلیسی (ایالات متحده) است، می‌توانید en-US را وارد کنید اما نه en-** ، en-GB ، یا en-US, en-GB وارد کنید. می‌توانید از محلی ریشه مانند en استفاده کنید تا هم en-GB و هم en-US را شامل شود.

برای تغییر نام برنامه یا محلی انتخاب شده برای پیش نمایش موجود، روی دکمه Delete در ابزار تست کلیک کنید. سپس، قبل از ایجاد پیش‌نمایش جدید، نام برنامه و محل مورد نظر را وارد کنید.

برای به‌روزرسانی پیش‌نمایش موجود برای مطابقت با فایل shortcuts.xml ، روی دکمه Update در ابزار تست کلیک کنید. اطلاعات مربوط به پیش نمایش فعلی شما در بخش Test App Action پنجره ابزار تست است.

یک BII را پیکربندی کنید

هنگامی که یک پیش نمایش برای برنامه خود ایجاد می کنید، می توانید مقادیر پارامترهای مختلف را برای BII ها در افزونه آزمایش کنید. برای هر BII در فایل shortcuts.xml شما، افزونه یک شی JSON-LD مربوطه را ارائه می دهد و مقادیر پارامتر پیش فرض را ارائه می دهد. می‌توانید این مقادیر پیش‌فرض را تغییر دهید تا App Actions خود را با ترکیب پارامترهای معنی‌دار آزمایش کنید و اطمینان حاصل کنید که عملکردهای برنامه صحیح را انجام می‌دهند.

پارامترها و مقادیر آنها معمولاً از ساختار schema.org یا schema.googleapis.com برای ویژگی ها و توضیحات پیروی می کنند. شما می توانید اطلاعات مربوط به هر پارامتر BII را با دسترسی به توضیحات نوع طرحواره یک پارامتر و پارامترهای سطح بالاتر آن بیابید.

برای مثال، actions.intent.GET_FOOD_OBSERVATION BII از پارامتر intent foodObservation.forMeal پشتیبانی می کند. صفحه schema.googleapis.com برای MealType name به عنوان یک ویژگی فهرست می کند. ویژگی forMeal یک حالت انتقال است و مقادیری از نوع MealType برشمرده شده را انتظار دارد (مانند MealTypeLunch ).

در ابزار تست، می توانید هر یک از شمارش ها را به عنوان مقدار foodObservation.forMeal ارائه دهید:

https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert

فعال کردن اقدامات برنامه

پس از ایجاد پیش‌نمایش و پیکربندی یک BII، می‌توانید مستقیماً از پنجره ابزار تست، یک App Action را روی دستگاه آزمایشی خود راه‌اندازی کنید.

برای فعال کردن یک App Action با ابزار تست، موارد زیر را انجام دهید:

دستگاه تست خود را وصل کنید
در بخش Select Target Device ، دستگاهی را انتخاب کنید که می‌خواهید App Action خود را در آن فعال کنید.
در قسمت Test App Action ، روی دکمه Run App Action کلیک کنید.

App Actions فعال شده در ابزار تست از دستور نمایش داده شده Android Debug Bridge ( adb ) استفاده می کند. دستور ایجاد شده adb shell شامل تمام ابرداده های مورد نیاز برنامه Google برای اجرای یک BII است. این رویکرد پس از استخراج اطلاعات کلیدی از یک جستجو توسط Assistant، رفتار App Action شما را تقلید می کند.

لاگ اندروید استودیو

گزارش‌های مخصوص ابزار تست در فایل‌های گزارش Android Studio در دسترس هستند، نه به عنوان خروجی Logcat. فرآیندهایی که مستقیماً در ایستگاه کاری شما اجرا می شوند، گزارش های Android Studio را ایجاد می کنند. می‌توانید از آنها برای عیب‌یابی عملیات ابزار آزمایشی مانند ایجاد، به‌روزرسانی یا حذف پیش‌نمایش استفاده کنید.

برای دسترسی به فایل‌های گزارش Android Studio خود، به Help > Show log in explorer بروید ( Help > Show log in finder on macOS).

گزارش‌های مربوط به App Actions برای برنامه شما در Logcat موجود است. Logcat گزارش‌ها را از دستگاه‌های مجازی یا فیزیکی متصل به Android Studio ضبط می‌کند.

برای دریافت گزارش‌های App Actions برای دستگاه خود، این مراحل را دنبال کنید:

با کلیک روی Logcat در نوار پنجره ابزار Android Studio به پیام‌های Logcat log خود دسترسی پیدا کنید.
گزارش‌هایی را جستجو کنید که شامل ActivityTaskManager هستند.

پشتیبانی و منابع اضافی دریافت کنید

افزونه Google Assistant پیوندهایی به اسناد، کدها و سایر منابع برای یادگیری و دریافت کمک با استفاده از ابزار تست ارائه می دهد.

می‌توانید با انتخاب Tools > Google Assistant > Help، دستیار را در Android Studio باز کنید.

دستیار ابزار تست اقدامات برنامه شکل 2. بخش راهنمای افزونه Google Assistant.

چگونه کار می کند

پشتیبانی محلی

افزونه را دریافت کنید

برای نصب افزونه Google Assistant در اندروید استودیو مراحل زیر را دنبال کنید:

به File > Settings ( Android Studio > Preferences در macOS) بروید.
در بخش Plugins ، به Marketplace بروید و "افزونه دستیار Google" را جستجو کنید.
ابزار را نصب کرده و اندروید استودیو را ریستارت کنید.

همچنین می‌توانید این افزونه را مستقیماً از مخزن عمومی Jetbrains دانلود کنید.

الزامات راه اندازی

محیط توسعه خود را با تنظیمات زیر آماده کنید:

به اندروید استودیو (نسخه 4.0 یا بالاتر) وارد شوید .
با همان حساب، در دستگاه تست Android خود وارد برنامه Google شوید.
با همان حساب، دسترسی کنسول Play را به بسته برنامه آپلود شده برای آزمایش دریافت کنید.
برنامه Google را در دستگاه تست Android خود باز کنید و مراحل اولیه راه اندازی دستیار را تمام کنید.
همگام سازی داده های دستگاه را در دستگاه آزمایشی خود فعال کنید.

محدودیت ها

افزونه Google Assistant دارای محدودیت های زیر است:

اقدامات برنامه‌ای که موجودی وب و فراخوانی برنامه پیش‌زمینه را در بر می‌گیرد را نمی‌توان مستقیماً در ابزار آزمایش یا با دستورات پل اشکال‌زدایی Android ( adb ) آزمایش کرد. برای آزمایش این برنامه‌ها، ابتدا با استفاده از ابزار تست یک پیش‌نمایش ایجاد کنید. سپس، با تعامل با Google Assistant در دستگاه فیزیکی خود، آن App Actions را فعال کنید.
موجودی درون خطی actions.intent.OPEN_APP_FEATURE BII را فقط می توان برای مدت شش ساعت پس از ایجاد یا به روز رسانی پیش نمایش آزمایش کرد. پیش نمایش ابزار تست را به روز کنید یا یک پیش نمایش جدید برای بازنشانی دوره زمانی شش ساعته ایجاد کنید.

آزمایشگرهای اضافی اضافه کنید

برای افزودن آزمایشگرهای دیگر، این مراحل را دنبال کنید:

به کنسول Play وارد شوید.
دستورالعمل‌های زیر راه‌اندازی مجوز برنامه را در این مبحث راهنمای کنسول Play دنبال کنید.
شکل 1. افزودن یک آزمایش کننده مجوز.
توجه: این مرحله به حساب Google دسترسی پیش‌نمایش خواندن و نوشتن را می‌دهد.
حساب Google آزمایش کننده مجوز را به عنوان یک کاربر فقط خواندنی کنسول Google Play دعوت کنید.
1. کاربر و مجوزها > دعوت از کاربران جدید > افزودن برنامه را انتخاب کنید.
2. در App Access ، مطمئن شوید که کادر تأیید Admin (همه مجوزها) پاک شده است.

از افزونه Google Assistant استفاده کنید

ایجاد، به روز رسانی، و حذف پیش نمایش

برای ایجاد پیش‌نمایش، در اندروید استودیو مراحل زیر را انجام دهید:

ابزار تست App Actions را باز کنید.
به صورت اختیاری، نام برنامه و منطقه محلی را برای آزمایش وارد کنید. نام پیش‌فرض برنامه و منطقه محلی، test app action و en است.
روی ایجاد پیش نمایش کلیک کنید. در صورت درخواست، خط‌مشی‌ها و شرایط خدمات App Actions را بررسی کرده و بپذیرید. پس از ایجاد پیش‌نمایش، پنجره ابزار تست به‌روزرسانی می‌شود تا اطلاعات مربوط به BIIهای موجود در فایل shortcuts.xml شما را نمایش دهد.

یک BII را پیکربندی کنید

در ابزار تست، می توانید هر یک از شمارش ها را به عنوان مقدار foodObservation.forMeal ارائه دهید:

https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert

فعال کردن اقدامات برنامه

برای فعال کردن یک App Action با ابزار تست، موارد زیر را انجام دهید:

دستگاه تست خود را وصل کنید
در بخش Select Target Device ، دستگاهی را انتخاب کنید که می‌خواهید App Action خود را در آن فعال کنید.
در قسمت Test App Action ، روی دکمه Run App Action کلیک کنید.

لاگ اندروید استودیو

برای دسترسی به فایل‌های گزارش Android Studio خود، به Help > Show log in explorer بروید ( Help > Show log in finder on macOS).

برای دریافت گزارش‌های App Actions برای دستگاه خود، این مراحل را دنبال کنید:

با کلیک روی Logcat در نوار پنجره ابزار Android Studio به پیام‌های Logcat log خود دسترسی پیدا کنید.
گزارش‌هایی را جستجو کنید که شامل ActivityTaskManager هستند.

پشتیبانی و منابع اضافی دریافت کنید

می‌توانید با انتخاب Tools > Google Assistant > Help، دستیار را در Android Studio باز کنید.

دستیار ابزار تست اقدامات برنامه شکل 2. بخش راهنمای افزونه Google Assistant.

چگونه کار می کند

پشتیبانی محلی

افزونه را دریافت کنید

برای نصب افزونه Google Assistant در اندروید استودیو مراحل زیر را دنبال کنید:

به File > Settings ( Android Studio > Preferences در macOS) بروید.
در بخش Plugins ، به Marketplace بروید و "افزونه دستیار Google" را جستجو کنید.
ابزار را نصب کرده و اندروید استودیو را ریستارت کنید.

همچنین می‌توانید این افزونه را مستقیماً از مخزن عمومی Jetbrains دانلود کنید.

الزامات راه اندازی

محیط توسعه خود را با تنظیمات زیر آماده کنید:

به اندروید استودیو (نسخه 4.0 یا بالاتر) وارد شوید .
با همان حساب، در دستگاه تست Android خود وارد برنامه Google شوید.
با همان حساب، دسترسی کنسول Play را به بسته برنامه آپلود شده برای آزمایش دریافت کنید.
برنامه Google را در دستگاه تست Android خود باز کنید و مراحل اولیه راه اندازی دستیار را تمام کنید.
همگام سازی داده های دستگاه را در دستگاه آزمایشی خود فعال کنید.

محدودیت ها

افزونه Google Assistant دارای محدودیت های زیر است:

اقدامات برنامه‌ای که موجودی وب و فراخوانی برنامه پیش‌زمینه را در بر می‌گیرد را نمی‌توان مستقیماً در ابزار آزمایش یا با دستورات پل اشکال‌زدایی Android ( adb ) آزمایش کرد. برای آزمایش این برنامه‌ها، ابتدا با استفاده از ابزار تست یک پیش‌نمایش ایجاد کنید. سپس، با تعامل با Google Assistant در دستگاه فیزیکی خود، آن App Actions را فعال کنید.
موجودی درون خطی actions.intent.OPEN_APP_FEATURE BII را فقط می توان برای مدت شش ساعت پس از ایجاد یا به روز رسانی پیش نمایش آزمایش کرد. پیش نمایش ابزار تست را به روز کنید یا یک پیش نمایش جدید برای بازنشانی دوره زمانی شش ساعته ایجاد کنید.

آزمایشگرهای اضافی اضافه کنید

برای افزودن آزمایشگرهای دیگر، این مراحل را دنبال کنید:

به کنسول Play وارد شوید.
دستورالعمل‌های زیر راه‌اندازی مجوز برنامه را در این مبحث راهنمای کنسول Play دنبال کنید.
شکل 1. افزودن یک آزمایش کننده مجوز.
توجه: این مرحله به حساب Google دسترسی پیش‌نمایش خواندن و نوشتن را می‌دهد.
حساب Google آزمایش کننده مجوز را به عنوان یک کاربر فقط خواندنی کنسول Google Play دعوت کنید.
1. کاربر و مجوزها > دعوت از کاربران جدید > افزودن برنامه را انتخاب کنید.
2. در App Access ، مطمئن شوید که کادر تأیید Admin (همه مجوزها) پاک شده است.

از افزونه Google Assistant استفاده کنید

ایجاد، به روز رسانی، و حذف پیش نمایش

برای ایجاد پیش‌نمایش، در اندروید استودیو مراحل زیر را انجام دهید:

ابزار تست App Actions را باز کنید.
به صورت اختیاری، نام برنامه و منطقه محلی را برای آزمایش وارد کنید. نام پیش‌فرض برنامه و منطقه محلی، test app action و en است.
روی ایجاد پیش نمایش کلیک کنید. در صورت درخواست، خط‌مشی‌ها و شرایط خدمات App Actions را بررسی کرده و بپذیرید. پس از ایجاد پیش‌نمایش، پنجره ابزار تست به‌روزرسانی می‌شود تا اطلاعات مربوط به BIIهای موجود در فایل shortcuts.xml شما را نمایش دهد.

یک BII را پیکربندی کنید

در ابزار تست، می توانید هر یک از شمارش ها را به عنوان مقدار foodObservation.forMeal ارائه دهید:

https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert

فعال کردن اقدامات برنامه

برای فعال کردن یک App Action با ابزار تست، موارد زیر را انجام دهید:

دستگاه تست خود را وصل کنید
در بخش Select Target Device ، دستگاهی را انتخاب کنید که می‌خواهید App Action خود را در آن فعال کنید.
در قسمت Test App Action ، روی دکمه Run App Action کلیک کنید.

لاگ اندروید استودیو

برای دسترسی به پرونده های ورود به سیستم Android Studio ، به Help> Show Log in Explorer ( راهنما> نمایش ورود به سیستم در MacOS) بروید.

سیاهههای مربوط به اقدامات برنامه برای برنامه شما در LogCat موجود است. Logcat سیاهههای مربوط به دستگاههای مجازی یا فیزیکی متصل به استودیوی اندرویدی را ضبط می کند.

برای به دست آوردن ورود به سیستم برنامه برای دستگاه خود ، این مراحل را دنبال کنید:

با کلیک بر روی LogCat در نوار پنجره ابزار Android Studio ، به پیام های ورود به سیستم LogCat خود دسترسی پیدا کنید.
پرونده هایی را که شامل ActivityTaskManager است ، جستجو کنید.

پشتیبانی و منابع اضافی را دریافت کنید

افزونه Google Assistant پیوندهایی را به اسناد ، CodeLabs و سایر منابع برای یادگیری و کمک به استفاده از ابزار تست ارائه می دهد.

با انتخاب ابزارها> دستیار Google> Help می توانید دستیار را در Android Studio باز کنید.

اقدامات برنامه دستیار ابزار تست شکل 2. بخش راهنما افزونه Google Assistant.

افزونه Google Assistant اقدامات برنامه را در Android Studio آزمایش می کند. در حین توسعه و آزمایش ، از افزونه برای ایجاد پیش نمایش اقدامات برنامه خود در دستیار حساب Google خود استفاده می کنید. سپس می توانید قبل از ارسال آن برای استقرار ، چگونه اقدامات برنامه شما پارامترهای مختلفی را انجام دهد.

چگونه کار می کند

افزونه Google Assistant شامل ابزار تست App Actions ، ویژگی ای است که پرونده میانبر شما را تجزیه می کند. این پیش نمایش ها Google Assistant را قادر می سازد قبل از استفاده از نسخه تولید برنامه خود به کنسول Google Play ، اقدامات برنامه شما را تشخیص دهد.

برای هر هدف داخلی (BII) در پرونده میانبر.xml شما ، ابزار یک شیء JSON-LD مربوطه را ارائه می دهد و مقادیر پارامتر پیش فرض را ارائه می دهد. سپس می توانید آن مقادیر را برای آزمایش اقدامات برنامه خود با ترکیب پارامتر معنی دار تغییر دهید و اطمینان حاصل کنید که آنها توابع برنامه صحیح را انجام می دهند. پیش نمایش ها در ابزار تست ایجاد ، به روز شده و حذف می شوند و به شما امکان می دهند تا اقدامات برنامه خود را در یک محیط امن آزمایش کرده و آزمایش کنید.

پس از ایجاد پیش نمایش ، می توانید مستقیماً از پنجره Test Tool یک برنامه را در دستگاه تست خود ایجاد کنید. برای BIIS که برای تحریک کاربر در دسترس است ، می توانید app name مستقیماً در دستیار دستگاه خود استفاده کنید تا اقدامات برنامه خود را امتحان کنید. به عنوان مثال ، می توانید بگویید ، "سلام گوگل ، تمرین من را با استفاده از برنامه مثال شروع کنید" برای راه اندازی یک برنامه برنامه که از actions.intent.START_EXERCISE BII استفاده می کند.

پشتیبانی محلی

ایجاد پیش نمایش برای محلی های خاص در ابزار تست توسط BII متفاوت است. صفحه برای هر BII در مرجع داخلی داخلی ، اطلاعاتی را در مورد آنچه که عملکردی برای آن BII در دسترس است ، ارائه می دهد ، مانند اینکه آیا ابزار تست از ایجاد پیش نمایش برای یک محل خاص پشتیبانی می کند ، و اینکه آیا اقدامات برنامه برای کاربران در دسترس است.

افزونه را دریافت کنید

افزونه Google Assistant برای Android Studio در دسترس است. برای اطلاعات در مورد نصب و استفاده از Android Studio ، به صفحه استودیوی Android مراجعه کنید.

برای نصب افزونه Google Assistant در Android Studio ، این مراحل را دنبال کنید:

به File > Settings ( Android Studio > تنظیمات برگزیده در MACOS) بروید.
در بخش افزونه ها ، به Marketplace بروید و "افزونه دستیار Google" را جستجو کنید.
ابزار را نصب کرده و استودیوی اندرویدی را مجدداً راه اندازی کنید.

همچنین می توانید این افزونه را مستقیماً از مخزن عمومی Jetbrains بارگیری کنید.

الزامات راه اندازی

استفاده از افزونه Google Assistant به تعدادی از مراحل پیکربندی نیاز دارد تا عمل برنامه شما با موفقیت آزمایش شود. به طور خاص ، شما باید از همان حساب کاربری در Android Studio ، در دستگاه تست خود و برای دسترسی به کنسول Google Play استفاده کنید.

محیط توسعه خود را با تنظیمات زیر آماده کنید:

وارد استودیوی Android (نسخه 4.0 یا بالاتر) شوید .
با همان حساب ، وارد برنامه Google در دستگاه تست Android خود شوید.
با همان حساب ، دسترسی به کنسول Play به بسته برنامه بارگذاری شده را برای آزمایش دریافت کنید.
برنامه Google را در دستگاه تست Android خود باز کنید و فرآیند اولیه تنظیم دستیار را به پایان برسانید.
همگام سازی داده های دستگاه را در دستگاه تست خود فعال کنید.

محدودیت ها

افزونه Google Assistant محدودیت های زیر را دارد:

اقدامات برنامه هایی که شامل موجودی وب و دعوت برنامه پیش زمینه هستند ، نمی توانند مستقیماً در ابزار تست یا توسط دستورات Android Debug Bridge ( adb ) آزمایش شوند. برای آزمایش این اقدامات برنامه ، ابتدا با استفاده از ابزار تست پیش نمایش ایجاد کنید. سپس با تعامل با Google Assistant در دستگاه فیزیکی خود ، آن اقدامات برنامه را تحریک کنید.
موجودی درون خطی برای actions.intent.OPEN_APP_FEATURE BII فقط برای مدت شش ساعت پس از ایجاد یا به روزرسانی پیش نمایش قابل آزمایش است. پیش نمایش ابزار تست را به روز کنید یا یک پیش نمایش جدید برای تنظیم مجدد دوره زمانی شش ساعته ایجاد کنید.

آزمایش کننده های اضافی اضافه کنید

شما می توانید کاربران اضافی را به پروژه خود دعوت کنید تا بتوانند ادغام اقدامات برنامه شما را آزمایش کنند. این زمانی مفید است که شما می خواهید پروژه را با سایر اعضای تیم توسعه خود به اشتراک بگذارید تا همه آنها بتوانند آزمایش کنند ، یا هنگام به اشتراک گذاشتن پروژه خود با آزمایش کنندگان تضمین کیفیت (QA) در آماده سازی برای تولید تولید. آزمایش کنندگان باید به عنوان تست کننده مجوز در فروشگاه Google Play اضافه شوند و فقط به خواندن کنسول Google Play دسترسی پیدا کنند.

برای افزودن آزمایش کننده های اضافی ، این مراحل را دنبال کنید:

وارد کنسول بازی شوید.
دستورالعمل های تحت تنظیم مجوز برنامه را در این موضوع کمک کنید .
شکل 1. اضافه کردن یک تستر مجوز.
توجه: این مرحله دسترسی به پیش نمایش به حساب Google را می خواند و می نویسد.
از حساب Google تست کننده مجوز به عنوان یک کاربر فقط خواندنی کنسول Google Play دعوت کنید.
1. کاربر و مجوزها را انتخاب کنید> دعوت کاربران جدید> اضافه کردن برنامه .
2. در دسترسی به برنامه ، اطمینان حاصل کنید که کادر انتخاب مدیر (کلیه مجوزها) پاک شده است.

برای هر تست کننده ای که می خواهید برای آزمایش پیش نمایش فعال کنید ، باید با حساب Google آن کاربر به طور جداگانه وارد Android Studio شوید. پس از ورود به سیستم ، از افزونه Google Assistant برای ایجاد پیش نمایش برای کاربر آزمایش استفاده کنید.

از افزونه Google Assistant استفاده کنید

با مراجعه به ابزارها> دستیار Google> ابزار تست اقدامات برنامه ، به ابزار تست App Action Action در Android Studio دسترسی پیدا کنید. هنگامی که ابزار را باز می کنید ، نمایش بر اساس اینکه آیا پیش نمایش ابزار تست فعال دارید ، تغییر می کند.

پیش نمایش ها را ایجاد ، به روز و حذف کنید

برای آزمایش می توانید از نسخه پیش نویس برنامه استفاده کنید. برای اطلاعات بیشتر ، به آماده سازی و انتشار نسخه مراجعه کنید. قبل از ارسال آن برای بررسی ، برنامه خود را در حالت پیش نویس آزمایش کنید.

ابزار تست پیش نمایش ها را بر اساس حساب Google و نام بسته برنامه ( شناسه برنامه ) ایجاد می کند ، بنابراین می توانید چندین برنامه را با همان حساب Google آزمایش کنید. تا زمانی که شناسه برنامه شما برای هر برنامه متفاوت باشد ، می توانید از همان حساب Google برای ایجاد و آزمایش پیش نمایش استفاده کنید. چندین حساب Google با دسترسی به همان بسته برنامه می تواند از ابزار تست برای ایجاد پیش نمایش های جداگانه برای آن برنامه استفاده کند.

برای ایجاد پیش نمایش ، موارد زیر را در Android Studio انجام دهید:

ابزار تست اقدامات برنامه را باز کنید.
برای آزمایش به صورت اختیاری یک نام برنامه و محلی را وارد کنید. نام برنامه پیش فرض و محلی test app action و en است.
روی ایجاد پیش نمایش کلیک کنید. در صورت درخواست ، خط مشی و شرایط خدمات اقدامات برنامه را بررسی و بپذیرید. پس از ایجاد پیش نمایش شما ، پنجره تست ابزار برای نمایش اطلاعات مربوط به BIIS موجود در پرونده میانبر .xml شما به روز می شود.

ابزار تست از نام برنامه برای ساخت و شبیه سازی پرس و جو دستیار برای اقدامات برنامه خود استفاده می کند. اقدامات برنامه مستقر از نام برنامه Play Store خود برای دعوت استفاده کنید ، اما می توانید از هر نام دعوت در ابزار تست استفاده کنید. با این حال ، ما توصیه می کنیم از نام برنامه خود به عنوان نام دعوت خود در ابزار تست استفاده کنید.

محلی که شما ارائه می دهید باید با زبان دستیار Google در دستگاه تست خود مطابقت داشته باشد و فقط می توانید یک پیش نمایش را در یک محلی ایجاد کنید. به عنوان مثال ، اگر زبان دستیار شما انگلیسی است (ما) ، می توانید en-US را وارد کنید اما نه en-** ، en-GB یا en-US, en-GB . شما می توانید از یک محل ریشه مانند en استفاده کنید تا en-GB و en-US را شامل شود.

برای تغییر نام برنامه یا محل انتخاب شده برای پیش نمایش موجود ، روی دکمه Delete در ابزار تست کلیک کنید. سپس قبل از ایجاد پیش نمایش جدید ، نام برنامه و محلی مورد نظر را وارد کنید.

برای به روزرسانی یک پیش نمایش موجود برای مطابقت با پرونده میانبر .xml ، روی دکمه Update در ابزار تست کلیک کنید. اطلاعات مربوط به پیش نمایش فعلی شما در بخش اقدام برنامه آزمایشی پنجره ابزار تست است.

پیکربندی BII

پس از ایجاد پیش نمایش برای برنامه خود ، می توانید مقادیر پارامتر مختلفی را برای BIIS در افزونه آزمایش کنید. برای هر BII در پرونده میانبر .xml ، افزونه یک شیء JSON-LD مربوطه را ارائه می دهد و مقادیر پارامتر پیش فرض را ارائه می دهد. شما می توانید آن مقادیر پیش فرض را برای آزمایش اقدامات برنامه خود با ترکیب های پارامتر معنی دار اصلاح کنید و اطمینان حاصل کنید که آنها عملکردهای صحیح برنامه را انجام می دهند.

پارامترها و مقادیر آنها به طور معمول از ساختار schema.org یا schema.googleapis.com برای خواص و توضیحات پیروی می کنند. با دسترسی به توضیحات نوع طرحواره از یک پارامتر و پارامترهای سطح بالاتر می توانید اطلاعات مربوط به هر پارامتر BII را پیدا کنید.

به عنوان مثال ، actions.intent.GET_FOOD_OBSERVATION bii از پارامتر هدف foodObservation.forMeal پشتیبانی می کند. صفحه schema.googleapis.com برای لیست MealType name به عنوان یک ویژگی. خاصیت forMeal شیوه انتقال است و انتظار می رود مقادیر (مانند MealTypeLunch ) از نوع MealType ذکر شده باشد.

در ابزار تست ، می توانید هر یک از شمارش ها را به عنوان ارزش foodObservation.forMeal ارائه دهید:

https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert

اقدامات برنامه Trigger

پس از ایجاد پیش نمایش و پیکربندی یک BII ، می توانید یک برنامه برنامه را مستقیماً از پنجره Test Tool در دستگاه تست خود شروع کنید.

برای ایجاد یک برنامه با ابزار تست ، موارد زیر را انجام دهید:

دستگاه تست خود را وصل کنید.
در بخش Select Target Device ، دستگاهی را که می خواهید برنامه خود را تحریک کنید ، انتخاب کنید.
در بخش تست برنامه عمل ، روی دکمه Run App Action کلیک کنید.

اقدامات برنامه در ابزار تست از دستور نمایش داده شده Android Debug Bridge ( adb ) استفاده می شود. دستور تولید شده adb Shell شامل تمام ابرداده های مورد نیاز برنامه Google برای اجرای BII است. این رویکرد پس از دستیار بخش های کلیدی اطلاعات را از یک پرس و جو از رفتار برنامه شما تقلید می کند.

ورود به سیستم استودیوی اندرویدی

سیاهههای مربوط به ابزار تست در پرونده های ورود به سیستم Android Studio موجود است ، نه به عنوان خروجی LogCat. فرآیندهای که مستقیماً در ایستگاه کاری شما انجام می شود ، سیاهههای استودیوی اندرویدی را تولید می کنند. می توانید از آنها برای عیب یابی عملیات ابزار تست مانند ایجاد ، به روزرسانی یا حذف پیش نمایش استفاده کنید.

برای به دست آوردن ورود به سیستم برنامه برای دستگاه خود ، این مراحل را دنبال کنید:

با کلیک بر روی LogCat در نوار پنجره ابزار Android Studio ، به پیام های ورود به سیستم LogCat خود دسترسی پیدا کنید.
پرونده هایی را که شامل ActivityTaskManager است ، جستجو کنید.

پشتیبانی و منابع اضافی را دریافت کنید

با انتخاب ابزارها> دستیار Google> Help می توانید دستیار را در Android Studio باز کنید.

اقدامات برنامه دستیار ابزار تست شکل 2. بخش راهنما افزونه Google Assistant.