UI Automator: এটি কী, মূল ধারণা এবং এটি কীভাবে কাজ করে

UI Automator কী?

UI Automator হল Android-এর ফাংশনাল UI টেস্টিংয়ের জন্য একটি ফ্রেমওয়ার্ক যা অপারেটিং সিস্টেম লেভেলে কাজ করে। এটি ডিভাইস স্ক্রিনের যেকোনো উপাদান অ্যাক্সেস করার জন্য API প্রদান করে, তা যেকোনো অ্যাপ্লিকেশনেরই হোক না কেন — সিস্টেম স্ট্যাটাস বার, পারমিশন ডায়ালগ, হোম স্ক্রিন এবং থার্ড-পার্টি অ্যাপ সহ। এটি একে একক অ্যাপের বাইরে যাওয়া পরিস্থিতি টেস্ট করার জন্য অপরিহার্য করে তোলে।

স্থাপত্যিকভাবে, UI Automator Accessibility Service ব্যবহার করে — একই সার্ভিস যা TalkBack, Switch Access এবং অন্যান্য অ্যাক্সেসিবিলিটি টুল ব্যবহার করে। এই সার্ভিসের মাধ্যমে, ফ্রেমওয়ার্ক বর্তমান স্ক্রিনের সম্পূর্ণ UI কম্পোনেন্ট ট্রি পায় এবং তাদের উপর ক্রিয়া করার অনুমতি দেয়: ট্যাপ করা, সোয়াইপ করা, টেক্সট ইনপুট এবং লং প্রেস করা।

UI Automator প্রথম Android 4.3 (API 18)-এ আবির্ভূত হয় এবং তারপর থেকে এটি ক্রস-অ্যাপ্লিকেশন টেস্টিংয়ের জন্য Google-এর অফিসিয়াল টুল হিসেবে Android Testing Support Library-এর অংশ। AndroidX Test-এ, এটি একটি পৃথক আর্টিফ্যাক্ট androidx.test.uiautomator:uiautomator সংস্করণ 2.3.0 (2024) হিসেবে উপলব্ধ, যা API 18 থেকে সমস্ত Android সংস্করণ সমর্থন করে।

UI Automator কীভাবে কাজ করে

কাজের নীতি: UI Automator বর্তমান স্ক্রিনের অ্যাক্সেসিবিলিটি ট্রি স্ক্যান করার উপর ভিত্তি করে। যখন findObject(selector) মেথড কল করা হয়, ফ্রেমওয়ার্ক View অনুক্রম অতিক্রম করে, UiSelector শর্তের সাথে মেলে এমন প্রথম উপাদান খুঁজে পায় এবং একটি UiObject রিটার্ন করে — প্রকৃত View-এর সাথে যোগাযোগের জন্য একটি প্রক্সি।

UI Automator টেস্ট লাইফসাইকেল

একটি সাধারণ UI Automator টেস্ট UiDevice ইনস্ট্যান্স প্রাপ্তির মাধ্যমে শুরু হয়, যা ফিজিক্যাল ডিভাইসকে প্রতিনিধিত্ব করে। UiDevice উপাদান খোঁজার, বাটন প্রেস (হোম, ব্যাক, রিসেন্ট) পরিচালনা করার, স্ক্রিন ঘোরানোর এবং স্ক্রিনশট নেওয়ার পদ্ধতি প্রদান করে। UiSelector-এর মাধ্যমে একটি উপাদান খোঁজার পর, UiObject-এ ক্রিয়া সম্পাদন করা হয়।

মৌলিক উদাহরণ

নীচের উদাহরণে, টেস্টটি Settings অ্যাপ খোলে, টেক্সট দ্বারা “ব্যাটারি” আইটেম খুঁজে পায় এবং ট্যাপ করে। UI Automator-এর Activity চালু করার প্রয়োজন নেই — এটি ডিভাইসের যেকোনো স্ক্রিনের সাথে কাজ করে, থার্ড-পার্টি অ্যাপ সহ।

val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())

// সেটিংস স্ক্রিন খুলুন
device.pressHome()
device.wait(Until.hasObject(UiSelector().text("সেটিংস")), 2000)

// "ব্যাটারি" আইটেম খুঁজুন এবং ট্যাপ করুন
val batteryItem = device.findObject(
    UiSelector().text("ব্যাটারি")
)
batteryItem.clickAndWait(Until.newWindow(), 3000)

UiDevice এবং UiSelector: মূল ক্লাস

UiDevice হল ডিভাইসের সাথে যোগাযোগের জন্য প্রধান ক্লাস। এটি উপাদান খোঁজার, হার্ডওয়্যার বাটন প্রেস (হোম, ব্যাক, মেনু, ভলিউম) সিমুলেট করার, পাওয়ার পরিচালনা করার, স্ক্রিনশট নেওয়ার এবং নির্দিষ্ট স্ক্রিন অবস্থার জন্য অপেক্ষা করার পদ্ধতি প্রদান করে। UiDevice প্রতি টেস্টে একবার তৈরি হয় এবং সমস্ত অপারেশনের জন্য পুনরায় ব্যবহার করা হয়।

UiSelector হল UI উপাদান খোঁজার জন্য একটি ফ্লুয়েন্ট API। Espresso ViewMatchers-এর বিপরীতে, UiSelector-এর কম্পাইলেশনের প্রয়োজন নেই — খোঁজার শর্তগুলি মেথড চেইনের মাধ্যমে গঠিত হয়: text(), className(), description(), resourceId(), index()। একাধিক শর্ত লজিক্যাল AND-এর মাধ্যমে স্বয়ংক্রিয়ভাবে একত্রিত হয়।

একাধিক শর্ত সহ খোঁজার উদাহরণ

যখন স্ক্রিনে একই টেক্সট সহ একাধিক উপাদান থাকে, UiSelector মানদণ্ড একত্রিত করার অনুমতি দেয়: ID দ্বারা একটি কন্টেইনার খুঁজুন, তারপর এর ভিতরে — টেক্সট এবং ক্লাস দ্বারা একটি উপাদান। এটি পছন্দসই কম্পোনেন্টের অনন্য সনাক্তকরণ নিশ্চিত করে। childSelector মেথড খোঁজার পরিধি একটি নির্দিষ্ট কন্টেইনারে সীমাবদ্ধ করে, UI ট্রিতে নেভিগেশন দ্রুত করে।

val scrollView = device.findObject(
    UiSelector().resourceId("android:id/list")
)

// তালিকার ভিতরে, "Wi-Fi" টেক্সট সহ উপাদান খুঁজুন
val wifiItem = scrollView.findObject(
    UiSelector().text("Wi-Fi")
wifiItem.click()

UI Automator দিয়ে ক্রস-অ্যাপ্লিকেশন টেস্টিং

ক্রস-অ্যাপ্লিকেশন (আন্তঃ-অ্যাপ্লিকেশন) টেস্টিং হল প্রধান বৈশিষ্ট্য যার জন্য UI Automator বেছে নেওয়া হয়। ফ্রেমওয়ার্ক অ্যাপের মধ্যে সুইচ করতে পারে, ব্রাউজারের মাধ্যমে OAuth লগইন টেস্ট করতে পারে, সিস্টেম ডায়ালগ (অনুমতি, অ্যাপ নির্বাচক) পরীক্ষা করতে পারে এবং সিস্টেম স্ট্যাটাস বার, নোটিফিকেশন প্যানেল এবং লক স্ক্রিনের সাথে যোগাযোগ করতে পারে।

OAuth লগইন টেস্টিং

একটি সাধারণ ক্রস-অ্যাপ টেস্ট পরিস্থিতি: অ্যাপটি OAuth অনুমোদনের জন্য একটি ব্রাউজার খোলে, ব্যবহারকারী তাদের লগইন এবং পাসওয়ার্ড প্রবেশ করান, এবং ব্রাউজারটি অ্যাপে ফিরে রিডাইরেক্ট করে। UI Automator প্রক্রিয়াগুলির মধ্যে সুইচ করে, ব্রাউজারে ইনপুট ফিল্ড খুঁজে পায়, সেগুলি পূরণ করে এবং “সাইন ইন”-এ ট্যাপ করে।

// ব্রাউজার প্রদর্শিত হওয়ার অপেক্ষা
device.wait(Until.hasObject(
    UiSelector().packageName("com.android.chrome")
), 5000)

// ব্রাউজারে ইমেইল ইনপুট ফিল্ড খোঁজা
val emailField = device.findObject(
    UiSelector().className("android.widget.EditText").instance(0)
)
emailField.text = "user@example.com"

সিস্টেম ডায়ালগ পরীক্ষা করা

UI Automator সিস্টেম ডায়ালগ পরীক্ষা এবং বন্ধ করতে পারে — অবস্থান অনুমতি, নোটিফিকেশন, ফাইল অ্যাক্সেস। প্রথম লঞ্চ পরিস্থিতি টেস্ট করার জন্য এটি গুরুত্বপূর্ণ যখন সিস্টেম ক্রমান্বয়ে একাধিক অনুমতি অনুরোধ করে। UI Automator ছাড়া, এই ধরনের পরিস্থিতি স্বয়ংক্রিয় করা যায় না কারণ সিস্টেম ডায়ালগ অ্যাপ্লিকেশনের প্রক্রিয়ার অন্তর্গত নয়।

UI Automator বনাম Espresso: পদ্ধতির তুলনা

পছন্দ UI Automator এবং Espresso-এর মধ্যে টেস্টিং পরিস্থিতির উপর নির্ভর করে। Espresso স্বয়ংক্রিয় সিঙ্ক্রোনাইজেশন এবং ন্যূনতম boilerplate সহ একক অ্যাপ টেস্টিংয়ের জন্য অপ্টিমাইজ করা। UI Automator সেই পরিস্থিতির জন্য উপযুক্ত যেখানে সিস্টেম, ব্রাউজার বা একাধিক অ্যাপের সাথে যোগাযোগের প্রয়োজন হয়।

ব্যবহারে, এই ফ্রেমওয়ার্কগুলি প্রায়শই একসাথে ব্যবহার করা হয়: Espresso উচ্চ স্থিতিশীলতার সাথে প্রধান অ্যাপের UI টেস্ট কভার করে, যখন UI Automator অ্যাপের সীমানার বাইরে যাওয়া পরিস্থিতির জন্য ব্যবহৃত হয় — OAuth লগইন, সিস্টেম অনুমতি, Share Intent নিয়ে কাজ করা। এই সংমিশ্রণ ন্যূনতম টেস্ট রক্ষণাবেক্ষণ খরচে সর্বাধিক UI কভারেজ প্রদান করে।

Android প্রজেক্টে UI Automator সেটআপ করা

ইন্টিগ্রেশন UI Automator-এর build.gradle-এ নির্ভরতা যোগ করার মাধ্যমে করা হয়। ফ্রেমওয়ার্কটি AndroidX Test-এর অংশ এবং ম্যানিফেস্টে অতিরিক্ত অনুমতির প্রয়োজন নেই — ইন্সট্রুমেন্টেড টেস্ট চালু হলে Accessibility Service-এ অ্যাক্সেস স্বয়ংক্রিয়ভাবে কনফিগার হয়।

Gradle নির্ভরতা

সর্বনিম্ন কনফিগারেশনে uiautomator আর্টিফ্যাক্ট এবং স্ট্যান্ডার্ড AndroidJUnitRunner টেস্ট রানার অন্তর্ভুক্ত। UI Automator টেস্টগুলি src/androidTest ডিরেক্টরিতে রাখা হয় এবং Android API 18+ চালানো ইমুলেটর বা ফিজিক্যাল ডিভাইসে চালানো হয়।

dependencies {
    androidTestImplementation("androidx.test.uiautomator:uiautomator:2.3.0")
    androidTestImplementation("androidx.test.ext:junit:1.2.1")
    androidTestImplementation("androidx.test:runner:1.6.1")
}

UiDevice এবং টেস্ট কনফিগারেশন

UiDevice ইনস্ট্যান্স পেতে InstrumentationRegistry.getInstrumentation() ব্যবহার করা হয়। UiDevice setUp() মেথডে একবার তৈরি করা উচিত এবং ডিভাইস সংস্থান সংরক্ষণের জন্য ক্লাসের সমস্ত টেস্টে পুনরায় ব্যবহার করা উচিত। এটি মনে রাখা গুরুত্বপূর্ণ যে UiDevice থ্রেড-সেফ নয় — সমস্ত অপারেশন টেস্ট মেথডের একই থ্রেডে সম্পাদন করা উচিত। প্রতিটি টেস্টে নতুন UiDevice তৈরি করা ওভারহেড সৃষ্টি করে এবং এক্সিকিউশন ধীর করে দেয়। beforeClass মেথডে একবার UiDevice তৈরি করে টেস্ট ক্লাসের সমস্ত টেস্টের জন্য পুনরায় ব্যবহার করার পরামর্শ দেওয়া হয়।

UI Automator-এ অপেক্ষা

Espresso-এর বিপরীতে, UI Automator-এ স্বয়ংক্রিয় সিঙ্ক্রোনাইজেশন নেই। উপাদান প্রদর্শিত হওয়ার জন্য অপেক্ষা করতে UiDevice.wait(condition, timeout) মেথড Until অবজেক্টের সাথে ব্যবহার করা হয়: Until.findObject(selector), Until.hasObject(selector), Until.gone(selector)। সঠিক অপেক্ষা ছাড়া, রেস কন্ডিশনের কারণে টেস্টগুলি অস্থির হয়ে যায় — খোঁজার সময় একটি উপাদান স্ক্রিনে উপস্থিত নাও হতে পারে। স্থিতিশীলতার জন্য কমপক্ষে 3–5 সেকেন্ডের টাইমআউট সেট করার পরামর্শ দেওয়া হয়।