Запустите XCTest

В этом руководстве описывается, как подготовить XCTest для тестирования в Firebase Test Lab .

Шаг 1 : Настройте местоположение производных данных вашего проекта

Xcode помещает скомпилированные артефакты iOS, включая любые тесты, которые вы создаете, в каталог Derived Data. При желании можно сохранить местоположение этого каталога по умолчанию, но часто бывает полезно выбрать более легкодоступное место для файлов, особенно если вы собираетесь часто запускать тесты с помощью Test Lab :

  1. Откройте свой проект в Xcode.
  2. В строке меню macOS выберите Файл > Настройки проекта...
  3. Измените раскрывающийся список «Производные данные» с «Расположение по умолчанию» на «Пользовательское расположение» .
  4. В поле под раскрывающимся списком выберите место, куда Xcode будет выводить ваши тесты. (Это ваша FOLDER_WITH_TEST_OUTPUT )

Шаг 2 : Создание универсального тестового файла

Test Lab запускает модульные тесты и тесты пользовательского интерфейса с использованием фреймворка XCTest . Чтобы запустить XCTest вашего приложения на устройствах Test Lab , создайте его для тестирования на Generic iOS Device:

  1. В раскрывающемся списке устройств в верхней части окна рабочей области Xcode выберите Generic iOS Device .
  2. В строке меню macOS выберите Продукт > Сборка для > Тестирование .

В качестве альтернативы вы можете собрать свой XCTest из командной строки. Используйте следующую команду в терминале:

проект

xcodebuild -project PATH/TO/YOUR_WORKSPACE/YOUR_PROJECT.xcodeproj \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

рабочее пространство

xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

Шаг 3 : Подпишите свой тест и подтвердите его

  1. Убедитесь, что все артефакты в приложении и тесте подписаны. Например, вы можете сделать это через Xcode, указав параметры подписи, такие как профиль подготовки и идентификация. Для получения дополнительной информации см. Подписание кода Apple .

  2. Проверьте подпись приложения, выполнив codesign --verify --deep --verbose /path/to/MyApp.app , где "MyApp" — это имя приложения внутри распакованной папки. Это зависит от каждого проекта. Ожидаемый вывод — MyApp.app: valid on disk .

  3. Если вы запускаете XCUITest, вам нужно проверить тест и исполнителя, запустив codesign --verify --deep --verbose /path/to/MyTest-Runner.app , где "MyTest" — это имя исполнителя внутри распакованной папки. Это зависит от каждого проекта. Ожидаемый вывод — MyTest-Runner.app: valid on disk .

Шаг 4 : Упакуйте свое приложение и протестируйте его для загрузки

  1. После успешного завершения теста заархивируйте его для загрузки в Test Lab :

    cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
    zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
    

Вы также можете упаковать свой тест, сжав тестовые файлы вручную:

  1. Откройте Finder и перейдите в папку FOLDER_WITH_TEST_OUTPUT .

  2. Откройте папку, в префиксе которой указано имя вашего проекта, затем перейдите в папку Build/Products .

  3. Выберите папки Debug-iphoneos и YOUR_SCHEME _iphoneos DEPLOYMENT_TARGET -arm64.xctestrun , а затем сожмите их.

Шаг 5 : (Необязательно) Запустите тест локально.

Перед запуском теста с помощью Test Lab вы можете запустить его локально с помощью подключенного по USB устройства, чтобы качественно проверить его поведение:

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YOUR_SCHEME.xctestrun" \
    -destination id=your-phone-id

Следующие шаги

Загрузите и запустите свой тест в консоли Firebase или в интерфейсе командной строки gcloud .