====== 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 [[http://wiki.brazilfw.com.br/glossary|Glossário]] ===== Gerenciador de Add-ons ===== Todo Add-on**((Definição do Termo no [[http://wiki.brazilfw.com.br/glossary|Glossário]]))** 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 {{ :wiki:addon-manager-01-pt-br.png |}}\\ * No BFW 3.x há duas formas de instalarmos add-ons pelo Gerenciador de Add-ons: {{ :wiki:addon-manager-01b-pt-br.png |}}\\ * 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 [[http://wiki.brazilfw.com.br/doku.php?id=addons#download_upload_de_add-ons|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. {{ :wiki:addon-manager-02-pt-br.png |}}\\ Ao clicar em **//Instalar/Atualizar//** teremos a obtenção da lista dos add-ons disponíveis através de uma janela pop-up.\\ \\ {{ :wiki:addon-manager-03-pt-br.png |}}\\ Para permitir a janela pop-up siga as telas abaixo. {{ :wiki:addon-manager-04-pt-br.png |}}\\ {{ :wiki:addon-manager-05-pt-br.png |}}\\ {{ :wiki:addon-manager-06-pt-br.png |}}\\ Nesta tela **//Instalar/Atualizar (Addons)//** instalaremos e/ou atualizaremos os add-ons disponíveis para o BFW 3.x. {{ :wiki:addon-manager-07-pt-br.png |}}\\ 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. {{ :wiki:addon-manager-08-pt-br.png |}}\\ ---- ==== Desinstalação ==== Webadmin » Menu » Addons » Gerenciar » Desinstalar Nesta opção podemos Desinstalar os add-ons instalados {{ :wiki:addon-manager-09-pt-br.png |}}\\ {{ :wiki:addon-manager-10-pt-br.png |}}\\ ---- ---- ===== 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. {{ :wiki:addon-manager-11-pt-br.png |}}\\ ==== 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. {{ :wiki:addon-manager-12-pt-br.png |}}\\ * 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. {{ :wiki:addon-manager-13-pt-br.png |}}\\ {{ :wiki:addon-manager-14-pt-br.png |}}\\ ---- ==== 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. {{ :wiki:addon-manager-15-pt-br.png |}}\\ * **Instalando Add-on não homologado ou em fase de testes (O mesmo procedimento é válido para recuperar backup de add-on)** {{ :wiki:addon-manager-16-pt-br.png |}}\\ {{ :wiki:addon-manager-17-pt-br.png |}}\\ {{ :wiki:addon-manager-18-pt-br.png |}}\\ {{ :wiki:addon-manager-19-pt-br.png |}}\\ {{ :wiki:addon-manager-20-pt-br.png |}}\\ ==== 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 {{ :wiki:addon-experimental-1-pt-br.png |}}\\ {{ :wiki:addon-experimental-2-pt-br.png |}}\\ ---- ==== 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)//** {{ :wiki:addon-experimental-3-pt-br.png |}}\\ ---- ---- ===== 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//**.\\ \\ \\ 4.1 - Abaixo temos as tags comentadas: ^ Tag ^ Comentário ^ | | Especifica o ícone do aplicativo, se não existir o brazilfw vai utilizar o padrão | | | Nome de exibição do addon - Exemplo: nome original: teste.bfw, Nome de exibição: Teste de conexão | | | Uma breve descrição sobre o add-on. É necessário especificar pelo o menos uma língua. É obrigatório a lingua inglesa | | | Demais línguas, só seguir o mesmo exemplo: , , | | | É a informação completa do addon, segue o mesmo esquema da língua default do | | | Tudo o que estiver dentro dessa tag será executado após a extração do addon | | | Tudo o que estiver dentro dessa tag será executado antes da remoção do addon | | |Tudo o que estiver dentro dessa tag será baixado como depedência do addon.\\ Exemplo:\\ \\ teste1.bfw\\ teste2.bfw\\ \\ \\ E se for 64 bits\\ \\ teste1.bfw64\\ teste2.bfw64\\ | \\ ---- ==== Exemplos de arquivo .info ==== * Abaixo temos exemplos de arquivos **//.bfw.info//**: * [[http://www.brazilfw.com.br/users/reginaldo/wiki3.x/addon-installer/exemplo-geral-bfw.info.txt|exemplo-geral.bfw.info]] * [[http://www.brazilfw.com.br/users/reginaldo/wiki3.x/addon-installer/bfwcache.bfw.info.txt|bfwcache.bfw.info]] * [[http://www.brazilfw.com.br/users/reginaldo/wiki3.x/addon-installer/ntop.bfw.info.txt|ntop.bfw.info]] * [[http://www.brazilfw.com.br/users/reginaldo/wiki3.x/addon-installer/phpmyadmin.bfw.info.txt|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.\\ ---- ==== 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 [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/|Repositório de Fontes de Add-ons]]. * 1 - Exemplo geral do que deverá ser enviado - [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/|fontes]] * 1.1 - Build (script para automatizar o processo de compilação e empacotamento). [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/build-ntop|Exemplo de Build]] * 1.2 - README para compilação. [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/README|Exemplo de README]] * 1.3 - Os fontes compactados em tar.gz para que os arquivos não percam as permissões. [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/ntop-4.1.0.tar.gz|Exemplo tar.gz]] ---- ==== Editor de texto ==== * Para a edição do texto formatado em "utf8". sugerimos o aplicativo [[http://notepad-plus-plus.org/|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. {{ :wiki:notepad-01-pt-br.png |}}\\ {{ :wiki:notepad-02-pt-br.png |}}\\ ---- ---- ===== 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. * O Build-tree pode ser instalado no próprio BFW 3.x » [[build-tree|BuildTree BFW 3.x]] * 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 ===== * *) » Definição do Termo no [[http://wiki.brazilfw.com.br/glossary|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@brazilfw.com.br|Reginaldo Sousa Melo]] 2013/11/07 23:39// //[[reginaldo@brazilfw.com.br|Reginaldo Sousa Melo]] 2017/04/16 20:09// ----