Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Code::Blocks

O Code::Blocks é uma IDE gratuita, de código aberto e multiplataforma.

Criando um novo projeto

Na tela principal do Code::Blocks, clique em Create a new project ou selecione File > New > Project....

../../../_images/code_blocks_file_new_project.png

Na janela New from template, em Projects, selecione Empty project e clique em Go.

../../../_images/code_blocks_new_empty_project.png

Clique em Next para passar pela introdução do assistente de novo projeto vazio.

../../../_images/code_blocks_wizard_welcome.png

O arquivo do projeto deve ser criado na raiz da pasta do projeto clonado. Para conseguir isso, primeiro, certifique-se de que o Project title seja o mesmo nome da pasta na qual o Godot foi clonado. A menos que você tenha clonado o projeto em uma pasta com um nome diferente, este será godot.

Segundo, certifique-se de que a Folder to create project in seja a pasta a partir da qual você executou o comando Git clone, não a pasta de projeto godot. Confirme se o campo Resulting filename criará o arquivo do projeto na raiz da pasta do projeto clonado.

../../../_images/code_blocks_project_title_and_location.png

As configurações do compilador e de ambiente são gerenciadas através do SCons e serão configuradas mais tarde. No entanto, vale a pena desmarcar a opção Create "Release" configuration; assim, apenas um único alvo de compilação será criado antes de clicar em Finish.

../../../_images/code_blocks_compiler_and_configuration.png

Configurando a compilação

O primeiro passo é alterar as propriedades do projeto. Clique com o botão direito no novo projeto e selecione Properties....

../../../_images/code_blocks_open_properties.png

Marque a propriedade This is a custom Makefile. Clique em OK para salvar as alterações.

../../../_images/code_blocks_project_properties.png

O próximo passo é alterar as opções de compilação. Clique com o botão direito no novo projeto e selecione Build Options....

../../../_images/code_blocks_open_build_options.png

Selecione a aba "Make" commands e remova todos os comandos existentes para todos os alvos de compilação. Para cada alvo de compilação, insira o comando SCons para criar a compilação desejada no campo Build project/target. O mínimo é scons. Para detalhes sobre as opções de compilação do SCons, veja Introdução ao sistema de compilação. Também é útil adicionar o comando scons --clean no campo Clean project/target aos comandos padrão do projeto.

Se você estiver usando o Windows, todos os comandos precisam ser precedidos por cmd /c para inicializar o interpretador de comandos.

../../../_images/code_blocks_scons_minimum.png

../../../_images/code_blocks_scons_clean.png

Exemplo do Windows:

../../../_images/code_blocks_scons_windows.png

O Code::Blocks agora deve estar configurado para compilar o Godot; então selecione Build > Build, clique no botão de engrenagem ou pressione Ctrl + F9.

Configurando a execução

Assim que o SCons tiver compilado com sucesso o alvo desejado, reabra as Properties... do projeto e selecione a aba Build targets. No campo Output filename, navegue até a pasta bin e selecione o arquivo compilado.

Desmarque as opções Auto-generate filename prefix e Auto-generate filename extension.

../../../_images/code_blocks_build_targets.png

O Code::Blocks agora deve estar configurado para rodar o seu executável compilado do Godot; então selecione Build > Run, clique no botão de seta verde ou pressione Ctrl + F10.

Há dois pontos adicionais que valem a pena notar. Primeiro, se necessário, o campo Execution working dir pode ser usado para testar projetos específicos, definindo-o para a pasta que contém o arquivo project.godot. Segundo, a aba Build targets pode ser usada para adicionar e remover alvos de compilação para trabalhar e criar diferentes builds.

Adicionando arquivos ao projeto

Para adicionar todos os arquivos de código do Godot ao projeto, clique com o botão direito no novo projeto e selecione Add files recursively....

../../../_images/code_blocks_add_files_recursively.png

Ele deve selecionar automaticamente a pasta do projeto; então simplesmente clique em Open. Por padrão, todos os arquivos de código são incluídos, então simplesmente clique em OK.

../../../_images/code_blocks_select_files.png

Configuração de estilo de código

Antes de editar qualquer arquivo, lembre-se de que todo o código precisa estar em conformidade com as diretrizes de estilo de código. Uma diferença importante com o Godot é o uso de tabulações (tabs) para recuos. Portanto, a principal configuração padrão do editor que precisa ser alterada no Code::Blocks é ativar tabulações para recuos. Essa configuração pode ser encontrada selecionando Settings > Editor.

../../../_images/code_blocks_update_editor_settings.png

Em General Settings, na aba Editor Settings, sob Tab Options, marque Use TAB character.

../../../_images/code_block_use_tab_character.png

É isso. Você está pronto para começar a contribuir para o Godot usando o Code::Blocks IDE. Lembre-se de salvar o arquivo do projeto e o Espaço de Trabalho. Se você tiver algum problema, peça ajuda em um dos canais da comunidade Godot.