Ferramentas do usuário

Ferramentas do site


addons

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

Gerenciador de Add-ons

Todo Add-on1) 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.

Gerenciar

 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.

Instalação/Atualização

 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.


Desinstalação

  Webadmin » Menu » Addons » Gerenciar » Desinstalar

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



Download/Upload de Add-ons

  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.


Download de Add-ons

  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.




Upload de Add-ons

  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)






Arquivo para Upload

Criação do arquivo para Upload de Add-ons através do Gerenciador de Add-ons do BFW 3.x

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



Add-on Experimental

  • 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.

Habilitar o Add-on Experimental

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




Instalação Add-on Experimental

  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)




Certificação de Add-Ons

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.

Arquivo .info

  • 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:

Tag Comentário
<icon></icon> Especifica o ícone do aplicativo, se não existir o brazilfw vai utilizar o padrão
<name></name> Nome de exibição do addon - Exemplo: nome original: teste.bfw, Nome de exibição: Teste de conexão
<description></description> Uma breve descrição sobre o add-on. É necessário especificar pelo o menos uma língua. É obrigatório a lingua inglesa
<en-us></en-us> Demais línguas, só seguir o mesmo exemplo: <pt-br></pt-br>, <es-es></es-es>, <pt-pt></pt-pt>
<information></information> É a informação completa do addon, segue o mesmo esquema da língua default do <description></description>
<install></install> Tudo o que estiver dentro dessa tag será executado após a extração do addon
<uninstall></uninstall> Tudo o que estiver dentro dessa tag será executado antes da remoção do addon
<dependencies></dependencies> Tudo o que estiver dentro dessa tag será baixado como depedência do addon.
Exemplo:
<dependencies>
teste1.bfw
teste2.bfw
</dependecies>

E se for 64 bits
<dependencies>
teste1.bfw64
teste2.bfw64
</dependencies>



Exemplos de arquivo .info


Códigos Fontes

  • 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

Editor de texto

  • 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. 





Compilar/Empacotar Add-on

  • 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

  Compilar Pacote (Autor: Bender)
  • Instale o builtree, que é o ambiente de desenvolvimento.
  • Executa-se o chroot (change root) do buildtree - é como se fosse outro sistema operacional.
cd /partition/brazilfw-3.x-build/
./setdevel.sh
  • 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.
cd devel
mkdir addons
cd addons
wget http://www.asty.org/cmatrix/dist/cmatrix-1.2a.tar.gz
tar -zxvf cmatrix-1.2a.tar.gz
cd cmatrix-1.2a
  • Faz-se a Compilação.
    • Aqui precisa saber o que está fazendo… não vou entrar nos detalhes.
./configure
make
  • 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).
mkdir -p /out/cmatrix
make DESTDIR=/out/cmatrix/ install
  • Cria-se o diretório que vai conter o arquivo .pkg e coloca a lista de arquivos do addon dentro deste .pkg
cd /out/cmatrix/
mkdir -p var/addon-list
touch var/addon-list/cmatrix.pkg
find . -type f >var/addon-list/cmatrix.pkg
find . -type l »var/addon-list/cmatrix.pkg
  • Saia do ambiente de desenvolvimento.
exit
  • Copie tudo para o BFW 3.x.
cp -rp /partition/brazilfw-3.x-build/out/cmatrix/* /tmp
  • Cria-se dentro do /tmp o add-on finalizado, o arquivo cmatrix.bfw.
cd /tmp
package cmatrix
  • 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

 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.

Fontes de Consulta

1) Definição do Termo no Glossário
addons.txt · Última modificação: 2017/04/16 20:11 por reginaldo