UI Automator: คืออะไร แนวคิดหลัก และทำงานอย่างไร

UI Automator คืออะไร?

UI Automator เป็นเฟรมเวิร์กสำหรับการทดสอบ UI เชิงฟังก์ชันของ Android ที่ทำงานในระดับระบบปฏิบัติการ มันให้ API สำหรับเข้าถึงองค์ประกอบใดๆ บนหน้าจออุปกรณ์ ไม่ว่าองค์ประกอบนั้นจะเป็นของแอปพลิเคชันใด — รวมถึงแถบสถานะระบบ ไดอะล็อกสิทธิ์ หน้าจอหลัก และแอปของบุคคลที่สาม สิ่งนี้ทำให้มันขาดไม่ได้สำหรับการทดสอบสถานการณ์ที่เกินกว่าแอปพลิเคชันเดียว

ในเชิงสถาปัตยกรรม UI Automator ใช้ Accessibility Service — บริการเดียวกับที่ TalkBack, Switch Access และเครื่องมือการเข้าถึงอื่นๆ ใช้ ผ่านบริการนี้ เฟรมเวิร์กจะได้รับ UI คอมโพเนนต์ทรีที่สมบูรณ์ของหน้าจอปัจจุบันและอนุญาตให้ดำเนินการกับองค์ประกอบเหล่านั้น: การแตะ การปัด การป้อนข้อความ และการกดค้าง

UI Automator ปรากฏครั้งแรกใน Android 4.3 (API 18) และตั้งแต่นั้นมาเป็นส่วนหนึ่งของ Android Testing Support Library ในฐานะเครื่องมืออย่างเป็นทางการของ Google สำหรับการทดสอบข้ามแอปพลิเคชัน ใน AndroidX Test มันพร้อมใช้งานเป็นอาร์ติแฟกต์แยกต่างหาก androidx.test.uiautomator:uiautomator เวอร์ชัน 2.3.0 (2024) ซึ่งรองรับ Android ทุกเวอร์ชันตั้งแต่ API 18

UI Automator ทำงานอย่างไร

หลักการทำงาน: UI Automator อาศัยการสแกน Accessibility ทรีของหน้าจอปัจจุบัน เมื่อเรียกเมธอด findObject(selector) เฟรมเวิร์กจะสำรวจลำดับชั้นของ View ค้นหาองค์ประกอบแรกที่ตรงกับเงื่อนไขของ UiSelector และส่งคืน UiObject — ตัวแทนสำหรับโต้ตอบกับ View จริง

วงจรชีวิตการทดสอบ UI Automator

การทดสอบ UI Automator ทั่วไปเริ่มต้นด้วยการรับอินสแตนซ์ของ UiDevice ซึ่งแสดงถึงอุปกรณ์จริง UiDevice มีเมธอดสำหรับค้นหาองค์ประกอบ จัดการการกดปุ่ม (Home, Back, Recent) หมุนหน้าจอ และจับภาพหน้าจอ หลังจากค้นหาองค์ประกอบผ่าน 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 เป็นคลาสหลักสำหรับโต้ตอบกับอุปกรณ์ มันมีเมธอดสำหรับค้นหาองค์ประกอบ จำลองการกดปุ่มฮาร์ดแวร์ (Home, Back, Menu, Volume) จัดการพลังงาน จับภาพหน้าจอ และรอสถานะหน้าจอที่เฉพาะเจาะจง UiDevice ถูกสร้างขึ้นหนึ่งครั้งต่อการทดสอบและนำมาใช้ซ้ำสำหรับการดำเนินการทั้งหมด

UiSelector เป็น API แบบลื่นไหลสำหรับค้นหาองค์ประกอบ UI ต่างจาก 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 ถูกปรับให้เหมาะสมสำหรับการทดสอบแอปเดียวด้วยการซิงโครไนซ์อัตโนมัติและโค้ดพื้นฐานที่น้อยที่สุด UI Automator เหมาะสำหรับสถานการณ์ที่ต้องโต้ตอบกับระบบ เบราว์เซอร์ หรือหลายแอป

ในทางปฏิบัติ เฟรมเวิร์กเหล่านี้มักใช้ ร่วมกัน: Espresso ครอบคลุมการทดสอบ UI ของแอปหลักด้วยความเสถียรสูง ในขณะที่ UI Automator ถูกนำมาใช้สำหรับสถานการณ์ที่เกินขอบเขตของแอป — การเข้าสู่ระบบ OAuth สิทธิ์ระบบ การทำงานกับ Share Intent การรวมกันนี้ให้ความครอบคลุม UI สูงสุดด้วยต้นทุนการบำรุงรักษาการทดสอบที่น้อยที่สุด

การตั้งค่า UI Automator ในโปรเจกต์ Android

การผสานรวม UI Automator ทำได้โดยเพิ่มการพึ่งพาใน build.gradle เฟรมเวิร์กเป็นส่วนหนึ่งของ AndroidX Test และไม่ต้องการสิทธิ์เพิ่มเติมใน manifest — การเข้าถึง 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 ใหม่ในแต่ละการทดสอบทำให้เกิดโอเวอร์เฮดและทำให้การทำงานช้าลง ขอแนะนำให้สร้าง UiDevice ครั้งเดียวในเมธอด beforeClass และนำมาใช้ซ้ำสำหรับการทดสอบทั้งหมดของคลาสทดสอบ

การรอใน UI Automator

ต่างจาก Espresso ตรงที่ UI Automator ไม่มีการซิงโครไนซ์อัตโนมัติ เพื่อรอให้องค์ประกอบปรากฏ ให้ใช้เมธอด UiDevice.wait(condition, timeout) กับออบเจกต์ Until: Until.findObject(selector), Until.hasObject(selector), Until.gone(selector) หากไม่มีการรอที่เหมาะสม การทดสอบจะไม่เสถียรเนื่องจากสภาวะการแข่งขัน — องค์ประกอบอาจยังไม่ปรากฏบนหน้าจอในเวลาที่ค้นหา ขอแนะนำให้ตั้งค่ากำหนดเวลาไม่น้อยกว่า 3–5 วินาทีเพื่อความเสถียร