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

# Como trabalhar com aplicações do AWS CDK
<a name="aws-cdk-apps"></a>


****  

|  | 
| --- |
| Esta é uma documentação de pré-lançamento de um recurso em versão de pré-visualização. Está sujeita a alteração. | 

Use o **AWS CDK Explorer** no kit de ferramentas da AWS para VS Code para visualizar e trabalhar com aplicações do AWS CDK.

## Pré-requisitos
<a name="aws-cdk-apps-prereq"></a>
+ Verifique se o sistema atende aos pré-requisitos especificados em [Instalar o kit de ferramenta para VS Code](setup-toolkit.md#setup-prereq).
+ Instale a interface de linha de comandos do AWS CDK, conforme descrito nas primeiras seções de [Getting started with the AWS CDK](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html) no *Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK)*.
**Importante**  
A versão do AWS CDK deve ser 1.17.0 ou posterior. Use **`cdk --version`** na linha de comando para ver qual versão está sendo executada.

## Visualizar uma aplicação do AWS CDK
<a name="aws-cdk-apps-visualize"></a>

Ao usar o AWS CDK Explorer do kit de ferramentas da AWS para VS Code, você pode gerenciar as [pilhas](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html) e os [recursos](https://docs.aws.amazon.com/cdk/latest/guide/resources.html) armazenados nas estruturas do CDK das aplicações. O AWS CDK Explorer mostra os recursos em uma exibição em árvore usando as informações definidas no arquivo `tree.json` que é criado quando você executa o comando **`cdk synth`**. O arquivo `tree.json` está localizado no diretório `cdk.out` de uma aplicação, por padrão.

Para começar a usar o AWS CDK Explorer do kit de ferramentas, você precisará criar uma aplicação do CDK.

1. Realize as primeiras etapas do [Hello World Tutorial](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial), localizado no [Guia do desenvolvedor do AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html).
**Importante**  
Ao chegar à etapa **Deploying the Stack** do tutorial, pare e retorne a este guia.
**nota**  
Você pode executar os comandos fornecidos no tutorial (por exemplo, **`mkdir`** e **`cdk init`**) em uma linha de comando do sistema operacional ou em uma janela do **Terminal** dentro do editor do VS Code.

1. Depois de realizar as etapas necessárias do tutorial do CDK, abra o conteúdo do CDK que você criou no editor do VS Code.

1. No painel de navegação da AWS, expanda o título **CDK (pré-visualização)**. Suas aplicações do CDK e os recursos correspondentes agora são exibidos na visualização em árvore do CDK Explorer. 

### Observações importantes
<a name="important-notes"></a>
+ Ao carregar aplicações do CDK no editor do VS Code, você poderá carregar várias pastas ao mesmo tempo. Cada pasta pode conter várias aplicações do CDK, conforme mostrado na imagem anterior. O AWS CDK Explorer localiza aplicações no diretório raiz do projeto e os respectivos subdiretórios diretos.
+ Ao executar as primeiras etapas do tutorial, você observará que o último comando executado é **`cdk synth`**, que gera o arquivo `tree.json`. Se você alterar aspectos de uma aplicação do CDK (por exemplo, adicionar mais recursos), será necessário executar esse comando novamente para ver as alterações refletidas na visualização em árvore.

## Executar outras operações em uma aplicação do AWS CDK
<a name="aws-cdk-apps-other-tasks"></a>

Você pode usar o editor do VS Code para realizar outras operações em uma aplicação do CDK, da mesma forma que faria usando a linha de comando do sistema operacional ou de outras ferramentas. Por exemplo, você pode atualizar os arquivos de código no editor e implantar a aplicação usando uma janela do **Terminal** do VS Code.

Para testar esses tipos de ações, use o editor do VS Code para prosseguir com o [Tutorial Hello World](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial) no *Guia do desenvolvedor do AWS CDK*. Verifique se você executou a última etapa **Destroying the App's Resources** para não incorrer em custos inesperados na conta da AWS.