Herramientas de Desarrollo

From Dolibarr ERP CRM Wiki
Revision as of 20:13, 21 July 2010 by Eldy (talk | contribs) (→‎Opcional)
Jump to navigation Jump to search

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.

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 3.0 con los plugins:
    • HTML Validator
    • Phplangeditor
    • Firebug + Firecookie
    • phplangeditor y los diccionarios de los idiomas en los que usted planea trabajar
    • Cert Viewer Plus si quiere realizar pruebas en HTTPS.
    • FoxyProxy 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 CVS

Una vez que tenga instalado Eclipse, puede conectar al repositorio CVS para recuperar la última versión de desarrollo.

  • Cree un nuevo proyecto : File >> New >> Projects y seleccione "Project from CVS" et "Next"
  • Seleccione "Create a new repository location" y "Next"
  • Rellene la ventana siguiente como sigue:
    • Host : cvs.savannah.nongnu.org
    • Repository path : /cvsroot/dolibarr
    • User : anonymous
    • Password : (dejar vacío)
    • Connection type : pserver
    • Use default port
  • Rellenar el campo Use specified module name : dolibarr
  • A continuación, elija el nombre que el proyecto tendrá en su equipo:
    • Comprobar Check out as a projet in the workspace
    • Project Name : dolibarr
    • Comprobar Checkout subfolders
  • A continuación, dejar la ruta por defecto del workspace y "Next"
  • Por último, seleccione la rama a cargar
    • HEAD es la versión de desarrollo
    • Las versiones 2.6, 2.7, etc., se situan en sus respectivas ramas
  • Haga clic en "Finish"

Los archivos deberían descargarse en su equipo local.

Para actualizar la versión de su máquina, debe pasar a la perspectiva "Team Synchronizing" para utilizar la funcionalidad "Synchronize CVS", lo que dará lugar a la descarga de la última versión en su equiplo local. Sólo se descargan los archivos que han cambiado.

Eclipsephp.jpg Opcional

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 el ajuste a la línea de código, instale XDebug:

En Ubuntu: Instalar el paquete php-Xdebug

En Wampserver/Windows, descargar el archivo php_debug_xxx.dll desde http://www.xdebug.org y guardarlo en el directorio /ext de php de WampServer.

  • Modificar el fichero php.ini (ó xdebug.ini) para agregar los 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
  • 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

From Eclipse

You can also optionnally install The PHP Tools integration for Eclipse:

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

From command line

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.

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.