As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integrar o XCTest UI para iOS ao Device Farm
O Device Farm comporta o framework de teste do XCTest UI. [Especificamente, o Device Farm suporta testes de interface do usuário do XCTest escritos em ambos Objective-C e em Swift.](https://developer.apple.com/swift/)
O framework do XCTest UI permite testes de interface do usuário no desenvolvimento para iOS, construído com base no XCTest. Para obter mais informações, consulte [Teste da interface do usuário](https://developer.apple.com/library/prerelease/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/09-ui_testing.html#//apple_ref/doc/uid/TP40014132-CH13-SW1) na biblioteca de desenvolvedor do iOS.
Para acessar informações gerais sobre testes no Device Farm, consulte [Frameworks de teste e testes integrados no AWS Device Farm](test-types.md).
Use as instruções a seguir para integrar o Device Farm ao framework de teste do XCTest UI para iOS.
**Topics**
+ [Preparação dos testes do XCTest UI para iOS](#test-types-ios-xctest-ui-prepare)
+ [Opção 1: criar um pacote .ipa do XCTest UI](#how-to-use-create-XCTestUI-ipa-package)
+ [Opção 2: criar um pacote .zip do XCTest UI](#how-to-use-create-XCTestUI-zip-package)
+ [Upload dos testes do XCTest UI para iOS](#test-types-ios-xctest-ui-upload)
## Preparação dos testes do XCTest UI para iOS
Você pode fazer upload de um arquivo `.ipa` ou `.zip` para seu pacote de testes XCTEST\_UI.
Arquivo `.ipa` é um arquivo de aplicação que contém a aplicação iOS Runner em formato de pacote. *Arquivos adicionais não podem ser incluídos no arquivo `.ipa`.*
Se você fizer upload de um arquivo `.zip`, ele poderá conter diretamente a aplicação iOS Runner ou um arquivo `.ipa`. Você também poderá incluir outros arquivos no arquivo `.zip` se quiser usá-los durante os testes. Por exemplo, é possível incluir arquivos, como `.xctestrun`, `.xcworkspace` ou `.xcodeproj` em um arquivo `.zip` para executar planos de teste XCUI no farm de dispositivos. Instruções detalhadas sobre como executar planos de teste estão disponíveis no arquivo de especificação de teste padrão para o tipo de teste XCUI.
## Opção 1: criar um pacote .ipa do XCTest UI
O *seu AppName* UITest-Runner.app pacote é produzido pelo Xcode quando você cria seu projeto para teste. Ele pode ser encontrado no diretório Products do projeto.
Para criar um arquivo .ipa:
1. Crie um diretório denominado {{Payload}}.
1. Adicione o diretório da sua aplicação ao diretório da carga útil.
1. Arquive o diretório Carga útil em um arquivo `.zip` e mude a extensão do arquivo para `.ipa`.
A estrutura de pastas a seguir mostra como um aplicativo de exemplo chamado {{my-project-nameUITest-Runner.app}} seria empacotado como um `.ipa` arquivo:
```
.
└── my-project-nameUITest.ipa
└── Payload (directory)
└── my-project-nameUITest-Runner.app
```
## Opção 2: criar um pacote .zip do XCTest UI
O Device Farm gera automaticamente um arquivo `.xctestrun` para você executar seu pacote completo de testes do XCTest UI. Se quiser usar seu próprio arquivo `.xctestrun` no Device Farm, compacte seus arquivos `.xctestrun` e o diretório da aplicação em um arquivo `.zip`. Se você já tem um `.ipa` arquivo para seu pacote de teste, você pode incluí-lo aqui em vez de{{\*-Runner.app}}.
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── SampleTestPlan_2.xctestrun
├── SampleTestPlan_1.xctestrun
└── (any other files)
```
Se você quiser executar um plano de teste do Xcode para seus testes XCUI no Device Farm, você pode criar um zip contendo seu arquivo *my-project-name UITest-Runner.app **ou** *my-project-name** e os arquivos de código-fonte xcode necessários para executar o XCTEST\_UI com planos de teste, incluindo um UITest.ipa arquivo ou. `.xcworkspace` `.xcodeproj`
Aqui está um exemplo de zip usando um arquivo `.xcodeproj`:
```
.
└── swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
├── (any directory)
└── {{SampleXcodeProject.xcodeproj}}
├── Testplan_1.xctestplan
├── Testplan_2.xctestplan
└── (any other source code files created by xcode with .xcodeproj)
```
Aqui está um exemplo de zip usando um arquivo `.xcworkspace`:
```
.
└──swift-sample-UI.zip (directory)
├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
└── (any directory)
│ ├── SampleXcodeProject.xcodeproj
│ ├── Testplan_1.xctestplan
│ ├── Testplan_2.xctestplan
| └── (any other source code files created by xcode with .xcodeproj)
└── {{SampleWorkspace.xcworkspace}}
└── contents.xcworkspacedata
```
**nota**
Garanta que você não tenha um diretório chamado “Carga útil” dentro do pacote .zip do XCTest UI.
## Upload dos testes do XCTest UI para iOS
Use o console do Device Farm para carregar seus testes.
1. Faça login no console do Device Farm em [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
1. No painel de navegação do Device Farm, escolha **Teste para dispositivos móveis** e, em seguida, **Projetos**.
1. Na lista de projetos, escolha o projeto para o qual deseja carregar seus testes.
**dica**
Você pode usar a barra de pesquisa para filtrar a lista de projetos por nome.
Para criar um projeto, siga as instruções em [Criar um projeto no AWS Device Farm](how-to-create-project.md).
1. Escolha **Criar execução**.
1. Em **Configurações de execução**, na seção **Tipo de execução**, escolha **Aplicação iOS**.
1. Em **Selecionar aplicação**, na seção **Opções de seleção de aplicação**, escolha **Fazer upload da própria aplicação**. Depois, selecione **Escolher arquivo** em **Fazer upload de aplicação**.
1. Procure e escolha o arquivo de seu aplicativo iOS. O arquivo deve ser .ipa.
**nota**
Confirme se o arquivo .ipa foi desenvolvido para um dispositivo iOS e não para um simulador.
1. Em **Configurar teste**, na seção **Selecionar framework de teste**, escolha **XCTest UI**. Depois, selecione **Escolher arquivo** em **Fazer upload de aplicação**.
1. Procure e selecione o arquivo .ipa ou .zip que contém o executor de testes do XCTest UI para iOS.
1. Conclua as etapas restantes no processo de criação do projeto. Você selecionará os dispositivos em que deseja testar e, opcionalmente, especificar uma configuração adicional.
1. Escolha **Criar execução**. O Device Farm executa o teste e mostra os resultados no console.