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 e [DI-1739] Desenvolver projetos Cronapp em outras IDEs. É 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 a versão do Java e JDK compatível e a variável de ambiente configurada. Para mais informações sobre as versões, consulte a documentação Requisitos recomendados.
3. Visual Studio Code instalado e configurado na máquina local. Nesse tutorial estamos usando a versão 1.88 (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 (download em https://www.jetbrains.com/idea/), porém outras versões irão funcionar da mesma forma.
5. Apache NetBeans instalado e configurado na máquina local. Nesse tutorial estamos usando a versão 21 (download em https://netbeans.apache.org/), porém outras versões irão funcionar da mesma forma.

Execução em outras IDEs

Projetos Cronapp podem ser executados em diversas IDEs e de várias maneiras, utilizando o Tomcat local, especificação de uma Classe Main, utilizando o plugin Maven ou o Spring Boot. Neste tutorial, iremos abordar a execução de um projeto Cronapp em IDEs externas utilizando os recursos Maven e Spring Boot, que possui um Tomcat embutido. Para mais detalhes, recomendamos consultar a documentação oficial do Spring Boot.

Exportar projeto .zip do Cronapp

Para exportar um projeto no Cronapp, acesse no menu do sistema Projeto > Exportar (Figura 1). Em seguida, na janela de seleção dos formatos a serem exportados, clique no formato Zip e depois no botão  Finalizar. 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, acesse no menu lateral 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" para 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 Projects (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

Apache NetBeans

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

Importando projeto

Abra o NetBeans, na tela inicial, clique no atalho Open Project... (seta da Figura 4) para selecionar a pasta descompactada do projeto Cronapp exportado e, em seguida, clique no botão "Open Project" (destaque 1 da figura 4).

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

Aguarde alguns minutos até que o Netbeans compile e valide todo o projeto.

Configurações de execução

Para configurar a execução do projeto, basta selecionar a raiz do projeto na aba Projects (destaque 1 da figura 4.1) e, na aba Navigator (2), selecionar e acessar o menu de contexto da opção spring-boot run e clicar em Execute Goal.

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

Executando o projeto

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

Figura 4.2 - Execução do projeto localmente no NetBeans