Apesar da plataforma Cronapp ser totalmente na nuvem (Saas), nada impede que você baixe o seu projeto e continue trabalhando off-line usando outras IDEs. 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. 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 um projeto do Cronapp, importar e executá-lo, utilizando Tomcat externo na IDE Visual Studio Code. É 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:

1. Projeto Cronapp criado. Caso haja dúvidas de como criar esse tipo de projeto acesse a documentação Criar projeto.
2. 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.

1. .

Configuração do ambiente

Para configurar o seu ambiente é necessário instalar e configurar os programas abaixo. Para mais informações, consulte a documentação Requisitos recomendados. Abaixo estão as principais configurações necessárias:

• Java 11 ou superior, JDK compatível e configuração da variável de ambiente. Consulte o tópico "Java Development Kit (JDK)" da documentação Configurações para rodar projeto local e publicar.
• Maven 3.5 ou superior e configuração da variável de ambiente. Consulte o tópico "Instalação do Maven" da documentação Configurações para rodar projeto local e publicar.
• Apache Tomcat 9. Consulte o tópico "Tomcat" da documentação Configurações para rodar projeto local e publicar.

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 no Visual Studio Code utilizando o Tomcat externo.

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

Abaixo veremos como instalar e configurar os recursos necessários no VS Code para execução do projeto localmente.

Instalando extensões

Antes de iniciarmos a configuração de execução do projeto, é necessário instalar as extensões Extension Pack for Java e Community Server Connectors 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

Após instalar a extensão apresentada acima, siga os mesmos passos da Figura 2.1 para instalar a extensão Community Server Connectors. Por fim, espere finalizar a compilação do projeto no terminal antes de avançar para os próximos passos.

Instalando dependências Maven

Para instalar as dependências Maven, clique sobre o menu suspenso "MAVEN" (destaque 1 da Figura 2.1.1). Após isso, o nome do projeto será exibido (2), clique com o botão direito do mouse sobre ele e selecione a opção "Run Maven Commands...", seguida de "install". Dessa forma, o processo de construção do projeto será iniciado, resultando na geração do arquivo war da aplicação no diretório "target", o que possibilitará a execução da aplicação em um servidor Tomcat. Aguarde a conclusão da compilação e prossiga para o próximo passo.

Figura 2.1.1 - Instalando dependências Maven

Servidor Tomcat

Para configurar o servidor Tomcat, clique sobre o menu suspenso "SERVER" (destaque 1 da Figura 2.1.2). Em seguida, será exibida a opção "Community Server Connectors" (2), clique nela com o botão direito do mouse e selecione a opção "Create New Server...". Após isso, na caixa de diálogo que exibir (3), selecione a opção "No, use serve on disk" para abrir a janela de seleção do diretório do Tomcat (4). Nela, navegue até o diretório correspondente para selecioná-lo e clique no botão de confirmação (5).

Figura 2.1.2 - Configurando servidor Tomcat

Em seguida, será exibida uma janela para configuração do servidor. Nessa janela, a única configuração necessária é informar o nome do servidor. Para fazer isso, no campo "Server Name" (destaque 1 na Figura 2.1.3), insira um nome e clique no botão "Finish".

Figura 2.1.3 - Configurando servidor Tomcat

Após realizar a ação anterior, o servidor será exibido com o nome informado no destaque 1 da Figura 2.1.3. Clique com o botão direito do mouse sobre ele e selecione a opção "Start Server" para iniciar a execução do servidor (destaque 1 da Figura 2.1.4). Aguarde até que a execução seja concluída (2) antes de prosseguir para o próximo passo.

Figura 2.1.4 - Iniciando servidor

Executando o projeto

Por fim, vamos iniciar a execução do projeto no servidor Tomcat configurado anteriormente. Para isso, na pasta "target" do seu projeto, clique com o botão direito do mouse sobre o arquivo war e escolha a opção "Run on Server" (destaque 1 da Figura 3). Em seguida, será exibida uma caixa de seleção do servidor, clique no servidor configurado anteriormente (2).

Figura 3 - Executando o projeto

Após selecionar o servidor, uma caixa de diálogo será exibida, permitindo a configuração de parâmetros para a execução do projeto. Para este exemplo, selecionamos a opção "No" (destaque 1 na Figura 3.1). Em seguida, a execução do projeto foi iniciada (2).

Figura 3.1 - Projeto em execução

Para acessar o projeto localmente no navegador, será necessário utilizar o endereço padrão "http://localhost:8080/" junto com o nome do arquivo war utilizado durante a execução do projeto (destaque 1 da Figura 3). Como mostra a imagem abaixo, para este exemplo, o projeto foi acessado em "http://localhost:8080/io.cronapp.apps.projetozip-1.0-SNAPSHOT" (destaque 1 da Figura 3.2).

Figura 3.2 - Projeto em execução no navegador