Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Execute um XCTest

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Passo 1 : Configure a localização dos Dados Derivados do seu projeto

O Xcode coloca os artefatos compilados do iOS, incluindo quaisquer testes que você criar, em um diretório Derived Data. É possível manter o local padrão para esse diretório, se desejar, mas geralmente é útil escolher um local de acesso mais fácil para os arquivos, especialmente se você executar 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 o menu suspenso 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.

Passo 2 : Crie 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 Test Lab, crie-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 Generic iOS Device.
  2. Na barra de menus do macOS, selecione Product > Build For > Testing .

Etapa 3 : empacotar seu aplicativo para upload

Finalmente, construa e empacote seu teste para carregar 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 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 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 depois 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 via 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

Carregue e execute seu teste no Firebase console ou na CLI gcloud .

,

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

Passo 1 : Configure a localização dos Dados Derivados do seu projeto

O Xcode coloca os artefatos compilados do iOS, incluindo quaisquer testes que você criar, em um diretório Derived Data. É possível manter o local padrão para esse diretório, se desejar, mas geralmente é útil escolher um local de acesso mais fácil para os arquivos, especialmente se você executar 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 o menu suspenso 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.

Passo 2 : Crie 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 Test Lab, crie-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 Generic iOS Device.
  2. Na barra de menus do macOS, selecione Product > Build For > Testing .

Etapa 3 : empacotar seu aplicativo para upload

Finalmente, construa e empacote seu teste para carregar 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 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 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 depois 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 via 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

Carregue e execute seu teste no Firebase console ou na CLI gcloud .