

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

# 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).