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á.

# Integrando a XCTest interface do usuário para iOS com o Device Farm
<a name="test-types-ios-xctest-ui"></a>

O Device Farm fornece suporte para a estrutura de teste de XCTest interface do usuário. [Especificamente, o Device Farm suporta testes de XCTest interface de usuário escritos em Objective-C e Swift.](https://developer.apple.com/swift/) 

 A estrutura de XCTest interface do usuário permite o teste de interface do usuário no desenvolvimento para iOS, construído sobre XCTest o. 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 à estrutura de teste de XCTest interface do usuário para iOS.

**Topics**
+ [Prepare seus testes de XCTest interface do iOS](#test-types-ios-xctest-ui-prepare)
+ [Opção 1: criar um pacote XCTest UI .ipa](#how-to-use-create-XCTestUI-ipa-package)
+ [Opção 2: criar um pacote XCTest UI .zip](#how-to-use-create-XCTestUI-zip-package)
+ [Carregue seus testes de XCTest interface do iOS](#test-types-ios-xctest-ui-upload)

## Prepare seus testes de XCTest interface do iOS
<a name="test-types-ios-xctest-ui-prepare"></a>

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 XCTest UI .ipa
<a name="how-to-use-create-XCTestUI-ipa-package"></a>

O pacote *yourAppName*UITest-runner.app é 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 XCTest UI .zip
<a name="how-to-use-create-XCTestUI-zip-package"></a>

O Device Farm gera automaticamente um `.xctestrun` arquivo para você executar seu conjunto completo de testes de XCTest interface do usuário. 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-nameUITest-runner.app *my-project-nameUITestou.ipa** e os arquivos de código-fonte do xcode necessários para executar o XCTEST\_UI com planos de teste, incluindo um 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**  
Certifique-se de que você não tenha um diretório chamado “Payload” dentro do seu pacote XCTest UI .zip. 

## Carregue seus testes de XCTest interface do iOS
<a name="test-types-ios-xctest-ui-upload"></a>

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 estrutura de teste**, escolha **XCTest UI**. Depois, selecione **Escolher arquivo** em **Fazer upload de aplicação**.

1. Procure e escolha o arquivo.ipa ou.zip que contém seu executor de teste de XCTest interface do 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.