AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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

# Trabalhando com construtores, executores e depuradores no IDE AWS Cloud9
<a name="build-run-debug"></a>

Um *construtor* instrui o Ambiente de Desenvolvimento AWS Cloud9 Integrado (IDE) a criar os arquivos de um projeto. Um *executor* instrui o AWS Cloud9 IDE a executar arquivos de um tipo específico. Um executor pode usar um *depurador* para ajudar a encontrar problemas no código-fonte dos arquivos.

Você pode usar o AWS Cloud9 IDE para criar, executar e depurar seu código das seguintes formas:
+ Use um compilador para compilar os arquivos do projeto. Para obter mais informações, consulte [Compilar os arquivos do projeto](#build-run-debug-build).
+ Use um executor para executar (e, opcionalmente, para depurar) o código. Para obter mais informações, consulte [Suporte à compilação, execução e depuração integradas](#build-run-debug-supported) e [Executar o código](#build-run-debug-run).
+ Altere um executor integrado para executar (e, opcionalmente, para depurar) o código de forma diferente daquela definida originalmente. Para obter mais informações, consulte [Alterar um executor integrado](build-run-debug-change-runner.md).
+ Use um executor para executar (e, opcionalmente, para depurar) o código com um combinação personalizada de nome de arquivo, opções da linha de comando, modo de depuração, diretório de trabalho atual e variáveis de ambiente. Para obter mais informações, consulte [Criar uma configuração de execução](build-run-debug-create-run-config.md).
+ Crie o seu próprio compilador ou executor. Para obter mais informações, consulte [Criar um compilador ou executor](#build-run-debug-create-builder-runner).

## Suporte à compilação, execução e depuração integradas
<a name="build-run-debug-supported"></a>

O AWS Cloud9 IDE fornece suporte incorporado para criar, executar e depurar código para várias linguagens. Para obter uma lista completa, consulte [Suporte às linguagens](language-support.md).

O suporte à compilação integrada está disponível na barra de menu nos comandos **Run** (Executar), **Build System** (Compilar sistema) e **Run** (Executar), **Build** (Compilar). Para adicionar suporte a uma linguagem de programação ou ferramenta que não está listada, consulte [Criar um compilador ou executor](#build-run-debug-create-builder-runner).

O suporte à execução integrada está disponível no botão **Run** (Executar) e na barra de menu nos comandos **Run** (Executar), **Run With** (Executar com) e **Run** (Executar), **Run Configurations** (Configurações de execução). Para adicionar suporte a uma linguagem de programação ou ferramenta que não está listada, consulte [Criar um compilador ou executor](#build-run-debug-create-builder-runner) e [Criar uma configuração de execução](build-run-debug-create-run-config.md).

O suporte à depuração integrada está disponível por meio da janela **Debugger (Depurador)**. Para exibir a janela **Debugger (Depurador)**, selecione o botão **Debugger (Depurador)**. Se o botão **Debugger (Depurador)** não estiver visível, selecione **Window (Janela)**, **Debugger (Depurador)** na barra de menus.

## Compilar os arquivos do projeto
<a name="build-run-debug-build"></a>

1. Abra um arquivo correspondente ao código que deseja compilar.

1. Na barra de menus, selecione **Run, Build System (Executar, Sistema de compilação)** e, em seguida, escolha o nome do compilador para usar, caso ainda não tenha sido escolhido. Se o compilador que deseja usar não estiver listado, interrompa esse procedimento, conclua as etapas em [Criar um compilador ou executor](#build-run-debug-create-builder-runner) e, em seguida, retorne para esse procedimento.

1. Selecione **Run, Build (Executar, Compilar)**.

## Executar o código
<a name="build-run-debug-run"></a>

1. Abra um arquivo correspondente ao código que deseja executar, caso ainda não esteja aberto e selecionado.

1. Na barra de menus, selecione um dos seguintes:
   + Para executar o código com o executor integrado correspondente mais próximo, selecione **Run, Run (Executar, Executar)**. Se AWS Cloud9 não conseguir encontrar um, esse comando será desativado.
   + Para executar o código com a configuração de execução usada AWS Cloud9 pela última vez, escolha **Executar, Executar por último**.
   + Para executar o código com um executor específico, selecione **Run, Run With (Executar, Executar com)** e, em seguida, escolha o nome do executor. Se o executor que deseja usar não estiver listado, interrompa esse procedimento, conclua as etapas em [Criar um compilador ou executor](#build-run-debug-create-builder-runner) e, em seguida, retorne para esse procedimento.
   + Para executar o código com um executor específico com uma combinação personalizada de nome de arquivo, opções da linha de comando, modo de depuração, diretório de trabalho atual e variáveis de ambiente, selecione **Run, Run Configurations (Executar, Configurações de execução)** e, em seguida, escolha o nome da configuração de execução. Na guia da configuração de execução exibida, selecione **Runner: Auto (Executor: automático)**, escolha o executor que deseja usar e, em seguida, selecione **Run (Executar)**. Se o executor que deseja usar não estiver listado, interrompa esse procedimento, conclua as etapas em [Criar um compilador ou executor](#build-run-debug-create-builder-runner) e, em seguida, retorne para esse procedimento.

## Depurar o código
<a name="build-run-debug-debug"></a>

1. Na guia da configuração de execução do código, selecione **Run in Debug Mode (Executar no modo de depuração)**. O ícone de bug muda para verde em um fundo branco. Para obter mais informações, consulte [Executar o código](#build-run-debug-run) e [Criar uma configuração de execução](build-run-debug-create-run-config.md).

1. Defina os pontos de interrupção no código onde deseja pausar durante a execução, da seguinte forma:

   1. Abra cada arquivo nos quais deseja definir um ponto de interrupção.

   1. Em cada ponto em um arquivo onde deseja definir um ponto de interrupção, selecione a área em branco no gutter à esquerda do número de linha. Um círculo vermelho é exibido.

      Para remover um ponto de interrupção, selecione o ponto existente no gutter.

      Para desativar um ponto de interrupção em vez de removê-lo, na janela **Debugger (Depurador)**, em **Breakpoints (Pontos de interrupção)**, desmarque a caixa correspondente ao ponto de interrupção que deseja desativar. Para ativar o ponto de interrupção novamente, selecione a caixa que foi desmarcada.

      Para desativar todos os pontos de interrupção de uma só vez, na janela **Debugger (Depurador)**, selecione **Deactivate All Breakpoints (Desativar todos os pontos de interrupção)**. Para ativar todos os pontos de interrupção novamente, selecione **Activate All Breakpoints (Ativar todos os pontos de interrupção)**.

      Se a janela **Debugger (Depurador)** não estiver visível, selecione o botão **Debugger (Depurador)**. Se o botão **Debugger (Depurador)** não estiver visível, selecione **Window (Janela)**, **Debugger (Depurador)** na barra de menus.

1. Defina quaisquer expressões de observação para as quais deseje obter o valor no momento em que a execução pausar, da seguinte forma:

   1. Na janela **Debugger (Depurador)**, em **Watch Expressions (Expressões de observação)**, selecione **Type an expression here (Digite uma expressão aqui)**.

   1. Digite a expressão que deseja observar e, em seguida, pressione `Enter`.

      Para alterar uma expressão de observação existente, clique com o botão direito do mouse na expressão e, em seguida, selecione **Edit Watch Expression (Editar expressão de observação)**. Digite a alteração e, em seguida, pressione `Enter`.

      Para remover uma expressão de observação existente, clique com o botão direito do mouse na expressão e, em seguida, selecione **Remove Watch Expression (Remover expressão de observação)**.

1. Execute o código conforme descrito em [Executar o código](#build-run-debug-run).

Sempre que uma execução pausar, também é possível pausar o ponteiro do mouse em qualquer trecho de código exibido (por exemplo, uma variável) para mostrar as informações disponíveis sobre ele em uma dica da ferramenta.

## Criar um compilador ou executor
<a name="build-run-debug-create-builder-runner"></a>

Esta etapa mostra como você pode criar seu compilador ou executor.

1. Para criar um compilador, na barra de menus, selecione **Run, Build System, New Build System (Executar, Sistema de compilação, Novo sistema de compilação)**. Para criar um executor, na barra de menus, selecione **Run, Run With, New Runner (Executar, Executar com, Novo executor)**.

1. Na guia do compilador (identificado como **My Builder.build**) ou na guia do executor (identificado como **My Runner.run**) exibida, defina o compilador ou o executor. Consulte [Definir um compilador ou executor](build-run-debug-define-builder-runner.md).

1. Depois de definir o compilador ou executor, selecione **File, Save As (Arquivo, Salvar como)**. Para um compilador, salve o arquivo com a extensão `.build` no diretório `my-environment/.c9/builders`, onde `my-environment` é o nome do ambiente. Para um executor, salve o arquivo com a extensão `.run` no diretório `my-environment/.c9/runners`, onde `my-environment` é o nome do ambiente. O nome de arquivo especificado será o nome exibido no menu **Run, Build System (Executar, Sistema de compilação)** (para um compilador) ou no menu **Run, Run With (Executar, Executar com)** (para um executor). Portanto, a menos que você especifique um nome de arquivo diferente, por padrão, o nome exibido será **My Builder** (para um compilador) ou **My Runner** (para um executor).

Para usar esse compilador ou executor, consulte [Compilar os arquivos do projeto](#build-run-debug-build) ou [Executar o código](#build-run-debug-run).

**nota**  
Qualquer compilador ou executor criado se aplica somente ao ambiente em que foi criado. Para adicionar o compilador ou executor em um ambiente separado, abra o outro ambiente e siga as etapas anteriores para criar o mesmo compilador ou executor nesse ambiente.