অ্যাপ টেস্ট করার এজেন্ট (Android)

অ্যাপ টেস্ট করার এজেন্ট হল টেস্ট কেস তৈরি, ম্যানেজ ও এক্সিকিউট করার এজেন্ট যা Firebase-এ Gemini দ্বারা পরিচালিত। আপনি ন্যাচারাল ল্যাঙ্গুয়েজে পরীক্ষার লক্ষ্য নির্ধারণ করেন, এবং এজেন্ট আপনার অ্যাপ বুঝতে ও নেভিগেট করতে, ব্যবহারকারীর ইন্টার‍্যাকশন সিমুলেট করতে এবং পরীক্ষার বিস্তারিত ফলাফল প্রদান করতে AI ব্যবহার করে।

অ্যাপ টেস্ট করার এজেন্ট কীভাবে আপনার ডেটা ব্যবহার করে

অ্যাপ টেস্ট করার এজেন্ট Gemini in Firebase-এর মাধ্যমে প্রদান করা হয় এবং একই শর্তাবলী দ্বারা পরিচালিত হয়। Firebase-এ Gemini কীভাবে আপনার ডেটা ব্যবহার করে সেই সম্পর্কে আরও তথ্য পেতে, Firebase-এ Gemini কীভাবে আপনার ডেটা ব্যবহার করে দেখুন।

শুরু করার আগে

আপনি আগে থেকে করে না থাকলে, Firebase-এর সাথে আপনার অ্যাপ রেজিস্টার করুন।

আপনি অন্য কোনও Firebase প্রোডাক্ট ব্যবহার না করলে, আপনাকে শুধু একটি প্রোজেক্ট তৈরি করে আপনার অ্যাপ রেজিস্টার করতে হবে। আপনার অ্যাপে কোনও SDK যোগ করতে হবে না। তবে, ভবিষ্যতে আপনি অতিরিক্ত প্রোডাক্ট ব্যবহার করার সিদ্ধান্ত নিলে, Firebase কনসোল ব্যবহার করে Firebase যোগ করুন লিঙ্কে গিয়ে সবকটি ধাপ সম্পূর্ণ করতে ভুলবেন না।

টেস্ট কেস তৈরি করুন

AI-নির্দেশিত টেস্ট রান করতে, অ্যাপ টেস্ট করার এজেন্ট আপনার অ্যাপের বিরুদ্ধে টেস্ট চালানোর জন্য আপনার ন্যাচারাল ল্যাঙ্গুয়েজ টেস্ট কেস ব্যবহার করে।

প্রতিটি টেস্ট কেসকে কয়েকটি ধাপে ভাগ করা হয়েছে, যা ক্রমানুসারে চালানো হবে। ধাপগুলি আপনাকে আপনার টেস্ট কেসকে বিভিন্ন পর্যায়ে ভাগ করতে দেয়, যার প্রত্যেকটির নিজস্ব অ্যাসারশন থাকে। এজেন্ট যেকোনও একটি ধাপ চলাকালীন অনেক অ্যাকশন নিতে পারে।

দুটি উপায়ে টেস্ট কেস তৈরি করা যায়: YAML ফাইল ব্যবহার করে অথবা Firebase কনসোল ব্যবহার করে। YAML ফাইলের মাধ্যমে আপনি নিজেই টেস্ট কেস ম্যানেজ করতে পারবেন, সাধারণত ভার্সন করা সোর্স কোড রিপোজিটরিতে। বিকল্প হিসেবে, Firebase কনসোল আপনার টেস্ট কেস রিমোটলি স্টোর করতে পারে, সাথে আপনার অ্যাপ ডিস্ট্রিবিউশন ডেটাও।

YAML ফাইল ব্যবহার করা

নিম্নলিখিত উদাহরণে একটি YAML ফাইল দেখানো হয়েছে যা দুটি টেস্ট কেসকে সংজ্ঞায়িত করে:

tests:
- displayName: Login as guest
  id: login-as-guest
  steps:
  - goal: Log in as a guest
    finalScreenAssertion: The home screen is visible
- displayName: View biography card birth date
  prerequisiteTestCaseId: login-as-guest
  steps:
  - goal: Open the article on "Bob Dylan"
    hint: Use the search function to find it
    finalScreenAssertion: >-
      The article is opened and the title "Bob Dylan" is visible.
  - goal: Find Bob Dylan's birthday in the article
    hint: >-
      Look for the "Born" section in the infobox on the right side of the page.
    finalScreenAssertion: >-
      The text "May 24, 1941" is visible on the screen.

আপনি একটি ফাইলে টেস্টের গ্রুপ সাজাতে এবং একাধিক ফাইলে এইসব টেস্ট স্যুট আলাদা করতে পারবেন। আপনি টেস্টে একটি আইডি যোগ করে এবং তারপরে prerequisiteTestCaseId ব্যবহার করে সেই আইডি রেফারেন্স করে একটি পূর্বশর্ত টেস্ট কেস যোগ করতে পারেন।

App Distribution কনসোল ব্যবহার করা

এছাড়াও, আপনি Firebase কনসোলে আপনার টেস্ট কেস তৈরি ও ম্যানেজ করতে পারবেন। টেস্ট কেস তৈরি করতে, Firebase কনসোলের App Distribution পৃষ্ঠা খুলুন এবং নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. টেস্ট কেস ট্যাবে, নতুন টেস্ট কেস বিকল্পে ক্লিক করুন। আপনি নিজের টেস্ট কেস তৈরি করতে না চাইলে, প্রদান করা উদাহরণ টেস্ট কেস ব্যবহার বা পরিবর্তন করতে পারেন।
2. টেস্ট কেস যোগ করুন ডায়ালগে, টেস্ট কেসের একটি নাম দিন। এটি টেস্ট শনাক্ত করতে ব্যবহার করা হয়, তবে এজেন্ট এটি উপেক্ষা করে।
3. (ঐচ্ছিক) একটি প্রয়োজনীয় টেস্ট কেস বেছে নিন যাতে মূল টেস্টের আগে রান করার জন্য সেট-আপের ধাপগুলি থাকে। প্রি-রিক্যুইজিট টেস্টে সমস্যা হলে, সম্পূর্ণ টেস্টটি ব্যর্থ হিসেবে চিহ্নিত করা হবে। টেস্টের ফলাফলে পূর্বপ্রয়োজনীয়তা এবং মূল টেস্টের ধাপ ও ফলাফল একসাথে দেখানো হবে।
4. অন্য একটি ধাপ যোগ করুন বোতামে ক্লিক করে, আপনার টেস্টকে একাধিক ধাপে ভাগ করার কথা বিবেচনা করুন।
5. প্রতিটি ধাপের জন্য একটি করে লক্ষ্য সেট করুন, যা বর্ণনা করবে যে সেই ধাপে অ্যাপ টেস্ট করার এজেন্টকে কী করতে হবে।
6. (ঐচ্ছিক) অ্যাপ টেস্ট করার এজেন্টকে অতিরিক্ত তথ্য প্রদান করতে একটি ইঙ্গিত যোগ করুন যাতে সেই ধাপ চলাকালীন আপনার অ্যাপ বুঝতে এবং নেভিগেট করতে সাহায্য করে।
7. অ্যাপ টেস্ট করার এজেন্টকে সাহায্য করতে চূড়ান্ত স্ক্রিন অ্যাসার্শন যোগ করুন যাতে ধাপটি কখন সফলভাবে সম্পূর্ণ হয়েছে তা নির্ধারণ করা যায়। এই অ্যাসারশন শুধুমাত্র স্ক্রিনে যা দেখা যাচ্ছে তার উল্লেখ করবে।
8. আপনার টেস্ট কাস্টমাইজ করা হয়ে গেলে সেভ করুন বিকল্পে ক্লিক করুন।

টেস্ট কেসের উদাহরণ

অ্যাপ টেস্ট করার এজেন্ট ব্যবহার করে কীভাবে টেস্ট কেস তৈরি করতে হয় তার উদাহরণ নিচে দেওয়া হল:

টেস্ট রান করুন

আপনি কীভাবে টেস্ট কেস তৈরি ও ম্যানেজ করেন তার উপর নির্ভর করে আপনি কীভাবে টেস্ট রান করবেন। আপনি YAML ফাইল ব্যবহার করে টেস্ট কেস নির্ধারণ করলে, Firebase CLI ব্যবহার করে সেইসব টেস্ট রান করবেন। আপনি App Distribution কনসোলে আপনার টেস্ট কেস তৈরি করলে, আপনি সেগুলি কনসোল থেকে বা App Distribution CLI টুলগুলির একটির মাধ্যমে চালাবেন।

YAML ফাইল ব্যবহার করা

YAML ফাইলে সংজ্ঞায়িত টেস্ট কেস Firebase CLI ব্যবহার করে চালানো যেতে পারে।

1. Firebase CLI-এর লেটেস্ট ভার্সন ইনস্টল বা আপডেট করুন। আপনার OS-এর জন্য নির্দিষ্ট CLI-এর জন্য স্ট্যান্ডঅ্যালোন বাইনারি ডাউনলোড করার সাজেশন আমরা দিই।
2. সাইন-ইন করুন এবং আপনার প্রোজেক্ট অ্যাক্সেস করতে পারছেন কিনা তা পরীক্ষা করুন। মনে রাখবেন, আপনি CI এনভায়রনমেন্টে Firebase CLI ব্যবহার করলে, পরিষেবা অ্যাকাউন্ট বা login:ci ব্যবহার করেও যাচাইকরণ করতে পারবেন।

3. apptesting:execute কমান্ড রান করুন। যেমন:

   firebase apptesting:execute \
     --app=1:1234567890:android:0a1b2c3d4e5f67890 \
     --test-dir=./mytests \
     ./app/build/outputs/apk/debug/app-debug.apk
   

App Distribution কনসোল ব্যবহার করা

অ্যাপ ডিস্ট্রিবিউশনে স্টোর করা টেস্ট কেস রান করতে, আপনি Firebase কনসোল, Firebase CLI অথবা App Distribution-এর Gradle বা fastlane প্লাগ-ইন ব্যবহার করতে পারবেন।

testPasswordFile="/path/to/testPassword.txt"

YAML ফাইলের মাধ্যমে টেস্ট কেস ইমপোর্ট ও এক্সপোর্ট করা

YAML ফাইল থেকে টেস্ট কেস ইম্পোর্ট করা তখন উপযোগী হয় যখন আপনি Firebase কনসোলের বাইরে টেস্ট কেস ম্যানেজ করতে চান। এছাড়াও, এক প্রোজেক্ট থেকে অন্য প্রোজেক্টে টেস্ট কেস সরানোর জন্য এক্সপোর্ট করতে এটি উপযোগী হতে পারে। আপনি আগে থেকে থাকা টেস্ট কেস রিফাইন করতে অথবা নতুন টেস্ট কেস তৈরি করতে LLM ব্যবহার করতে পারেন। আপনি Firebase কনসোলের টেস্ট কেস পৃষ্ঠা থেকে অথবা Firebase CLI ব্যবহার করে প্রোগ্রাম্যাটিক প্রসেসে টেস্ট কেস ইমপোর্ট ও এক্সপোর্ট করতে পারবেন। YAML টেস্ট কেসের উদাহরণ দেখতে, YAML টেস্ট কেস তৈরি করুন বিকল্প দেখুন।

আপনার টেস্টের ফলাফল দেখুন

আপনি রিলিজ পৃষ্ঠা থেকে কোনও রিলিজের অ্যাপ টেস্ট করার এজেন্ট ট্যাবে গিয়ে আপনার টেস্টের ফলাফল দেখতে পারবেন। বিবরণ দেখুন বোতামে ক্লিক করলে পরীক্ষার ফলাফল সংক্রান্ত ডায়ালগ বক্স খুলে যাবে এবং আপনাকে যেকোনও সমস্যা, অ্যাপের স্ক্রিনশট এবং পরীক্ষা চলাকালীন Gemini যেসব অ্যাকশন নিয়েছে তা দেখাবে।

কোনও টেস্টে রিপ্লে করা অ্যাকশন থাকলে, আপনি আসল AI-গাইডেড টেস্ট রান দেখতে বা ক্যাশে মুছে দিতে পারবেন।

আপনার টেস্টের ফলাফল সম্পর্কে আরও জানতে, নিম্নলিখিত টেবিলটি ব্যবহার করুন:

আপনার টেস্টের ফলাফল ডিবাগ করুন

আপনার টেস্টের ফলাফল প্রত্যাশিত ফলাফলের থেকে আলাদা হলে, টেস্টের ফলাফল পৃষ্ঠায় বিবরণ দেখুন বিকল্পের মধ্যে এজেন্ট ভিউ দেখুন টগল ব্যবহার করে আপনার টেস্ট ডিবাগ করতে পারবেন। এজেন্ট ভিউ আপনাকে অন-স্ক্রিন এলিমেন্ট দেখায় যা অ্যাপ টেস্ট করার এজেন্ট অ্যাপের অ্যাক্সেসিবিলিটি তথ্য ব্যবহার করার সময় শনাক্ত করতে পেরেছে। এজেন্ট কী দেখেছেন তা আরও ভালভাবে দেখতে চাইলে, আপনি অ্যাকশন ওভারফ্লো মেনু থেকে সেই তথ্য ডাউনলোড করতে পারবেন।

এছাড়াও, আপনার টেস্ট ফলাফলের জন্য সব ভিডিও, লগ ও অন্যান্য Cloud আর্টিফ্যাক্ট দেখতে, আপনি টেস্ট ফলাফল পৃষ্ঠায় আর্টিফ্যাক্ট দেখুন বোতাম ব্যবহার করতে পারবেন।

পরিচিত সমস্যা ও সীমাবদ্ধতা

অ্যাপ টেস্ট করার এজেন্টের প্রিভিউতে কিছু পরিচিত সীমাবদ্ধতা রয়েছে:

• AI-নির্দেশিত টেস্টের টাইমআউট ৫ মিনিট। কোনও টেস্ট শুরু হওয়ার পরে, সেই সময়ের মধ্যে এটি অবশ্যই সফল হতে হবে, অন্যথায় এটি তাড়াতাড়ি শেষ হয়ে যাবে এবং টেস্ট করায় সমস্যা হিসেবে গণ্য করা হবে।
• অ্যাপ টেস্ট করার এজেন্ট আপনার অ্যাপ টেস্ট করার জন্য জেনারেটিভ AI ব্যবহার করে, তাই এটি কখনও কখনও একই নির্দেশাবলী অনুসরণ করার সময়ও বিভিন্ন অ্যাকশন নেবে।
• অ্যাপ টেস্ট করার এজেন্ট শুধুমাত্র নিম্নলিখিত অ্যাকশনগুলি করতে পারে: ট্যাপ করা, টেক্সট লেখা, উপরে/নিচে/বাঁদিকে/ডানদিকে সোয়াইপ করা, বেশিক্ষণ প্রেস করে রাখা, টেনে নিয়ে রাখা, ফিরে যাওয়া এবং অপেক্ষা করা।
• অ্যাপ টেস্ট করার এজেন্টের এমন টেস্ট চালাতে সমস্যা হয় যাতে শুধুমাত্র একটি ধাপ থাকে এবং সেটি সম্পূর্ণ করতে অনেক অ্যাকশন নিতে হয়। জটিল টাস্ককে একাধিক ছোট ছোট ধাপে ভাগ করে নিলে এটি আরও ভালো পারফর্ম করে।
• অ্যাপ টেস্ট করার এজেন্ট কখনও কখনও স্ক্রিনের বাইরে থাকা অন্যান্য এলিমেন্ট দেখানোর জন্য স্ক্রল করবে না। স্ক্রল করার সুবিধা আছে কিনা তা বোঝার জন্য কোনও ভিজ্যুয়াল ইঙ্গিত না থাকলে, এটি প্রায়শই ঘটে। বিকল্প হিসেবে, স্ক্রল করার সাজেশন দিতে "ইঙ্গিত" ফিল্ড ব্যবহার করা যেতে পারে।
• অ্যাপ টেস্ট করার এজেন্ট কখনও কখনও গণনা করতে সমস্যায় পড়ে, যেমন নির্দিষ্ট সংখ্যক বার কোনও অ্যাকশন সম্পাদন করা।
• FLAG_SECURE চালু থাকলে, অ্যাপ টেস্ট করার এজেন্ট আপনার অ্যাপ নেভিগেট করতে পারবে না। আপনার অ্যাপের স্ক্রিনশটের পরিবর্তে, এটি শুধুমাত্র একটি ফাঁকা স্ক্রিন দেখতে পাবে।

কোটা পরীক্ষা করা

প্রিভিউ চলাকালীন, AI-নির্দেশিত টেস্টগুলি একটি কোটা সীমার মধ্যে কোনও খরচ ছাড়াই অফার করা হবে। ডিফল্ট কোটার সীমা হল প্রতি মাসে, প্রতি Firebase প্রোজেক্টে ২০০টি টেস্ট।

মনে রাখবেন, আপনি যদি একাধিক টেস্ট কেস রান করার সিদ্ধান্ত নেন বা একাধিক ডিভাইসে একই টেস্ট কেস রান করেন, তাহলে এটি একাধিক টেস্ট হিসেবে গণ্য করা হয়। যেমন, আপনি ২টি ডিভাইসে ২টি টেস্ট কেস রান করলে, মোট ৪টি টেস্ট হিসেবে এটি গণনা করা হয়।

ডিফল্ট সীমার উপরে আপনার কোটা বাড়াতে, আপনার ব্যবহারের ক্ষেত্র সহ Firebase সহায়তা টিমের সাথে যোগাযোগ করুন।