Documentación para desarrolladores

Transcripción

1 Documentación para desarrolladores Página 1 de 180

2 1.Introducción ChinApp es una aplicación móvil con soporte para generar está misma a través de una aplicación web. Este documento es una informativa sobre la parte interna de la aplicación, para proporcionar a los futuros desarrolladores de más datos para continuar la tarea del desarrollo. Para saber más acerca de la aplicación, es interesante revisar el manual del usuario antes de leer este documento. Página 2 de 180

3 2. Arquitectura software y hardware. La aplicación web está basada en una arquitectura Modelo Vista Controlador (a partir de ahora MVC). Esto se consigue gracias al framework de java Spring-mvc, el cual por medio de anotaciones consigue realizar este patrón de programación en la parte servidora. Mientras, la parte cliente contempla el framework Angularjs de Google. 3. Configuración Configuración del puesto del desarrollador Obtener la versión estable de Eclipse y descomprimirla en la carpeta que deseemos tener la instalación. Instalación de JDK7 1. Obtener la versión de Java Descomprimirla en la carpeta que deseemos tener la instalación. 3. Para integralo en Eclipse: Abrir Windows Preferences. En el apartado Java Installed JREs tenemos el listado de Javas instalados. Página 3 de 180

4 Pulsamos el boton Add. Seleccionamos Standard VM y pulsamos Next> Página 4 de 180

5 Pulsando en el botón Directory buscamos y seleccionamos el directorio donde hemos instalado la JDK en el paso anterior. Ponemos un nombre a la instalación y pulsamos Finish. Ahora nos aparecerá la nueva instalacion de Java en la lista de JREs instalada. Página 5 de 180

6 Marcamos el check al lado del nombre, para que sea la instalación por defecto; y pulsamos Ok. Instalación de JBOSS 1. Obtener la version de Jboss 6.2: 2. Descomprimirla en la carpeta que deseemos tener la instalación. 3. Integración de Jboss en Eclipse. a. Abrimos la ventana de crear un nuevo servidor y desplegamos la carpeta Jboss para ver los servidores disponibles, si la versión que queremos integrar no está disponible nos descargamos los adaptadores haciendo clic en Download additional server adapters. Página 6 de 180

7 b. En la lista de disponibles seleccionamos JBOSS AS Tools y pulsamos Next c. Aceptamos la licencia y pulsamos Finish. Página 7 de 180

8 d. Se descargará las herramientas y nos pedirá reiniciar Eclipse al final del proceso. e. Volvemos a abrir la pantalla de crear nuevo servidor y ahora desplegamos la carpeta de Jboss Community, seleccionamos Jboss eap 6.1+ y pulsamos Next. Página 8 de 180

9 f. Ponemos en el campo Home Directory la carpeta donde hemos instalado Jboss y pulsamos Finish g. Una vez terminado el proceso tendremos en la pestaña Servers creado el servidor de aplicaciones. Instalación de Apache Maven Obtener la version de Maven Descomprimirla en la carpeta que deseemos tener la instalación. 3. Crear la variable de entorno M2_HOME. Página 9 de 180

10 a. Abrir las pantalla de system properties (WinKey + Pause). Ir a la pantalla de advanced system settings b. En la pestaña Advanced pulsar el botón Environment Variables. c. Pulsar el botón New de la sección User variables for. Página 10 de 180

11 a. Creamos la nueva variable M2_HOME con el valor del directorio donde hemos descomprimido el software. b. Al pulsar OK la variable tiene que quedar registrada en la sección de variables de usuario. Página 11 de 180

12 4. Siguiendo el mismo procedimiento hay que añadir la variable M2, con el contenido %M2_HOME%\bin. 5. Siguiendo el mismo procedimiento añadir/modificar la variable PATH para que incluya esta última variable creada. Página 12 de 180

13 6. Asegurarse de que existe la variable JAVA_HOME y si no está, crearla siguiendo el mismo procedimiento apuntando a la carpeta donde tenemos instalada la JDK. 7. Añadir en el PATH del sistema la carpeta %JAVA_HOME%\bin Página 13 de 180

14 8. Para probar que todo está correctamente configurado, abrimos una consola y ejecutamos en comando mvn - version. Conexion a repositorio SVN desde Eclipse Primero tenemos que obtener un Plug-in para Subversion. Dentro de Eclipse vamos a Help Eclipse MarketPlace. Buscamos la cadena subversion y obtenemos una lista de plug-ins. Para el proyecto NGE hemos instalado Subversive SVN Team Provider 1.1.2, el plug-in desarrollado por Eclipse. Página 14 de 180

15 Pulsamos el botón Install y comienza a instalar. Página 15 de 180

16 Instalamos todas las herramientas y pulsando Confirm> y aceptando la licencia. Cuando termina el proceso, reiniciamos Eclipse para completar la instalación. En el menu principal de Eclipse vamos a Window, Open Perspective, Other. Seleccionamos SVN repository Exploring para pasar a la perspectiva de exploracion de repositorios. Nos aparecerá una pantalla para instalar los conectores al repositorio. Página 16 de 180

17 Seleccionamos el SVN Kit y el Native JavaHL (32-bits) y pulsamos Finish. Instalamos todos los componentes propuestos y pulsando Next> y aceptando la licencia. Si nos aparece un Warning informando que instalaremos software no firmado, pulsamos OK para que continue la instalación. Página 17 de 180

18 Cuando termina el proceso, reiniciamos Eclipse para completar la instalación. Para configurar el repositorio, en la vista SVN Repositories pulsamos botón derecho, New, Repository Location. Introducimos la URL de nuestro repositorio: Y ponemos nuestro usuario y contraseña, que tienen que estar creados previamente en SVN. Contactar con Veronica para confirmar que está creado. Cuando termine el proceso, ya tenemos disponible nuestro repositorio. Página 18 de 180

19 Para importar los proyectos que están en el repositorio pasamos a la perspectiva de trabajo. En el Project Explorer pulsamos el botón derecho, New, Other. En el filtro ponemos Maven y seleccionamos Checkout Maven Project from SCM y pulsamos Next> En la ventana de Target Location aparecerá la lista de SCM URL vacía, la primera vez. Pulsamos m2e Marketplace para descargar los componentes necesarios. Página 19 de 180

20 Seleccionamos el m2e-subversive y pulsamos Finish Instalamos el componente propuesto y pulsamos Next> ; aceptamos la licencia. Si nos aparece un Warning informando que instalaremos software no firmado, pulsamos OK para que continue la instalación. Cuando termina el proceso, reiniciamos Eclipse para completar la instalación. Cuando reinicia el Eclipse volvemos a iniciar el proceso de importación de los proyectos, en el Project Explorer botón derecho, New, Other. Página 20 de 180

21 En el filtro ponemos Maven y seleccionamos Checkout Maven Project from SCM y pulsamos Next> En la ventana de Target Location desplegamos la lista de SCM URL y seleccionamos svn y ponemos la URL de nuestro repositorio. Pulsamos Finish. Para descargar todo el código fuente de nuestro proyecto desde el repositorio. Desde la vista SVN Repositories desplegamos el repositorio xiangmu y seleccionamos el proyecto xiangmu-parent. Pulsamos botón derecho y seleccionamos Check out. Página 21 de 180

22 Cuando el proceso termina ya tenemos el proyecto descargado en nuestro espacio de trabajo con todos los proyectos hijos en su interior. Ahora vamos a importar los proyectos hijos. Página 22 de 180

23 Seleccionamos el proyecto sigma-parent, hacemos botón derecho y seleccionamos Import Seleccionamos Existing Maven Projects y pulsamos Next>. En la lista nos aparecen los proyectos incluidos en sigma-parent. Seleccionamos los que necesitamos pulsamos Finish. Página 23 de 180

24 Tras importarlos se actualiza automáticamente el espacio de trabajo. Ahora ya nos aparecen en nuestro espacio de trabajo los proyectos listos para trabajar en ellos. Página 24 de 180