이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Uiautomator 테스트

교차 앱 기능 UI 테스트를 위한 프레임워크

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2025년 5월 20일	2.3.0	-	-	2.4.0-alpha03

종속 항목 선언

테스트 관련 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation "androidx.test.uiautomator:uiautomator:2.4.0-alpha03"
}

Kotlin

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation("androidx.test.uiautomator:uiautomator:2.4.0-alpha03")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 2.4

버전 2.4.0-alpha03

2025년 5월 20일

androidx.test.uiautomator:uiautomator:2.4.0-alpha03이 출시되었습니다. 버전 2.4.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

버그 수정

경우에 따라 waitForStableInActiveWindow에서 NPE가 발생하는 문제를 수정했습니다. (Ibf50f, b/417046391)

버전 2.4.0-alpha02

2025년 5월 7일

androidx.test.uiautomator:uiautomator:2.4.0-alpha02이 출시되었습니다. 버전 2.4.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

새 Uiautomator API의 초기 형식입니다. UiAutomatorTestScope는 새 onView API에 액세스할 수 있는 팩토리 uiAutomator를 통해 만들 수 있습니다.
AccessibilityNodeInfo#getText 사용에 관한 경고를 제공하고 textAsString 사용을 제안하는 초기 린트 규칙

API 변경사항

모든 검색을 (Icdf17)으로 제한하도록 디스플레이 ID를 설정하는 Configurator#setDefaultDisplayId를 추가했습니다.
편의를 위해 Searchable (UiDevice 및 UiObject2에서 공유하는 인터페이스)를 공개로 변경했습니다. (I67f18)

버그 수정

UiDevice#pressKeyCodes에서 메타 키 처리를 수정했습니다. (I73f80).
항상 Z 순서로 루트를 반환하도록 UiDevice#getWindowRoots를 업데이트했습니다. (I87426)
특정 동작이 불완전하게 실행되는 문제를 수정했습니다. (I60dd3, If4edd)
UiDevice#scrollUntil를 호출할 때 발생하는 드문 무한 루프를 수정했습니다. (I39989)

버전 2.4.0-alpha01

2024년 6월 26일

androidx.test.uiautomator:uiautomator:2.4.0-alpha01이 출시되었습니다. 버전 2.4.0-alpha01에는 이 커밋이 포함되어 있습니다.

API 변경사항

텍스트가 키 누르기가 아닌 직접 삽입되므로 매개변수가 더 이상 사용되지 않으므로 Configurator#getKeyInjectionDelay 및 setKeyInjectionDelay를 지원 중단했습니다. (I3bcc5).

버그 수정

동적 화면 재생 빈도 (예: 스무스 디스플레이)를 고려하도록 UiObject2 모션 이벤트 간의 지연을 업데이트했습니다. (I43f12)
접근성 캐시를 주기적으로 무효화하여 특정 UI의 접근성 노드 비활성 상태로 인한 불안정성을 줄였습니다 (I3be25).
비활성 UiObject2에서 toString 또는 hashCode를 호출할 때 발생하는 StaleObjectException를 수정했습니다. (I38ea1).
불필요한 waitForIdle 호출을 건너뛰어 UiWatcher 성능을 개선했습니다. (I8c65e)
특히 각 Configurator 매개변수가 사용되는 시점을 명확히 하기 위해 javadoc 부정확성을 수정했습니다. (Ie10b1, I71631).

버전 2.3.0

2024년 2월 21일

androidx.test.uiautomator:uiautomator:2.3.0이 출시되었습니다. 버전 2.3.0에 포함된 커밋을 확인하세요.

2.2.0 이후 중요 변경사항

다중 디스플레이 지원: 여러 디스플레이에서 객체를 찾고 작업하는 기능과 보조 디스플레이를 관리하는 UiDevice 메서드가 추가되었습니다 (Ie6544, I912cd).
새로운 선택기:
- 디스플레이 ID로 객체를 선택하는 By.displayId를 추가했습니다. (I1825b)
- 상위 요소에 따라 객체를 선택하는 By.hasParent 및 By.hasAncestor를 추가했습니다. (I93c36)
- 힌트 텍스트로 객체를 선택하는 By.hint 메서드를 추가했습니다 (Idd345).
맞춤 조건: 맞춤 대기 조건을 지원하도록 Condition 인터페이스를 노출하고 상응하는 UiDevice#wait, UiObject2#wait, UiObject2#scrollUntil 메서드 (27c0ea, 099d6e)를 추가했습니다.
버그 수정 및 안정성
- 디스플레이 크기 계산이 잘못되어 화면의 일부가 무시될 수 있는 문제를 수정했습니다. (Ifc016) 테스트에 사용되는 좌표와 오프셋을 조정해야 할 수 있습니다.
- 정확성 (678ca3)을 개선하고 사용자 동작을 더 잘 에뮬레이션하도록 MotionEvent 삽입을 업데이트했습니다. (454450)
- 스크롤 (I7b059), 회전 (c6cea0), 길게 클릭 (49572b), 핀치 (3c619a) 등의 안정성을 개선했습니다.

버전 2.3.0-rc01

2024년 2월 7일

androidx.test.uiautomator:uiautomator:2.3.0-rc01은 변경사항 없이 출시되었습니다. 버전 2.3.0-rc01에 포함된 커밋을 확인하세요.

버전 2.3.0-beta01

2023년 12월 13일

androidx.test.uiautomator:uiautomator:2.3.0-beta01이 출시되었습니다. 버전 2.3.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

일관성을 위해 UiObject2 비율 기반 여백 메서드의 이름을 setGestureMarginPercentage 및 setGestureMarginsPercentage로 변경했습니다. (I24435)

버그 수정

보조 디스플레이를 찾을 수 없거나 액세스할 수 없는 경우 발생하는 오류를 개선했습니다. (116b23)

버전 2.3.0-alpha05

2023년 11월 1일

androidx.test.uiautomator:uiautomator:2.3.0-alpha05이 출시되었습니다. 버전 2.3.0-alpha05에 포함된 커밋을 확인하세요.

API 변경사항

그리기 순서 (z 인덱스) 정보를 노출하는 UiObject2#getDrawingOrder를 추가했습니다. (I5dfa4)
보조 디스플레이의 회전을 가져오고, 설정하고, 고정하고, 고정 해제하는 UiDevice 메서드를 추가했습니다. (I912cd).

버그 수정

스크롤의 끝을 감지할 수 없는 경우 UiObject2#scrollUntil에 재시도를 추가했습니다. (Ibac6f)
UiDevice가 다시 생성되면 비활성 Instrumentation 인스턴스를 사용하는 문제를 수정했습니다. (I18cae)
노드를 덤핑할 때 디스플레이 ID를 확인할 수 없는 경우 발생할 수 있는 NPE를 수정했습니다. (Icafcb)
클릭 불가/스크롤 불가 객체에서 클릭/스크롤을 실행할 때 경고를 추가했습니다 (I4a5d9).
안정성을 개선하기 위해 기본 UiObject2 스크롤 속도를 줄였습니다 (I5e071).

버전 2.3.0-alpha04

2023년 7월 26일

androidx.test.uiautomator:uiautomator:2.3.0-alpha04이 출시되었습니다. 버전 2.3.0-alpha04에 포함된 커밋을 확인하세요.

API 변경사항

상위 요소에 따라 객체를 찾을 수 있도록 By.hasParent 및 By.hasAncestor를 추가했습니다. (I93c36)
객체의 힌트 텍스트를 가져오는 UiObject2#getHint와 힌트 텍스트에 따라 객체를 선택하는 By.hint 메서드를 추가했습니다 (Idd345).
By.displayId를 추가하여 객체가 있는 디스플레이에 따라 객체를 선택할 수 있도록 지원했습니다 (I1825b).
디스플레이의 크기를 ID (Ie6544)로 찾는 UiDevice#getDisplayHeight(int) 및 UiDevice#getDisplayWidth(int) 메서드를 추가했습니다.
이전 버전과의 호환성을 위해 wait(SearchCondition, long) 및 wait(UiObject2Condition, long) 메서드를 다시 추가했습니다. (Iebfda)
UiDevice#executeShellCommand를 숨김이 아닌 공개로 변경했지만 권장하지 않습니다 (Ic48a1).

버그 수정

속도보다 동작 정확성을 우선하여 불안정성을 줄이기 위해 MotionEvent 삽입을 업데이트했습니다. (678ca3)
성능 병목 현상을 식별하기 위해 리소스 사용량이 많은 메서드에 추적을 추가했습니다 (d17de3).
UiAutomation 연결을 시작할 때 재시도 메커니즘을 추가했습니다 (048caf).
UiDevice#dumpWindowHierarchy의 null 노드에서 발생할 수 있는 NPE를 수정했습니다. (b725eb)
비공개 디스플레이를 쿼리하거나 작업할 때 발생하는 예기치 않은 오류를 수정했습니다. (985db6, 7053d4)

버전 2.3.0-alpha03

2023년 4월 19일

androidx.test.uiautomator:uiautomator:2.3.0-alpha03이 출시되었습니다. 버전 2.3.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

Until의 내장 항목에만 의존하지 않고 맞춤 대기 조건을 허용하도록 Condition 인터페이스를 노출하고 이 인터페이스를 수용하도록 UiDevice#wait 및 UiObject2#wait 메서드를 업데이트했습니다 (27c0ea).
조건이 충족될 때까지 스크롤을 지원하고 UiScrollable와 동등성을 유지하도록 UiObject2#scrollUntil를 추가했습니다. (099d6e)
기기 유형 간에 회전을 용이하게 하는 UiDevice#setOrientationPortrait 및 setOrientationLandscape를 추가했습니다. (e13cb7)
객체 크기를 기준으로 여백을 설정할 수 있도록 UiObject2#setGestureMarginPercent를 추가했습니다. (Ib8c77)

버그 수정

SDK 18~22에서 가끔 잘못된 좌표를 사용하는 UiScrollable 메서드가 수정되었습니다. (b53ece)
SDK 18 및 19에서 UiObject2#setText 및 clearText가 텍스트를 수정하지 못하는 문제를 수정했습니다 (77e41d).
UiWatcher가 올바른 순서로 실행되지 않는 문제를 수정했습니다 (c85f92).
UiDevice 방향 변경 후 기기 회전이 아직 완료되지 않을 수 있는 문제를 수정했습니다. (c6cea0)
길게 클릭, 드래그, 핀치의 안정성이 향상되었습니다. (49572b, 3c619a)

버전 2.3.0-alpha02

2023년 1월 11일

androidx.test.uiautomator:uiautomator:2.3.0-alpha02가 출시되었습니다. 버전 2.3.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

라이브러리 전반에서 로깅을 재작업하여 더 많은 정보를 제공하고 발생 가능한 문제를 경고하고 일관성을 개선했습니다.
동시에 여러 키 누르기(예: POWER와 VOLUME_DOWN을 눌러 스크린샷 찍기)를 지원하는 UiDevice#pressKeyCodes를 추가했습니다. (22e525)
UiDevice#setCompressedLayoutHierarchy를 추가하고 UiDevice#setCompressedLayoutHeirarchy를 지원 중단하여 메서드 이름의 오타를 수정했습니다. (4e2f65)
UiAutomatorInstrumentationTestRunner는 지원 중단된 UiAutomatorTestCase를 처리하고 더 이상 필요하지 않으므로 지원 중단됨으로 표시했습니다. (be6c85)
사용자 동작을 더 잘 에뮬레이션하도록 UiObject2 MotionEvent 간의 지연 시간을 화면 재생 빈도의 두 배로 업데이트했습니다. (454450)
여러 줄 텍스트 및 설명 일치 지원을 추가했습니다. (1625e6, b/255787130)

버그 수정

객체를 쿼리하거나 기다리는 동안 가끔 발생하는 StaleObjectException 문제를 수정했습니다. (4cbcc0)
UiScrollable#scrollToBeginning, scrollToEnd, flingToBeginning, flingToEnd의 반환 값이 시작/끝에 도달했는지 여부를 표시하지 않는 문제를 수정했습니다. (d33e06)
UiScrollable#scrollForward 및 scrollBackward 메서드가 구성된 제한 시간을 무시하는 문제를 수정했습니다. (29e4f3)
BySelector 복사 생성자가 깊이 선택기를 처리하지 않는 문제를 수정했습니다. (6c7b91)
UiObject#pinchIn 및 pinchOut에서 잘못된 백분율 값 처리 문제를 수정했습니다. (01b973)
드물지만 기본 UiAutomation 연결이 재설정되면 멀티 윈도우 지원이 중단되는 문제를 수정했습니다. (1bb956)

버전 2.3.0-alpha01

2022년 9월 7일

androidx.test.uiautomator:uiautomator:2.3.0-alpha01이 출시되었습니다. 버전 2.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

모든 공개 메서드에 nullness 주석을 추가했습니다.
더 원활한 UiObject2 동작을 위해 MotionEvent 삽입을 짧은 지연이 있는 비동기식으로 전환했습니다.
기다리는 동안 폴링 간격을 1000ms에서 100ms로 줄였습니다.
전원 버튼을 재정의하는 기기를 지원하기 위해 KEYCODE_WAKEUP과 KEYCODE_SLEEP을 사용하도록 UiDevice#wakeUp과 UiDevice#sleep을 업데이트했습니다.
여러 디스플레이에서 객체를 찾고 관리하기 위해 UiObject2#getDisplayId와 관련 지원을 추가했습니다.
좌표를 사용하여 점을 클릭하는 UiObject#click 및 UiObject2#clickAndWait 메서드를 추가했습니다.

버그 수정

디스플레이 크기가 잘못 계산되어 특히 멀티 윈도우 모드에서 화면의 일부가 무시될 수 있는 문제를 수정했습니다. (Ifc016c)
UiDevice#takeScreenshot에서 발생하던 스크린샷 확장 문제를 수정했습니다. (Id80ad6)
Until.scrollFinished 및 UiObject2#scroll의 안정성을 개선했습니다. (I7b0595)
엄격 모드 IncorrectContextUseViolation 경고를 수정했습니다. (Iffa6a0)