Catch up on everthing we announced at this year's Firebase Summit. Learn more

Execute um XCTest

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

Passo 1: Configurar seu projeto é derivado de localização de dados

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

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

Passo 2: Criar um arquivo de teste genérico

Test Lab executa testes de unidade e testes de interface do usuário usando o XCTest quadro. Para executar os XCTests do seu aplicativo em dispositivos Test Lab, construa-o para teste 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 Dispositivo iOS genérico.
  2. Na barra de menus MacOS, selecione produto> construir para> Testing.

Passo 3: Pacote seu aplicativo para upload

Finalmente, construir e empacotar seu teste para o upload para Test Lab através da compressão dos arquivos de teste que você construiu em um .zip arquivo.

  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 fazer o upload para o 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 designado para a saída de Dados Derivados.

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

  3. Selecione as pastas Debug-iphoneos e PROJECT_NAME _iphoneos DEVELOPMENT_TARGET -arm64.xctestrun e, em seguida, comprimi-los.

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óxima Etapa

Carregar e executar o teste na consola Firebase ou o CLI gcloud .