Criar uma biblioteca e usá-la em outros projetos

Quando o mesmo código aparece em vários projetos (o controle de um tipo de motor, uma conversão de escala, um protocolo próprio), coloque-o numa biblioteca. Assim ele é corrigido num lugar só, tem versão e pode ser distribuído para outras instalações. Esta página mostra como criar, publicar, usar e distribuir uma biblioteca.

Antes de começar

  • Saiba para quais famílias de equipamento a biblioteca vai servir (NEON, RION…): ela é compilada para cada família escolhida (ver O que acontece quando você compila).

  • Escolha um namespace curto, em maiúsculas, que identifique a biblioteca no código (por exemplo MOTORES). Os projetos chamam os blocos da biblioteca com esse prefixo, o que evita conflito com nomes do próprio projeto.

Criar a biblioteca

  1. Selecione Arquivo ‣ Novo Projeto, escolha o Tipo de Projeto Biblioteca, dê um nome e clique em Criar. As propriedades do projeto abrem.

  2. Em Informações da Biblioteca, informe o Namespace e a Versão (por exemplo 1.0.0).

  3. Em Famílias Alvo, marque as famílias de equipamento.

  4. Salve as propriedades.

  5. Crie os tipos de dados e as POUs (funções e blocos de função) da biblioteca (ver Escrever um programa). Marque como Público o que os projetos poderão usar e documente cada POU na aba Documentação: esse texto vira a documentação que aparece no painel Bibliotecas de quem usar a biblioteca.

Publicar a biblioteca

  1. Abra a atividade Compilar / Implantar.

  2. Em Famílias de Destino, marque as famílias.

  3. Clique em Compilar e Implantar.

Resultado: a biblioteca é compilada (arquivo .wcl) para cada família e publicada no repositório de bibliotecas do computador. Ela passa a aparecer no painel Bibliotecas e pode ser adicionada aos projetos de aplicação. Se a compilação falhar, os problemas aparecem na aba PROBLEMAS, como numa aplicação.

Para publicar uma correção, altere a Versão nas propriedades e publique de novo. Os projetos que usam a versão latest passam a usar a nova na próxima compilação.

Usar a biblioteca num projeto

  1. Abra o projeto de aplicação e, nas propriedades do projeto (botão direito no nome do projeto, Editar Propriedades), vá a Dependências.

  2. Clique em Adicionar Dependência, escolha a biblioteca e a versão: latest para sempre a mais recente instalada, ou uma versão fixa, para o projeto só mudar quando você decidir.

  3. Salve. No código, chame os blocos e funções com o namespace:

    VAR
    motor_esteira : MOTORES.FB_PARTIDA_DIRETA;
END_VAR

Resultado: o autocompletar e o painel Bibliotecas passam a mostrar o conteúdo da biblioteca. O mesmo vale para as bibliotecas que a HI Tecnologia publica: instale-as pelo gerenciador de bibliotecas (ver Bibliotecas) e adicione-as às dependências.

Levar a biblioteca para outro computador

Escolha o que entregar:

  • Arquivo Compilado (.wcl): para quem só vai usar a biblioteca. Em Arquivo ‣ Exportar…, escolha o projeto da biblioteca e Arquivo Compilado. No outro computador, Arquivo ‣ Importar… instala a biblioteca.

  • Arquivo do Projeto (.wpl): para quem vai manter a biblioteca, com o código-fonte.

Veja Levar um projeto para outro computador.

Se algo der errado

  • O projeto de aplicação não compila e acusa a biblioteca como Não instalada: ela não foi publicada neste computador ou não foi compilada para a família do equipamento. Publique-a com a família marcada.

  • Depois de atualizar o OnStudio, a biblioteca é acusada como gerada para uma versão anterior: publique-a de novo (ver Bibliotecas).