Apesar da plataforma Cronapp ser totalmente na nuvem (Saas), nada impede que você baixe o seu projeto e continue trabalhando off-line usando outras IDE.

O Cronapp não possui lock-in em seus projetos, assim, ao retirar seu projeto da nossa plataforma, tudo permanecerá funcionando e você continuará o desenvolvimento do ambiente do sistema, banco de dados, microsserviços e todos os recursos gerado pelo Cronapp. Isso é possível pois o Cronapp exporta todo o conteúdo em código padrão, sem componentes proprietários, de forma organizada, otimizada e atualizada em linguagem padrão de mercado. Permitindo também a publicação em ambientes fora da nossa plataforma.

Veremos nesse tutorial como exportar o projeto do Cronapp, importar e executar nas IDEs Visual Studio Code, IntelliJ IDEA, Eclipse e NetBeans. É importante destacar que esse tutorial é apenas demonstrativo. Caso ocorra algum problema na execução, consulte a documentação da IDE utilizada.

Requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

Requisitos:

1. Projeto Cronapp criado. Caso haja dúvidas de como criar esse tipo de projeto acesse a documentação Criar projeto.
2. É necessário ter instalado a versão do Java e JDK compatível e a variável de ambiente configurada. Para mais informações, consulte a documentação documentação Requisitos recomendados.
3. Visual Studio Code instalado e configurado na máquina local. Nesse tutorial estamos usando a versão 1.88 do VS Code (download em https://code.visualstudio.com/), porém outras versões irão funcionar da mesma forma.
4. IntelliJ IDEA instalado e configurado na máquina local. Nesse tutorial estamos usando a versão 2024.1 do VS Code (download em https://www.jetbrains.com/idea/), porém outras versões irão funcionar da mesma forma.
5. Eclipse <TO DO>
6. NetBeans <TO DO>

Exportar projeto .zip do Cronapp

Para exportar um projeto, acesse no menu do sistema Projeto > Exportar (Figura 1). Essa janela também pode ser acessada através do menu de contexto na raiz do projeto (nome do projeto) na árvore de arquivos. Em seguida, na janela de seleção dos formatos a serem exportados, clique no formato Zip e finalize. O Cronapp compactará o projeto e logo em seguida inicializará o download na sua máquina local.

Figura 1 - Baixando projeto compactado do Cronapp

Após o download, descompacte o conteúdo para um diretório a sua escolha, usaremos esse diretório para abrir o projeto nas outras IDEs.

Visual Studio Code

Após configurar o ambiente e exportar o projeto do Cronapp, vamos importar o projeto e configurar o VS Code nos passos abaixo.

Importando projeto

Abra o VS Code, acesse no menu do sistema File > Open Folder (destaque 1 da Figura 2) para abrir a janela de importação de projetos. Na janela Open Folder navegue até o diretório em que foi salvo o projeto e selecione a pasta descompactada e, em seguida, clique no botão "Selecionar pasta".

Figura 2 - Abrindo a janela de importação de projeto existente

Configurações de execução

Antes de iniciarmos a configuração de execução do projeto, será preciso instalar a extensão Extension Pack for Java no VS Code. Para isso, no menu lateral acesse Extensions (destaque 1 da Figura 2.1). Em seguida, no campo de busca pesquise por "Extension Pack for Java" (2) e, por fim, clique no botão "Install" pra instalar a extensão (3).

Figura 2.1 - Configurando ambiente

Para configurar a execução do projeto, acesse no menu lateral a opção Run and Debug (destaque 1 da Figura 2.2). Em seguida, na caixa de seleção localizada anterior ao botão de configuração, selecione a opção "SpringBootMain:run" (2). Esta é uma configuração predefinida que executa a classe principal do Spring Boot. Por fim, clique no botão "Start Debugging" (3) para iniciar a execução.

Figura 2.2 - Configurando execução do projeto

Executando o projeto

Após clicar no botão "Start Debugging" (destaque 3 da Figura 2.2), a execução do projeto iniciará e poderá ser visualizada no Debug Console (destaque 1 da Figura 2.3) do VS Code. Durante a execução, uma barra de ferramentas será exibida com alguns botões úteis que podem ser utilizados para interagir com o processo em execução (2). Para acessar o projeto localmente, no navegador, digite o endereço padrão de execução: http://localhost:8000/ (3).

Figura 2.3 - Execução do projeto localmente

IntelliJ IDEA

Após configurar o ambiente e exportar o projeto do Cronapp, vamos importar o projeto e configurar o IntelliJ nos passos abaixo.

Importando projeto

Abra o IntelliJ, na tela inicial, no menu lateral Project (destaque 1 da Figura 3) clique em Open (2) para selecionar a pasta descompactada do projeto Cronapp exportado (3) e, em seguida, clique no botão "OK".

Figura 3 - Abrindo a janela de importação de projeto existente

Configurações de execução

Para configurar a execução do projeto, no menu superior, clique na caixa de seleção "Current File" (destaque 1 da Figura 3.1) e selecione a opção "Edit Configurations" (2) para abrir a janela Run/Debug Configurations (Figura 3.2).

Figura 3.1 - Acessando as configurações de execução

Na janela Run/Debug Configurations, clique no botão "Add New Configuration" (destaque 1 da Figura 3.2) e escolha a opção "Maven". Em seguida, no campo Run selecione o comando "spring-boot:run" (2). Em Java Options, no campo JRE,selecione o JDK do seu sistema, caso ainda não esteja selecionado. Por fim, clique no botão "Apply" para aplicar as alterações e, em seguida, em "Run" para executar o projeto. 

Figura 3.2 - Configurando a execução Maven

Caso esteja utilizando o sistema operacional Windows e ocorra o erro de execução "CreateProcess error=206", é possível contorná-lo nas configurações do Intellj.

Para isso, seguindo os passos da Figura 3.1, acesse novamente a janela Run/Debug Configurations. Nela, clique no botão "Add New Configuration" (destaque 1 da Figura 3.3) e escolha a opção "Spring Boot". No campo Build and run selecione o JDK do seu sistema, caso ainda não esteja selecionado (2), e, ao lado, selecione "SpringBootMain". Em seguida, clique em Modify options (3) e escolha a opção "Shorten command line" e, nela, selecione "JAR manifest" (4). Por fim, clique no botão "Apply" para aplicar as alterações e, em seguida, em "Run" para executar o projeto. 

Figura 3.3 - Configurando a execução Spring-boot

Executando o projeto

Após seguir os passos anteriores, a execução do projeto iniciará e poderá ser visualizada no Console (destaque 1 da Figura 3.4) do IntelliJ. Para acessar o projeto localmente, no navegador, digite o endereço padrão de execução: http://localhost:8000/ (2).

Figura 3.4 - Execução do projeto localmente