Spectatio는 실제 기기와 가상 기기에서 Android Automotive OS(AAOS)를 테스트하려고 개발된 오픈소스 테스트 프레임워크입니다. Spectatio는 확장 가능하고 확장 가능한 솔루션입니다. AAOS 및 앱의 기능과 성능을 확인하는 데 사용됩니다.
대략적인 구성
Spectatio 프레임워크는 다양한 AAOS UI 구현에 맞게 조정 가능하고 확장 가능합니다. AAOS의 기능과 성능을 테스트하는 데 사용됩니다. 가상 환경에서 애플리케이션을 실행하는 데 사용할 수 있습니다.
다음 그림은 Spectatio 프레임워크의 대략적인 구성을 설명합니다.
그림 1. Spectatio 프레임워크의 대략적인 구성
UI Automator를 기반으로 빌드된 Spectatio 프레임워크는 일련의 API를 제공합니다. 를 사용하여 AAOS에서 사용자 및 시스템 앱과 상호작용하는 UI 테스트를 빌드합니다. 자동차 테스트는 Spectatio 프레임워크에서 제공하는 API를 사용하여 이러한 테스트는 테스트 대상 기기 (DUT)와 별개이며 테스트를 위해 확장 가능합니다. 다양한 기기(지원되는 경우)
그림 1은 Spectatio 프레임워크가 앱별 인터페이스와 도우미를 사용하여 다이얼러, Medicenter, 설정과 같은 참조 앱을 바탕으로 모듈화되므로 새 앱에 맞도록 쉽게 확장 가능함을 보여줍니다. Spectatio 프레임워크는 공통 표준 및 유틸리티 도우미 클래스를 재사용합니다. 표준 도우미 클래스 는 모든 앱 도우미 함수의 상위 클래스이며 앱에 적용할 수 있는 표준 기능이 포함됩니다. 유틸리티 도우미 클래스는 기기에서 파일 읽기 또는 쓰기와 같은 유틸리티를 제공합니다.
아키텍처
Spectatio 프레임워크는 UI 테스트 빌드를 위한 API 세트를 제공하기 위해 기존 표준 도우미를 확장하는 동시에 앱별 인터페이스 및 도우미 유틸리티 도우미 클래스를 가져옵니다.
그림 2는 Spectatio 프레임워크의 개략적인 아키텍처와 앱 테스트를 위한 API 구현과 관련된 모든 항목이 포함됩니다.
그림 2. Spectatio 프레임워크의 대략적인 아키텍처
앱 도우미 인터페이스는
앱 도우미가 있습니다 앱 테스트에 필요한 다양한 도우미 함수로 구성됩니다. 각 앱에는 IAutoSettingHelper 및 IAutoDialHelper와 같은 자체 인터페이스가 있습니다.
자세한 내용과 인터페이스 함수 목록은 AOSP의 앱 도우미 인터페이스 함수를 참고하세요.
표준 도우미 클래스는 기기 설정에 필요하지만 앱과는 관련이 없는 표준 속성과 함수로 구성됩니다(예: pressHome, scroll). 표준 도우미 클래스는 AbstractAutoStandardAppHelper.java에 정의되어 있습니다.
유틸리티 도우미 클래스는 Spectatio 프레임워크에 의해 사용됩니다. 대상
예를 들어 AutoJsonUtility.java는
지정된 기기 JSON 구성 파일을 로드하고 업데이트하는 유틸리티 클래스입니다.
런타임 시 프레임워크 구성을
제어할 수 있습니다
앱 도우미 구현 모듈은 Spectatio의 핵심입니다.
프레임워크입니다 이 파일에는
앱 도우미 인터페이스를 제공합니다.
사용할 수 있습니다. 각 앱에는 SettingHelperImpl와 같은 자체 구현이 있습니다.
및
DialHelperImpl님,
사용 주체
앱 테스트를 위한 Automotive 테스트입니다. 최신 버전의 목록에 대한 자세한 내용과
자세한 내용은 앱 도우미 구현 함수를 참고하세요.
지원했습니다.
자동차 테스트
앱 도우미 구현 함수를 사용하여 다양한 작업 테스트
앱과 관련된 문제일 수 있습니다. HelperAccessor 클래스 사용하기
앱 도우미 구현 함수에 액세스할 수 있습니다.
다음 코드는 샘플 Automotive 테스트의 설정, 정리, 실행을 보여줍니다.
@RunWith(AndroidJUnit4.class)
public class AutoApplicationTest {
static HelperAccessor<IAutoApplicationHelper> autoApplicationHelper =
new HelperAccessor<>(IAutoApplicationHelper.class);
public AutoApplicationTest() {
// constructor
// Initialize any attributes that are required for the test execution
}
@Before
public void beforeTest() {
// Initial setup before each test
// For example - open the app
autoApplicationHelper.open();
}
@After
public void afterTest() {
// Cleanup after each test.
// For example - exit the app
autoApplicationHelper.exit();
}
@Test
public void testApplicationFeature() {
// Test
// For example - Test if app is open
assertTrue("Application is not open.", autoApplicationHelper.isOpen());
}
}
맞춤설정
Spectatio 프레임워크는 기기 UI와는 별개이므로 다양한 UI와 하드웨어를 사용하는 기기 테스트를 위해 확장 가능합니다. Spectatio에서는 확장성을 실현하기 위해 참조 기기에 기반한 기본 기기 설정을 사용하고 받는사람
기본이 아닌 기기 설정을 지원할 경우 프레임워크는 JSON
구성 파일을 사용하여 기기에 원하는 UI 변경사항을 설정합니다. 가
JSON 구성 파일은 TEXT, DESCRIPTION,
RESOURCE_ID 및 path 설정. 정보만 포함해야 함
DUT의 UI 변경사항에 관해 알아봅니다. 나머지 UI 요소는
구성 값을 사용할 수 있습니다.
기본 기기 설정
다음 샘플 JSON 구성 파일은 사용 가능한 기기 설정 및 기본값을 보여줍니다.
샘플 JSON을 표시하려면 여기를 클릭하세요. 구성 파일
{
"SETTINGS": {
"APPLICATION_CONFIG": {
"SETTINGS_TITLE_TEXT": "Settings",
"SETTINGS_PACKAGE": "com.android.car.settings",
"SETTINGS_RRO_PACKAGE": "com.android.car.settings.googlecarui.rro",
"OPEN_SETTINGS_COMMAND": "am start -a android.settings.SETTINGS",
"OPEN_QUICK_SETTINGS_COMMAND": "am start -n com.android.car.settings/com.android.car.settings.common.CarSettingActivity"
},
"QUICK_SETTINGS": {
"OPEN_MORE_SETTINGS": {
"TYPE": "RESOURCE_ID",
"VALUE": "toolbar_menu_item_1",
"PACKAGE": "com.android.car.settings"
},
"NIGHT_MODE": {
"TYPE": "TEXT",
"VALUE": "Night mode"
}
},
"DISPLAY": {
"PATH": "Settings > Display",
"OPTIONS": [
"Brightness level"
],
"BRIGHTNESS_LEVEL": {
"TYPE": "RESOURCE_ID",
"VALUE": "seekbar",
"PACKAGE": "com.android.car.settings"
}
},
"SOUND": {
"PATH": "Settings > Sound",
"OPTIONS": [
"Media volume",
"Alarm volume"
]
},
"NETWORK_AND_INTERNET": {
"PATH": "Settings > Network & internet",
"OPTIONS": [
],
"TOGGLE_WIFI": {
"TYPE": "RESOURCE_ID",
"VALUE": "master_switch",
"PACKAGE": "com.android.car.settings"
}
},
"BLUETOOTH": {
"PATH": "Settings > Bluetooth",
"OPTIONS": [
],
"TOGGLE_BLUETOOTH": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_toolbar_menu_item_switch",
"PACKAGE": "com.android.car.settings"
}
},
"APPS_AND_NOTIFICATIONS": {
"PATH": "Settings > Apps & notifications",
"OPTIONS": [
],
"SHOW_ALL_APPS": {
"TYPE": "TEXT",
"VALUE": "Show all apps"
},
"ENABLE_DISABLE_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_toolbar_menu_item_text",
"PACKAGE": "com.android.car.settings"
},
"DISABLE_BUTTON_TEXT": {
"TYPE": "TEXT",
"VALUE": "Disable"
},
"ENABLE_BUTTON_TEXT": {
"TYPE": "TEXT",
"VALUE": "Enable"
},
"DISABLE_APP_BUTTON": {
"TYPE": "TEXT",
"VALUE": "DISABLE APP"
},
"FORCE_STOP_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Force stop"
},
"OK_BUTTON": {
"TYPE": "TEXT",
"VALUE": "OK"
},
"PERMISSIONS_MENU": {
"TYPE": "TEXT",
"VALUE": "Permissions"
},
"ALLOW_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Allow"
},
"DENY_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Deny"
},
"DENY_ANYWAY_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Deny anyway"
}
},
"DATE_AND_TIME": {
"PATH": "Settings > Date & time",
"OPTIONS": [
"Automatic date & time",
"Automatic time zone"
],
"AUTOMATIC_DATE_AND_TIME": {
"TYPE": "TEXT",
"VALUE": "Automatic date & time"
},
"AUTOMATIC_TIME_ZONE": {
"TYPE": "TEXT",
"VALUE": "Automatic time zone"
},
"SET_DATE": {
"TYPE": "TEXT",
"VALUE": "Set date"
},
"SET_TIME": {
"TYPE": "TEXT",
"VALUE": "Set time"
},
"SELECT_TIME_ZONE": {
"TYPE": "TEXT",
"VALUE": "Select time zone"
},
"USE_24_HOUR_FORMAT": {
"TYPE": "TEXT",
"VALUE": "Use 24-hour format"
},
"OK_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "toolbar_menu_item_0",
"PACKAGE": "com.android.car.settings"
},
"NUMBER_PICKER_WIDGET": {
"TYPE": "CLASS",
"VALUE": "android.widget.NumberPicker"
},
"EDIT_TEXT_WIDGET": {
"TYPE": "CLASS",
"VALUE": "android.widget.EditText"
}
},
"USERS": {
"PATH": "Settings > Users",
"OPTIONS": [
"Guest"
]
},
"ACCOUNTS": {
"PATH": "Settings > Accounts",
"OPTIONS": [
"Automatically sync data"
],
"ADD_ACCOUNT": {
"TYPE": "TEXT",
"VALUE": "ADD ACCOUNT"
},
"ADD_GOOGLE_ACCOUNT": {
"TYPE": "TEXT",
"VALUE": "Google"
},
"SIGN_IN_ON_CAR_SCREEN": {
"TYPE": "TEXT",
"VALUE": "Sign in on car screen"
},
"GOOGLE_SIGN_IN_SCREEN": {
"TYPE": "TEXT",
"VALUE": "Sign in to your Google Account"
},
"ENTER_EMAIL": {
"TYPE": "CLASS",
"VALUE": "android.widget.EditText"
},
"ENTER_PASSWORD": {
"TYPE": "CLASS",
"VALUE": "android.widget.EditText"
},
"NEXT_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Next"
},
"DONE_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Done"
},
"REMOVE_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Remove"
},
"REMOVE_ACCOUNT_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Remove Account"
}
},
"SYSTEM": {
"PATH": "Settings > System",
"OPTIONS": [
"About", "Legal information"
],
"ABOUT_MENU": {
"TYPE": "TEXT",
"VALUE": "About"
},
"RESET_OPTIONS_MENU": {
"TYPE": "TEXT",
"VALUE": "Reset options"
},
"LANGUAGES_AND_INPUT_MENU": {
"TYPE": "TEXT",
"VALUE": "Languages & input"
},
"DEVICE_MODEL": {
"TYPE": "TEXT",
"VALUE": "Model"
},
"ANDROID_VERSION": {
"TYPE": "TEXT",
"VALUE": "Android version"
},
"ANDROID_SECURITY_PATCH_LEVEL": {
"TYPE": "TEXT",
"VALUE": "Android security patch level"
},
"KERNEL_VERSION": {
"TYPE": "TEXT",
"VALUE": "Kernel version"
},
"BUILD_NUMBER": {
"TYPE": "TEXT",
"VALUE": "Build number"
},
"RECYCLER_VIEW_WIDGET": {
"TYPE": "CLASS",
"VALUE": "androidx.recyclerview.widget.RecyclerView"
},
"RESET_NETWORK": {
"TYPE": "TEXT",
"VALUE": "Reset network"
},
"RESET_SETTINGS": {
"TYPE": "TEXT",
"VALUE": "RESET SETTINGS"
},
"RESET_APP_PREFERENCES": {
"TYPE": "TEXT",
"VALUE": "Reset app preferences"
},
"RESET_APPS": {
"TYPE": "TEXT",
"VALUE": "RESET APPS"
},
"LANGUAGES_MENU": {
"TYPE": "TEXT",
"VALUE": "Languages"
},
"LANGUAGES_MENU_IN_SELECTED_LANGUAGE": {
"TYPE": "TEXT",
"VALUE": "Idiomas"
}
},
"SECURITY": {
"PATH": "Settings > Security",
"OPTIONS": [
],
"TITLE": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_toolbar_title",
"PACKAGE": "com.android.car.settings.googlecarui.rro"
},
"CHOOSE_LOCK_TYPE": {
"TYPE": "TEXT",
"VALUE": "Choose a lock type"
},
"LOCK_TYPE_PASSWORD": {
"TYPE": "TEXT",
"VALUE": "Password"
},
"LOCK_TYPE_PIN": {
"TYPE": "TEXT",
"VALUE": "PIN"
},
"LOCK_TYPE_NONE": {
"TYPE": "TEXT",
"VALUE": "None"
},
"CONTINUE_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Continue"
},
"CONFIRM_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Confirm"
},
"ENTER_PASSWORD": {
"TYPE": "CLASS",
"VALUE": "android.widget.EditText"
},
"PIN_PAD": {
"TYPE": "RESOURCE_ID",
"VALUE": "pin_pad",
"PACKAGE": "com.android.car.settings"
},
"ENTER_PIN_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "key_enter",
"PACKAGE": "com.android.car.settings"
},
"REMOVE_BUTTON": {
"TYPE": "TEXT",
"VALUE": "Remove"
}
}
},
"PHONE": {
"APPLICATION_CONFIG": {
"DIAL_PACKAGE": "com.android.car.dialer",
"PHONE_ACTIVITY": "com.android.car.dialer/.ui.TelecomActivity",
"OPEN_DIAL_PAD_COMMAND": "am start -a android.intent.action.DIAL"
},
"IN_CALL_VIEW": {
"DIALED_CONTACT_TITLE": {
"TYPE": "RESOURCE_ID",
"VALUE": "user_profile_title",
"PACKAGE": "com.android.car.dialer"
},
"DIALED_CONTACT_NUMBER": {
"TYPE": "RESOURCE_ID",
"VALUE": "user_profile_phone_number",
"PACKAGE": "com.android.car.dialer"
},
"END_CALL": {
"TYPE": "RESOURCE_ID",
"VALUE": "end_call_button",
"PACKAGE": "com.android.car.dialer"
},
"MUTE_CALL": {
"TYPE": "RESOURCE_ID",
"VALUE": "mute_button",
"PACKAGE": "com.android.car.dialer"
},
"SWITCH_TO_DIAL_PAD": {
"TYPE": "RESOURCE_ID",
"VALUE": "toggle_dialpad_button",
"PACKAGE": "com.android.car.dialer"
},
"CHANGE_VOICE_CHANNEL": {
"TYPE": "RESOURCE_ID",
"VALUE": "voice_channel_view",
"PACKAGE": "com.android.car.dialer"
},
"VOICE_CHANNEL_CAR": {
"TYPE": "TEXT",
"VALUE": "Car speakers"
},
"VOICE_CHANNEL_PHONE": {
"TYPE": "TEXT",
"VALUE": "Phone"
}
},
"DIAL_PAD_VIEW": {
"DIAL_PAD_MENU": {
"TYPE": "TEXT",
"VALUE": "Dial Pad"
},
"DIAL_PAD_FRAGMENT": {
"TYPE": "RESOURCE_ID",
"VALUE": "dialpad_fragment",
"PACKAGE": "com.android.car.dialer"
},
"DIALED_NUMBER": {
"TYPE": "RESOURCE_ID",
"VALUE": "title",
"PACKAGE": "com.android.car.dialer"
},
"MAKE_CALL": {
"TYPE": "RESOURCE_ID",
"VALUE": "call_button",
"PACKAGE": "com.android.car.dialer"
},
"DELETE_NUMBER": {
"TYPE": "RESOURCE_ID",
"VALUE": "delete_button",
"PACKAGE": "com.android.car.dialer"
}
},
"CONTACTS_VIEW": {
"CONTACTS_MENU": {
"TYPE": "TEXT",
"VALUE": "Contacts"
},
"CONTACT_INFO": {
"TYPE": "RESOURCE_ID",
"VALUE": "call_action_id",
"PACKAGE": "com.android.car.dialer"
},
"CONTACT_NAME": {
"TYPE": "RESOURCE_ID",
"VALUE": "title",
"PACKAGE": "com.android.car.dialer"
},
"CONTACT_DETAIL": {
"TYPE": "RESOURCE_ID",
"VALUE": "show_contact_detail_id",
"PACKAGE": "com.android.car.dialer"
},
"ADD_CONTACT_TO_FAVORITE": {
"TYPE": "RESOURCE_ID",
"VALUE": "contact_details_favorite_button",
"PACKAGE": "com.android.car.dialer"
},
"SEARCH_CONTACT": {
"TYPE": "RESOURCE_ID",
"VALUE": "menu_item_search",
"PACKAGE": "com.android.car.dialer"
},
"CONTACT_SEARCH_BAR": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_toolbar_search_bar",
"PACKAGE": "com.android.car.dialer"
},
"SEARCH_RESULT": {
"TYPE": "RESOURCE_ID",
"VALUE": "contact_name",
"PACKAGE": "com.android.car.dialer"
},
"CONTACT_SETTINGS": {
"TYPE": "RESOURCE_ID",
"VALUE": "menu_item_setting",
"PACKAGE": "com.android.car.dialer"
},
"CONTACT_ORDER": {
"TYPE": "TEXT",
"VALUE": "Contact order"
},
"SORT_BY_FIRST_NAME": {
"TYPE": "TEXT",
"VALUE": "First name"
},
"SORT_BY_LAST_NAME": {
"TYPE": "TEXT",
"VALUE": "Last Name"
},
"CONTACT_TYPE_WORK": {
"TYPE": "TEXT",
"VALUE": "Work"
},
"CONTACT_TYPE_MOBILE": {
"TYPE": "TEXT",
"VALUE": "Mobile"
},
"CONTACT_TYPE_HOME": {
"TYPE": "TEXT",
"VALUE": "Home"
}
},
"CALL_HISTORY_VIEW": {
"CALL_HISTORY_MENU": {
"TYPE": "TEXT",
"VALUE": "Recents"
},
"CALL_HISTORY_INFO": {
"TYPE": "RESOURCE_ID",
"VALUE": "call_action_id",
"PACKAGE": "com.android.car.dialer"
}
},
"FAVORITES_VIEW": {
"FAVORITES_MENU": {
"TYPE": "TEXT",
"VALUE": "Favorites"
}
}
},
"NOTIFICATIONS": {
"APPLICATION_CONFIG": {
"OPEN_NOTIFICATIONS_COMMAND": "service call statusbar 1"
},
"EXPANDED_NOTIFICATIONS_SCREEN": {
"NOTIFICATION_VIEW": {
"TYPE": "RESOURCE_ID",
"VALUE": "notification_view",
"PACKAGE": "com.android.systemui"
},
"CLEAR_ALL_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "clear_all_button",
"PACKAGE": "com.android.systemui"
},
"STATUS_BAR": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_top_navigation_bar_container",
"PACKAGE": "com.android.systemui"
},
"APP_ICON": {
"TYPE": "RESOURCE_ID",
"VALUE": "app_icon",
"PACKAGE": "com.android.systemui"
},
"APP_NAME": {
"TYPE": "RESOURCE_ID",
"VALUE": "header_text",
"PACKAGE": "com.android.systemui"
},
"NOTIFICATION_TITLE": {
"TYPE": "RESOURCE_ID",
"VALUE": "notification_body_title",
"PACKAGE": "com.android.systemui"
},
"NOTIFICATION_BODY": {
"TYPE": "RESOURCE_ID",
"VALUE": "notification_body_content",
"PACKAGE": "com.android.systemui"
},
"CARD_VIEW": {
"TYPE": "RESOURCE_ID",
"VALUE": "card_view",
"PACKAGE": "com.android.systemui"
}
}
},
"MEDIA_CENTER": {
"APPLICATION_CONFIG": {
"MEDIA_CENTER_PACKAGE": "com.android.car.media",
"MEDIA_ACTIVITY": "com.android.bluetooth/com.android.bluetooth.avrcpcontroller.BluetoothMediaBrowserService"
},
"MEDIA_CENTER_SCREEN": {
"PLAY_PAUSE_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "play_pause_stop",
"PACKAGE": "com.android.car.media"
},
"NEXT_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "skip_next",
"PACKAGE": "com.android.car.media"
},
"PREVIOUS_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "skip_prev",
"PACKAGE": "com.android.car.media"
},
"SHUFFLE_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "overflow_on",
"PACKAGE": "com.android.car.media"
},
"PLAY_QUEUE_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "play_queue",
"PACKAGE": "com.android.car.media"
},
"MINIMIZED_MEDIA_CONTROLS": {
"TYPE": "RESOURCE_ID",
"VALUE": "minimized_playback_controls",
"PACKAGE": "com.android.car.media"
},
"TRACK_NAME": {
"TYPE": "RESOURCE_ID",
"VALUE": "title",
"PACKAGE": "com.android.car.media"
},
"TRACK_NAME_MINIMIZED_CONTROL": {
"TYPE": "RESOURCE_ID",
"VALUE": "minimized_control_bar_title",
"PACKAGE": "com.android.car.media"
},
"BACK_BUTTON": {
"TYPE": "DESCRIPTION",
"VALUE": "Back"
}
},
"MEDIA_CENTER_ON_HOME_SCREEN": {
"PLAY_PAUSE_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "play_pause_stop",
"PACKAGE": "com.android.car.carlauncher"
},
"NEXT_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "skip_next",
"PACKAGE": "com.android.car.carlauncher"
},
"PREVIOUS_BUTTON": {
"TYPE": "RESOURCE_ID",
"VALUE": "skip_prev",
"PACKAGE": "com.android.car.carlauncher"
},
"TRACK_NAME": {
"TYPE": "RESOURCE_ID",
"VALUE": "title",
"PACKAGE": "com.android.car.carlauncher"
}
}
}
}
대체 기기 설정
다음 코드 샘플은 기본 설정이 DUT의 설정으로 재정의된 JSON 구성 파일의 예를 보여줍니다. 이 예는 다음과 같습니다.
인터넷 설정은 네트워크 및 참조 기기 및 인터넷 연결 DUT의 연결
날짜 및 시간 설정은 설정 > 날짜 및 시간 설정 > 시스템 > DUT의 날짜 및 시간입니다.
// Default configuration file
{
....
"SECURITY_SETTINGS_SCROLL_ELEMENT": {
"TYPE": "RESOURCE_ID",
"VALUE": "fragment_container",
},
....
}
// JSON configuration file for non-reference device
{
....
"SECURITY_SETTINGS_SCROLL_ELEMENT": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_recycler_view"
},
....
}
JSON 구성 파일이 준비되면 다음과 같이 런타임 시 제공됩니다. 다음 코드 블록에서 확인할 수 있습니다.
# Push The JSON configuration file to the device
adb -s DEVICE-SERIAL push PATH-OF-JSON-FILE /data/local/tmp/runtimeSpectatioConfig.json
이 명령어에서
DEVICE-SERIAL: DUT의 일련번호 ID입니다. 이 매개변수는 하나의 기기만 호스트에 연결된 경우 필요합니다.
PATH-TO-JSON-FILE: 호스트 머신의 JSON 파일 경로입니다.
구성 형식
구성에 다음 키가 포함된 5개의 최상위 수준 객체가 있습니다. 및 값:
| 객체 | 설명 |
|---|---|
PACKAGES |
다양한 앱의 기본 패키지를 설명하는 객체로, 앱이 포그라운드에 있는 시점을 파악할 수 있습니다. |
ACTIONS |
다양한 작업의 작업 유형 및 매개변수를 나타내는 객체입니다. 예를 들어 스크롤할 때 버튼을 사용할지, 동작을 사용할지 등입니다. |
COMMANDS |
다양한 작업을 실행하는 명령어를 지정하는 객체입니다. |
UI_ELEMENTS |
UI를 선택하는 UI Automator `BySelectors` 를 구성하는 데 사용되는 객체 요소 (아래에 자세히 설명됨) |
WORKFLOWS |
상위 수준의 작업을 수행하는 작업 순서 (아래 참조) 참조하세요. |
UI 요소
각 UI 요소에는 UI Automator가 찾을 항목을 지정하는 TYPE가 있습니다.
요소 (예: 리소스 ID, 텍스트, 설명)를 식별하고
해당 유형과 연결된 구성 값 일반적으로 도우미가
이 구성을 사용하여 화면의 요소를 식별하므로
사용할 수 있습니다. 여러 요소가 구성과 일치하는 경우 임의의 요소는
사용됩니다. 따라서 구성은 일반적으로
관련 컨텍스트에서 하나의 요소로 좁혀집니다.
텍스트
가장 간단한 UI 요소 유형입니다. UI 요소는 텍스트로 식별되며 정확한 일치가 필요합니다.
"CALL_HISTORY_MENU": {
"TYPE": "TEXT",
"VALUE": "Recents"
}
텍스트 포함
TEXT과 동일. 단, 지정된 VALUE은
일치시킬 요소의 텍스트입니다.
"PRIVACY_CALENDAR": {
"TYPE": "TEXT_CONTAINS",
"VALUE": "Calendar"
}
설명
콘텐츠 설명 속성으로 요소를 식별합니다. 정확한 일치해야 합니다.
"APP_GRID_SCROLL_BACKWARD_BUTTON": {
"TYPE": "DESCRIPTION",
"VALUE": "Scroll up"
}
RESOURCE_ID
리소스 ID로 요소를 식별하고 필요한 경우 패키지를 확인합니다.
구성요소입니다. PACKAGE 키는 선택사항입니다. 생략된 경우 모든 패키지
ID에서 :id/ 뒤에 오는 부분만 고려됩니다.
"APP_LIST_SCROLL_ELEMENT": {
"TYPE": "RESOURCE_ID",
"VALUE": "apps_grid",
"PACKAGE": "com.android.car.carlauncher"
}
클릭 가능, 스크롤 가능
클릭 가능 또는 스크롤 가능 여부에 따라 요소를 식별합니다.
이들은 매우 광범위한 요소 유형이며 일반적으로
MULTIPLE는 다른 요소 유형의 범위를 좁히는 데 도움이 됩니다. FLAG 키는 선택사항입니다.
기본값은 true입니다.
"SAMPLE_ELEMENT": {
"TYPE": "CLICKABLE",
"FLAG": false
}
수업
클래스를 기준으로 요소를 식별합니다.
"SECURITY_SETTINGS_ENTER_PASSWORD": {
"TYPE": "CLASS",
"VALUE": "android.widget.EditText"
}
HAS_ANCESTOR
상위에서 위젯 계층 구조를 조회하여 요소를 식별합니다. 이
ANCESTOR 키는 상위 항목을 식별하는 객체를 포함합니다. DEPTH 키
계층 구조에서 얼마나 위로 갈지 지정합니다. DEPTH는 선택사항이며
기본값은 1입니다.
"SAMPLE_ELEMENT": {
"TYPE": "HAS_ANCESTOR",
"DEPTH": 2,
"ANCESTOR": {
"TYPE": "CLASS",
"VALUE": "android.view.ViewGroup"
}
}
있음
하위 요소에서 계층 구조를 내려다보며 요소를 식별합니다. 이
DESCENDANT 키에는 찾을 하위 요소를 지정하는 객체가 포함됩니다. 이
DEPTH 키는 계층 구조에서 얼마나 위로 갈지 지정합니다. DEPTH는 선택사항이며
기본값은 1입니다.
"SAMPLE_ELEMENT": {
"TYPE": "HAS_DESCENDANT",
"DEPTH": 2,
"DESCENDANT": {
"TYPE": "CLASS",
"VALUE": "android.view.ViewGroup"
}
}
여러 개
여러 동시 조건을 토대로 원소를 식별합니다. 모든 조건이 충족되어야 합니다. 충족해야 합니다.
"APP_INFO_SETTINGS_PERMISSION_MANAGER": {
"TYPE": "MULTIPLE",
"SPECIFIERS": [
{
"TYPE": "CLASS",
"VALUE": "android.widget.RelativeLayout"
},
{
"TYPE": "HAS_DESCENDANT",
"MAX_DEPTH": 2,
"DESCENDANT": {
"TYPE": "TEXT",
"VALUE": "Permission manager"
}
}
]
}
이 예에서 구성은 RelativeLayout
깊이 2의 하위 요소이며 Permission manager 텍스트가 있습니다.
워크플로
워크플로는 특정 목표를 달성하는 데 사용되는 일련의 작업을 나타냄 태스크는 기기 유형에 따라 충분히 다를 수 있으며 코드보다 구성에서 표현할 수 있습니다.
"WORKFLOWS": {
"OPEN_SOUND_SETTINGS_WORKFLOW": [
{
"NAME": "Go to Home",
"TYPE": "PRESS",
"CONFIG": {
"TEXT": "HOME"
}
},
{
"NAME": "Open Settings",
"TYPE": "COMMAND",
"CONFIG": {
"TEXT": "am start -a android.settings.SETTINGS"
}
},
{
"NAME": "Open Sound Settings",
"TYPE": "SCROLL_TO_FIND_AND_CLICK",
"CONFIG": {
"UI_ELEMENT": {
"TYPE": "TEXT",
"VALUE": "Sound"
}
},
"SCROLL_CONFIG": {
"SCROLL_ACTION": "USE_GESTURE",
"SCROLL_DIRECTION": "VERTICAL",
"SCROLL_ELEMENT": {
"TYPE": "RESOURCE_ID",
"VALUE": "car_ui_recycler_view"
}
}
}
]
}
각 워크플로는 키-값 쌍이며, 여기서 키는 워크플로의 이름이며
값은 수행할 작업의 배열입니다. 각 작업에는 NAME, TYPE,
(일반적으로 CONFIG) SWIPE_CONFIG 또는 SCROLL_CONFIG (때로는)입니다. 대상
대부분의 TYPE에서 CONFIG은 값이 있는 UI_ELEMENT 키가 있는 객체입니다.
UI 요소 항목과 동일한 양식 (위 참조) 각 유형의 특징은 다음과 같습니다.
| 누르기 길게_표시 클릭 길게_클릭 클릭_IF_EXIST |
HAS_UI_ELEMENT_IN_FOREGROUND SCROLL_TO_FIND_AND_클릭 스크롤해서_FIND_AND_클릭_IF_EXIST 스와이프하여_FIND_AND_클릭 FIND_AND_click_IF_EXIST로 스와이프 |
다른 TYPE의 구성 세부정보는 다음과 같습니다.
| 객체 | 설명 |
|---|---|
COMMAND |
실행할 명령어가 포함된 TEXT 값이 있는 객체입니다. |
HAS_PACKAGE_IN_FOREGROUND |
TEXT 값이 패키지를 포함하는 객체입니다. |
SWIPE |
SWIPE 작업의 경우 CONFIG key를 생략합니다. 이
SWIPE_CONFIG만 사용 |
WAIT_MS |
TEXT 값이 포함된 객체:
밀리초 단위로 대기합니다 |
스크롤 및 스와이프 관련 작업에는 다음과 같이 추가 구성이 필요합니다.
SCROLL_CONFIG
| 객체 | 설명 |
|---|---|
SCROLL_ACTION |
USE_GESTURE 또는 USE_BUTTON |
SCROLL_DIRECTION |
HORIZONTAL 또는 VERTICAL |
SCROLL_ELEMENT |
스크롤할 컨테이너를 나타내는 객체(UI와 동일한 양식 사용) 요소 구성 (위 참고) |
SCROLL_BACKWARD SCROLL_FORWARD |
앞으로 및 뒤로 스크롤 버튼(
SCROLL_ACTION이 USE_BUTTON임). |
SCROLL_MARGIN |
SCROLL_ACTION가 USE_GESTURE이면 거리는
사용할 드래그를 시작하고 중지합니다.
를 눌러 스크롤을 수행합니다 (선택사항, 기본값 = 10). |
SCROLL_WAIT_TIME |
SCROLL_ACTION이 USE_GESTURE이면
다음 스크롤 동작 사이에 대기하는 시간(밀리초)이 지난 후에야
클릭합니다.
(선택사항, 기본값 = 1) |
스와이프_구성
| 객체 | 설명 |
|---|---|
SWIPE_DIRECTION |
TOP_TO_BOTTOM, BOTTOM_TO_TOP,
LEFT_TO_RIGHT 또는 RIGHT_TO_LEFT |
SWIPE_FRACTION |
다음 중 하나:
|
NUMBER_OF_STEPS |
스와이프를 수행하는 데 사용할 단계 수입니다.
segmentSteps를 참조하세요.
|
빌드 및 실행
Spectatio 프레임워크는 테스트 APK의 일부로 자동 빌드됩니다. 빌드하려면 테스트 APK의 경우 AOSP 코드베이스가 로컬 워크스테이션에 있어야 합니다. 테스트 APK가 빌드되면 사용자는 기기에 APK를 설치하고 테스트를 실행해야 합니다.
다음 코드 샘플은 테스트 APK의 빌드, 설치, 실행을 보여줍니다.
# Build Test APK make TEST-APK-NAME# Install Test APK adb -s DEVICE-SERIAL install -r PATH-FOR-BUILT-TEST-APK# Execute Test with the JSON file adb -s DEVICE-SERIAL shell am instrument -w -r -e debug false -e config-file-path /data/local/tmp/jsonFile.json -e class TEST-PACKAGE.TEST-CLASSNAME TEST-PACKAGE/androidx.test.runner.AndroidJUnitRunner
이러한 명령어에서 각 항목의 의미는 다음과 같습니다.
TEST-APK-NAME: 테스트할 앱의 이름입니다. 예를 들어
Android.bp파일에 지정된 대로 TEST-APK-NAME을AndroidAutomotiveSettingsTests로 설정하여 Wi-Fi 설정을 테스트합니다. APK의 이름은 자동차 테스트의 각Android.bp파일에서 확인할 수 있습니다.DEVICE-SERIAL: DUT의 일련번호 ID입니다. 이 매개변수는 하나의 기기만 호스트에 연결된 경우 필요합니다.
config-file-path: 제공하기 위해서만 필요한 선택적 매개변수입니다. JSON 구성에 지정된 기본이 아닌 기기 UI 구성을 지정합니다. 파일을 참고하세요. 제공되지 않는 경우 기본값을 사용하여 테스트를 실행합니다.PATH-FOR-BUILT-TEST-APK:
make명령어가 실행될 때 테스트 APK가 빌드되는 경로입니다.TEST-PACKAGE: 테스트 패키지의 이름입니다.
TEST-CLASSNAME: 테스트 클래스의 이름입니다. 예를 들어 Wi-Fi 설정 테스트에서 테스트 패키지는
android.platform.tests이며 테스트 클래스 이름은WifiSettingTest입니다.
Automotive 스니펫 라이브러리
Automotive 스니펫 라이브러리는 자동차와 상호작용하도록 설계된 Android 오픈소스 프로젝트 (AOSP) 관리할 수 있습니다 편리한 메커니즘으로 Spectatio를 활용합니다. 호스트(테스트) 컴퓨터에서 Android 지원 기기
시작하기
시작하기 전에 다음 섹션을 검토하세요.
기본 요건
- 호스트 머신에 설치된 Python 3.x
- 필요한 빌드 도구를 사용한 AOSP 환경 설정
- adb 액세스 권한이 있는 Android Automotive 기기 (에뮬레이터 또는 실제 기기)
컴파일
Automotive 스니펫 라이브러리에서 제공하는 다양한 스니펫을 컴파일하려면 다음을 실행해야 합니다.
제공된 android.bp 파일을 사용할 수 있습니다. 이전 모듈에서 다룬
섹션을 사용하여 APK를 컴파일할 수 있습니다.
배포
스니펫 라이브러리를 성공적으로 컴파일한 후 결과 APK를
이전에서 언급된 adb install 명령어를 사용하여 대상 기기
섹션으로 이동합니다.
테스트 실행
스니펫 라이브러리는 자동차와 상호작용하는 여러 RPC 메서드를 노출합니다.
있습니다. 이러한 메서드는 호스트에서 Mobly 프레임워크를 통해 호출할 수 있습니다.
가상 머신을 만드는 데
도움이 됩니다 Mobly 테스트 환경을 설정했다고 가정하면
snippet_shell.py 스크립트를 사용하여 대화형 Python 셸을 엽니다. 여기에서
수동으로 기기에서 RPC 메서드를 호출할 수 있습니다. 호출 예:
python3 snippet_shell.py com.google.android.mobly.snippet.bundled -s <serial>
<serial>를 다음을 통해 얻을 수 있는 기기 일련번호로 바꿉니다.
adb 기기.
포함된 라이브러리
Automotive 스니펫 라이브러리에는 다음과 같은 스니펫 라이브러리가 포함되어 있습니다. 도우미:
Automotive스니펫: 다음과 같은 차량 작업과 관련된 API를 제공합니다. 다이얼, 볼륨 제어, 차량 하드 키 및 미디어 센터 상호작용
Phonesnippet: 통화 처리, 연락처 탐색, SMS 운영 등 다양한 기능을 제공합니다.
Automotive 스니펫과 Phonesnippet은 몇 가지 공통 로직을 공유합니다.
특히 블루투스 관련 RCP 호출을 침입하여 자동차를 블루투스와 페어링할 수 있습니다.
휴대전화 기기 등이 있습니다. 이 bt_discovery_test에서 방법을 확인할 수 있습니다.
- TEST-CLASSNAME: 테스트 클래스의 이름입니다. 예를 들어 Wi-Fi 설정 테스트의 경우 테스트 패키지는
android.platform.tests이며 테스트 클래스 이름은WifiSettingTest입니다.