Опыт iOS-проекта с AI-функциональностью
В iOS-проекте с AI-функциональностью интерфейс меняется постоянно: сообщения, действия над ними, состояния ввода, оформление под разные темы. Проверять это руками дорого, а UI-тесты на XCUITest медленные и хрупкие. Мы искали способ проверять SwiftUI-компоненты на уровне обычных юнит-тестов. Ниже: что из этого вышло, во что мы упёрлись и почему главной проблемой оказался не инструмент.
Зачем нужен ViewInspector
ViewInspector позволяет в юнит-тесте обойти иерархию SwiftUI-вью, найти нужный элемент, прочитать текст, проверить состояние кнопки или вызвать её действие. Приложение для этого не запускается, а тест выполняется за миллисекунды.
Важно понимать границы. Он проверяет структуру и поведение вью: что элемент есть, что текст верный, что нажатие вызывает нужное действие. Пиксели, анимации, реальную раскладку и системные эффекты он не проверяет. Для этого нужны другие инструменты или человеческий взгляд.
Пример учебного компонента:
import SwiftUI
struct MessageActionsView: View {
let onCopy: () -> Void
let onRetry: () -> Void
var body: some View {
HStack {
Button("Копировать", action: onCopy)
Button("Повторить", action: onRetry)
}
}
}И тесты к нему:
import XCTest
import ViewInspector
@testable import ChatUI
final class MessageActionsViewTests: XCTestCase {
func test_tapOnCopy_callsHandler() throws {
var copied = false
let sut = MessageActionsView(onCopy: { copied = true }, onRetry: {})
try sut.inspect().find(button: "Копировать").tap()
XCTAssertTrue(copied)
}
func test_containsRetryAction() throws {
let sut = MessageActionsView(onCopy: {}, onRetry: {})
XCTAssertNoThrow(try sut.inspect().find(button: "Повторить"))
}
}Где мы споткнулись: дело было не в библиотеке
Первые тесты на ViewInspector мы написали быстро, но стабильно запустить их в пайплайне не получалось. Это был не один сбой, а целый комплекс ошибок. Общим источником оказались неправильно настроенные тестовые таргеты.
Главная проблема: UI-тесты, юнит-тесты и снепшот-тесты лежали в одном общем таргете. У разных видов тестов разные требования к окружению и зависимостям, и в одном таргете они мешали друг другу. Документация ViewInspector при этом требует подключать библиотеку к юнит-тестовому таргету и не добавлять её в основной таргет сборки. Пока тестовый код был простым, беспорядок не мешал. Первый инструмент, которому нужен чёткий граф зависимостей, всё вскрыл.
Откуда взялся беспорядок, мы знали. При переезде в новый модуль тестовую архитектуру переносили на скорую руку: важнее было, чтобы всё собиралось. Это нормальный компромисс на момент переезда, но у него есть срок годности. Спустя время мы заплатили за него отдельной задачей.
Параллельно возник второй вопрос: как подключать сам ViewInspector. Можно как Swift Package, то есть исходниками, а можно готовым бинарём. Мы выбрали бинарь и пересборку после обновлений версии библиотеки. Причина практическая: так обновляться проще, чем следить за выходом новых версий и вручную дописывать изменения.
Итогом стала переработка тестовой архитектуры: UI-, юнит- и снепшот-тесты мы развели по отдельным таргетам с явными зависимостями. Примерно так это может выглядеть в XcodeGen:
targets:
ChatUITests:
type: bundle.unit-test
platform: iOS
sources: [Tests/ChatUITests]
dependencies:
- target: ChatUI
- framework: Frameworks/ViewInspector.xcframeworkПродуктовый таргет ChatUI о ViewInspector ничего не знает. Библиотека живёт только в тестовом таргете.
Вывод: если новый тестовый инструмент не заводится на CI, проверьте, как устроены ваши тестовые таргеты. Быстрый перенос тестов «лишь бы работало» откладывает проблему, а не решает её.
Сравнение значений без Equatable
Отдельная практическая тема: как проверять результат работы use case, если возвращаемый тип нельзя просто сравнить через ==. Типичный случай: enum с ассоциированными значениями, внутри которых лежат типы без Equatable.
Один из приёмов, которым мы пользовались, это сравнение по структуре через рефлексию:
enum MessageAction {
case copy(text: String)
case retry(messageID: Int)
case share(Attachment) // Attachment не Equatable
}
/// Сравнивает значения по структуре через рефлексию.
func assertEqualByStructure<T>(
_ lhs: T, _ rhs: T,
file: StaticString = #filePath, line: UInt = #line
) {
XCTAssertEqual(structure(of: lhs), structure(of: rhs), file: file, line: line)
}
private func structure<T>(of value: T) -> String {
var output = ""
dump(value, to: &output)
return output
}Использование в тесте:
func test_useCase_returnsCopyAction() {
let result = useCase.action(for: .copy, message: message)
assertEqualByStructure(result, MessageAction.copy(text: "Привет"))
}Функция dump печатает структуру значения вместе с именами case и свойств, поэтому два значения совпадают, только если совпадает вся структура.
Плюсы: не нужно добавлять Equatable в продуктовый код только ради тестов, и один небольшой хелпер подходит для многих типов.
Минусы, о которых стоит помнить: замыкания так не сравнить, тест становится чувствительным к переименованию свойств, то есть к рефакторингу, а сообщения об ошибках менее понятны, чем у явного сравнения.
Мы считаем приём разумным компромиссом для тестов, но не заменой нормальной модели данных там, где Equatable можно добавить без ущерба.
Что получилось
Покрытие автотестами на момент, когда я работал с проектом, составляло примерно 50-60%. Для компонентов интерфейса это хороший уровень: большая часть проверок, которые не требуют человеческого взгляда, выполняется автоматически.
Что мы всё же оставляем людям: внешний вид, анимации, плавность прокрутки и всё, что нужно увидеть глазами. Автотесты проверяют логику и структуру, а оценить, как это выглядит и ощущается, они не могут.
Итого
ViewInspector хорош для структурных проверок SwiftUI без запуска UI.
Если он не заводится на CI, проверьте архитектуру тестовых таргетов, а не только библиотеку.
Спешный перенос тестовой инфраструктуры потом возвращается долгом.
Автоматизируйте всё, что может проверить машина, а человека оставьте для того, что нужно увидеть.
Комментарии 0