Add-ons

Neste capítulo Add-ons¹ veremos:

• Gerenciador de Add-ons
  • Download e Upload de Add-ons
• Add-on Experimental
• Certificação de Add-ons
• Compilar e Empacotar Add-ons

*) » Definição do Termo no Glossário

Todo Add-on¹⁾ Homologado e Certificado para o BFW 3.x estará disponível para instalação através do Gerenciador de Add-ons do BFW 3.x

• Uma vez ao dia o sistema irá buscar no repositório os add-ons e gerar a lista.
• O Sistema também atualizará a lista quando um novo add-on homologado for disponibilizado no Gerenciador de add-ons.

 Webadmin » Menu » Addons » Gerenciar

Para que o Gerenciador de Add-ons funcione corretamente é necessário queo DNS do BFW esteja ativo

Através da opção Gerenciar do Gerenciador de Add-ons iremos Instalar, atualizar, desinstalar e fazer downloads e uploads dos Add-ons Certificados, em fase de testes ou não homologados para o BrazilFW 3.x

• No BFW 3.x há duas formas de instalarmos add-ons pelo Gerenciador de Add-ons:

• Na opção Instalar/Atualizar, instalamos e ou atualizamos Add-ons Certificados para o BFW 3.x disponíveis no Gerenciador de Add-ons.

• Já na opção Upload tanto podemos recuperar backup feito dos addons quanto instalar addons não homologados e ou em fase de testes como veremos no sub-título Download/Upload de Add-ons.

 WebAdmin » Menu » Addons » Gerenciar » Instalar/Atualizar 

Nesta opção podemos instalar e/ou atualizar e termos mais informações dos add-ons disponíveis para instalação/atualização.

Ao clicar em Instalar/Atualizar teremos a obtenção da lista dos add-ons disponíveis através de uma janela pop-up.

Para permitir a janela pop-up siga as telas abaixo.

Nesta tela Instalar/Atualizar (Addons) instalaremos e/ou atualizaremos os add-ons disponíveis para o BFW 3.x.

Como já devem ter percebido a instalação e atualização são na mesma tela. Quando já temos um add-on instalado e este tendo uma atualização liberada, ao entrarmos na referida tela o add-on instalado com atualização aparecerá com uma cor diferenciada conforme tela baixo.

  Webadmin » Menu » Addons » Gerenciar » Desinstalar

Nesta opção podemos Desinstalar os add-ons instalados

  Webadmin » Menu » Addons » Gerenciar » Download/Upload

• Através da opção Download podemos fazer backups dos add-ons instalados no Servidor BFW.
• Na opção Upload podemos recuperar o backup dos add-ons que fizemos e também podemos instalar add-ons não homologados e ou em fase de testes.

  Webadmin » Menu » Addons » Gerenciar » Download

• Utilizamos a opção Download para fazermos backups de todos os add-ons instalados no Servidor BFW.

• O Gerenciador de Add-ons irá:
  • Gerar um backup de todos os add-ons instalados no Servidor BFW e baixar para o seu terminal de trabalho.

  Webadmin » Menu » Addons » Gerenciar » Upload

• Na a opção Upload podemos recuperar backup de addons feito e instalar add-ons não hologados e ou em fase de testes.

• Instalando Add-on não homologado ou em fase de testes (O mesmo procedimento é válido para recuperar backup de add-on)

Para termos um arquivo válido para instalação pela opção upload do Gerenciador de Add-ons siga os passos abaixo:

• (A) Ter os arquivos:
  • nome-do-addon.bfw ou nome-do-addon.bfw64 (Addon empacotado)
  • nome-do-addon.bfw.info ou nome-do-addon.bfw64.info (Informações do Addon)
  • nome-do-addon.png (icone do addon, com tamanho máximo de 48 x 48 pixels)

• (B) Criar um arquivo vazio com o nome bfw.addon

• (C) Compactar os arquivos (nome-do-addon.bfw + nome-do-addon.bfw.info + nome-do-addon.png + bfw.addon) em um arquivo .zip com o nome nome-do-addon-32bis.zip para addons em 32 bits

• (D) Compactar os arquivos (nome-do-addon.bfw64 + nome-do-addon.bfw64.info + nome-do-addon.png + bfw.addon) em um arquivo .zip com o nome nome-do-addon-64bis.zip para addons em 64 bits

Pronto. Temos um arquivo pronto para Upload pelo Gerenciador de Addons do BFW 3.x

• A partir da versão 3.0.259 do BFW 3.x temos o recurso do Add-on Experimental.
  
• Permanecem inalterados os requisitos para add-ons “Certificados” e “Não Certificados”.
  Todavia, o recurso de “Add-on Experimental” é exclusivo aos add-ons Homologados enquanto estes ainda estiverem em fase de testes.
  
• O “Add-on Experimental” é a “segunda fase” no Sistema de Certificação de Add-ons. Depois que o Add-on for aprovado na 1ª fase de testes ele receberá o atributo de “Add-on RC”, e vai para o Gerenciador de Add-ons do BFW 3.x como “Add-on Experimental”, permanecendo assim por 30 dias.
  
• Será criado um tópico no fórum aberto para postagens de relatos de bugs e testes.
  
• Nesse período, não sendo encontrado nenhum bug (ou qualquer outro problema de natureza grave) o add-on em questão receberá o atributo de “Add-on Estável” e será lançado oficialmente.
  

  Webadmin » Configurações » Sistema » Geral » Add-on Experimental » Sim

  WebAdmin » Menu » Add-ons » Gerenciar » Instalar/Atualizar

• O add-on experimental ficará em destaque.
• O Destaque é composto de uma marcação no ícone do Add-on e a Expressão (Add-on Experimental)

Para que o Add-on homologado seja certificado para o BFW3.x o Addon Developer deve enviar para os emails reginaldo@brazilfw.com.br e woshman@brazilfw.com.br os seguintes arquivos:

1 - nome-do-addon.bfw ou nome-do-addon.bfw64
2 - nome-do-addon.bfw.info ou nome-do-addon.bfw64.info
3 - O ícone se houver
4 - As dependências se houver
5 - Fontes
 5.1 - Build (script de compilação).
 5.2 - README para compilação.
 5.3 - Os fontes compactados em tar.gz para que
       os arquivos não percam as permissões.

• O arquivo nome-do-addon.bfw.info ou nome-do-addon.bfw64.info deve obedecer/conter:
  
  • 1 - Para Add-ons 32 bits o nome deverá ser nome-do-addon.bfw.info
    
  • 2 - Para Add-ons 64 bits o nome deverá ser nome-do-addon.bfw64.info
    
  • 3 - O conteúdo do arquivo .bfw.info ou .bfw64.info deve ter todo o texto formatado em "utf8".
    
    

4 - Abaixo temos as tags para o arquivo nome-do-addon.bfw.info.

<icon></icon>
<name></name>
<description></description>
<en-us></en-us>
<pt-br></pt-br>
<es-es></es-es>
<pt-pt></pt-pt>
<information></information>
<install></install>
<uninstall></uninstall>
<dependencies></dependencies>

4.1 - Abaixo temos as tags comentadas:

• Abaixo temos exemplos de arquivos .bfw.info:
  • exemplo-geral.bfw.info
  • bfwcache.bfw.info
  • ntop.bfw.info
  • phpmyadmin.bfw.info
    
    
• Observação: Os arquivos dos exemplos estão com extensão final .txt para uma melhor visualização, mas ao serem enviados deverão ser com a extensão .bfw.info para 32 bits e .bfw64.info para 64 bits.
  

• Junto com os arquivos acima para o Gerenciador de Add-ons deverão vir junto os fontes que serão disponibilizados no Repositório de Fontes de Add-ons.
• 1 - Exemplo geral do que deverá ser enviado - fontes
  • 1.1 - Build (script para automatizar o processo de compilação e empacotamento). Exemplo de Build
  • 1.2 - README para compilação. Exemplo de README
  • 1.3 - Os fontes compactados em tar.gz para que os arquivos não percam as permissões. Exemplo tar.gz

• Para a edição do texto formatado em "utf8". sugerimos o aplicativo notepad++.

Notepad++ is a free (as in “free speech” and also as in “free beer”) source code

editor and Notepad replacement that supports several languages. Running in the
MS Windows environment, its use is governed by GPL License. Based on the
powerful editing component Scintilla, Notepad++ is written in C++ and uses pure
Win32 API and STL which ensures a higher execution speed and smaller program size.
By optimizing as many routines as possible without losing user friendliness,
Notepad++ is trying to reduce the world carbon dioxide emissions. When using less
CPU power, the PC can throttle down and reduce power consumption, resulting
in a greener environment. 

• Abaixo veremos:
  • Como compilar um Add-on já existente para a Versão 3.x do BFW.
  • Como Instalar um Add-on sem Precisar Reiniciar o Servidor.

  Compilar Pacote (Autor: Bender)

• Instale o builtree, que é o ambiente de desenvolvimento.
  • O Build-tree pode ser instalado no próprio BFW 3.x » BuildTree BFW 3.x

• Executa-se o chroot (change root) do buildtree - é como se fosse outro sistema operacional.
  

• Cria-se um diretório pra o novo addon, baixa e descompacta os fontes. (Para este Exemplo usei uma espécie de screensaver do Matrix.

• Faz-se a Compilação.
  • Aqui precisa saber o que está fazendo… não vou entrar nos detalhes.

• Cria-se um diretório para colocar os binários compilados e o restando dos arquivos necessário.
  Instala-se o pacote neste diretório (eles que irão virar o add-on).

• Cria-se o diretório que vai conter o arquivo .pkg e coloca a lista de arquivos do addon dentro deste .pkg

• Saia do ambiente de desenvolvimento.

• Copie tudo para o BFW 3.x.

• Cria-se dentro do /tmp o add-on finalizado, o arquivo cmatrix.bfw.

• Para Instalar siga a orientação abaixo do TecJair de como instalar um add-on no BFW 3.x sem reiniciar.
  

 Instalar Add-on sem reiniciar (Autor: tecJair)

- Uma pequena contribuição para esse Manual do BFW 3.x

• Como instalar um add-on sem reiniciar, para isso usarei um dos pacotes-exemplo acima:
• Monte o diretório /mnt e vá para ele.

mt
cd /mnt

• Tendo um pacote com o mesmo nome do addon, remova-o antes.

rm cmatrix.bfw

• Copiamos o pacote a ser instalado para /mnt.

cp /tmp/cmatrix.bfw /mnt

• Agora, vamos “invocar” o arquivo de funções para usarmos uma de suas funções.
  • O arquivo é o /lib/system-functions, ele contém diversas funções do sistema (Obrigado Woshman).

. /lib/system-functions

• em seguida, instalamos o novo pacote.

extract cmatrix.bfw

• Se tudo ocorrer bem, deverá retornar 0
  
  
• Assim é possível instalar e testar sem muitas reiniciações. Agora quanto a desinstalar são outros 500!!
  Remover o pacote do /mnt e reiniciar é o mais eficiente.

• *) » Definição do Termo no Glossário
• http://www.brazilfw.com.br/forum/viewtopic.php?f=77&t=71933#p196518
• Erro ao acessar Gerenciador de Add-ons » http://www.brazilfw.com.br/forum/viewtopic.php?f=77&t=89855#p324291

Reginaldo Sousa Melo 2013/11/07 23:39

Reginaldo Sousa Melo 2017/04/16 20:09