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

# Transformar código na linha de comandos com o Amazon Q Developer
<a name="transform-CLI"></a>

Você pode transformar suas aplicações por meio da linha de comandos com a ferramenta de transformação de linha de comandos do Amazon Q Developer. Para transformar seu código, você fornece o caminho para o código-fonte e todos os arquivos de configuração necessários, e o Amazon Q gera o novo código em uma série de etapas. Durante a transformação, o Amazon Q cria código em seu ambiente local para verificar as alterações. Para obter mais informações, consulte [Compilar código no ambiente local](#local-builds). O Amazon Q cria uma ramificação em seu repositório onde confirma as alterações no código. Quando a transformação estiver concluída, você pode mesclar a ramificação em sua ramificação original para incorporar as alterações à sua base de código. 

Para começar, instale a ferramenta de linha de comando, faça a autenticação e, em seguida, veja os comandos para configurar e iniciar uma transformação. 

**Topics**
+ [Compilar código no ambiente local](#local-builds)
+ [Comandos](#commands)
+ [Executar uma transformação na linha de comandos com o Amazon Q Developer](run-CLI-transformations.md)
+ [Solucionar problemas de transformações na linha de comando](troubleshooting-CLI-transformations.md)
+ [Histórico de versões da ferramenta de transformação de linha de comandos do Amazon Q Developer](transform-CLI-versions.md)

## Compilar código no ambiente local
<a name="local-builds"></a>

Durante uma transformação, o Amazon Q realiza compilações de verificação em seu ambiente local. O Amazon Q transforma seu código no lado do servidor em várias etapas. Após cada etapa, o Amazon Q envia o código para seu ambiente local para compilar e testar as alterações feitas. O código é então enviado de volta para o lado do servidor para continuar a transformação. 

A compilação no ambiente local ajuda a verificar o código transformado, permitindo que o Amazon Q execute testes que exigem acesso a recursos privados. Para minimizar os riscos de segurança associados à compilação de código gerado por IA no ambiente local, o Amazon Q revisa e atualiza o código que gera para tratar de questões de segurança.

**nota**  
O Amazon Q realiza transformações com base nas solicitações, descrições e conteúdo do projeto. Para manter a segurança, evite incluir artefatos externos não verificados no repositório do projeto e sempre valide o código transformado em termos de funcionalidade e segurança.

## Comandos
<a name="commands"></a>

Para step-by-step obter instruções sobre como executar esses comandos, consulte[Executar uma transformação na linha de comandos com o Amazon Q Developer](run-CLI-transformations.md). 

Para configurar uma transformação e se autenticar no Amazon Q Developer Pro, execute:

```
qct configure
```

Para iniciar uma transformação para uma atualização do Java, execute o comando a seguir. Para*<your-source-java-version>*, você pode inserir `JAVA_1.8``JAVA_8`,`JAVA_11`,`JAVA_17`, ou`JAVA_21`. Para*<your-target-java-version>*, você pode inserir um `JAVA_17` ou`JAVA_21`. `--source_version` e `--target_version` são opcionais. O sinalizador `--trust` permite que uma transformação seja executada durante a verificação do código para manter a segurança.

```
qct transform --source_folder <path-to-folder>
    --source_version <your-source-java-version>        
    --target_version <your-target-java-version>
    --trust
```

Para iniciar uma transformação para uma conversão SQL, execute:

```
qct transform --source_folder <path-to-folder>
    --sql_conversion_config_file <path-to-sql-config-file>
```

Para ver qual versão da ferramenta de linha de comandos para transformação você está usando, execute:

```
qct -v
```

Para obter ajuda com as transformações, execute:

```
qct -h
```

Para visualizar seu histórico de trabalhos de transformação, execute:

```
qct history
```

Para obter mais informações sobre como visualizar e gerenciar o histórico de trabalhos de transformação, consulte [Visualizar o histórico de trabalhos na linha de comando](transformation-job-history.md#cli-job-history).