====== Add-ons ====== En computación el término **//Add-ons//** se refiere a módulos de hardware o software (sub-sistemas o pseudo-programas) que suplementan o aumentan las herramientas y posibilidades de uso o características originales donde son utilizados. También son utilizados otros términos tales como: plugins, extensiones, snap-ins y varios otros especificados de acuerdo con el fabricante. Estos módulos frecuentemente poseen licencias específicas donde los derechos de propriedad son asegurados para prevenir que otras empresas compitan produciendo el mismo producto. Los fabricantes acostumbran usar los Add-ons para crear enlaces entre productos imponiendo limitaciones y opciones de mejoras e incremento de funciones disponibles solamente cuando es aprobado por el fabricante original. ===== Administrador de Add-ons ===== * Todo Add-on Homologado y //Certificado// para //BFW 3.x// estará disponible para instalación a través del **//Gerenciador de Add-ons de BFW 3.x//** * Una vez al día el sistema buscará en el repositorio de add-ons y generará la lista. * El Sistema también actualizará la lista cuando haya un nuevo add-on homologado disponible en el Administrador de add-ons. ==== Administrar ==== Webadmin » Menu » Addons » Administrar **Para que el Administrador de Add-ons funcione correctamente es necesario que el DNS de BFW esté activo** A través de la opción **Administrar** del administrador de Add-ons Instalaremos, actualizaremos, desinstalaremos y haremos descargas y cargas de los Add-ons Certificados, en fase de testeo o no homologados para BrazilFW 3.x {{ :wiki:addon-manager-01-pt-br.png |}}\\ * En BFW 3.x hay dos formas de instalar add-ons por el Administrador de Add-ons: {{ :wiki:addon-manager-01b-pt-br.png |}}\\ * En la opción //**Instalar/Actualizar**//, instalamos y o actualizamos Add-ons Certificados para BFW 3.x disponibles en el Administrador de Add-ons. * En la opción //**Upload**// podemos recuperar backups hechos de los addons como instalar addons no homologados y o en fase de testeo como veremos en el sub-título [[http://wiki.brazilfw.com.br/doku.php?id=addons#download_upload_de_add-ons|Download/Upload de Add-ons]]. ---- ==== Instalación/Actualización ==== * **WebAdmin » Menu » Addons » Administrar » Instalar/Actualizar**\\ \\ * En esta opción podemos instalar y/o actualizar y tenemos mas informaciones de los add-ons disponibles para instalar/atualizar. {{ :wiki:addon-manager-02-pt-br.png?nolink |}} \\ * Al hacer click en **//Instalar/Actualizar//** tendremos la lista de los add-ons disponibles a través de una ventana emergente.\\ \\ {{ :wiki:addon-manager-03-pt-br.png?nolink |}} * Para permitir la ventana emergente, siga las siguientes instrucciones. {{ :wiki:addon-manager-04-pt-br.png?nolink |}}\\ {{ :wiki:addon-manager-05-pt-br.png?nolink |}}\\ {{ :wiki:addon-manager-06-pt-br.png?nolink |}}\\ \\ * En esta pantalla **//Instalar/Actualizar (Addons)//** instalaremos y/o actualizaremos los add-ons disponibles para BFW 3.x. {{ :wiki:addon-manager-07-pt-br.png?nolink |}}\\ * Como ya se habrán dado cuenta, instalación y actualización son la misma pantalla. Cuando ya tenemos un add-on instalado y este cuente con una actualización liberada, al entrar en dicha pantalla, el add-on instalado con actualización disponible, aparecerá con un color distinto, como lo muestra la siguiente pantalla. {{ :wiki:addon-manager-08-pt-br.png?nolink |}}\\ \\ ==== Desinstalación ==== * **//Webadmin » Menu » Addons » Adminstrar » Desinstalar//** * En esta pantalla podemos Desinstalar los add-ons instalados. {{ :wiki:addon-manager-09-pt-br.png?nolink |}}\\ {{ :wiki:addon-manager-10-pt-br.png?nolink |}}\\ \\ \\ \\ ===== Certificación de Add-Ons ===== * Para que el Add-on sea homologado **//certificado//** para BFW3.x, el Addon Developer debe enviar a los emails **//reginaldo@brazilfw.com.br//** y **//woshman@brazilfw.com.br//** los siguientes archivos:\\ 1 - nombre-del-addon.bfw o nombre-del-addon.bfw64 2 - nombre-del-addon.bfw.info o nombre-del-addon.bfw64.info 3 - El icono si hubiera 4 - Las dependencias si hubiera 5 - Los Fuentes 5.1 - Build (script de compilación). 5.2 - README para compilación. 5.3 - Los fuentes comprimidos en tar.gz para que los archivos no pierdan los permisos. ==== Archivo .info ==== * El archivo //nombre-de-addon.bfw.info// o //nombre-de-addon.bfw64.info// debe tener/contener:\\ * 1 - Para Add-ons **//32 bits//** el nombre deberá ser **//nombre-del-addon.bfw.info//**\\ * 2 - Para Add-ons **//64 bits//** el nombre deberá ser **//nombre-del-addon.bfw64.info//**\\ * 3 - El contenido del archivo //.bfw.info// o //.bfw64.info// **{{fontcolor|debe ter todo el texto en formato ''utf8''}}**.\\ \\ 4 - A continuación tenemos las etiquetas para el archivo **//nombre-del-addon.bfw.info//**.\\ \\ \\ 4.1 - A continuación tenemos las etiquetas "tags" comentadas: ^ Tag ^ Comentario ^ | | Especifica el icone de la aplicación, se no tiene, brazilfw utilizara la predeterminada | | | Nombre que se muestra del addon - Ejemplo: nombre original: teste.bfw, Nombre para mostrar: Testeo de conexión | | | Una breve descripción sobre el add-on. Es necesario especificar al menos un idioma. Es obligatorio el idioma ingles | | | Para los demás idiomas, simplemente siga el mismo ejemplo: , , | | | Es la información completa del addon, sigue el mismo esquema del idioma predeterminado | | | Todo lo que esté dentro de esa etiqueta será ejecutado después de la extracción del addon | | | Todo lo que esté dentro de esa etiqueta será ejecutado antes de la desinstalación del addon | | |Todo lo que esté dentro de esa etiqueta será descargado como dependencia del addon.\\ Ejemplo:\\ \\ teste1.bfw\\ teste2.bfw\\ \\ \\ y si fuera 64 bits\\ \\ teste1.bfw64\\ teste2.bfw64\\ | \\ \\ ==== Ejemplos de archivo .info ==== * Aquí tenemos ejemplos de archivos **//.bfw.info//**: * [[http://www.brazilfw.com.br/users/reginaldo/wiki3.x/addon-installer/exemplo-geral-bfw.info.txt|ejemplo-general.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]]\\ \\ * Observación: Los archivos de los ejemplos tienen extensión .txt para una mejor visualización, pero al ser enviados deberán tener la extensión .bfw.info para 32 bits y .bfw64.info para 64 bits. \\ \\ ==== Códigos Fuentes ==== * Junto con los archivos mencionados, al **//Administrador de Add-ons//** deberán enviarse los fuentes que estarán disponibles en el [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/|Repositorio de Fuentes de Add-ons]]. * 1 - Ejemplo general de lo que deberá ser enviado - [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/|fuentes]] * 1.1 - Build (script para automatizar el proceso de compilación y empaquetado). [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/build-ntop|Ejemplo de Build]] * 1.2 - README para compilación. [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/README|Ejemplo de README]] * 1.3 - Los fuentes compactados en tar.gz para que los archivos no pierdan los permisos. [[http://www.brazilfw.com.br/downloads/addons/bfw3.x/sources/ntop/ntop-4.1.0.tar.gz|Ejemplo tar.gz]] ==== Editor de texto ==== * Para la edición de texto en formato **{{fontcolor|utf8}}** sugerimos la aplicación [[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?nolink |}}\\ \\ {{ :wiki:notepad-02-pt-br.png?nolink |}}\\ \\ \\ ===== Add-on Experimental ===== * A partir de la versión 3.0.258 de BFW 3.x contamos con el recurso Add-on Experimental.\\ * Se mantendrán los requisitos que para los add-ons **//"Certificados"//** y **//"No Certificados"//**.\\ Sin embargo, el recurso "Add-on Experimental" es exclusivo de los add-ons Homologados mientras están en fase de pruebas.\\ * Add-on Experimental" es la "segunda fase" en el Sistema de Certificación de Add-ons. Después que el Add-on es aprobado por el Grupo Beta Testers (que a partir de ahora llamaremos 1ª fase de testeos) recibirá el nombre "Add-on RC", y será publicado en el Administrador de Add-ons de BFW 3.x como "Add-on Experimental", permaneciendo así por 30 días.\\ * Será creado un tema en el foro abierto para reportes de errores y testeos.\\ * En ese período, no habiendo encontrado ningún error (o cualquier otro problema de naturaleza grabe) el add-on en cuestión obtendrá el atributo de "Add-on Estável" y será lanzado oficialmente.\\ \\ \\ ==== Habilitar la función Add-on Experimental ==== * **//Webadmin » Configuraciones » Sistema » General » Add-on Experimental » Si //**\\ {{ :wiki:addon-experimental-1-pt-br.png?nolink |}}\\ {{ :wiki:addon-experimental-2-pt-br.png?nolink |}}\\ ==== Instalación de Add-on Experimental ==== * **//WebAdmin » Menu » Add-ons » Administrar » Instalar/Actualizar//** * El add-on experimental se verá diferenciado. * Esta diferencia será una marca en el icono del Add-on con la Expresión **//(Add-on Experimental)//** {{ :wiki:addon-experimental-3-pt-br.png?nolink |}}\\ \\ \\ ===== Compilar y Empaquetar un Add-on para BFW 3.x ===== * A continuación veremos: * Como compilar un Add-on existente para la Versión 3.x de BFW. * Como Instalar un Add-on sin Necesidad de Reiniciar el Servidor. ==== Compilar un paquete - Por Bender ==== * Instale el builtree, que es el ambiente de desarrollo. * Build-tree puede ser instalado en el mismo BFW 3.x » [[build-tree|BuildTree BFW 3.x]] * Ejecutar el chroot (change root) de buildtree - como si fuera otro sistema operativo.\\ cd /partition/brazilfw-3.x-build/ ./setdevel.sh * Crear un directorio para el nuevo addon, bajar y descomprimir los fuentes. * Para este Ejemplo es una especie de screensaver de Matrix (fue lo mas inútil que encontré). 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 * Compilar. * Aquí precisa saber lo que está haciendo... no voy a entrar en detalles. ./configure make * Crear un directorio para colocar los binarios compilados y los demás archivos necesarios.\\ * Instalar el paquete en este directorio (ellos harán funcioar el add-on). mkdir -p /out/cmatrix make DESTDIR=/out/cmatrix/ install * Crear un directorio que vaya a contener el archivo .pkg y colocar la lista de archivos del addon dentro de este .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 * Salga del ambiente de desarrollo. exit * Copie todo para BFW 3.x. cp -rp /partition/brazilfw-3.x-build/out/cmatrix/* /tmp * Crear dentro de /tmp el add-on finalizado, el arquivo //cmatrix.bfw//. cd /tmp package cmatrix * Para Instalar siga las indicaciones de TecJair de como instalar un add-on en BFW 3.x sin reiniciar. \\ ==== Instalar un Addon sin Reiniciar - Por tecJair ==== // - Juro que voy a aprender a compilar por BFW. Ahora una pequeña contribución para este tutorial.// * Como //instalar// un add-on sin reiniciar, para eso usaré uno de los paquetes de ejemplo anteriores: * Monte el diretório /mnt y vaya ahí. mt cd /mnt * Teniendo un paquete con el mismo nombre del addon, bórrelo antes. rm cmatrix.bfw \\ * Copiamos en /mnt el paquete a ser instalado. cp /tmp/cmatrix.bfw /mnt \\ * Ahora, vamos a "//llamar//" al archivo de funciones para usar una de ellas. * El archivo es ///lib/system-functions//, el contiene diversas funciones del sistema //(Gracias Woshman)//. . /lib/system-functions * enseguida, instalamos el nuevo paquete. extract cmatrix.bfw * Si todo resulta correcto, deberá devolver **//0//**\\ \\ * Así es posible instalar y testear sin tantos reinicios. Ahora en cuanto a desinstalar, son otros 500!!\\ Remover el paquete de /mnt y reiniciar es lo mas eficiente. ===== Fuentes de Consulta ===== » http://pt.wikipedia.org/wiki/Add-ons\\ » http://www.brazilfw.com.br/forum/viewtopic.php?f=77&t=71933#p196518 --- //[[reginaldo@brazilfw.com.br|Reginaldo Sousa Melo]] 2013/11/07 23:39// --- // Traducido al Castellano por [[http://www.brazilfw.com.br/forum/memberlist.php?mode=viewprofile&u=20870|Néstor Javier Clariá]]//