Herramientas de usuario

Herramientas del sitio


es:addons

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


  • En BFW 3.x hay dos formas de instalar add-ons por el Administrador de Add-ons:


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


  • Al hacer click en Instalar/Actualizar tendremos la lista de los add-ons disponibles a través de una ventana emergente.

  • Para permitir la ventana emergente, siga las siguientes instrucciones.





  • En esta pantalla Instalar/Actualizar (Addons) instalaremos y/o actualizaremos los add-ons disponibles para BFW 3.x.


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



Desinstalación

  • Webadmin » Menu » Addons » Adminstrar » Desinstalar
    • En esta pantalla podemos Desinstalar los add-ons instalados.






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 debe ter todo el texto en formato ''utf8''.

4 - A continuación tenemos las etiquetas para el archivo nombre-del-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 - A continuación tenemos las etiquetas “tags” comentadas:

Tag Comentario
<icon></icon> Especifica el icone de la aplicación, se no tiene, brazilfw utilizara la predeterminada
<name></name> Nombre que se muestra del addon - Ejemplo: nombre original: teste.bfw, Nombre para mostrar: Testeo de conexión
<description></description> Una breve descripción sobre el add-on. Es necesario especificar al menos un idioma. Es obligatorio el idioma ingles
<en-us></en-us> Para los demás idiomas, simplemente siga el mismo ejemplo: <pt-br></pt-br>, <es-es></es-es>, <pt-pt></pt-pt>
<information></information> Es la información completa del addon, sigue el mismo esquema del idioma predeterminado <description></description>
<install></install> Todo lo que esté dentro de esa etiqueta será ejecutado después de la extracción del addon
<uninstall></uninstall> Todo lo que esté dentro de esa etiqueta será ejecutado antes de la desinstalación del addon
<dependencies></dependencies> Todo lo que esté dentro de esa etiqueta será descargado como dependencia del addon.
Ejemplo:
<dependencies>
teste1.bfw
teste2.bfw
</dependecies>

y si fuera 64 bits
<dependencies>
teste1.bfw64
teste2.bfw64
</dependencies>



Ejemplos de archivo .info



Códigos Fuentes

  • 1 - Ejemplo general de lo que deberá ser enviado - fuentes
    • 1.1 - Build (script para automatizar el proceso de compilación y empaquetado). Ejemplo de Build
    • 1.2 - README para compilación. Ejemplo de README
    • 1.3 - Los fuentes compactados en tar.gz para que los archivos no pierdan los permisos. Ejemplo tar.gz

Editor de texto

  • Para la edición de texto en formato utf8 sugerimos la aplicación 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. 






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



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)




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

es/addons.txt · Última modificación: 2017/06/10 19:55 por nclaria