ایجاد سفرها برای اندروید استودیو با فراهم کردن امکان استفاده از زبان طبیعی برای توصیف مراحل و اظهارات هر تست - که یک سفر نامیده می‌شود - به شما کمک می‌کند تا تست‌های سرتاسری را به راحتی بنویسید و نگهداری کنید. با بهره‌گیری از قابلیت‌های بینایی و استدلال Gemini، مراحل نوشته شده به زبان طبیعی به اقداماتی تبدیل می‌شوند که Gemini در برنامه شما اجرا می‌کند و سفرها را برای نوشتن و درک ساده می‌کند. علاوه بر این، می‌توانید اظهارات پیچیده‌تری بنویسید و توصیف کنید که Gemini بر اساس آنچه در دستگاه می‌بیند ارزیابی می‌کند تا مشخص کند که آیا سفرهای شما موفق هستند یا شکست می‌خورند.
و از آنجا که Gemini تعیین می‌کند کدام اقدامات برای رسیدن به اهداف انجام شوند، مسیرها در برابر تغییرات نامحسوس در طرح‌بندی یا رفتار برنامه شما مقاوم‌تر هستند و در نتیجه هنگام اجرا در برابر نسخه‌های مختلف برنامه و پیکربندی‌های مختلف دستگاه، تست‌های ناقص کمتری ایجاد می‌شود.
سفرنامه‌ها را مستقیماً از اندروید استودیو روی هر دستگاه محلی یا از راه دور مبتنی بر اندروید بنویسید و اجرا کنید. این IDE یک تجربه ویرایشگر جدید برای ساخت سفرنامه‌ها و همچنین نتایج غنی ارائه می‌دهد که به شما کمک می‌کند استدلال و اجرای سفرنامه خود را در Gemini بهتر درک کنید.
سفرنامه بنویسید
اندروید استودیو یک قالب فایل و یک ویرایشگر جدید ارائه می‌دهد که ایجاد و ویرایش سفرها را ساده می‌کند. سفرها با استفاده از سینتکس زبان نشانه‌گذاری توسعه‌پذیر (XML) نوشته می‌شوند تا شرح سفر و مراحل آن را سازماندهی کنند.
برای ایجاد و شروع ویرایش یک سفر، موارد زیر را انجام دهید:
- از پنل پروژه در اندروید استودیو، روی ماژول اپلیکیشنی که می‌خواهید برایش یک مسیر بنویسید، کلیک راست کنید.
- جدید > تست > فایل سفر را انتخاب کنید.
- در کادر محاوره‌ای که ظاهر می‌شود، نام و شرح سفر خود را وارد کنید.
- روی تأیید کلیک کنید. اندروید استودیو یک فایل XML برای سفر شما با نامی که انتخاب کرده‌اید ایجاد می‌کند. می‌توانید از نمای Code برای ویرایش مستقیم XML یا از نمای Design برای تجربه ویرایش بهبود یافته استفاده کنید.
- هنگام مشاهده سفر خود در نمای طراحی ، از فیلد متنی برای توصیف هر مرحله از سفر خود استفاده کنید. هر مرحله می‌تواند شامل اقدامات توصیفی باشد که می‌خواهید Gemini انجام دهد یا اظهاراتی باشد که می‌خواهید Gemini ارزیابی کند.
- برای شروع یک اعلان جدید در همان مسیر، کلید Enter را روی صفحه کلید خود فشار دهید. می‌توانید این کار را در صورت نیاز برای هر مرحله از مسیر که می‌خواهید تعریف کنید، تکرار کنید.
نکاتی برای نوشتن سفرنامه
نوشتن سفرهایتان به صورت دقیق و سازمان‌یافته می‌تواند احتمال اجرای دقیق‌تر سفرهای مورد نظرتان توسط Gemini را افزایش دهد. در اینجا چند نکته برای کمک به شما در نوشتن مؤثرتر سفرهایتان آورده شده است:
- جدا کردن ادعاها از اقدامات: Gemini دائماً وضعیت برنامه شما را ارزیابی می‌کند تا مشخص کند که آیا برای ادامه مسیر در وضعیت "صحیح" قرار دارد یا خیر. با این حال، ممکن است لازم باشد ادعاها (assertions) پیچیده‌تری را به عنوان یک مرحله جداگانه تعریف کنید. علاوه بر این، هر اعلان را با استفاده از عبارات کلیدی مانند "Verify that"، "Assert that" یا "Check that" شروع کنید تا به Gemini نشان دهید که این مرحله قرار است یک ادعا باشد.
- هدایت Gemini با کشیدن انگشت: علاوه بر تعاملات اولیه، مانند ضربه زدن یا ورودی‌های صفحه کلید، Gemini از اقداماتی پشتیبانی می‌کند که نیاز به کشیدن انگشت روی صفحه در جهت‌های خاص دارند. به عنوان مثال، برای پیمایش محتوا یا رد کردن برخی از رابط‌های کاربری، جهت و هدف عمل کشیدن انگشت خود را توصیف کنید. به طور پیش‌فرض، Gemini از مرکز صفحه نمایش کشیدن انگشت می‌کند، اما می‌توانید مشخص کنید که باید روی قسمت دیگری از صفحه دستگاه بکشید.
- از تعاملات پیچیده و تغییرات پیکربندی اجتناب کنید: جمینی از همه تعاملات و تغییرات پیکربندی، مانند حرکات چند انگشتی، چرخش صفحه یا اقدامات تاشو پشتیبانی نمی‌کند. این تیم در تلاش است تا قابلیت‌های جمینی را بهبود بخشد.
سفر خود را اجرا کنید
شما می‌توانید مسیر خود را روی هر دستگاه محلی یا از راه دور موجود، مشابه هر تست ابزاری دیگری، اجرا کنید و اندروید استودیو نتایج غنی‌ای تولید می‌کند که به شما در درک اجرای مسیرتان کمک می‌کند.
برای آزمایش یک سفر، موارد زیر را انجام دهید:
- مانند زمانی که یک تست ابزاری انجام می‌دهید، یک دستگاه هدف را از نوار ابزار اصلی انتخاب کنید.
- به فایل XML سفری که می‌خواهید تست کنید بروید و آن را در ویرایشگر باز کنید.
- در ویرایشگر، یکی از موارد زیر را انجام دهید:
- اگر در نمای طراحی (Design view) هستید، کلیک کنید
سفر را اجرا کنید . - اگر در نمای کد هستید، کلیک کنید
testدر کادر کنار نام سفر که در فایل XML تعریف شده است، اجرا کنید .
- اگر در نمای طراحی (Design view) هستید، کلیک کنید
اندروید استودیو یک پیکربندی تست سفرها (Journeys Test) برای شما ایجاد می‌کند و آن را روی دستگاه هدف اجرا می‌کند. در طول اجرا، اندروید استودیو برنامه شما را می‌سازد و مستقر می‌کند و به Gemini متصل می‌شود تا اقداماتی را که باید برای هر مرحله از سفر شما انجام شود، تعیین کند.
برای مشاهده اطلاعات بیشتر، نشانگر ماوس را روی تصویر کوچک در ویرایشگر نگه دارید. این می‌تواند هنگام تکرار دستورالعمل‌ها در مسیرتان مفید باشد.
مشاهده نتایج
وقتی اندروید استودیو تست شما را تمام کرد، پنل نتایج تست به طور خودکار ظاهر می‌شود تا نتایج را به شما نشان دهد.
در مقایسه با سایر تست‌های ابزاری که ممکن است در اندروید استودیو اجرا کنید، تفاوت‌هایی در نحوه نمایش نتایج سفرها وجود دارد.
- پنل تست‌ها ، این سفر را به مراحل مجزا تقسیم می‌کند. می‌توانید روی هر مرحله کلیک کنید تا اطلاعات بیشتری در مورد نحوه اجرای آن توسط Gemini کسب کنید.
- پنل نتایج ، اطلاعات غنی‌ای را نشان می‌دهد که به شما کمک می‌کند تفسیر و استدلال جمینی در مورد سفرتان و نحوه اجرای آن توسط جمینی را درک کنید.
- اسکرین‌شات‌هایی که برای Gemini ارسال شده‌اند، برای کمک بصری در هر مرحله نشان داده می‌شوند.
- هر اقدام انجام شده و دلیل Gemini برای آن اقدام در کنار هر تصویر توضیح داده شده است.
- هر اقدام در این مرحله شماره گذاری شده است.
مشکلات شناخته شده
- هنگام آزمایش یک سفر، تمام مجوزهای برنامه شما به طور پیش‌فرض اعطا می‌شوند.
- هنگام آزمایش یک سفر در دستگاهی که اندروید ۱۵ (سطح API ۳۵) را اجرا می‌کند، ممکن است هشداری روی دستگاه با عنوان « برنامه ناامن مسدود شده » برای « خزنده AndroidX » مشاهده کنید. می‌توانید برای دور زدن این بررسی، روی «به هر حال نصب کن » کلیک کنید. همچنین، می‌توانید گزینه‌های توسعه‌دهنده روی دستگاه را پیکربندی کنید و گزینه تأیید برنامه‌ها از طریق USB را غیرفعال کنید.
- فایل‌های سفر در حال حاضر در نمای اندروید در پنل پروژه‌ها نمایش داده نمی‌شوند. برای مشاهده فایل‌های سفر در پروژه خود، از نمای پروژه استفاده کنید.
- اگر چندین اقدام در یک سفر، دقیقاً همان اعلان را به اشتراک بگذارند، نتایج آزمایشی نمایش داده شده در ویرایشگر سفر ممکن است نادرست باشد. به طور خاص، تمام اقداماتی که اعلان تکراری دارند، نتایج آزمایشی مرتبط با جدیدترین نمونه به‌روزرسانی شده آن اعلان را نشان می‌دهند. برای حل این مشکل، مطمئن شوید که هر اقدام یک اعلان منحصر به فرد دارد - به عنوان مثال، با اضافه کردن یک پیشوند یا پسوند مجزا.
- بار دوم که کیبورد روی یک شبیه‌ساز جدید بارگذاری می‌شود، یک پنجره‌ی بازشو با قلم ظاهر می‌شود. این پنجره معمولاً باعث می‌شود تست‌هایی که با فیلدهای متنی تعامل دارند، با شکست مواجه شوند. در این صورت، پنجره را ببندید و دوباره مراحل را اجرا کنید.
- ممکن است گاهی اوقات مصنوعات خزنده برنامه در منطق عامل ظاهر شوند.
- اجرای Journey گاهی اوقات با خطای
IllegalStateExceptionبا شکست مواجه می‌شود. در این صورت، می‌توانید روی Test Results کلیک کنید تا خطای کامل را مشاهده کنید. اگر افزونه‌ی اندروید گریدل (
com.android.application) در فایلbuild.gradleسطح بالا تعریف نشده باشد، ممکن است هنگام اجرای یک journey با خطای زیر مواجه شوید:Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'برای حل این مشکل، مطمئن شوید که افزونه در فایل
build.gradleسطح بالا تعریف شده است. برای اطلاعات بیشتر به پیکربندی سیستم ساخت اندروید مراجعه کنید.