Difference between revisions of "Herramientas de Desarrollo"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Tag: 2017 source edit
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<!-- BEGIN interlang links -->
 +
<!-- Do NOT edit this section
 +
    Links below are automatically managed by PolyglotBot
 +
    You can edit links on the English source page : Environment_and_development_tools -->
 +
[[en:Environment_and_development_tools]]
 +
[[fr:Outils_de_développement]]
 +
[[zh:开发环境与工具]]
 +
<!-- END interlang links -->
 +
 
{{TemplateDocDesarrollo}}
 
{{TemplateDocDesarrollo}}
  
Line 15: Line 24:
 
En Windows: Instalar [http://www.wampserver.com/ 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.
 
En Windows: Instalar [http://www.wampserver.com/ 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 ==
+
== Chrome o Firefox y plugins ==
* Firefox con los plugins:  
+
* Chrome
** Firebug + Firecookie
+
Descargables desde el sitio http://www.chrome.com
** 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
 
  
 +
* Firefox
 
Descargables desde el sitio http://www.firefox.com
 
Descargables desde el sitio http://www.firefox.com
  
Line 38: Line 42:
  
 
De lo contrario, puede encontrar las versiones disponibles en el sitio [http://www.eclipse.org Eclipse].
 
De lo contrario, puede encontrar las versiones disponibles en el sitio [http://www.eclipse.org Eclipse].
 +
 +
Una vez instalado Eclipse, es recomendable modificar/verificar las siguienes configuraciones:
 +
{{EclipseStandardSetup}}
  
 
=== Instalación del plugin Eclipse para PHP: PDT ===
 
=== Instalación del plugin Eclipse para PHP: PDT ===
Line 44: Line 51:
 
{{DownloadEclipsePDT}}
 
{{DownloadEclipsePDT}}
  
=== Configurar Eclipse para recuperar la versión CVS ===
+
=== 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.
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 (o login [http://savannah.nongnu.org/projects/dolibarr/ savannah])
 
** Password :  (dejar vacío)
 
** Connection type : pserver (o ext con login [http://savannah.nongnu.org/projects/dolibarr/ savannah])
 
** 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.
+
Vea la página [[Recuperar, actualizar los fuentes del proyecto]].
 
 
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.
 
  
 
= [[File:Computer.png]] Opcional =
 
= [[File:Computer.png]] Opcional =
 
+
Ver [[Herramientas de Desarrollo - 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 [[UML2Dolibarr - Crear un módulo usando MDA|Generar un módulo con MDA]]. Para utilizarlo, deberá instalar los siguientes componentes:
 
 
 
* Instalación de TopCased 1.4 ó +: http://www.topcased.org
 
 
 
* 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:
 
<source lang="bash">
 
svn checkout svn://svn.forge.objectweb.org/svnroot/acceleo/trunk/modules/community/uml21/dolibarr/trunk/
 
</source>
 
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:
 
<source lang="ini">
 
SetEnv DOL_TUNING 1
 
</source>
 
 
 
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:
 
 
 
=== [[File:Logo_windows.png|24px]] 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:
 
<source lang="ini">
 
[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
 
</source>
 
 
 
=== [[File:Logo_ubuntu.png|24px]] Ubuntu / Linux ===
 
* Instale el paquete '''php-xdebug''':
 
<source lang="bash">
 
sudo apt-get install php5-xdebug
 
</source>
 
 
 
* Modique el archivo xdebug.ini añadiendo los siguientes parámetros después de la línea zend_extension=xxx (o similar):
 
<source lang="ini">
 
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
 
</source>
 
 
 
=== [[File:Eclipsephp.jpg|24px]] 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):
 
 
 
[[File:Eclipse setup PHPUnit.png|100px]]
 
 
 
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 ==
 
* Instalar Doxygen, disponible en http://www.doxygen.org (o en el paquete doxygen bajo Ubuntu).
 
* Instalar el plugin Eclipse añadiento la url fuente http://download.gna.org/eclox/update/ en la herramienta de actualización de Eclipse.
 
 
 
= [[File: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.
 

Latest revision as of 09:44, 2 April 2025


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.

Chrome o Firefox y plugins

  • Chrome

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

  • Firefox

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.

Una vez instalado Eclipse, es recomendable modificar/verificar las siguienes configuraciones:

  • Window - Preferences - General - Workspace - Text file encoding -> UTF8
  • Window - Preferences - General - Workspace - New text file line delimiter -> Unix
  • Window - Preferences - General - Compare/Patch - Ignore white spaces -> Yes
  • Window - Preferences - General - Editor - Text editors - Tab delimiter length -> 4
  • Window - Preferences - General - Editor - Text editors - Insert spaces for tab -> No
  • Window - Preferences - General - Editor - File Association -> Add *.lang associated to "Text Editor"
  • Note: You can also disable Windows - Preferences - Java - Editor - Content Assist - Auto Activation

And if PDT is installed (see later):

  • Window - Preferences - PHP - Code Style - Formatter - Tab policy -> Tab
  • Window - Preferences - PHP - Code Style - Formatter - Default indentation for wrapped line -> 1
  • Window - Preferences - PHP - Code Style - Formatter - Default indentation for array initializer -> 0
  • Window - Preferences - PHP - Editor - Typing - Uncheck "When Pasting Adjust Indentation" (keeping this option checked create corruption of text files by adding bad end of line characters)
  • Window - Preferences - PHP - Code Style - Formatter - Use the profile provided into dev/setup/eclipse/PSR-12 [built-in].xml as Eclipse syntax formatter.
  • Note: You can also disable Windows - Preferences - PHP - Editor - Content Assist - Auto Activation

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.

Vea la página Recuperar, actualizar los fuentes del proyecto.

Computer.png Opcional

Ver Herramientas de Desarrollo - Opcional