Execute um XCTest

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

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

O Xcode coloca artefatos iOS compilados, incluindo quaisquer testes que você cria, em um diretório de Dados Derivados. É possível manter o local padrão para esse diretório, se desejar, mas geralmente é útil escolher um local mais acessível para os arquivos, especialmente se você estiver executando testes com o Test Lab com frequência:

  1. Abra seu projeto no Xcode.
  2. Na barra de menus do macOS, selecione Arquivo > Configurações do projeto...
  3. Altere a lista suspensa Dados derivados de Local padrão para Local personalizado .
  4. No campo abaixo do menu suspenso, selecione um local para o Xcode enviar seus testes.

Etapa 2 : criar um arquivo de teste genérico

O Test Lab executa testes de unidade e testes de interface do usuário usando a estrutura XCTest . Para executar os XCTests do seu aplicativo em dispositivos do Test Lab, crie-o para teste em um dispositivo iOS genérico:

  1. Na lista suspensa do dispositivo na parte superior da janela do espaço de trabalho do Xcode, selecione Dispositivo iOS genérico.
  2. Na barra de menus do macOS, selecione Produto > Construir para > Teste .

Etapa 3 : empacotar seu aplicativo para upload

Por fim, compile e empacote seu teste para upload no Test Lab compactando os arquivos de teste que você criou em um arquivo .zip .

  1. Para construir 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

    área de trabalho

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

  2. Depois que seu teste for compilado com sucesso, compacte-o para upload no Test Lab:

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

Você também pode empacotar seu teste compactando os arquivos de teste manualmente:

  1. Abra o Finder e navegue até o diretório que você designou para a saída de dados derivados.

  2. Abra a pasta que você selecionou para o seu projeto e, em seguida, abra a pasta Build/Products dentro dela.

  3. Selecione as pastas Debug-iphoneos e PROJECT_NAME _iphoneos DEVELOPMENT_TARGET -arm64.xctestrun e então compacte-as.

Etapa 4. (Opcional) Execute seu teste localmente

Antes de executar seu teste com o Test Lab, você pode executá-lo localmente com um dispositivo conectado por USB para verificar a qualidade de seu comportamento:

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

Próximos passos

Faça upload e execute seu teste no console do Firebase ou na CLI do gcloud .