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

# Conceitos básicos do Device Farm
<a name="getting-started"></a>

Este passo a passo mostra como usar o Device Farm para testar um aplicativo nativo para Android ou iOS. Use o console do Device Farm para criar um projeto, carregar um arquivo .apk ou .ipa, executar um conjunto de testes padrão e, em seguida, visualizar os resultados.

**nota**  
O Device Farm está disponível somente na região `us-west-2` (Oregon) da AWS .

**Topics**
+ [Pré-requisitos](#getting-started-prepare)
+ [Etapa 1: Fazer login no console do](#getting-started-console)
+ [Etapa 2: criar um projeto](#getting-started-create-project)
+ [Etapa 3: Criar e iniciar uma execução](#getting-started-create-run)
+ [Etapa 4: visualizar os resultados da execução](#getting-started-view-run-results)
+ [Próximas etapas](#getting-started-next-steps)

## Pré-requisitos
<a name="getting-started-prepare"></a>

Antes de começar, verifique se você atendeu aos seguintes requisitos:
+ Siga as etapas em [Configurar](setting-up.md). Você precisa de uma AWS conta e de um usuário AWS Identity and Access Management (IAM) com permissão para acessar o Device Farm.
+ Em relação ao Android, você pode trazer um arquivo .apk (pacote de aplicações Android) ou usar a aplicação de exemplo que fornecemos. Para iOS, você precisa de um arquivo .ipa (arquivo de aplicativo iOS). Você carregará o arquivo no Device Farm mais adiante neste passo a passo.
**nota**  
Confirme se o arquivo .ipa foi desenvolvido para um dispositivo iOS e não para um simulador.
+ (Opcional) Você precisa de um teste de uma das estruturas de teste compatíveis com o Device Farm. Você carrega esse pacote de teste no Device Farm e, em seguida, executa o teste mais adiante neste passo a passo. Se você não tiver um pacote de testes disponível, poderá especificar e executar um conjunto de testes integrado padrão. Para obter mais informações, consulte [Frameworks de teste e testes integrados no AWS Device Farm](test-types.md).

## Etapa 1: Fazer login no console do
<a name="getting-started-console"></a>

Você pode usar o console do Device Farm para criar e gerenciar projetos e execuções para testes. Você conhecerá projetos e execuções ainda nesta demonstração.
+ Faça login no console do Device Farm em [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)

## Etapa 2: criar um projeto
<a name="getting-started-create-project"></a>

Para testar um aplicativo no Device Farm, você deve primeiro criar um projeto.

1. No painel de navegação, escolha **Teste para dispositivos móveis** e **Projetos**.

1. Em **Projetos de teste para dispositivos móveis**, escolha **Criar projeto**.

1. Em **Criar projeto**, insira um **Nome do projeto** (por exemplo, **MyDemoProject**).

1. Escolha **Criar**.

   O console abre a página **Testes automatizados** do seu projeto recém-criado.

## Etapa 3: Criar e iniciar uma execução
<a name="getting-started-create-run"></a>

Agora que você já tem um projeto, pode criar e iniciar uma execução. Para obter mais informações, consulte [Execuções](test-runs.md).

1. Na guia **Testes automatizados**, escolha **Criar execução**. Como alternativa, você pode seguir o tutorial no console selecionando **Criar execução com tutorial**.

1. (Opcional) Em **Configurações de execução**, na seção **Nome da execução**, insira um nome para a execução. Se nenhum nome for fornecido, o console do Device Farm chamará sua execução de “Minha execução do Device Farm” por padrão.

1. Em **Configurações de execução**, na seção **Tipo de execução**, selecione seu tipo de execução. Selecione **Aplicação Android** se você não tiver uma aplicação pronta para teste ou se estiver testando uma aplicação Android (.apk). Selecione **Aplicação iOS** se estiver testando uma aplicação iOS (.ipa).

1. Em **Selecionar aplicação**, na seção **Opções de seleção de aplicações**, escolha **Selecionar aplicação de exemplo fornecida pelo Device Farm** se não tiver uma aplicação disponível para teste. Se você estiver trazendo sua própria aplicação, selecione **Fazer upload da própria aplicação** e escolha o arquivo da sua aplicação. Se você estiver fazendo upload de um aplicativo iOS, certifique-se de escolher **iOS device (Dispositivo iOS)**, e não um simulador.

1. Na página **Configurar teste**, na seção **Selecionar framework de teste**, escolha um dos frameworks de teste ou pacotes de testes integrados. Para ter mais informações sobre cada opção, consulte [Frameworks de teste e testes integrados no AWS Device Farm](test-types.md).
   + Se você ainda não tiver empacotado seus testes para o Device Farm, escolha **Integrado: fuzz** para executar um conjunto de testes padrão integrado. Você pode manter os valores padrão para **Contagem de eventos**, **Restrição de eventos** e **Semente aleatória**. Para obter mais informações, consulte [Executar o teste fuzz incorporado do Device Farm (Android e iOS)](test-types-built-in-fuzz.md).
   + Se você tiver um pacote de teste de uma das estruturas de teste compatíveis, escolha a estrutura de teste correspondente e, em seguida, faça o upload do arquivo que contém seus testes.

1. Em **Selecionar dispositivos**, escolha **Usar grupo de dispositivos** e **Principais dispositivos**.

1. (Opcional) Para adicionar configurações adicionais, abra o menu suspenso **Configuração adicional**. Nesta seção, é possível realizar qualquer um destes procedimentos:
   + Para fornecer outros dados para o Device Farm usar durante a execução, ao lado de **Adicionar dados extras**, selecione **Escolher arquivo** e, em seguida, navegue até o arquivo .zip que contém os dados e escolha-o.
   + Para instalar uma aplicação adicional para o Device Farm usar durante a execução, ao lado de **Instalar outras aplicações**, selecione **Escolher arquivo** e, em seguida, procure e escolha o arquivo .apk ou .ipa que contém a aplicação. Repita isso para outros aplicativos que você deseja instalar. Você pode alterar a ordem de instalação arrastando e soltando os aplicativos depois de fazer upload deles. 
   + Para especificar se Wi-Fi, Bluetooth, GPS ou NFC estará habilitado durante a execução, ao lado de **Set radio states (Definir estados de rádio)**, selecione as caixas apropriadas.
   + Para predefinir a latitude e a longitude do dispositivo para a execução, ao lado de **Device location (Local do dispositivo)**, insira as coordenadas.
   + Para predefinir a localidade da execução, em **Localidade do dispositivo**, escolha a localidade.
   + Selecione **Habilitar a gravação de vídeo** para gravar vídeos durante o teste.
   + Selecione **Habilitar a captura de dados de performance da aplicação** para capturar dados de desempenho do dispositivo.
**nota**  
A configuração do estado do rádio do dispositivo está disponível apenas para testes nativos do Android no momento.
**nota**  
Se você tiver dispositivos privados, a configuração específica dos dispositivos privados também será exibida.

1. Na parte inferior da página, escolha **Criar execução** para agendar a execução.

O Device Farm inicia a execução assim que os dispositivos estão disponíveis, normalmente em poucos minutos. Para ver o status da execução, na página **Testes automatizados** do seu projeto, escolha o nome da execução. Na página de execução, em **Dispositivos**, cada dispositivo começa com o ícone pendente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-calendar.png) na tabela de dispositivos e depois muda para o ícone em execução ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-progress.png) quando o teste começa. Quando cada teste termina, o console exibe um ícone de resultado do teste ao lado do nome do dispositivo. Quando todos os testes são concluídos, o ícone pendente ao lado da execução muda para um ícone de resultado de teste.

## Etapa 4: visualizar os resultados da execução
<a name="getting-started-view-run-results"></a>

Para ver os resultados do teste, na página **Testes automatizados** do seu projeto, escolha o nome da execução. A página de resumo exibe:
+ O número total de testes, por resultado.
+ Lista de testes com avisos exclusivos ou falhas.
+ Uma lista de dispositivos com resultados de testes para cada um.
+ Quaisquer capturas de tela durante a execução, agrupadas por dispositivo.
+ Uma seção para baixar o resultado da análise.

Para obter mais informações, consulte [Visualizar relatórios de testes no Device Farm](how-to-use-reports.md).

## Próximas etapas
<a name="getting-started-next-steps"></a>

Para obter mais informações sobre o Device Farm, consulte [Conceitos](concepts.md).