Execute um XCTest

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 .