Apesar da plataforma Cronapp ser totalmente na nuvem (Saas), nada impede que você baixe o seu projeto e continue trabalhando off-line usando o Visual Studio Code ou outra 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 no nas IDEs Visual Studio Code.

, IntelliJ IDEA 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 do tipo web ou mobile 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 do VS Code (download em https://code.visualstudio.com/), porém outras versões irão funcionar da mesma forma.

1. 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.
2. 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

Caso queira, é possível utilizar o Docker, facilitando as configurações necessárias para executar localmente o seu projeto.

.

Exportar projeto .zip do Cronapp

Para exportar um projeto no Cronapp, 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 finalizedepois 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 no VS Code.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".

Image Modified

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

Image Added

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.

Image Added

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

Image Added

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

Image Added

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

Image Added

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.  Se o JDK não estiver adicionado, desmarque a checkbox "Inherit from settings", acima do destaque 3, para selecioná-lo. Por fim, clique no botão "Apply" para aplicar as alterações e, em seguida, em Run para executar o projeto. 

Image Added

Figura 3.2 - Configurando a execução Maven

Caso esteja utilizando o sistema operacional Windowse 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. 

Image Added

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 menu lateral navegador, digite o endereço padrão de execução: http://localhost:8000/ (2).

Image Added

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

Image Added

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.

Image Added

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

Image Added

Figura 4.2 - Execução do projeto localmente no NetBeansImage Removed