Como na maioria dos Ambientes de desenvolvimento Integrado (IDE), o Cronapp possui áreas bem distintas e funcionais para facilitar o trabalho do desenvolvedor em seus projetos. Na figura abaixo são apresentadas as principais áreas do ambiente.

Open

1. Botão do menu do sistema: ao clicar no botão, um menu lateral será expandido, exibindo atalhos e outros menus.

2. Menu do sistema: exibe os principais menus do sistema.

3. Botões de atalho: atalhos para salvar e fechar arquivos, além de atalhos para executar o projeto.

4. Menu do usuário: contém informações do usuário, plano adquirido, consumo de recurso e atalhos para outros locais dentro da plataforma Cronapp.

5. Arquivos do projeto: exibe a árvore de arquivos do projeto ao habilitar o Modo Avançado ou a árvore de recursos (simplificado), quando o Modo Avançado estiver desabilitado. Possui atalhos laterais para facilitar o acesso.

6. Área de trabalho: espaço onde são exibidas as janelas das ferramentas.

7. Área de informações: local onde são apresentadas as janelas de console, depuração, erros, expressões, breakpoints e outras.

8. Barra de status: área com informações sobre o status atual do projeto.

Botão do Menu do sistema

O botão do Menu do sistema se encontra no canto superior esquerdo da IDE e é uma extensão da barra de menu azul, contendo atalhos, menus do sistema e recursos utilizados com menor frequência.

Open

1. Botão do Menu do sistema.

2. Testar com Selenium IDE: abre a ferramenta para criar testes automatizados.

3. Rodar os Testes: executa os testes configurados na Ferramenta integrada de testes ou Testes unitários.

4. Terminal: acessa o terminal Linux, onde você tem acesso a todos os arquivos do seu projeto.

5. Fonte de Dados: abre a janela para criar e listar as Fontes de dados do projeto.

6. Banco de Dados: abre a janela de configuração de Banco de dados e perfis da aplicação.

7. Serviços de Cloud: abre a janela com os serviços disponíveis do Cronapp cloud.

8. Modo Avançado: define o modo de desenvolvimento no Cronapp.

   • Desabilitado: oculta os recursos high-code e destaca os recursos visuais do Cronapp.

   • Habilitado: exibe todo o conteúdo do projeto.

9. Outros Menus do sistema: menus utilizados com menor frequência.  

Opção de Modo Avançado

Esse recurso é uma ótima opção para diminuir ainda mais a curva de aprendizado dentro do Cronapp. Ao desabilitar o botão alternância Modo Avançado (destaque 8 da figura 2), o Cronapp realiza algumas alterações em sua interface para facilitar o desenvolvimento dentro da plataforma. Essas alterações consistem em ocultar os recursos e arquivos que necessitam de algum desenvolvimento high-code, normalmente desnecessário ao utilizar o Cronapp, exibindo os diretórios e arquivos do projeto de forma simplificada e destacando os recursos visuais. 

Também é possível alternar entre os modos através do menu do sistema: Espaço de Trabalho > Modo de uso da IDE > Modo Analista para desabilitar ou Espaço de Trabalho > Modo de uso da IDE > Modo Avançado para habilitar.

A alternância entre os modos pode ser feita a qualquer momento durante o desenvolvimento do projeto e não gera qualquer impacto no resultado final. Assim, mesmo que a estrutura de arquivos seja exibida de forma simplificada, ao exportar seu projeto, a hierarquia de arquivos estará igual ao apresentado no Modo Avançado, pois trata-se da estrutura real.

Acesse o tópico "Opção Modo Avançado" da documentação Estrutura de arquivos para mais detalhes.

Menu do sistema

O Menu do sistema do Cronapp é dividido em 2 partes: na barra de menu azul (destaque 1 da figura 3) são exibido os menus utilizados com maior frequência, enquanto os demais (3) são acessíveis a partir do botão do menu do sistema (2) . 

Open

Quando não existem projetos abertos no espaço de trabalho do Cronapp, o menu do sistema sofrerá algumas alterações, exibindo apenas recursos que podem funcionar sem um projeto aberto. Nesse momento, é possível alternar entre as telas de Bem-vindos e Meus Projetos, veja mais detalhes na documentação Abrir projeto.

Projeto

Menu responsável por gerenciar e configurar o projeto aberto, além de abrir algumas ferramentas fundamentais para o projeto.

• Meus Projetos: abre a tela para criar ou abrir um projeto existente.

• Abrir Recentes: apresenta uma lista de projetos que foram utilizados recentemente na IDE.

• Fonte de Dados: abre a janela de Fontes de dados, onde é possível criar, pesquisar, remover e alterar as Fontes de dados do sistema.

• Banco de Dados: abre a janela de configuração de Banco de dados e perfis da aplicação.

• Chaves de Internacionalização: exibe a tela para a configuração das chaves de internacionalização web, mobile e servidor.

• Permissão de Segurança: abre a tela para configuração dos permissionáveis, grupos e usuários.

• Gerenciamento de Tokens: abre a ferramenta para o gerenciamento das chaves de APIs e Tokens de autenticação usados no projeto.

• Eventos e Ações: permite a configuração de eventos e ações do projeto, substituindo recursos padrões do Cronapp.

• Parâmetros do Sistema: permite criar e personalizar os parâmetros do sistema.

• Agendador de Tarefas: abre uma janela para criação de jobs, permitindo definir tempo para executar ações geradas por bloco de programação.

• Gerar Documentação: exibe a ferramenta de geração automática de diversas partes do sistema, como Diagrama de dados, APIs, Bloco de programação e outros. 

• Compartilhar Projeto: cria uma cópia compactada do projeto, um link público é gerado para permitir que a pessoa que recebeu o link possa obter uma cópia do projeto em seu espaço de trabalho. O link expira depois de 24 horas.

• Conceder Acesso Remoto: cria um link para permitir que outro usuário trabalhe ao mesmo tempo no mesmo projeto, usado para suporte.

• Importar: importa um projeto Cronapp em formato *.zip ou obtém serviços de uma estrutura SOAP e OpenAPI.

• Exportar: permite exportar tanto as bibliotecas do projeto quanto o próprio projeto, para o Git ou nos formatos: *.war ou *.zip.

• Limpar Todos os Caches: limpa todos os dados do cache da IDE.

• Recompilar: exibe opções para recompilar recursos servidor e cliente.

  • Recompilar Projeto: compila o lado servidor do projeto.

  • Recompilar e Reabrir Projeto: compila o lado servidor, e em seguida, fecha e abre o projeto.

  • Recompilar Maven: permite executar comandos Maven. O comando padrão força a resolução das dependências Maven (pom.xml).

  • Recompilar NPM Web: compila as dependências NPM da aplicação web (package.json).

  • Recompilar NPM Mobile: compila as dependências NPM da aplicação mobile.

• Configurações: abre a ferramenta de configurações do projeto, permitindo visualizar e editar diversos recursos do sistema.

• Fechar: fecha o projeto atualmente aberto na IDE.

Equipe

O conteúdo deste menu irá variar dependendo se o projeto está ou não sob versionamento Git.

Sem versionamento

• Exportar para Repositório Git: abre a janela para exportar o projeto para o Git.

Com versionamento

• Acesse o tópico "Menu de opções" da documentação Versionamento usando Git para obter a descrição da lista de itens.

Espaço de Trabalho

Possui algumas configurações do ambiente Cronapp.

• Idiomas: define o idioma da IDE, atualmente estão disponíveis os idiomas inglês e português.

• Perfil do Usuário: abre uma janela para exibir algumas informações de sua conta.

• Mudar Senha: altera a senha do seu usuário Cronapp.

• Memória de Run/Debug: seleciona a porcentagem de memória reservada para a execução do projeto.

• Memória de Desenvolvimento: seleciona a porcentagem de memória destinada para o desenvolvimento do projeto.

• Modo de Uso da IDE: define o modo de desenvolvimento no Cronapp. Equivale a desativar ou ativar o botão de alternância Modo Avançado. Acesse o tópico Opção de Modo Avançado para mais detalhes.

  • Analista: oculta os recursos high-code e destaca os recursos visuais do Cronapp.

  • Avançado: exibe todo o conteúdo do projeto.

• Perfis da VPN [depreciado]: abre a janela de configuração de VPN no Cronapp.

• Preferências: abre a janela de configurações do espaço de trabalho

Perfil do Usuário

Essa janela é acessível a partir do menu do sistema Espaço de Trabalho > Perfil do Usuário e possui informações do usuário logado.

Open

1. Foto do perfil do usuário: exibe a foto selecionada pelo usuário.

2. Selecione uma imagem: abre janela de seleção de imagem para adicionar ao perfil.

3. Limpar imagem: exclui a imagem selecionada e retorna a imagem padrão.

4. Campo Identificador: registro único do usuário dentro da plataforma Cronapp.

5. Campo Nome: permite que o usuário altere o seu nome dentro da plataforma Cronapp.

6. Mudar senha: abre a janela para alteração da senha do usuário.

Preferências do Espaço de Trabalho

Essa janela é acessível a partir do menu do sistema Espaço de Trabalho > Preferências e possui algumas configurações para personalizar o seu ambiente de trabalho no Cronapp.

Open

• Máximo de linhas no console: define a quantidade máxima de linhas exibidas por vez no Console do depurador. Definir um valor muito alto pode ocasionar lentidão ou travamentos no Console do depurador.

• Receber notificações gerais: habilita o recebimento de mensagens referentes ao contrato e aos projetos atualmente em desenvolvimento.

• Receber notificações do Cloud Services: habilita o recebimento de mensagens informando sobre alterações dos recursos do Cloud Services vinculados ao contrato do usuário.

• Receber notificações com novidades: notificações sobre lançamentos e atualizações do Cronapp.

• Usar Abas na Abertura de Arquivos: define como será visível a lista de arquivos abertos. 

• Preferir Popups ao invés de Abas: ao habilitar, o Cronapp deixará de exibir alguns recursos em janelas flutuantes (exemplo Configurações do projeto) e passará a abrir na área de trabalho, criando uma aba com os demais arquivos abertos.

• Sempre Mostrar Código Fonte: exibe a aba "Código" em ferramentas como Editor de Views e Editor de Blocos de programação, independente da configuração do Modo Avançado.

Usar Abas na Abertura de Arquivos

Essa opção na janela de Preferências do Espaço de Trabalho (Figura 3.2) define como o usuário poderá alterar entre os arquivos abertos na IDE.

Ao habilitar, o Cronapp exibirá várias abas na parte superior da área de trabalho (destaque 1 da figura 3.3), permitindo alterar entre as telas ao selecionar cada aba, da mesma forma como ocorre com os navegadores web. É possível acessar o menu de contexto diretamente na aba.

Open

Ao desabilitar, o Cronapp exibirá a opção Abertos (destaque 1 da figura 3.4), logo abaixo do Botão do Menu do Sistema. Um pequeno círculo em amarelo mostrará a quantidade de arquivos abertos no momento. Clique para exibir a lista e alterar entre os arquivos abertos. O primeiro da lista representa o conteúdo aberto atualmente na área de trabalho, posicione o cursor do mouse sobre ele para exibir o seu menu de contexto.

Esse modo não exibe um "x" em cada elemento da lista, como ocorre no modo aba, logo, para fechar um arquivo é necessário utilizar o botão "X" na barra de menu azul ou através da opção "Fechar" do menu de contexto.

Open

Ajuda

• Relatar problemas: direciona o usuário para a página de abertura de chamados do suporte do Cronapp.

• Documentação: abre o portal de documentação do Cronapp.

• Academia Cronapp: abre a plataforma com cursos de capacitação e fórum de interação entre os usuários do Cronapp.

• Lista de atalhos: direciona o usuário para a documentação Atalhos do Cronapp, que apresentará os principais comandos de atalhos disponíveis no Cronapp.

• Iniciar Assistente: exibe opções para habilitar ou desabilitar o assistente que informa os passos iniciais dentro do Cronapp.

• Notas da Versão: abre a janela com o Release notes.

• Termos de Serviço Beta do Cronapp: exibe os termos para uso da versão Beta do Cronapp. Opção disponível apenas nas versões beta do Cronapp.

• Sobre: informações sobre a versão atual do Cronapp e o servidor no qual o Cronapp está sendo executado.

Relatar Problemas 

Essa funcionalidade direciona o usuário para a página de abertura de chamados do suporte do Cronapp, permitindo que o usuário informe, de forma detalhada, um problema presente na aplicação ou na própria IDE. Esse recurso está disponível pelo menu Ajuda > Relatar Problema (figura 3.5).

Open

Além disso, por meio da opção Baixar conteúdo (Figura 3.6), disponível no menu de contexto do Console do depurador, é possível baixar um arquivo no formato .txt com as informações detalhadas sobre o erro ocorrido na aplicação. Esse arquivo pode ser anexado ao formulário de abertura de chamados para facilitar a avaliação pela equipe de suporte.

Open

Arquivo

Realiza algumas ações no arquivo aberto na área de trabalho.

• Buscar: (atalho: shift + shift) procura pelo nome de um arquivo ou pelo tipo de arquivo (Java, HTML, txt, entre outros).

• Buscar Símbolos: procura por arquivos dentro do projeto e dentro de dependências do projeto.

• Buscar Conteúdo: procura pelo conteúdo em todos os arquivos do projeto.

• Índice de Métodos: lista os métodos do arquivo, facilitando a navegação. Opção disponível apenas quando um arquivo *.java estiver aberto.

• Abrir Recentes: lista os últimos arquivos fechados.

• Salvar: (atalho: ctrl + S) salva o conteúdo da aba ativa na área de trabalho.

• Salvar Como: cria uma cópia do arquivo em edição, permitindo alterar o nome e local de salvamento.

• Salvar Todos: (atalho: ctrl + shift + S) salva o conteúdo de todas as abas abertas.

• Próximo: (atalho: alt + →) alterna para a próxima tela aberta na área de trabalho.

• Anterior: (atalho: alt + ←) alterna para a tela anterior aberta na área de trabalho.

• Fechar: fecha a aba da área de trabalho ativa no momento.

Editar

Permite a edição e pesquisa do conteúdo do arquivo aberto.

• Desfazer: desfaz a última ação feita.

• Refazer: refaz a última ação desfeita.

• Recortar: recorta algum conteúdo selecionado.

• Copiar: copia um conteúdo selecionado.

• Colar: cola um conteúdo copiado ou recortado.

• Pesquisar: pesquisa por um conteúdo na janela aberta.

• Substituir: pesquisa por um conteúdo na janela aberta e o substitui por outro.

Plugin

O plugin do Cronapp é uma pequena aplicação desenvolvida e disponibilizada para provê alguma funcionalidade bem específica aos projetos Cronapp. Existem vários plugins que facilitam a integração com sistemas externos. Além dos plugins existentes, você também pode criar seus próprios plugins.

• Plugins da Organização: lista de plugins criados por você ou sua organização.

• Plugins Instalados: exibe os plugins instalados no projeto.

• Instalar Plugins: abre uma janela para adicionar um plugin ao projeto.

Executar

Menu que reúne algumas funcionalidades necessárias para executar a aplicação.

• Iniciar Projeto: roda o projeto em modo de depuração.

• Iniciar Projeto sem Debug: roda o projeto.

• Parar Projeto: para a execução da aplicação no servidor Tomcat.

• Prosseguir Execução: [debug das funções servidor] executa a aplicação ignorando os breakpoints.

• Próximo Passo: [debug das funções servidor] segue para a próxima linha do código, mas não entra no método, se houver.

• Entrar: [debug das funções servidor] segue para a próxima linha do código e entra no método, se houver.

• Sair: [debug das funções servidor] caso esteja dentro de método, clicando em sair, você segue para a próxima linha de código após a chamada do método.

• Abrir Navegador: exibe opções para abrir a aplicação quando ela estiver em execução. As opções de Swagger e OpenAPI só estarão disponíveis após habilitar esse recurso nas Configurações do projeto.

  • Navegador (Web): abre o projeto web em uma página web.

  • Navegador (Mobile): abre o projeto mobile em uma página web.

  • Simulador: abre o projeto mobile em um simulador dentro do Cronapp (Acesse tópico "Simulador" em Menu Dispositivos Móveis para mais detalhes).

  • Visualizar documentação das APIs (Swagger): abre outra aba no navegador com a página do Swagger.

  • Visualizar arquivo de configuração (OpenAPI):  abre outra aba no navegador com o esquema do OpenAPI. Acessível também através do seu endereço: <domínio>/api/metadata/configuration

• Rodar os Testes: executa os testes configurados na Ferramenta integrada de testes ou Testes unitários.

Ferramentas

Em ferramentas é possível fazer o gerenciamento dos tipos de bancos de dados e dos backups automáticos, além de abrir o terminal.

• Gerenciador de SQL: abre a ferramenta de Manipulação de dados do Banco de dados (Acesse tópico "Manipular dados" em Banco de dados para mais detalhes).

• Terminal: acessa o terminal Linux, onde você tem acesso a todos os arquivos do seu projeto.

• Testador de Consultas JPQL: abre uma janela onde é possível testar consultas JPQL.

• Gerenciamento de Backups: gerencia os backups de seus projetos, permitindo baixar, remover ou restaurá-los.

• Testar com Selenium IDE: abre a ferramenta para criar testes automatizados.

Deploy

Acesso aos recursos na nuvem e publicação na App Store.

• Serviços de Cloud: abre a janela com os serviços disponíveis do Cronapp cloud.

• Publicar Aplicação na App Store: faz a publicação do seu projeto mobile diretamente na loja da Apple.

• Publicar Biblioteca no Maven: permite exportar recursos do seu projeto para o Maven.

Dispositivos Móveis

Esse menu somente estará ativo para projetos mobile. Veja mais detalhes sobre essas funcionalidades em Menu Dispositivos Móveis.

• Compilar: compila e gera um arquivo binário para as plataformas mobile.

  • Android: gera arquivos .apk ou .bundle utilizados na plataforma Android.

  • iOS: gera arquivos .ipa utilizados na plataforma iOS.

• Executar: traz opções para executar o projeto mobile.

  • Simulador: abre a aplicação mobile em um simulador dentro do Cronapp.

  • Cronapp Browser: abre a aplicação mobile em um smartphone a partir do app Cronapp Browser.

• Gerar Projeto Nativo: gera arquivo .zip para abrir o projeto mobile no Xcode.

• Limpar Workspace: apaga as modificações feitas nos plugins do Cordova.

• Configurações: abre a janela de configurações dos projetos mobile Android e iOS.

Botões de Atalho

A barra de menu azul do Cronapp possui os botões de atalhos mais importantes. Esses botões podem variar a depender do contexto do projeto, por exemplo, parado, em execução ou em debug.

Projeto parado

A figura abaixo apresenta os botões de atalhos da barra de menu com o projeto parado.

Open

1. Salvar: (atalho ctrl+s) salva o conteúdo da aba ativa na área de trabalho.

2. Salvar todos: (atalho ctrl+shift+s) salva o conteúdo de todas as abas abertas.

3. Fechar: fecha a aba ativa na área de trabalho.

4. Iniciar projeto: roda o projeto em modo debug.

   1. Ao clicar no lado direito do ícone Iniciar projeto, um menu será exibido para executar o projeto em um dos perfis da aplicação (acesse o tópico "Perfis da aplicação" em Banco de dados para mais detalhes).

Projeto em execução

A figura abaixo apresenta os botões de atalhos da barra de menu azul com o projeto em execução.

Open

1. Parar: para a execução do projeto.

2. Abrir navegador: exibe opções de inicialização das aplicações:

   1. Ao clicar no lado direito no Abrir navegador, um menu será exibido com opções para inicializar as aplicações. Essas opções podem variar a depender do tipo de projeto ou se a opção "Open API" estiver habilitada nas Configurações do Projeto.

      • Navegador [web]: abre o projeto web em outra aba do navegador.

      • Navegador [mobile]: abre o projeto mobile em outra aba do navegador.

      • Simulador: abre o projeto mobile utilizando o simulador Cronapp.

      • Visualizar documentação das APIs (Swagger): abre outra aba no navegador com a página do Swagger.

      • Visualizar arquivo de configuração (OpenAPI): abre outra aba no navegador com o esquema do OpenAPI. Acessível também através do endereço: <domínio da aplicação>/api/metadata/configuration

3. Botões debug: esses botões só serão exibidos após executar alguma função servidor com ponto de interrupção (breakpoint), acesse o tópico "Debug Visual" em Bloco de programação para mais detalhes. 

1.  

   • Prosseguir execução: executa a aplicação normalmente, ignorando os breakpoints.

   • Próximo passo: segue para a próxima linha do código ou bloco de programação, mas não entra no método se houver.

   • Entrar: segue para a próxima linha do código ou bloco de programação e entra no método.

   • Sair: caso esteja dentro de método, clicando em sair, você segue para a primeira linha de código ou bloco de programação que fica fora do método.