Tip
Kaspresso — это фреймворк для тестирования пользовательского интерфейса (UI) приложений под Android
Для создания экранов с элементами, необходимо насследоваться от Kscreen() и переопределить 2 метода: layoutId (id макета) и viewClass(класс activity).
Для нахождения элементов на экране можно воспользовться LayoutInspector.
object MainScreen : KScreen<MainScreen>() {
override val layoutId: Int? = null
override val viewClass: Class<*>? = null
val simpleActivityButton = KButton { withId(R.id.simple_activity_btn) }
}
Перед запуском необходимо открыть экран - например MainActivity.
@get:Rule
val activityRule = activityScenarioRule<MainActivity>()
targetContext - обращаемся к тестируемому приложению.
val intent = device.targetContext.packageManager.getLaunchIntentForPackage(GOOGLE_PLAY_PACKAGE)
Tip
ADB - это инструмент командной строки, который позволяет взаимодействовать с девайсом посредством различных команд. Для того, чтобы тесты, которые работают с adb, могли выполняться, необходимо запустить adb-server
performAdbвыполняет команду adbperformShellвыполняет команду shellperformCmdвыполняет команду командной строки
adbServer.performAdb("devices")
| Команда | Что делает |
|---|---|
| adb devices | Какие устройства сейчас подключены к adb |
| adb shell | для выполнения Linux-команд на устройстве(открывает консоль) |
| adb reboot | перезагрузка устройства |
| adb install app.apk | установка apk приложения |
| adb shell pm list packages | вывод установленных приложений |
Warning
Чтобы использовать step-ы, необходимо вызвать метод run {} и в фигурных скобках перечислить все шаги, которые будут выполнены во время теста.
@Test
fun checkCallIfPermissionDenied() = run {
step("Открываем экран Авторизации") {
}
}
before, after - вспомогательные методы, которые можно устанавливать перед и после теста.
@Test
fun test() {
before {
/**
* Выполняется перед тестом
*/
}.after {
/**
* Выполняется после теста
*/
}.run {
step("Открываем экран Авторизации") {
}
}
}
Important
Сценарии – это классы, которые позволяют объединить в себе несколько step-ов.
class LoginScenario : Scenario() {
override val steps: TestContext<Unit>.() -> Unit = {
step("Открываем экран Авторизации") {
}
step("Проверяем видимость элементов) {
}
}
}
Tip
У класса Log необходимо вызвать один из публичных статических методов: i (info), d (debug), w (warning), e (error)
- Debug — сообщения для отладки программы
- Error — серьезные ошибки, возникшие во время работы программы
- Warning — предупреждения. Программа может продолжать работу, но рекомендуется обратить внимание на какую-то проблему
- Info — простые сообщения, содержащие различного рода информацию. Система работает нормально
UiTestLogger - вывод сообщений в лог с тэгом "KASPRESSO_TEST" реализован под капотом. В самих тестах вам достаточно обратиться к объекту testLogger, вызвав метод с необходимым уровнем логирования.
testLogger.i("Generated data. Username: $username, Password: $password")
С помощью объекта device можно:
- device.targetContext.packageName - имя пакета приложения
- device.keyboard.typeText("text")/sendEvent(KeyEvent.KEYCODE_S) - ввод текста через клавиатуру
- device.network.toggleWiFi(false) - В качестве параметра передаем тип boolean, false если хотим выключить Wifi, true - если хотим включить
- device.exploit.setOrientation(Exploit.DeviceOrientation.Landscape / (Exploit.DeviceOrientation.Portrait)) - переворачивать экран
- device.permissions.allowViaDialog/denyViaDialog() - разрешить функцию на устройстве
- device.phone.cancelCall("phoneNumber") - звонить, сбрасывать звонок
Tip
В Kaspresso есть возможность во время теста делать скриншоты на любом шаге Для этого достаточно вызвать метод device.screenshots.take("file_name")
Чтобы не добавлять перед/после каждо шага, добавим в конструктор тестируемого класса
kaspressoBuilder = Kaspresso.Builder.simple().apply {
}
В такой реализации после неудачного step будет сохранент скриншот
В случае, если хотим, чтобы скрины были после каждого шага
kaspressoBuilder = Kaspresso.Builder.simple().apply {
stepWatcherInterceptors.add(ScreenshotStepWatcherInterceptor(screenshots))
}
Important
Путь до скриншотов: Переходим в Android Studio в Device File Explorer -> sdcard/Documents/screenshots
Tip
Явное ожидание - ожидание с явно заданным максимальным временем (таймаутом) для конкретного элемента и условия. Если условие не выполняется за указанное время — выбрасывается исключение (например, TimeoutException).
flakySafely(3000) { //устанавливаем явное ожидание 3 сек }
Tip
Неявное ожидание - глобальная настройка драйвера, которая автоматически применяется ко всем поискам элементов (findElement, findElements). Если элемент не найден сразу, драйвер ждёт указанное время (периодически опрашивая DOM), прежде чем выбросить исключение.
Threads vs flakySafely: Главное отличие, если у flakySafely установлен таймер, то при возвращении результата быстрее установочного таймера, при продолжим выполнение теста, при таймере в Threads, будем ждать полностью установочный таймер.
Caution
В Kaspresso все проверки неявно используют метод flakySafely с каким-то таймаутом (в текущей версии Kaspresso таймаут составляет 10 секунд)
Создание списка разрешений перед выполнением теста
Note
На современных версиях ОС Android (API 23 и выше) разрешения у пользователя запрашиваются во время работы приложения посредством диалога. Но в более ранних версиях они запрашивались в момент установки приложения, а во время работы считалось, что пользователь согласился со всеми требуемыми разрешениями. Поэтому, если вы запускаете тест на устройствах с API ниже 23-ой версии, то никакого запроса разрешений не будет, соответственно проверка диалога не требуется.
Warning
Работает на SDK <=23
@get:Rule
val grantPermissionRule: GrantPermissionRule = GrantPermissionRule.grant(
android.Manifest.permission.CALL_PHONE
)
Warning
Для SDK >= 23
device.permissions.apply {
flakySafely {
Assert.assertTrue(isDialogVisible())
denyViaDialog()
}
}
Tip
Аннотация перед тестом позволяет поставить минимальную версию SDK: @SdkSuppress(minSdkVersion = 23)
Еще можно проверять SDK так:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
step("Accept permission") {
device.permissions.apply {
flakySafely {
Assert.assertTrue(isDialogVisible())
allowViaDialog()
}
}
}
}
Документацию по Kaspresso можно посмотреть по ссылке