Запустите 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 запускает модульные и UI-тесты с помощью фреймворка XCTest . Чтобы запустить XCTest-тесты вашего приложения на устройствах Test Lab , скомпилируйте его для тестирования на универсальном устройстве iOS:

  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 .