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á.
# Hosts para ambientes de teste personalizados
O Device Farm oferece suporte a um conjunto de sistemas operacionais com software pré-configurado por meio do uso de um ambiente de host de teste. Durante a execução do teste, o Device Farm utiliza instâncias gerenciadas pela Amazon (hosts) que se conectam dinamicamente ao dispositivo selecionado em teste. Essa instância é totalmente limpa e não é reutilizada entre as execuções e é encerrada com os artefatos gerados após a conclusão da execução do teste.
**Topics**
+ [Hosts de teste disponíveis para ambientes de teste personalizados](#custom-test-environments-hosts-available)
+ [Seleção de um host de teste para ambientes de teste personalizados](#test-host-selection)
+ [Software compatível em ambientes de teste personalizados](custom-test-environments-hosts-software.md)
+ [Ambiente de teste para dispositivos Android](custom-test-environments-hosts-android.md)
+ [Ambiente de teste para dispositivos iOS](custom-test-environments-hosts-ios.md)
## Hosts de teste disponíveis para ambientes de teste personalizados
Os hosts de teste são totalmente gerenciados pelo Device Farm. A tabela a seguir lista os hosts de teste Device Farm atualmente disponíveis e compatíveis para ambientes de teste personalizados.
| Plataforma de dispositivos | Host de teste | Sistema operacional | Arquitetura (s) | Dispositivos compatíveis |
| --- | --- | --- | --- | --- |
| Android | amazon\$1linux\$12 | Amazon Linux 2 | x86\$164 | Android6 e acima |
| iOS | macos\$1sequoia | macOS Sequoia(versão 15) | arm64 | iOS15 a 26 |
**nota**
Periodicamente, o Device Farm adiciona novos hosts de teste para uma plataforma de dispositivo para oferecer suporte às versões mais recentes do sistema operacional do dispositivo e suas dependências. Quando isso ocorre, os hosts de teste mais antigos da respectiva plataforma do dispositivo estão sujeitos ao fim do suporte.
### Versão do sistema operacional
Cada host de teste disponível usa uma versão específica do sistema operacional compatível com o Device Farm no momento. Embora tentemos usar a versão mais recente do sistema operacional, essa pode não ser a versão mais recente distribuída publicamente disponível. O Device Farm atualizará periodicamente o sistema operacional com pequenas atualizações de versão e patches de segurança.
Para saber a versão específica (incluindo a versão secundária) do sistema operacional em uso durante a execução do teste, você pode adicionar o seguinte trecho de código a qualquer uma das fases do arquivo de especificação de teste.
**Example**
```
phases:
install:
commands:
# The following example prints the instance's operating system version details
- |-
if [[ "Darwin" == "$(uname)" ]]; then
echo "$(sw_vers --productName) $(sw_vers --productVersion) ($(sw_vers --buildVersion))";
else
echo "$(. /etc/os-release && echo $PRETTY_NAME) ($(uname -r))";
fi
```
## Seleção de um host de teste para ambientes de teste personalizados
Você pode especificar o host de teste do Android e do iOS nas `ios_test_host` variáveis apropriadas `android_test_host` do seu [arquivo de especificação de teste](custom-test-environment-test-spec.md#custom-test-environment-test-spec-syntax).
Se você não especificar uma seleção de host de teste para a plataforma de dispositivo especificada, os testes serão executados no host de teste que o Device Farm definiu como padrão para o dispositivo e a configuração de teste especificados.
**Importante**
Ao testar no iOS 18 e versões anteriores, um host de teste legado será usado quando um host não for selecionado. Para obter mais informações, consulte o tópico no[Host de teste iOS antigo](custom-test-environments-hosts-ios.md#legacy-ios-host).
Como exemplo, analise o seguinte trecho de código:
**Example**
```
version: 0.1
android_test_host: amazon_linux_2
ios_test_host: macos_sequoia
phases:
# ...
```
# Software compatível em ambientes de teste personalizados
O Device Farm usa máquinas host pré-instaladas com muitas das bibliotecas de software necessárias para executar estruturas de teste suportadas em nosso serviço, fornecendo um ambiente de teste pronto para o lançamento. O Device Farm oferece suporte a vários idiomas por meio do uso de nosso mecanismo de seleção de software e atualizará periodicamente as versões dos idiomas incluídos no ambiente.
Para qualquer outro software necessário, você pode modificar o arquivo de especificação de teste para instalar pelo pacote de testes, fazer o download da Internet ou acessar origens privadas na VPC (consulte [VPC ENI](https://docs.aws.amazon.com//devicefarm/latest/developerguide/vpc-eni.html) para obter mais informações). Para obter mais informações, consulte [Exemplos de especificações de teste](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example).
## Software pré-configurado
Para facilitar o teste de dispositivos em cada plataforma, as seguintes ferramentas são fornecidas no host de teste:
| Ferramentas | Plataforma (s) do dispositivo |
| --- | --- |
| Android SDK Build-Tools | Android |
| Android SDK Platform-Tools(inclui`adb`) | Android |
| Xcode | iOS |
## Software selecionável
Além do software pré-configurado no host, o Device Farm oferece uma maneira de selecionar determinadas versões do software compatível por meio das `devicefarm-cli` ferramentas.
A tabela a seguir contém o software selecionável e os hosts de teste que o contêm.
| Software/Ferramenta | Hosts que oferecem suporte a este software | Comando a ser usado em sua especificação de teste |
| --- | --- | --- |
| Java 17 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 17` |
| Java 11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 11` |
| Java 8 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 8` |
| Node.js 20 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 20` |
| Node.js 18 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 18` |
| Node.js 16 | amazon\$1linux\$12 | `devicefarm-cli use node 16` |
| Python 3.11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.11` |
| Python 3.10 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.10` |
| Python 3.9 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.9` |
| Python 3.8 | amazon\$1linux\$12 | `devicefarm-cli use python 3.8` |
| Ruby 3.2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use ruby 3.2` |
| Ruby 2.7 | amazon\$1linux\$12 | `devicefarm-cli use ruby 2.7` |
| Appium 3 | amazon\$1linux\$12 | `devicefarm-cli use appium 3` |
| Appium 2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use appium 2` |
| Appium 1 | amazon\$1linux\$12 | `devicefarm-cli use appium 1` |
| Xcode 26 | macos\$1sequoia | `devicefarm-cli use xcode 26` |
| Xcode 16 | macos\$1sequoia | `devicefarm-cli use xcode 16` |
O host de teste também inclui ferramentas de suporte comumente usadas para cada versão do software, como gerenciadores de `npm` pacotes `pip` e (incluídos no Python e no Node.js, respectivamente) e dependências (como o UIAutomator2 driver Appium) para ferramentas como o Appium. Isso garante que você tenha as ferramentas necessárias para trabalhar com as estruturas de teste compatíveis.
# Usando a ferramenta devicefarm-cli em ambientes de teste personalizados
O host de teste usa uma ferramenta padronizada de gerenciamento de versões chamada ` devicefarm-cli` para selecionar versões de software. Essa ferramenta é separada da AWS CLI e está disponível somente no host de teste do Device Farm. Com a `devicefarm-cli`, você pode alternar para qualquer versão de software pré-instalada no host de teste. Isso proporciona uma maneira direta de manter o arquivo de especificações de teste do Device Farm ao longo do tempo e oferece um mecanismo previsível para atualizar as versões do software no futuro.
**Importante**
Essa ferramenta de linha de comando não está disponível em hosts iOS antigos. Para obter mais informações, consulte o tópico no[Host de teste iOS antigo](custom-test-environments-hosts-ios.md#legacy-ios-host).
O trecho abaixo mostra a página de `help` da `devicefarm-cli`:
```
$ devicefarm-cli help
Usage: devicefarm-cli COMMAND [ARGS]
Commands:
help Prints this usage message.
list Lists all versions of software configurable
via this CLI.
use Configures the software for usage within the
current shell's environment.
```
Vamos analisar alguns exemplos usando a `devicefarm-cli`. Para usar a ferramenta para alterar a versão do Python de *3.10* para *3.9* em seu arquivo de especificação de teste, execute os seguintes comandos:
```
$ python --version
Python 3.10.12
$ devicefarm-cli use python 3.9
$ python --version
Python 3.9.17
```
Para alterar a versão do Appium de *1* para: *2*
```
$ appium --version
1.22.3
$ devicefarm-cli use appium 2
$ appium --version
2.1.2
```
**dica**
Observe que, quando você seleciona uma versão de software, a `devicefarm-cli` também alterna as ferramentas de suporte para essas linguagens, como `pip` para Python e `npm` para NodeJS.
Para obter mais informações sobre o software pré-instalado no host de teste, consulte[Software compatível em ambientes de teste personalizados](custom-test-environments-hosts-software.md).
# Ambiente de teste para dispositivos Android
O AWS Device Farm utiliza máquinas host Amazon Elastic Compute Cloud (EC2) executando o Amazon Linux 2 para executar testes do Android. Quando você agenda uma execução de teste, o Device Farm aloca um host dedicado para cada dispositivo para executar testes de forma independente. As máquinas host são encerradas após a execução do teste junto com todos os artefatos gerados.
O host Amazon Linux 2 oferece várias vantagens:
+ **Testes mais rápidos e confiáveis**: em comparação com o host antigo, o novo host de teste melhora significativamente a velocidade do teste, especialmente reduzindo os tempos de início do teste. O host Amazon Linux 2 também demonstra maior estabilidade e confiabilidade durante os testes.
+ **Acesso remoto aprimorado para testes manuais**: as atualizações para o host de teste mais recente e as melhorias resultam em menor latência e melhor desempenho de vídeo para testes manuais do Android.
+ **Seleção de versão de software padrão**: o Device Farm agora padroniza o suporte às principais linguagens de programação no host de teste, bem como nas versões de estrutura do Appium. Para linguagens compatíveis (atualmente Java, Python, Node.js e Ruby) e Appium, o novo host de teste fornece versões estáveis de longo prazo logo após o lançamento. O gerenciamento centralizado de versões por meio da ferramenta `devicefarm-cli` permite o desenvolvimento de arquivos de especificações de teste com uma experiência consistente entre as estruturas.
**Topics**
+ [Intervalos de IP aceitos para o ambiente de teste do Amazon Linux 2 no Device Farm](amazon-linux-2-ip-ranges.md)
# Intervalos de IP aceitos para o ambiente de teste do Amazon Linux 2 no Device Farm
Os clientes geralmente precisam saber o intervalo de IP do qual o tráfego do Device Farm se origina, principalmente para definir seus firewalls e configurações de segurança. Em relação aos hosts de teste do Amazon EC2, o intervalo de IP abrange toda a região `us-west-2`. Em relação aos hosts de teste do Amazon Linux 2, que é a opção padrão para novas execuções do Android, os intervalos foram restritos. O tráfego agora se origina de um conjunto específico de gateways NAT, restringindo o intervalo de IP aos seguintes endereços:
****
| Intervalos de IP |
| --- |
| **44.236.137.143** |
| **52.13.151.244** |
| **52.35.189.191** |
| **54.201.250.26** |
Para acessar mais informações sobre ambientes de teste no Device Farm, consulte [Ambiente de teste para dispositivos Android](custom-test-environments-hosts-android.md).
# Ambiente de teste para dispositivos iOS
O Device Farm utiliza instâncias macOS gerenciadas pela Amazon (hosts) que se conectam dinamicamente ao dispositivo iOS durante a execução do teste. Cada host é pré-configurado com um software que permite testar dispositivos em várias plataformas de teste populares, como XCTest UI e Appium.
A iteração atual do host de teste do iOS melhorou a experiência de teste em comparação com as versões anteriores, incluindo:
+ **Experiência consistente de sistema operacional e ferramentas do iOS 15 ao iOS 26** Antes, o host de teste era determinado pelo dispositivo em uso, resultando em um ambiente de software fragmentado ao ser executado em várias versões do iOS. A experiência atual permite uma seleção simples de hosts para permitir um ambiente consistente em todos os dispositivos. Isso permitirá que a mesma versão e ferramentas do macOS (como o Xcode) estejam disponíveis em cada dispositivo iOS.
+ **Melhorias no desempenho dos testes do iOS 15 e 16** Usando a infraestrutura atualizada, o tempo de configuração melhorou substancialmente para os testes do iOS 15 e 16.
+ **Versões padronizadas de software selecionáveis para dependências suportadas** Agora temos o sistema de seleção de `devicefarm-cli` software nos hosts de teste iOS e Android, permitindo que você selecione sua versão preferida de nossas dependências suportadas. Para dependências compatíveis (como Java, Python, Node.js, Ruby e Appium), as versões poderão ser selecionadas por meio da especificação de teste. Para ter uma ideia de como esse recurso funciona, consulte o tópico em[Software compatível em ambientes de teste personalizados](custom-test-environments-hosts-software.md).
**Importante**
Se estiver executando no iOS 18 e versões anteriores, seus testes serão executados em hosts de teste legados por padrão. Veja o tópico abaixo sobre como migrar dos hosts legados.
## Host de teste iOS antigo
Para testes existentes no iOS 18 e versões anteriores, os hosts de teste legados são selecionados por padrão para ambientes de teste personalizados. A tabela a seguir contém a versão do host de teste que é executada pela versão do dispositivo iOS.
| Sistema operacional | Arquitetura (s) | Padrão para dispositivos |
| --- | --- | --- |
| macOS Sonoma(versão 14) | arm64 | iOS 18 |
| macOS Ventura(versão 13) | arm64 | iOS 17 |
| macOS Monterey(versão 12) | x86\$164 | iOS 16e abaixo |
Para selecionar os hosts de teste mais novos, consulte o tópico relacionado[Migrando seus ambientes de teste personalizados para os novos hosts de teste do iOS](ios-host-migration.md).
## Software compatível para dispositivos iOS
Para oferecer suporte aos testes de dispositivos iOS, os hosts de teste do Device Farm para dispositivos iOS vêm pré-configurados com o Xcode e suas ferramentas de linha de comando associadas. Para outros softwares disponíveis, consulte o tópico relacionado[Software compatível em ambientes de teste personalizados](custom-test-environments-hosts-software.md).
# Migrando seus ambientes de teste personalizados para os novos hosts de teste do iOS
Para migrar os testes existentes do host legado para o novo host de teste do macOS, você precisará desenvolver novos arquivos de especificação de teste com base nos arquivos preexistentes.
A abordagem recomendada é começar com o exemplo de arquivo de especificação de teste para os tipos de teste desejados e, em seguida, migrar os comandos relevantes do arquivo de especificação de teste antigo para o novo. Isso permite que você aproveite novos recursos e otimizações da especificação de teste de exemplo para o novo host enquanto reutiliza trechos do código existente.
**Topics**
+ [Tutorial: migrando arquivos de especificações de teste do iOS com o console](#ios-host-migration-console-tutorial)
+ [Diferenças entre os hosts de teste novos e os antigos](#ios-host-migration-differences)
## Tutorial: migrando arquivos de especificações de teste do iOS com o console
Neste exemplo, o console Device Farm será usado para integrar uma especificação de teste de dispositivo iOS existente para usar o novo host de teste.
### Etapa 1: Criar novos arquivos de especificação de teste com o console
1. Faça login no [console do AWS Device Farm](https://console.aws.amazon.com/devicefarm).
1. Navegue até o projeto do Device Farm que contém seus testes de automação.
1. Faça o download de uma cópia da especificação de teste existente com a qual você deseja integrar.
1. Clique na opção “Configurações do projeto” e navegue até a guia **Uploads**.
1. Navegue até o arquivo de especificação de teste com o qual você deseja integrar.
1. Clique no botão **Download** para fazer uma cópia local desse arquivo.
1. Navegue de volta para a página do projeto e clique em **Criar execução**.
1. Preencha as opções no assistente como se fosse iniciar uma nova execução, mas pare na opção **Selecionar especificação de teste**.
1. Usando a especificação de teste do iOS selecionada por padrão, clique no botão **Criar uma especificação de teste**.
1. Modifique a especificação do teste que foi selecionada por *padrão* no editor de texto.
1. Se ainda não estiver presente, modifique o arquivo de especificação de teste para selecionar o novo host usando:
```
ios_test_host: macos_sequoia
```
1. A partir da cópia de sua especificação de teste baixada em uma etapa anterior, revise cada ` phase` uma.
1. Copie comandos das fases da especificação de teste antiga para cada fase respectiva na nova especificação de teste, ignorando os comandos relacionados à instalação ou seleção de Java, Python, Node.js, Ruby, Appium ou Xcode.
1. Insira um novo nome de arquivo na caixa de texto **Salvar como**.
1. Clique no botão **Salvar como novo** para salvar suas alterações.
Para ver um exemplo de um arquivo de especificação de teste que você pode usar como referência, consulte o exemplo fornecido em[Exemplos de especificações de teste](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example).
### Etapa 2: Selecionar software pré-instalado
No novo host de teste, as versões pré-instaladas do software são selecionadas usando uma nova ferramenta padronizada de gerenciamento de versões chamada. `devicefarm-cli` Agora, esse conjunto de ferramentas é a abordagem recomendada para usar os vários softwares que fornecemos nos hosts de teste.
Como exemplo, você adicionaria a seguinte linha para usar um JDK 17 diferente em seu ambiente de teste:
```
- devicefarm-cli use java 17
```
Para obter mais informações sobre o software suportado disponível, revise:[Software compatível em ambientes de teste personalizados](custom-test-environments-hosts-software.md).
### Etapa 3: Usando o Appium e suas dependências por meio das ferramentas de seleção de software
O novo host de teste suporta apenas o Appium 2.x e superior. Selecione explicitamente a versão do Appium usando o`devicefarm-cli`, enquanto remove ferramentas legadas, como. ` avm` Por exemplo:
```
# This line using 'avm' should be removed
# - avm 2.3.1
# And the following lines should be added
- devicefarm-cli use appium 2 # Selects the version
- appium --version # Prints the version
```
A versão do Appium selecionada `devicefarm-cli` vem pré-instalada com uma versão compatível do driver XCUITest para iOS.
Além disso, você precisará atualizar sua especificação de teste para usar ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9` em vez de` DEVICEFARM_WDA_DERIVED_DATA_PATH`. A nova variável de ambiente aponta para uma versão pré-construída da WebDriverAgent 9.x, que é a versão mais recente compatível com os testes do Appium 2.
Para obter mais informações, revise [Seleção de uma WebDriverAgent versão para testes do iOS](test-types-appium.md#test-types-appium-select-wda) [Variáveis de ambiente para testes Appium](custom-test-environment-variables.md#custom-test-environment-variables-appium) e.
## Diferenças entre os hosts de teste novos e os antigos
Ao editar seu arquivo de especificação de teste para usar o novo host de teste do iOS e fazer a transição dos testes do host de teste legado, esteja ciente dessas principais diferenças de ambiente:
+ **Versões do Xcode:** no ambiente antigo do host de teste, a versão do Xcode disponível foi baseada na versão iOS do dispositivo usado para testes. Por exemplo, testes em dispositivos iOS 18 usaram o Xcode 16 no host legado, enquanto os testes no iOS 17 usaram o Xcode 15. No novo ambiente host, todos os dispositivos podem acessar as mesmas versões do Xcode, permitindo um ambiente consistente para testes em dispositivos com versões diferentes. Para obter uma lista das versões do Xcode atualmente disponíveis, consulte[Software compatível](custom-test-environments-hosts-software.md).
+ **Seleção de versões de software:** em muitos casos, as versões padrão do software foram alteradas. Portanto, se você não estava selecionando explicitamente sua versão de software no host de teste legado antes, talvez queira especificá-la agora no novo host de teste usando [`devicefarm-cli`](custom-test-environments-hosts-software-cli.md). Na grande maioria dos casos de uso, recomendamos que os clientes selecionem explicitamente as versões do software que usam. Ao selecionar uma versão de software, `devicefarm-cli` você terá uma experiência previsível e consistente com ela e receberá muitos avisos se a Device Farm planejar remover essa versão do host de teste.
Além disso, ferramentas de seleção de software como `nvm`, `pyenv`, ` avm` e `rvm` foram removidas em favor do novo sistema de seleção de software ` devicefarm-cli`.
+ **Versões de software disponíveis:** muitas versões do software pré-instalado anteriormente foram removidas e muitas novas versões foram adicionadas. Portanto, ao usar a `devicefarm-cli` para selecionar suas versões de software, você deve selecionar as versões que estão na [lista de versões compatíveis](custom-test-environments-hosts-software.md).
+ **O `libimobiledevice` conjunto de ferramentas foi removido** em favor de ferramentas mais novas/originais para monitorar os testes atuais de dispositivos iOS e os padrões do setor. Para o iOS 17 e versões posteriores, você pode migrar a maioria dos comandos para usar ferramentas semelhantes do Xcode, chamadas. `devicectl` Para obter informações sobre`devicectl`, você pode executar `xcrun devicectl help` a partir de uma máquina com o Xcode instalado.
+ Os **caminhos de arquivo codificados** no arquivo de especificação de teste do host legado como caminhos absolutos provavelmente não funcionarão conforme o esperado no novo host de teste e geralmente não são recomendados para o uso do arquivo de especificação de teste. Recomendamos que você use caminhos relativos e variáveis de ambiente para todo o código do arquivo de especificação de teste. Para obter mais informações, consulte o tópico em[Práticas recomendadas para execução de ambientes de teste personalizados](custom-test-environments-best-practices.md).
+ **Versão e arquitetura do sistema operacional:** os hosts de teste antigos estavam usando uma variedade de versões do macOS e arquiteturas de CPU com base no dispositivo atribuído. Como resultado, os usuários podem notar algumas diferenças nas bibliotecas de sistema disponíveis no ambiente. Para obter mais informações sobre a versão anterior do sistema operacional host, revise[Host de teste iOS antigo](custom-test-environments-hosts-ios.md#legacy-ios-host).
+ **Para usuários do Appium**, a forma de selecionar o WebDriverAgent mudou para um prefixo de variável de ambiente de uso ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V` em vez do prefixo antigo. ` DEVICEFARM_WDA_DERIVED_DATA_PATH_V` Para obter mais informações sobre a variável atualizada, revise[Variáveis de ambiente para testes Appium](custom-test-environment-variables.md#custom-test-environment-variables-appium).
+ **Para usuários do Appium Java**, o novo host de teste não contém nenhum arquivo JAR pré-instalado em seu caminho de classe, enquanto o host anterior continha um para a estrutura TestNG (por meio de uma variável de ambiente). `$DEVICEFARM_TESTNG_JAR` Recomendamos que os clientes empacotem os arquivos JAR necessários para suas estruturas de teste dentro do pacote de teste e removam instâncias da variável `$DEVICEFARM_TESTNG_JAR` de seus arquivos de especificação de teste.
Recomendamos que entre em contato com a equipe de serviço por meio de um caso de suporte se tiver algum feedback ou dúvida sobre as diferenças entre os hosts de teste do ponto de vista do software.