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

# Software compatível em ambientes de teste personalizados
<a name="custom-test-environments-hosts-software"></a>

 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
<a name="custom-test-environments-hosts-software-configured"></a>

 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
<a name="custom-test-environments-hosts-software-selection"></a>

 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
<a name="custom-test-environments-hosts-software-cli"></a>

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 <software> <version>     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).