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:
- Abra seu projeto no Xcode.
- Na barra de menus do macOS, selecione Arquivo > Configurações do projeto...
- Altere o menu suspenso Dados derivados de Local padrão para Local personalizado .
- 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:
- No menu suspenso do dispositivo na parte superior da janela do espaço de trabalho do Xcode, selecione Generic iOS Device.
- 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
.
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
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:
Abra o Finder e navegue até o diretório designado para a saída de dados derivados.
Abra a pasta que você selecionou para o seu projeto e, em seguida, abra a pasta
Build/Products
dentro dela.Selecione as pastas
Debug-iphoneos
ePROJECT_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:
- Abra seu projeto no Xcode.
- Na barra de menus do macOS, selecione Arquivo > Configurações do projeto...
- Altere o menu suspenso Dados derivados de Local padrão para Local personalizado .
- 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:
- No menu suspenso do dispositivo na parte superior da janela do espaço de trabalho do Xcode, selecione Generic iOS Device.
- 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
.
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
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:
Abra o Finder e navegue até o diretório designado para a saída de dados derivados.
Abra a pasta que você selecionou para o seu projeto e, em seguida, abra a pasta
Build/Products
dentro dela.Selecione as pastas
Debug-iphoneos
ePROJECT_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 .