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 o Device Farm com XCTest o iOS
<a name="test-types-ios-xctest"></a>

Com o Device Farm, você pode usar a XCTest estrutura para testar seu aplicativo em dispositivos reais. Para obter mais informações sobre XCTest, consulte [Noções básicas](https://developer.apple.com/library/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/03-testing_basics.html) sobre *testes com o Xcode*.

Para executar um teste, você cria os pacotes para a execução do teste e faz o upload desses pacotes para o Device Farm.

Para acessar mais informações sobre testes no Device Farm, consulte [Frameworks de teste e testes integrados no AWS Device Farm](test-types.md).

**Topics**
+ [Crie os pacotes para sua XCTest corrida](#test-types-ios-xctest-create-packages)
+ [Faça o upload dos pacotes para sua XCTest execução no Device Farm](#test-types-ios-xctest-upload)

## Crie os pacotes para sua XCTest corrida
<a name="test-types-ios-xctest-create-packages"></a>

Para testar seu aplicativo usando a XCTest estrutura, o Device Farm exige o seguinte:
+ Que seu pacote de aplicativos seja um arquivo `.ipa`.
+ Seu XCTest pacote como um `.zip` arquivo.

Que você crie esses pacotes usando a saída da compilação gerada pelo Xcode. Conclua as etapas a seguir para criar os pacotes para que você possa carregá-los no Device Farm.

**Para gerar a saída da compilação para seu aplicativo**

1. Abra o projeto do aplicativo em Xcode.

1. No menu suspenso do esquema na barra de ferramentas do Xcode, escolha **Dispositivo iOS genérico** como destino.

1. No menu **Produto**, selecione **Compilar para** e depois selecione **Teste**.

**Para criar o pacote de aplicativos**

1. No navegador de projeto no Xcode, em **Produtos**, abra o menu contextual do arquivo chamado `app-project-name.app`. Escolha **Mostrar no Finder**. O Finder abrirá uma pasta chamada `Debug-iphoneos`, que contém a saída gerada pelo Xcode para sua compilação de teste. Essa pasta inclui o arquivo `.app` .

1. No Finder, crie uma nova pasta e nomeie-a `Payload`.

1. Copie o arquivo `app-project-name.app` e cole-o na pasta `Payload`.

1. Abra o menu contextual da pasta `Payload` e escolha **Compactar "Payload"**. Um arquivo chamado `Payload.zip` será criado.

1. Altere o nome do arquivo e a extensão de `Payload.zip` para `app-project-name.ipa`.

   Em uma etapa posterior, você fornecerá esse arquivo ao Device Farm. Para facilitar a localização do arquivo, você pode movê-lo para outro local, como sua área de trabalho.

1. Opcionalmente, você pode excluir a pasta `Payload` e o arquivo `.app` que está nela.

**Para criar o XCTest pacote**

1. No Finder, no diretório `Debug-iphoneos`, abra o menu contextual do arquivo `app-project-name.app`. Escolha **Mostrar conteúdo do pacote**.

1. No conteúdo do pacote, abra a pasta `Plugins`. Essa pasta contém um arquivo chamado `app-project-name.xctest`.

1. Abra o menu contextual desse arquivo e escolha **Compactar "`app-project-name.xctest`"**. Um arquivo chamado `app-project-name.xctest.zip` será criado.

   Em uma etapa posterior, você fornecerá esse arquivo ao Device Farm. Para facilitar a localização do arquivo, você pode movê-lo para outro local, como sua área de trabalho.

## Faça o upload dos pacotes para sua XCTest execução no Device Farm
<a name="test-types-ios-xctest-upload"></a>

Use o console do Device Farm para carregar os pacotes do seu teste.

1. Faça login no console do Device Farm em [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)

1. Se você ainda não tiver um projeto, crie um. Para obter as etapas para criar um projeto, consulte [Criar um projeto no AWS Device Farm](how-to-create-project.md).

   Caso contrário, no painel de navegação do Device Farm, escolha **Teste para dispositivos móveis** e escolha **Projetos**.

1. Escolha o projeto que você deseja usar para executar o teste.

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 o arquivo `.ipa` para seu aplicativo e faça o upload dele.
**nota**  
Seu pacote `.ipa` deve ser compilado para testes.

1. Em **Configurar teste**, na seção **Selecionar estrutura de teste**, escolha **XCTest**. Depois, selecione **Escolher arquivo** em **Fazer upload de aplicação**.

1. Navegue até o `.zip` arquivo que contém o XCTest pacote do seu aplicativo e faça o upload dele.

1. Conclua as etapas restantes no processo de criação do projeto. Selecione os dispositivos que deseja testar e especifique o estado do dispositivo.

1. Escolha **Criar execução**. O Device Farm executa o teste e mostra os resultados no console.