Взаимодействие с alerts и permissions в ui-тестировании iOS

Привет, Хабр!

Меня зовут Ахмат. Я iOS QA Automation Engineer — в Vivid Money.

В этой статье я хочу рассказать про взаимодействие с alerts и permissions в iOS тестах и показать, как их можно эффективно обрабатывать в своём проекте.

Данная статья будет полезна начинающим iOS-автоматизаторам, либо разработчикам, которые решили изучить XCUITest и покрыть свой проект ui-тестами.

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

• Что такое alerts и permissions вашего iOS приложения;

• Как обрабатывать alerts в коде теста, где они являются частью сценария;

• Как автоматически обрабатывать permissions;

• Как реализовать механизм включения и выключения alerts и permissions с помощью передачи аргументов при запуске тестов.

Что такое alerts и permissions?

Alerts — дают возможность предоставлять пользователям критически важную информацию.
Например, alert может сообщать пользователю, что приложение запрашивает разрешение на отправку им нотификаций, и давать им возможность подтвердить или отклонить. Alerts появляются при первичном запуске вашего приложения.

Permissions — позволяют приложениям запрашивать разрешение на использование настроек конфиденциальности. Например таких, как Location Services для определения вашего точного местоположения.

Permissions появляются при первичном входе в раздел, к которому требуется запросить у вас разрешение.

Как обрабатывать alerts?

Способы взаимодействия с alerts — сделать их частью сценария (онбординг/авторизация и т.д) и кликать на нужные кнопки из кода теста или делать отдельный тест в наборе, который явно запускается первым и проходит все alerts при первом запуске приложения.

Alerts находятся в иерархии текущего активного приложения, иногда это ваше тестируемое, иногда это springboard (встроенное приложение, которое управляет домашним экраном iOS).

let springBoardApp = XCUIApplication(     bundleIdentifier: "com.apple.springboard" )  let app = XCUIApplication()  if springBoardApp.alerts.buttons["Allow"].waitForExistence(timeout: 1) { springBoardApp.alerts.buttons["Allow"].tap() } else if app.alerts.buttons.element(boundBy: 1).waitForExistence(timeout: 1) { app.alerts.buttons["Allow"].tap() }

Наиболее эффективный способ — это обрабатывать alerts, когда они являются частью сценария.

Создание отдельного теста для обработки всех alerts при первичном запуске может привести к нестабильности прогона всего тестового набора. Зачастую может произойти сбой во время прокликивания alerts, что в последствии приведет к частичному падению следующих тестов в наборе.

Как автоматически обрабатывать permissions?

В тестовый проект нужно добавить монитор прерывания пользовательского интерфейса. В XCTest есть метод, addUIInterruptionMonitor() который мы можем использовать для мониторинга и реагирования на появление permissions.

addUIInterruptionMonitor(withDescription: "Tracking Usage Permission Alert") {     (alert) -> Bool in     if alert.buttons["Allow"].exists {         alert.buttons["Allow"].tap()         self.app.activate()         return true     }     return false     }

Наиболее эффективно вызывать addUIInterruptionMonitor() в начале теста, где мы точно знаем что по сценарию появится permission. Вызов обработчика в setUp() не будет отрабатывать автоматически на всех тестах. Так же для каждого permission нужен отдельный вызов монитора прерывания пользовательского интерфейса.

Как включать и выключать alerts и permissions с помощью передачи аргументов?

Можно включать появление alerts и permissions только в тех тестах, где они будут являться частью тестового сценария.

Потребуется реализовать механизм управления добавлением в инициализацию делегатов, отвечающих за alerts и permissions.

Реализуем механизм включения/выключения оповещения о трекинге активности. За появление диалогового окна трекинг менеджера в нашем приложении отвечает механизм ATTrackingManager.

Создадим расширение для XCUIApplication, где напишем функцию launch с возможностью передачи аргументов:

extension XCUIApplication {  func launch(arguments: [String] = ["TrackingManager"]) {     if state != .notRunning {         terminate()         launchArguments = []     }      launchArguments = arguments      launch()     _ = wait(for: .runningForeground, timeout: 10) }  }

Далее нам потребуется выяснить в каком делегате у нас реализован вызов диалогового окна трекинг менеджера. Достаточно в поиске ввести ATTrackingManager и взять название делегата.

final class AppsFlyerAppDelegate: NSObject, UIApplicationDelegate {      func applicationDidBecomeActive(_ application: UIApplication) {         // for iOS 13 and below - The IDFA will be collected by the SDK. The user will NOT be prompted for permission.         if #available(iOS 14, *) {             // Show the user the Apple IDFA consent dialog (AppTrackingTransparency)             // Can be called in any place             ATTrackingManager.requestTrackingAuthorization { _ in             }         }                  if let deviceId = CheckEmailAccessExperiment.obtainDeviceId(inPlace: "AppsFlyerInstance") {             appsFlyerInstance.customerUserID = deviceId         }                  appsFlyerInstance.start()     } }

Реализуем обработчик в AppDelegate и запуск ATTrackingManager в тестах, где аргумент “TrackingManager” не передается:

public class AppDelegate: UIResponder {          let pushNotificationsAppDelegate = PushNotificationsAppDelegate()     let appsFlyerAppDelegate = AppsFlyerAppDelegate()      private lazy var appDelegates: [UIApplicationDelegate] = {          var appDelegates: [UIApplicationDelegate] = [             pushNotificationsAppDelegate         ]                  if !ProcessInfo.processInfo.arguments.contains("TrackingManager") {             appDelegates.append(appsFlyerAppDelegate)         }                  return appDelegates     }()      }

Таким способом можно отключать все виды alerts и permissions по отдельности, как показано в примере выше или можно создать один общий аргумент для обработки добавления делегатов в appDelegates, отвечающий за все виды alerts и permissions.

Сочетая все три способа взаимодействия с alerts и permissions, можно сделать ваш код чистым и уменьшить число флаков при прогоне тесового набора.