Apesar da plataforma Cronapp ter todos os recursos necessários para criação de plugins, nada impede que se utilize uma IDE convencional para criar novos plugins. Neste tutorial criaremos um plugin com funções de bloco de programação servidor para ser utilizado na plataforma Cronapp.
Pré-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 do tipo web ou mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );
- Uma IDE convencional instalada na máquina local, para este tutorial utilizaremos a IDE Apache NetBeans na versão 16 (download no link ). mas fique a vontade para escolher qualquer outra.
- JDK 11
Inclusão de dependências no pom.xml
Crie um projeto maven (para jar - "<packaging>jar</packaging>") na IDE de preferência. Em seguida inclua no seu pom.xml a dependência para a lib io.cronapp:cronapi-java, essa lib tem tudo que você precisa para criar suas funções.
Figura 1 - Inclusão de dependência para a biblioteca
Nova Categoria
Agora faremos uma classe java que representará a sua nova Categoria, com duas novas funções.
Figura 2 - Criação da classe que representará uma nova Categoria
Obs.1: As anotações @CronapiMetaData e @ParamMetaData são as anotações principais que você utilizará para definir como e com que nome sua função aparecerá na lista de funções para bloco.
Obs.2: A lib cronapi tem todas as principais funções já existentes para blocos, e você pode reutiliza-las em sua função se desejar.
Obs.3: Não há limites para o que pode ser feito, o que seu conhecimento na linguagem java permitir, você pode utilizar.
Uma vez concluído, você deve publicar seu plugin. recomendamos usar o MarketPlace da plataforma Cronapp, mas para fins de uso, consideraremos que apenas fizemos uma publicação pública no repositório central maven.
Inclusão do novo plugin no projeto Cronapp
Agora vamos utilizar o novo plugin apenas publicado no repositório central maven em um projeto na plataforma Cronapp. Para ativar o plugin que acabamos de criar, vamos inclui-lo manualmente no pom.xml do nosso projeto. Em modo avançado, edite o arquivo "Definições Maven" (no modo avançado o arquivo pom.xml tem esse nome) para incluir seu plugin como dependência. (ou use o marketPlace se tiver publicado por lá)
Figura 3 - Edição do arquivo Definições Mave
Recompile e reabra o projeto, e então use sua nova função como desejar.
Figura 4 - Novos blocos criados prontos para utilização