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 / bibliotecas para importar em seu projeto Cronapp. Neste tutorial criaremos um plugin uma biblioteca com funções de bloco de programação servidor para ser utilizado na em uma IDE externa e importaremos esse conteúdo para a 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:

1. 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.
2. Recomendado o JDK 11

1. .

Projeto Maven

Crie um projeto maven Maven (para jar - "<packaging>jar</packaging>") na IDE de preferência. Em seguida, inclua no seu pom.xml a dependência para a lib biblioteca io.cronapp:cronapi-java, essa lib tem , dentro do elemento <dependencies>, ela contém tudo que você precisa para criar suas funções, inclusive a chamada para todos os blocos de programação servidor.

Image AddedImage Removed

Figura 1 - Inclusão de dependência para a biblioteca 

Definindo as anotações do blockly

Agora faremos uma classe java Java que representará a sua nova Categoria dentro do Editor de bloco de programação, com duas novas funções.

Image AddedImage Removed

Figura 2 - Criação da classe que representará uma nova Categoria do blockly

• A primeira função, operacaoSoma, realiza a soma entre dois números passados por parâmetro pelo usuário.
• A segunda função, Expoente, utiliza o bloco de programação Elevar à potência para realizar a operação de exponenciação, tendo como base o primeiro valor passado pelo usuário, num1, e como expoente o segundo valor, num2.

A classe apresentada na figura 2 pode ser baixada no arquivo a seguir:

 Arquivo 1 - Classe operacoes.java

Uma vez concluído, você deve publicar seu pluginsua biblioteca. recomendamos Recomendamos usar o MarketPlace da plataforma Cronapp, mas para fins de uso, consideraremos que apenas fizemos uma publicação pública , como fizemos nesse exemplo, também é possível realizar uma publicação no repositório central maven.

Inclusão

da biblioteca no projeto Cronapp

 Agora Agora vamos utilizar o novo plugin apenas publicado a biblioteca que subimos no repositório central maven Central Maven em um projeto na plataforma Cronapp. Para ativar o plugin a biblioteca que acabamos de criar, vamos inclui-lo la manualmente no arquivo pom.xml do nosso projeto. Em Com o modo avançado, edite o arquivo ativado (destaque 1 da figura 3), acesse o arquivo pom.xml (ou "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á)

Image Removed

, destaque 2 da figura 3) e inclua a dependência da biblioteca criada dentro do elemento <dependencies> (destaque 3 da figura 3).

Image Added

Figura 3 - Edição do arquivo Definições Maven (pom.xml)

Recomendamos ao final dessa etapa realizar a limpeza de cache do projeto. Para isso, acesse no menu do sistema Projeto > Limpar Todos os Caches. (Figura 3.1)

Image Added

Figura 3.1 - Limpando o cache do projeto

Recompile e reabra o projeto, e então use sua nova função como desejarpara exibir as funções criadas.

Image AddedImage Removed

Figura 4 3.2 - Novos blocos criados prontos para utilização

Utilizando as funções

Após realizar as configurações apresentadas acima, podemos testar nossas funções, confira as figuras 4 e 4.1.

Image Added

Figura 4 - Exemplo de uso da função operacaoSoma

Image Added

Figura 4.1 - Exemplo de uso da função Expoente