Versões comparadas

Versão antiga 8

changes.mady.by.user Fábio Duarte Freitas

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Igor Andrade

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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:

  • Projeto do tipo web ou mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );
    1. Uma IDE convencional instalada na máquina local, para este tutorial utilizaremos a IDE Apache
    NetBean
    1. NetBeans na versão
    2018-12 (download em https://www.eclipse.org/downloads/).
    1. 16. mas fique a vontade para escolher qualquer outra.

    Configuração do ambiente

    Para configurar o seu ambiente é necessário instalar e configurar os programas abaixo. Caso tenha dúvidas de qual versão está instalada ou como instalar, acesse a documentação: Configurações para rodar projeto local e publicar.
    1. Recomendado o JDK 11.

    Projeto Maven

    Crie um projeto

    maven

    Maven (para jar - "<packaging>jar</packaging>") na

    sua

    IDE

    preferida. (Neste documento usaremos Apache NetBeans)
    Após criar seu projeto

    de preferência. Em seguida, inclua no seu pom.xml a dependência para a

    lib

    biblioteca io.cronapp:cronapi-java,

    esta lib tem

    dentro do elemento <dependencies>, ela contém tudo que você precisa para criar suas funções

    .
    Image Removed

    , inclusive a chamada para todos os blocos de programação servidor.


    Image Added

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


    Dica

    A versão da biblioteca cronapi-java está em constante atualização, acesse o repositório do cronapi-java na Central Mavel para obter a última versão.

    Definindo as anotações do blockly

    Agora faremos uma classe Java

    Faremos agora uma classe java

    que representará a sua nova Categoria dentro do Editor de bloco de programação, com duas novas funções

    .
    Image Removed
    Obs.1:

    .


    Image Added

    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:


    View file
    nameoperacoes.java
    pageCriar plugin utilizando IDEs padrões de mercado
    spaceCRON2
    height150

     Arquivo 1 - Classe operacoes.java


    Informações
    titleObservações
    • 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
    • Veja mais detalhes no tópico "Anotações" da documentação Criando blocos servidor customizados.
    • A biblioteca 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
    liguagem java
    • linguagem Java permitir, você pode utilizar.
    (sorriso)
    •  


    Uma vez concluído, você deve publicar

    seu plugin

    sua biblioteca. 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 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

    ativado (destaque 1 da figura 3), acesse o arquivo pom.xml (ou "Definições Maven"

    para incluir seu plugin como dependência. (ou use o marketPlace se tiver publicado por lá)
    Image Removed
    Recompile o projeto e limpe todos os caches (ou apenas reabra o projeto), e então use sua nova função como desejar.
    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


    Dica
    Limpar o cache nem sempre é o suficiente para exibir o bloco de programação criado, caso este procedimento não funcione, siga os passos a seguir: acesse o menu de contexto do arquivo pom.xml, selecione a opção Maven > Processar Alvos... e uma janela de Confirmação irá abrir já com um comando Maven dependency: resolve-U. Clique em OK. 


    Recompile e reabra o projeto, para exibir as funções criadas.


    Image Added

    Figura 3.2 - Novos blocos criados

    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

    Nesta página

    Índice