Executar um XCTest

Este guia descreve como preparar um XCTest para testes no Firebase Test Lab.

Etapa 1: configurar o local dos dados derivados de seu projeto

O Xcode coloca os elementos do iOS compilados, incluindo todos os testes que você cria, em um diretório de dados derivados. É possível manter o local padrão para esse diretório, mas é útil escolher um local mais acessível para os arquivos, especialmente se você pensa executar testes pelo Test Lab com frequência:

1. Abra seu projeto no Xcode.
2. Selecione File > Project Settings… na barra de menu do macOS.
3. Altere a lista suspensa Derived Data de Default Location para Custom Location.
4. No campo abaixo da lista suspensa, selecione um local onde o Xcode possa guardar seus testes.

Etapa 2: criar um arquivo de teste genérico

O Test Lab executa testes de unidade e de interface usando o framework XCTest. Para executar os XCTests do seu app em dispositivos do Test Lab, crie-os para que sejam testados em um dispositivo iOS genérico:

1. No menu suspenso do dispositivo, na parte superior da janela do espaço de trabalho do Xcode, selecione "Generic iOS Device".
2. Na barra de menu do macOS, selecione Product > Build For > Testing.

Etapa 3: criar um pacote do app para upload

Por fim, crie um pacote para seu teste para fazer upload no Test Lab compactando em um arquivo .zip os arquivos de teste que você criou.

1. Para criar seu XCTest, use o seguinte comando em um terminal:

   projeto

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

   workspace

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

2. Depois de criar o projeto, faça upload para o Test Lab:

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

Também é possível criar um pacote do teste compactando os arquivos de teste manualmente:

1. Abra o localizador e navegue até o diretório escolhido para a saída de dados derivados.

2. Abra a pasta selecionada para o projeto e abra a pasta Build/Products dentro dela.

3. Selecione as pastas Debug-iphoneos e PROJECT_NAME_iphoneosDEVELOPMENT_TARGET-arm64.xctestrun e compacte-as.

Etapa 4. (Opcional) Executar o teste localmente

Antes de executar seu teste com o Test Lab, é possível executá-lo localmente com um dispositivo conectado via USB para verificar a qualidade do comportamento:

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

Próximas etapas

Faça upload e execute o teste no Console do Firebase ou na CLI gcloud.