- Criado por Laila Maria Vieira Souza, última alteração por Igor Andrade em 21/05/2024
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 NetBeans. É importante destacar que esse tutorial é apenas demonstrativo. Caso ocorra algum problema na execução, consulte a documentação da IDE utilizada.
Outras opções para executar projetos Cronapp localmente:
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:
- Projeto Cronapp criado. Caso haja dúvidas de como criar esse tipo de projeto acesse a documentação Criar projeto.
- É 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.
- 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.
- 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.
- 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. 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.
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
Nesta página
- Sem rótulos