Instalación de las herramientas

En la asignatura de Diseño del Software vamos a utilizar el entorno de desarrollo

Android Studio para desarrollar el código de nuestra aplicación y el plugin SimpleUML
para poder visualizar el diagrama de clases que representa el código escrito.

1. En primer lugar, descargaremos e instalaremos Android Studio

(https://developer.android.com/studio/). Instalaremos la ultima versión, y una
vez abierto, le daremos permisos al Android Studio para que instale el SDK y los
plugins por defecto necesarios.

2. A continuación, instalaremos el plugin SimpleUMLCE. Descargaremos la ultima

versión del plugin (https://plugins.jetbrains.com/plugin/4946-simpleumlce) y la
guardamos en nuestro disco local.

a) Abriremos Android Studio y nos dirigiremos a las preferencias (Archivo ->

preferencias [Win], Android Studio [Mac]).
b) Seleccionamos Plugins del panel izquierdo y clicamos en Instalar Plugin de
disco.

c) Seleccionamos el archivo que nos hemos descargado, lo seleccionamos e

instalamos
d) Reiniciamos Android Studio.
Creando nuestro proyecto en Android
En Android Studio crearemos un nuevo proyecto (Start a new Android Studio Project).
Seguís los pasos como se muestran en las siguientes ilustraciones. Recordad que
debéis poner un nombre a la aplicación, y un Company domain, que representará
vuestro dominio dentro de la aplicación. Se recomienda utilizar los siguientes dominios
para desarrollar la práctica:
 Fita 1 -> DS.Core
 Fita 2 -> DS.Reports
 Fita 3 -> DS.UI

Escogeremos el tipo de proyecto y la API a utilizar (se recomienda escoger Phone and
Tablet y la última API disponible)
A continuación, seleccionamos la “Actividad”. Aunque En las dos primeras Fitas no se
va a hacer uso de la interfaz, se recomienda escoger un “Empty Activity”.
Posteriormente ya se escogerá la Activity apropiada cuando se tenga que desarrollar la
interfaz.

Finalmente, indicamos el nombre de la actividad y del Layout.

Se abrirá el workspace de nuestro proyecto.

Podréis observar que Android Studio ha generado muchas carpetas y archivos. Todos
estos archivos son, en la mayor parte, ficheros de configuración que nos ayudarán a
personalizar nuestra App. Pero como la mayoría están centrados en la interfaz, y esto
es algo que está fuera de nuestro objetivo para las Fitas 1 y 2, para empezar no nos
preocuparemos por todas estas carpetas y ficheros. Nosotros nos centraremos en la
carpeta donde esta alojada el código.

Dentro de app -> java -> <Company_domain>.<name_project> estará vuestro espació

de trabajo para ir creando código. Crearemos las clases que necesitemos para
desarrollar nuestro proyecto. Y una vez creadas las clases, podremos generar el
diagrama de clases con SimpleUML.

Podemos observar que Android Studio habrá creado un fichero .java que inicia la
actividad (en nuestro ejemplo MainActivity.java) el cual contendrá algo similar al
siguiente código:

package u.ds.ds_example;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}

Debéis tener en cuenta que la función onCreate es nuestro punto de entrada. Podéis
escribir directamente vuestros test ahí, o crearlos en funciones separadas y desde el
onCreate invocarlos.

package u.ds.ds_example;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

private void test1(){}

private void test2(){}

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

test1();
}
Convirtiendo nuestro “Activity” a “Application”
Por defecto Android Studio está enfocado a realizar App para dispositivos móviles, y
por eso, por defecto crea una Activity que nos permite ejecutar nuestro código en una
aplicación móvil.

Para iniciar el desarrollo de las prácticas de la asignatura de Diseño del Software no es

necesario que ejecutemos nuestro código como si fuera una aplicación móvil. En estás
prácticas vamos a empezar a desarrollar primero el core de la aplicación, y
posteriormente (en la fita 3) es cuando ya desarrollaremos la interfaz y necesitaremos
ejecutarla como una aplicación móvil.

Para convertir nuestra proyecto (“Activity”) en un aplicación de consola (”Application”)

debéis seguir los siguientes pasos:

Creáis un nuevo fichero que contendrá nuestro nuevo punto de entrada a la aplicación
(por ejemplo “MainApplication.java”)

Deberemos indicarle a nuestra clase cual es el punto de entrada. Para ello

simplemente definimos el método “main” dentro de la clase. Os debe quedar algo
similar a esto:
package core.ds.exampleds;

public class MainApplication {

public static void main(String [] args){

System.out.println("Hello world!");
}

Ahora configuramos nuestro proyecto para que sea del tipo “Application” y sepa cuál
es el nuevo punto de entrada. Para ello abrimos la edición de la configuración de
nuestro proyecto (parte superior derecha -> “Edit Configurations”)

En la nueva ventana que aparece, añadimos una nueva configuración del tipo
“Application”.

Se os abrirá el formulario de configuración de la aplicación. Aquí se debe escoger la

clase principal. Para ello deberemos pinchar sobre los 3 puntos “...” del parámetro
“Main Class”, y en el buscador podemos empezar a buscar la clase que acabamos de
crear (en nuestro caso “MainApplication”) y nos aparecerá la clase, que
seleccionaremos como punto de entrada.

Por último, seleccionamos el classpath de nuestro modulo:

Guardamos la nueva configuración, y ya podemos ejecutar nuestro proyecto. Ahora

veremos como Android Studio ya no pide abrir un terminal o emulador, sino que
ejecuta nuestro código utilizando el Terminal como punto de entrada y salida.
Generando el diagrama de clases
Una vez escrito nuestro código, generaremos el diagrama de clases. Para ello
abriremos el menú contextual (botón derecho del ratón) sobre la carpeta del código y
seleccionaremos Add to SimpleUML Diagram -> New Diagram

Introduciremos el nombre del diagrama

Y le indicaremos que añada las carpetas recursivamente

Nos creará el diagrama de clases, pero con todos los elementos superpuestos.
Podemos organizar los elementos de forma manual, o indicarle al plugin que haga una
alineación automática

Le indicamos que “destruya” el layout actual.

Debéis prestar atención al menú que hay en la parte izquierda del diagrama. Con él
podréis mostrar u ocultar los elementos del diagrama.
*Introduciendo cardinalidades en el diagrama

Por defecto el plugin SimpleUML no lleva implementada la funcionalidad de introducir

las cardinalidades de las relaciones. Para añadirlas en nuestro diagrama podemos
utilizar el elemento de texto
Importando librerías .jar
Es muy usual que en nuestros proyectos utilicemos librerías desarrolladas por terceros
para poder incorporar su funcionalidad dentro de nuestro proyecto. En este apartado
os vamos a explicar como añadir librerías .jar a nuestro proyecto.

Como ejemplo utilizaremos la librería Slf4j. Se trata de una librería que nos permitirá
los mensajes del sistema de forma eficiente. Tener en cuenta que al principio no
necesitaréis está librería para empezar vuestro proyecto de la asignatura, se os
indicará en las clases de prácticas cuando deberéis utilizarla.

En primer lugar, descargamos la librería de: https://www.slf4j.org/android/.

Escogemos la ultima versión que haya (binaria), por ejemplo slf4j-android-1.6.1-
RC1.jar.

A continuación, localizamos dentro de nuestro proyecto la carpeta de librerías (libs).

Tener en cuenta que debéis estar en la vista Project (1 y 2), y dentro de la carpeta del
proyecto, dirigirnos a la carpeta app -> libs. Allí copiamos la librería que nos acabamos
de descargar.
Una vez la librería está correctamente copiada en nuestra carpeta de librerías,
debemos añadirla en la lista de dependencias. Para ello abriremos File -> Project
Structure -> Select app -> Dependencies

Pulsamos sobre el botón (+) y seleccionamos Jar dependency. Buscamos dentro de las
carpetas del proyecto el fichero .jar que acabamos de añadir.
Guardamos los cambios y ya estaremos listos para utilizar la librería. En este caso
concreto, debemos importar la librería en nuestro código escribiendo el siguiente
código:

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
Comprobando el estilo (checkingstyle)
Android Studio lleva por defecto una herramienta que nos permite comprobar el estilo
de nuestra codificación. Para poder utilizar esta herramienta, previamente haremos
unas comprobaciones de configuración.

Abrimos las preferencias de Android Studio -> Editor -> Code Style. Comprobamos que
el lenguaje Java tiene seleccionado el Scheme Default. Podríamos escoger otro, o
incluso importar nuevos estilos, pero para alcanzar los objetivos de esta asignatura, es
suficiente el Default.

Una vez asignado el estilo, debemos comprobar el estilo de nuestra codificación. Para
ello, seleccionamos el fichero, o la carpeta del proyecto, que queremos analizar con el
botón derecho del ratón para que se despliegue el menú, y seleccionamos Analyze ->
Inspect code...
Si todo ha ido correcto, porque nuestro código respeta el estilo de codificación, en la
parte inferior podremos observar el resultado del análisis.

En el caso contrario, se nos mostrará la parte del código que no respeta el estilo de
codificación con la consiguiente información del error, y en la mayoría de casos, es el
propio Android Studio quien nos sugiere como podemos solucionarlo.