Dolibarr ERP CRM Wiki

Herramientas de Desarrollo

Revision as of 13:11, 26 September 2011 by Eldy (talk | contribs) (→‎Configurar Eclipse para recuperar la versión CVS)

Volver al índice
Documentación desarrolladores

File Doc dev.png

Puede ser utilizado cualquier entorno de desarrollo. De todas maneras aquí hay una lista de herramientas muy recomendable por su integridad, calidad y productividad del desarrollo que aportan. Son utilizadas por la mayoría de los desarrolladores principales de Dolibarr. Tenga en cuenta que todas estas soluciones son gratuitas y OpenSource.

Eclipsephp.jpg Para todos los desarrolladores

Aquí está la base de trabajo recomendado, no obstante cualquier herramienta que respete el estándar Web, PHP, MySQL puede realizar bien el trabajo.

Un servidor AMP

  • Apache, Mysql y PHP

En Linux: Estos 3 productos están disponibles en todas las distribuciones.

En Windows: Instalar WampServer 2 (base de datosMysql, Apache y PHP todo en uno). El servidor WAMP ofrece el trio MySql+Apache+PHP, con la posibilidad de bascular de versión para cualquiera de sus componentes con un simple clic.

Firefox y plugins

  • Firefox con los plugins:
    • Firebug + Firecookie
    • HTML Validator
    • Phplangeditor y los diccionarios de los idiomas en los que usted planea trabajar
    • Selenium IDE
    • Cert Viewer Plus si quiere realizar pruebas en HTTPS.
    • QuickProxy si quiere bascular rápidamente su navegador hacia las utilidades Proxy (WebScarab)
    • User agent switcher para simular accesos desde un smartphone

Descargables desde el sitio http://www.firefox.com

SquirrelSQL

  • SquirrelSql para la administración de la base de datos

Descargable desde el sitio http://squirrel-sql.sf.net

Eclipse y plugins

Instalación de Eclipse

Recomendamos la versión :

https://eclipse.org/pdt/

De lo contrario, puede encontrar las versiones disponibles en el sitio Eclipse.

Instalación del plugin Eclipse para PHP: PDT

Para ello, utilizar el método Find And Install y agregar la URL de actualización:

https://download.eclipse.org/releases/xxx - xxx = version

Or from the GUI of any Eclipse =>Install New Software =>Work With Kepler => Wait until list display =>General Purpose Tools Check PHP development tools (PDT)=>Install

Configurar Eclipse para recuperar la versión

Una vez que tenga instalado Eclipse, puede conectar al repositorio GIT para recuperar la última versión de desarrollo. Vee pagina FAQ_Get,update_project_sources.

Computer.png Opcional

Instalación del plugin para Eclipse para GIT

  • Instalación del plugin para Eclipse para GIT: EGit

para ello, utilizar el metódo Find And Install y agregar la URL de actualización:

http://download.eclipse.org/egit/updates

Si gestiona otros proyectos en SVN

  • Instalación del plugin para Eclipse para SVN: SubClipse

para ello, utilizar el metódo Find And Install y agregar la URL de actualización:

http://subclipse.tigris.org/install.html

o

  • Instalación del plugin para Eclipse para SVN: Subversive

http://community.polarion.com/projects/subversive/download/eclipse/2.0/ganymede-site/ - [required] Subversive SVN Connectors

http://community.polarion.com/projects/subversive/download/integrations/ganymede-site/ - [optional] Subversive Integrations

Si desea realizar scripts en Perl

  • Instalación del plugin Eclipse para Perl: EPIC

Para ello, utilizar el método Find And Install y agregar la URL de actualización: http://e-p-i-c.sourceforge.net/updates

Si desea desarrollar módulos con el generador UML2Dolibarr

Un método para generar un módulo funcional desde UML se encuentra en fase de puesta a punto. Más información en la página Generar un módulo con MDA. Para utilizarlo, deberá instalar los siguientes componentes:

  • Instalación de acceleo 2.2.1 ó +: Para ello, utilizar el médoto Find And Install y agregar la URL de actualización: http://www.acceleo.org/update/
  • Instalación d'UML2Dolibarr

Para ello, recupere los proyectos con el comando: 

svn checkout svn://svn.forge.objectweb.org/svnroot/acceleo/trunk/modules/community/uml21/dolibarr/trunk/

e impórtelos en Eclipse.

Si trabaja bajo Windows

  • WampServer 2 (para disponer de la base de datos Mysql, Apache y PHP todo en uno). El servidor WAMP ofrece el trio MySql+Apache+PHP instalado llave en mano, con posibilidad de cambiar de versión, para cualquiera de estos componentes con un solo clic). ¡Imprescindible!
  • Notepad++ (para aquellos que no soportan el uso de Java o un viejo cuco demasiado bajo para Eclipse).
  • WinMerge (para la comparación de ficheros o carpetas)
  • CygWin (para los comandos patch y los comandos en línea cvs si prefiere la línea de comandos)

Si usted quiere realizar depuración paso a paso o ajustada (XDebug)

  • Para agregar información de tuning en la barra de estado del navegador, agregar la variable de entorno DOL_TUNING con valor 1, para ello incluya la siguiente línea en su fichero apache.conf:
SetEnv DOL_TUNING 1

A continuación, compruebe que su navegador no tiene una opción para bloquear la barra de tareas por javasscript.

  • Para la depuración línea a línea, instale XDebug:

  Windows

  • Descargue el archivo dll php_debug_xxx.dll desde http://www.xdebug.org y guárdelo en el directorio /ext de php. Seguidamente active el plugin.
  • Modifique el archivo php.ini file añadiendo lo siguientes parámetros:
 [xdebug]
 xdebug.remote_enable=on
 xdebug.remote_handle=dbgp
 xdebug.remote_host=localhost
 xdebug.remote_port=9000
 xdebug.profiler_enable=1
 xdebug.show_local_vars=off
 xdebug.profiler_output_dir=c:/temp
 xdebug.profiler_append=0

  Ubuntu / Linux

  • Instale el paquete php-xdebug:
sudo apt-get install php5-xdebug
  • Modique el archivo xdebug.ini añadiendo los siguientes parámetros después de la línea zend_extension=xxx (o similar):
 xdebug.remote_enable=on
 xdebug.remote_handle=dbgp
 xdebug.remote_host=localhost
 xdebug.remote_port=9000
 xdebug.profiler_enable=1
 xdebug.show_local_vars=off
 xdebug.profiler_output_dir=/var/tmp
 xdebug.profiler_append=0

  Configuración de Eclipse

  • Abra Eclipse. En el menú Window->Preferences->General->Web Browser, seleccione external web browser, y seleccione Default system web browser.
  • Vaya a la sección debug, Window->Preferences->PHP->Debug, y establezca la opción PHP Debugger a XDebug (por defecto este valor está establecido a Zend Debugger). Note que el chekbox “Break at first line” está activado – puede cambiarlo después, si lo necesita.
  • Después de haber aplicado los cambios, vaya a la prespectiva PHP Debug, y entre al menú Debug Configurations… Allí, asegúrese que el Server Debugger está configurado como XDebug, y que el PHP server apunta a http://localhost/ o a una dirección correcta. la sección file apunta al archivo index.php, relativo a su workspace, la ruta relativa puede ser /dolibarr/htdocs/index.php.
  • Compruebe que la sección URL apunte a la dirección correcta – de lo contrario, desmarque el checkbox “Auto-Generate”, y teclee la dirección correcta. Aplique los cambios y cierre la ventana.
  • Debería estar preparado para debugear Dolibarr. Haga clic en Run->Debug o F11 para activar el debugging, Eclipse debe pasar a la vista de Debug, y Dolibarr debe iniciarse en su explorador. Si el chexbox “Break at First Line” está activado, Dolibarr parará en la primera línea. Puede ir paso a paso por las líneas usando los controles de depuración del menú superior izquierdo. Puede poner breakpoints en varios lugares del código y la ejecución del mismo parará en ellos.
  • A continuación, para analizar los archivos de perfiles generados por Xdebug, puede instalar KCacheGrind (Linux) o WinCacheGrind (Windows).

Para desarrollar o usar los tests tests PHPUnit

Desde Eclipse

El mejor método es las PHP Tools integration para Eclipse:

http://www.phpsrc.org/eclipse/pti/

De este modo, la instalación y ejecución de los tests PHPUnit se integran directamente en su Eclipse. Modifique la configuración en Eclipse (Windows-Preferences-PHPTools-PHPUnit) tal y como sigue en la pantalla siguiente (haga clic para agrandar):

 

De lo contrario, deberá realizar instalación manual y ejecución en línea de comandos.

Desde línea de comandos

Instalar PHPUnit
  • Descargar el archivo de la versión desde http://pear.phpunit.de/get/ y descomprimir el contenido en un directorio que se encuentre incluido en el parámetro include_path de su archivo de configuración php.ini.
  • Preparar el script phpunit:
    • Bajo Linux: Renombrar el script phpunit.php a phpunit y remplazar la cadena @php_bin@ del archivo con la ruta completa de la línea de comandos del intérprete PHP (normalmente /usr/bin/php).
    • Bajo Windows: Remplazar la cadena @php_bin@ del archivo phpunit.bat con la ruta complete de la línea de comandos del intérprete de PHP y remplazar la cadena @bin_dir@ con el directorio de PHPUnit.
    • Modificar su PATH para incluir el directorio que contiene phpunit.
    • Asignar los permisos de ejecución (chmod +x phpunit bajo Linux).
  • Preparar el script PHPUnit/Util/PHP.php:
    • Remplazar la cadena @php_bin@ del archivo con la ruta completa de la línea de comandos del intérprete PHP (normalmente /usr/bin/php).
  • También se requiere el módulo xdebug si desea realizar informes de la cobertura de los tests.
Ejecutar los tests PHPUnit
  • Ir al directorio /test de la versión CVS. Consulte el archivo README para conocer el proceso de ejecución de una batería de tests.

Para desarrollar o usar los test Selenium

Desde Firefox

Instalar el plugin para Firefox Selenium IDE
  • Descargar el archivo del plugin Selenium IDE para Firefox.
  • Añadirlo en Herramientas - Módulos complementarios de Firefox.
Ejecutar los tests Selenium
  • Ir al menú Herramientas - Selinum IDE de firefox.
  • Abrir el archivo de tests xml
  • Ejecutar el test.

Para generar la documentación Doxygen

Art.png Configuración CVS

Si es un desarrollador oficial con acceso a CVS en escritura, añadir en la configuración de su Eclipse CVS, una entrada a CVS.

  • :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr para la versión principal de Dolibarr.
  • :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarrmod para los módulos externos.

En caso contrario deberá descargar los fuentes disponibles desde la página web Dolibarr (http://www.dolibarr.org) en el área de descargas.

Retrieved from "https://wiki.dolibarr.org/index.php?title=Herramientas_de_Desarrollo&oldid=23392"