Ускоряем прохождение iOS UI-тестов. Часть 3. Старт приложения с определенного экрана

Хабр привет!

Меня зовут Борис. Я руководитель группы автоматизации тестирования в Звук.

В этой статье я хочу рассказать про старт приложения с определенного экрана и какие способы реализации данного подхода существуют.

Данная статья будет полезна iOS‑автоматизаторам с опытом, либо разработчикам.

В рамках этой статьи мы разберем:

• Зачем стартовать приложение с определенного экрана?

• Какие способы реализации существуют?

• Реализация с помощью диплинков

• Реализация с помощью ArgumentHandler для подмены стартового View

• Плюсы и минусы обоих подходов

Зачем стартовать приложение с определенного экрана?

В тест‑кейсах часто встречаются проверки, где нужно дойти до определенного экрана и проверить на нём уникальное состояние элемента, которое зависит от ответа бэкенда, например: На экране плейлистов музыки ещё нет созданных плейлистов или наоборот есть. Достаточно затратно по времени проверять данную логику проходя весь флоу и также это не стабильно т.к. при изменении навигации в приложении придется это переписывать, хотя сам экран и логика на нём не была затронута. В таких случаях отличный выбор поднимать экран и сразу совершать необходимую проверку.

Какие способы реализации существуют?

Принято использовать два подхода:

1. Реализация с помощью диплинков.

2. Реализация с помощью ArgumentHandler для подмены стартового View.

Реализация с помощью диплинков

Для данного подхода нужно, чтобы в вашем приложении был реализован механизм обработки диплинков и все необходимые вам для тестов экраны были покрыты диплинками. Если эти условия соблюдены, вы можете использовать следующий код для перехода на нужный экран:

1. Если у вас Xcode версии < 14.3. Данный подход отрабатывает в среднем 7 секунд.

let safari = XCUIApplication(bundleIdentifier: "com.apple.mobilesafari") let url = safari.textFields.firstMatch let alertOpenButton = safari.otherElements["SFDialogView"].buttons.element(boundBy: 1) safari.activate() url.waitForExistence(timeout: 2) url.tap() url.waitForExistence(timeout: 2) url.typeText("yourApp://deeplink") safari.keyboards.buttons["go"].waitForExistence(timeout: 2) safari.keyboards.buttons["go"].tap() alertOpenButton.waitForExistence(timeout: 2) alertOpenButton.tap()

2. Если у вас Xcode версии > 14.3. Данный подход отрабатывает моментально.

В этой версии Apple добавили метод open(), который позволяет мгновенно открыть диплинк.

XCUIApplication().launch() let device = XCUIDevice.shared.system device.open(URL(string: "yourApp://deeplink")!)

Реализация с помощью ArgumentHandler для подмены стартового View

Зачастую реализации в проектах бывают более сложными, поэтому данный пример служит ориентиром.

Реализация данного подхода состоит из 3 этапов:

1. Открыть ваш таргет с ui-тестами и перейти в нужный вам тест. Придумать название для аргумента или переменной, которая бы ассоцировалась с нужным вам экраном или скрином. Как пример название может дублировать название вашего Page в тестах или название ViewController.

// UIKit & SwiftUI override func setUp() { XCUIApplication().launchArguments.append("DetailsScreen") XCUIApplication().launchEnvironment["Screen"] = "DetailsScreen" } 

2. Создать ArgumentHandler в основном таргете приложения.

// UIKit struct ArgumentHandler {     static func handleView() -> UIViewController {         let arguments = ProcessInfo.processInfo.arguments              if arguments.contains("DetailsScreen") {           return DetailViewController()         }         return MainViewController     } }

// SwiftUi struct ArgumentHandler: View {     var body: some View {         let arguments = ProcessInfo.processInfo.arguments                  if arguments.contains("DetailsScreen"){             DetailView()         } else {             ContentView()         }     } }

3. Использовать ArgumentHandler для подмены стартового экрана в жизненном цикле приложения. Важно также использовать макрос #DEBUG , чтобы ваша подмена экрана не попала в релизную сборку

// UIKit class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions                      launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {  let window = UIWindow() #if DEBUG window.rootViewController = ArgumentHandler.handleView() #else window.rootViewController = MainViewController() #endif window.makeKeyAndVisible()  self.window = window return true } }

// SwiftUI @main struct PublicArtApp: App { var body: some Scene { WindowGroup { #if DEBUG ArgumentHandler() #else ContentView() #endif } } }

Самое важное

• Если у вас есть тест‑кейсы, в которых целевая проверка находится на определенном экране, поднимайте этот экран. Не нужно начинать флоу с стартового экрана, так как это удлиняет время прохождения вашего теста и делает его менее стабильным.

• Если в вашем приложении основные экраны покрыты диплинками, и разработчики готовы идти вам навстречу, добавляя их для экранов, необходимых для вашего тестирования, воспользуйтесь реализацией с диплинками.

• Если у вас в приложении отсутствуют диплинки или они не охватывают основные экраны для тестирования, воспользуйтесь реализацией с использованием ArgumentHandler для подмены стартового View.

Навигация по статьям:

• Ускоряем прохождение iOS UI‑тестов. Часть 1. Запускаем тесты без сборки проекта

• Ускоряем прохождение iOS UI‑тестов. Часть 2. Распараллеливание тестов

Интересуешься автоматизацией на iOS? Подписывайся на мой телеграмм‑канал, в котором я публикую материалы, которые будут полезны как начинающим, так и опытным iOS‑автоматизаторам.