El Gran Libro de Android

-

-

-

-~-

El gran libro de Android El

gran

libro

de

Android

Jc&ú& Tomó~ Tomás Gironé~ Gironés ----------Je~ú~

22 22 Edición Edición

AAifaomega

A Alfaomega

marcombo ediciones técnicas edicion e s técnicas

t·

1

El gran gran libro libro de de Android Androíd El Jesús Tomás Gironés Tomás Gironés Jesús

El gran gran libro El libro de de Android Android Jesús Tomás Gironés Gironés Jesús Tomás

/:1. Alfaomega

H marcombo ediciones técnicas

Datos catalográficos Tomás, Jesús El gran libro de Android Segunda Edición México C .V., México de C.V., .A . de Alfaomega Grupo Editor, SSA. 978-607-707-506-6 ISBN: 978-607-707-506-6 Formato: Formato: 17 x 23 cm Páginas: 404 Páginas: Android El gran libro de Android Gironés Jesús Tomás Girones España Barcelona,España A.,Barcelona, MARCOMBO,SSA., porMARCOMBO, publicadapor espaí'íol publicada en español edición en ISBN: 978-84-267-1832-7, edición Derechos reservados © MARCOMBO, A.. MARCOMBO , SS.A 2012 julio 2012 México,julio Editor, México, Grupo Editor, Segunda edición: Alfaomega Grupo

C.V. de C.V. Editor, SS.A. © 2012 Alfaomega Grupo Editor, A. de D.F. México D.F. 03100, México Valle , 03100, Pitágoras 1139, Col. Del Del Valle, Mexicana Editorial Mexicana Industria Editorial la Industria de la Nacional de Miembro de la Cámara Nacional Registro No. 2317

Pág.. Web: http://wwwailfaomega.com.mx http://www.alfaomega.com.mx Pág [email protected] E-mail : [email protected] E-mail: ISBN: 978-607-707-506-6 Derechos reservados: lengua en lengua publicación en de publicación derechos de los derechos autor yy los su autor de su intelectual de Esta obra es propiedad intelectual total parcialoototal reproducción parcial su reproducción Prohibida su editor. Prohibida al editor. transferidos al española han sido legalmente legalmente transferidos copyright. delcopyright. derechosdel losderechos de los propietariode del propietario escrito del por escrito permiso por por cualquier medio sin permiso

Nota importante: tanto, porlolotanto, didáctico y,y,por exclusivamente didáctico fin exclusivamente un fin tiene un obra tiene esta obra en esta La información contenida en indicaciones Las indicaciones industrial. Las profesional oo industrial. nivel profesional no está previsto su aprovechamiento aprovechamiento aa nivel autor yy por elel autor cuidado por gran cuidado con gran elaborados con sido elaborados han sido incluidos, han técnicas y programas incluidos, de S.A . de EDITOR , SA. GRUPO EDITOR, ALFAOMEGA GRUPO control. ALFAOMEGA de control. normas de reproducidos bajo estrictas estrictas normas que sese perjuiciosque daños yy perjuicios omisiones; daños errores uu omisiones; por: errores responsable por: jurídicamente responsable C .V. no será jurídicamente C.V. utilización por lala utilización libro, nini por este libro, en este comprendida en información comprendida la información de la pudieran atribuir al uso uso de indebida que pudiera dársele. dársele. Mexico. in México. Impreso en México. Printed in

Empresas del grupo: 03100. C.P.03100. D.F.México,D.E Valle,México, DelValle, Col.Del 1139,Col. Pitágoras 1139, C.V.de C.V. A. de México: Alfaomega Grupo Editor, - Pitágoras - C.P. Editor, SSA. O1-800-020-4396 costo: 01-800-020-4396 Sin costo: 2490. Sin 5575-2420 /12490. (52-55) 5575-2420 Fax: (52-55) Tel.: (52-55) 5575-5022 -- Fax: [email protected] E-mail: [email protected],mx Colombia, Bogotá,Colombia, 29,Bogotá, 64AA29, No.64 15 No. S.A.--Carrera Colombia; Alfaomega Colombiana Carrera 15 Colombiana SA. Colombia: [email protected] E-mail: [email protected] 6068648(57-1) 6068648 Fax: (57-1) 2100122(57-1) 2100122 Tel.: (57-1) - Fax: - E-mail: Chile Santiago,Chile Providencia,Santiago, 1437,Providencia, Sierra 1437, La Sierra Dr. La S.A.Chile: Alfaomega Grupo Editor, - Dr. Editor, SA. [email protected] E-mail: [email protected] 235-5786(56-2) 235-5786 Fax: (56-2) 235-4248Tel.: (56-2) 235-4248 - Fax; - E-mail: Aires, BuenosAires, 1057,Buenos 11, C.P. 1057, Argentina: Alfaomega GmpoEditorArgentino,S 1307 P.B. Of.11,C.P. A. - Paraguay 1307P.B.Of. Grupo Editor Argentino, SA.-Paraguay [email protected] E-mail: [email protected] 71834811 7183 (54-11) 4811-0887 yy4811 - TelJFax: (54-11)4811-0887 Argentina, -Tel/Fax: Argentina, - E-mail:

Para Bea, Sea, con amor y gratitud

Índice índice general general Lista de acrónimos .............................................................................................15 15 ¿Cómo leer este libro? .......................................................................................17 17

1. Visión general y entorno de desarrollo ....................................21 CAPÍTULO l. 21 1.1. 22 1.1. ¿Qué hace que Android sea especial? .....................................................22 23 1.2. 1.2. Los orígenes .................................................. .. ... .......................................23 24 1.3. 1.3. Comparativa con otras plataformas ................................. .. .. .....................24 1.4. 1.4. Arquitectura de Android .............................................................................26

1.4.1. El núcleo Linux ............................................................... ........ .............27 1.4.1. 1.4.2. 27 1.4.2. RuntimedeAndroid Runtime de Android ........ ........................... ............. .............................27 1.4.3. 28 1.4.3. Librerías nativas ..................................................................................28

1.4.4. Entorno de aplicación ...... ................................................................. ...28 1.4.4. 28 29 1.4.5. 1.4.5. Aplicaciones .........................................................................................29 29 1.5. 1.5. Instalación del entorno de desarrollo ............. .. .........................................29 1.5.1. 30 1.5.1. Instalación de los componentes por separado ....................................30

1.5.1.1. 1.5.1. 1. Instalación de la máquina virtual Java .............................................30 30 1.5.1.2. 1.5. 1.2. Instalación de Eclipse .......................................................................30 30 1.5.1.3. Instalar Android SDK de Google Goog/e ......................................................31 31

1.5.2. Instalación del plug-in Android para Eclipse (ADT) .. .. .........................35 1.5.2. 35 1.5.3. Instalación con MOTODEV Studio ..... .................................................36 36 1.5.3. 1.6. Las versiones de Android y niveles de API. API .. ............................... ............ .38 38 1.6. 1.6.1. Android 1.0 Nivel de API 1 1 (septiembre 2008) ....................................39 1.6.1. 39 1.6.2. Android 1.1 1.1 Nivel de API 2 (febrero 2009) ... .......................................39 1.6.2. 39 1.6.3. Android 1.5 Nivel de API 3 (abril 2009, Cupcake) ...............................39 (abril2009, 39 1.6.3. 1.6.4. Android 1.6 1,6 Nivel de API 4 (diciembre 2009, 2009, Donut) ...........................39 1.6.4. 39 1.6.5. 1.6.5. Android 2.0 Nivel de API 5 (octubre 2009, 2009, Éclair) .............................. .40 40

1.6.6. Android 2.1 2.1 Nivel de API 7 (enero 2010, 2010, Éclair) ..................................40 1.6.6. 1.6.7. Android 2.2 Nivel de API 8 (mayo 2010, 1.6.7. 2010, Froyo) .... .............. ................40 40 2010, Gingerbread) ............... .41 41 1.6.8. Android 2.3 Nivel de API 9 (diciembre 2010, 1.6.9. 1.6.9. Android 3.0 3,0 Nivel de API 11 (febrero 2011 2011,, Honeycomb) .................. .41 41 1.6.10. 1.6.10. Android 3. 3.11 Nivel de API 12 (mayo 2011) ......................................... .42 42

7

1.6.11. Android 3.2 Nivel de API 13 Uulio (julio 2011) ............................................ .42 42 1.6.12. Android 4.0 Nivel de API 14 (octubre 2011, Ice Cream Sandwich) .... 43 Sandwich)....43 1.6.13. 43 1.6.13. Android 4.0.3 Nivel de API15 API 15 (diciembre 2011) ........................ .. .... ..43 1.6.14. 1.6.14. Elección de la plataforma de desarrollo .. ............ .............................. .43 43 1.7. Creación de un primer programa ............................................................. .45 45

1.7.1. 1. 7.1. Creación del proyecto ................ ..........................................................45 45 49 1.8. 1.8. Ejecución del programa .................. .................................................. ........ .49 1.8.1. 1.8.1. Ejecución en el emulador ............ ................. ...................................... .49 49 1.8.2. Ejecución en un terminal real ................................ ............................. .49 49

1.9. Elementos de un proyecto Android ............................................... .. .. ........51 1.9. 51 1.10. 53 1.10. Componentes de una aplicación ...............................................................53 53 1.10.1. 1.10.1. Vista (View) ................... ....................................... .............. .. ......... .. ....53 1.1 0.2. Layout ................ ... .. ...... .. ......... .... ... .......... ........ ... ................ ... .... .. .... ..53 53 1.10.2. 54 1.10.3. 1.10.3. Actividad (Activity) .. ........... ...................... ............. ...... ...................... ..54 54 1.1 0.4. Servicio (Serv/ce) ( Service) ........................ .. .......................... ... ............... ..........54 1.10.4. 1.1 0.5. Intención (lntent) 54 1.10.5. (Intent) .................. .................... .......... ... .. ...... .. ................ ... .54 1.10.6. 54 1.10.6. Receptor de anuncios (Broadcast receiver) ........ ................ .. ..... .. ......54 55 1.10.7. Proveedores de Contenido (Content (Contení Provider) .. ............. ....... ............55 1.11. Documentación y ApiDemos ...... ..... .. ........................................................55 55 1.11 .1. Donde encontrar documentación .......................................................55 55 1.11.1. 1.11 .2. La aplicación ApiDemos ...... ...... .................. ......... ........................ ......55 55 1.11.2. 51 1.12. 1.12. Depurar ................................... .............. ...... ... .......... .. ........ ............ ..... ..... .57 1.12.1. 57 1.12.1. Depurar con Eclipse ...........................................................................57 1.12.2. 58 1.12.2. Depurar con mensajes Log ........ .... .... .................................. .......... .....58

CAPÍTULO 2. Diseño de la interfaz de usuario: Vistas y Layouts .................61 61 2.1. 62 2.1. Creación de una interfaz de usuario por código ............. ..........................62 63 2.2. XML.. ..................................63 2.2. Creación de una interfaz de usuario usando XML 66 2.2.1. 2.2,1. Edición visual de las vistas ..... ........ .............. ................ .......................66 70 2.3. 2.3. Layouts ....................... ........................... ......................... .. .........................70 2.4. 76 2.4. Una aplicación de ejemplo: ejemplo: Asteroides ..... ............................ ....................76 78 2.4.1. Recursos alternativos .. ....... .... .... .... .. .. .............. ..... ..............................78 2.5. Estilos y temas ... ... .......................... .. ......... ......................................... ......82 82

8

2.5.1. Losestilos Los estilos....... ............... ..... ........ ....................... ........ ........................... 83 2.5.1. 2.5.1.1. 2.5. J. J. Heredar de un estilo propio ...............................................................83 83 2.5.2. Los temas ................... ........ .......... .................. ... ..................................84 84 2.6. 85 2.6. Uso práctico de Vistas y Layouts .. ..................................... .......................85

2.6.1. Acceder y modificar las propiedades de las vistas por código ............87 2.6.1. 87 2.7. Uso de TabLayout .....................................................................................89 2.7. 89 91 2.7.1. Uso de la etiqueta en Layouts ............................................91

CAPÍTULO 3. Actividades e Intenciones ..........................................................93 93 3.1.

Creación de nuevas actividades ....................... ................................... .....94 94

3.2. Comunicación entre actividades ...............................................................98 3.2. 98 3.3. Añadiendo un menú ................................................................................100 100

3.4. Creación y uso de iconos ........................................................................102 3.4. 102 3.5. Añadiendo preferencias de usuario ............... ...... ................................. ..105 3.5. 105 3.5.1. Organizando preferencias ............................................. .......... .. ........108 3.5.1. 108 3.5.2. Como se almacenan las preferencias de usuario .............................109 109 3.5.2. 3.5.3. Accediendo a los valores de las preferencias ...... .. ...........................110 3.5.3. 11 O 3.6.. Añadiendo una lista de puntaciones en Asteroides ....... .. .... .. ....... ......... .111 3.6 111 3.7. 3. 7. La vista ListView ... .. ....... ................. ............ ............... ...... .. ......................113 113 3.7.1. 3. 7 .1. Un ListView que visualiza una lista de Strings ..................................115 115 3.7.2. Un ListView que visualiza Layouts personalizados .. .................. .......116 116

3.7.3. Un ListView con nuestro propio adaptador ........... .................... ........118 118 3.7.4. 3. 7 .4. Detectar una pulsación sobre un elemento de la lista .......... .............120 120 3.8.

121 Las Intenciones ....................... .. .. .................................... .... ....................121

3.8.1. La etiqueta ...................................................................126 126

CAPÍTULO 4. Gráficos en Android ................................................................127 127 4.1. Clases para gráficos en Android .............................. .. .............................128 4.1. 128 128 4.1.1. Canvas ............................................. .. ............................. ...................128

4.1.2. Paint .. ................................................................ ...............................130 4.1 .2. Paint.. 130 4.1.2.1. 4. J.2. J. Definición de colores .......................................................................131 J3 J 4.1.3. Path ...................... ................. .. ..........................................................133 4.1.3. 133 135 4.1.4. Drawable ....................................... .. .......... .........................................135

9

4. 1.4.1. BitmapDrawable ..............................................................................136 136 4.1.4.1.

4.1.4.2. 4. 1.4.2. GradienDrawable ............................................................................137 137 4. 1.4.3. TransitionDrawable .........................................................................138 138 4.1.4.3. 4. 1. 4.4. ShapeDrawable ................................................................................138 138 4.1.4.4. 4. 1.4.5. AnimationDrawable .........................................................................139 139 4.1.4.5.

4.2. Creación de una vista en un fichero independiente ................. ...............140 4.2. 140 4.3. 143 4.3. Creando la actividad principal de Asteroides ............................. .............143 4.3.1. La clase Gráfico ............... ............ .. .......... ................... ........... ............145 4.3.2. 146 4.3.2. La clase VistaJuego .................. ......................................... ..... .. ........146 4.3.3. 148 4.3.3. Introduciendo la nave en VistaJuego ........................................ ........148 4.4. 150 4.4. Representación de gráficos vectoriales en Asteroides ...........................150 152 4.5. 4.5. Animaciones ................ ... ..... ... ..... .................. .............................. ............152 4.5.1. 153 4.5.1. Animaciones Tween ......................................................... .......... .......153 4.5.2. 156 4.5.2. Animaciones de propiedades ........................................ ...... ..............156

CAPÍTULO 5. Entradas en Android: teclado, pantalla táctil y sensores .....157 157 5.1. Manejando eventos de usuario ............................... ................ .. ..............158 158 5. 1.1. Escuchador de eventos ............................. ........ ..... ...........................158 158 5.1.1. 5.1.2. Manejadores de eventos ...................................................................159 159 159 5.2. 5.2. El teclado ..................................................... .......................................... ..159 5.3. 162 5.3. La pantalla táctil ......................................... .......................................... ...162 5.3.1. 165 5.3.1. Manejo de la pantalla táctil con multi-touch ....... .............. ...... ...........165 5.3.2. 168 5.3.2. Manejo de la nave con la pantalla táctil ......... ................ ........... ........168 5.4. 5.4. Gestures ............................................... ..................... .. ........ ....................169 5.4.1. 170 5.4.1. Creación y uso de una librería de gestures ......... .. ............................170 5.4.2. 174 5.4.2. Añadiendo gestures a Asteroides ............. .. ............................ ...........174 5.5. 176 5.5. Los sensores .... ......... .................. ... ................ .. .. .................................... .176 5.5.1. Un programa que muestra los sensores disponibles y sus valores en tiempo real. 181 real .... ................................... ..... ......... ........181 5.5.2. 183 5.5.2. Utilización de los sensores en Asteroides .........................................183 5.6. 184 5.6. Uso de hilos de ejecución (Threads) ...... ............................... ....... ...........184 5.6.1. 185 5.6.1. Introduciendo movimiento en Asteroides .. ..................... ...................185 187 5.7. Introduciendo un misil en Asteroides ................. .. .. .. .... .. ....... .. ....... .........187

10

CAPÍTULO 6. Multimedia yy ciclo ciclo de de vida vida de de una una actividad actividad ...........................191 191 6.1. de una una actividad actividad ..... .............................. .................... .........192 192 6.1. Ciclo de vida de 6.1.1. proceso se se elimina? elimina? ......................................... ........................198 198 6.1.1. ¿Qué proceso el estado estado de de una una actividad actividad ..............................................200 200 6.1.2. Guardando el 6.1.2. Guardando 6.2.

Utilizando multimedia multimedia en en Android Android .. .. ...... .. .... .. .. ...... ........ .................. ........202 202 Utilizando

6.3. La vista VideoView VideoView .......... ................ ........... ..... ........ ................................205 205 6.4. MediaPiayer ..............................................................................207 207 6.4. La clase MediaPlayer 207 6.4.1 de audio audio con con MediaPlayer MediaPiayer .................... ......................207 6.4.1.. Reproducción de 6.5. multimedia pasó pasó aa paso paso .................................................208 208 6.5. Un reproductor multimedia 6.6. efectos de de audio audio con con SoundPool SoundPool .....................................215 215 6.6. Introduciendo Introduciendo efectos 6.7. de audio audio .............. ...................................................................217 217 6.7. Grabación de

CAPÍTULO 7. Seguridad Seguridad yy posícionamiento posicionamiento ....................................................223 223 7.1. Los tres pilares pilares de de la la seguridad seguridad en en Android Android ................ ............................224 224 7.1.1. Linux yy acceso acceso aa ficheros ficheros ............ .........................................225 225 7.1.1. Usuario Linux esquema de de permisos permisos en en Android Android .................................................225 225 7.1.2. 7.1.2. El esquema 7.1.3. definidos por por el el usuario usuario en en Android Android ...... .. ...........................227 227 7.1.3. Permisos definidos 7.2. Localización Localización .. ........................... ....... ................ .........................................231 231

7.2.1. Emulación 7.2.1. Emulación del del GPS GPS con con Eclipse Eclipse ........................................................236 236 7.3. Maps ................... .................. .. ....................................................237 237 7.3. Google Maps 7.3.1. de una una clave clave Google Google Maps Maps ........ .............. ...... ..................237 237 7.3.1. Obtención de

7.4. Fragmentando los 242 los asteroides asteroides ..................................................................242 7.4.

CAPÍTULO 8. Servicios, Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios ..................245 245 8.1. los servicios servicios en en Android Android ...................................................246 246 8.1. Introducción Introducción aa los

8.1.1. Ciclo de vida 8.1.1. vida de de un un servicio servicio ...............................................................247 247 8.1.2. Permisos ...................................... ............................ ..........................249 249 8.1.2. 8.2. Un servicio para ejecución ejecución en en segundo segundo plano plano........................................249 249 8.2. 8.2.1. Los métodos 8.2.1. métodos onStartCommad() onStartCommad() yy onStartQ onStart() ......................................252 252 8.3. Las notificaciones 8.3. notificaciones de de la la barra barra de de estado estado .................................................254 254 Configurando tipos tipos de de avisos avisos en en las las notificaciones notificaciones .............. .............257 257 8.3.1. Configurando

8.3.1.1. 7 8. 3.1.1. Asociar un sonido sonido ............................................................................25 257 8.3. 1.2. Añadiendo vibración vibración .......................................................................257 257 8.3.1.2.

11

8.3. 1.3. Añadiendo parpadeo de LED ..........................................................25 257 8.3.1.3. 7

8.4. 8.4. Receptores de anuncios ............................................ ............. ..... ............258 258 AndroidManifest.xml ...... ..........259 259 8.4.1. Receptor de anuncios registrado en AndroidManifest.xml

8.4.2. Arrancar un servicio tras cargar el sistema operativo .......................265 265 aplicaciones .......266 266 8.5. 8.5. Un servicio como mecanismo de comunicación entre aplicaciones 267 8.5.1. Crear la interfaz en AIDL ................................ ................ ...................267 268 8.5.2. Implementar la interfaz ................ ................................................ ......268 8.5.2. 8.5.3. Publicar la interfaz en un servicio ..................... .................................269 269 8.5.3. 270 8.5.4. 8.5.4. Llamar a una interfaz remoto ................ .................. ................... ........270

CAPÍTULO 9. Almacenamiento de datos .........................................................273 273 9.1. Alternativas para guardar datos datos permanentemente en Android .. ....... ....274 274 9.1. 275 9.2. Añadiendo puntuaciones en Asteroides ........ .......... ................ ............... .275 9.3. Preferencias .... ........... ...... ....................... ................................................277 277

9.4. Accediendo a ficheros ............... .................................. ....... .... ...... ..... ......280 9.4. 280 281 9.4.1. Sistema interno de ficheros ...............................................................281 9.4.2. Sistema de almacenamiento externo ...... .............. ................ ............283 283 9.4.2. 1. Verificando acceso a la memoria externa ........................................285 285 9.4.2.1.

9.4.2.2. 9.4. 2.2. Almacenando ficheros específicos especificas de tu aplicación en el almacenamiento externo ..........................................................286 286 9.4.2.3. Almacenando ficheros compartidos en el almacenamiento externo ..................................................................287 287

9.4.3. Acceder a un fichero de los recursos ................................................288 288 9.5. Trabajando con XML ................. ........ ......................................................289 289 9.5. 290 9.5.1. 9.5.1. Procesando XML con SAX .......... ......................................................290 296 9.5.2. 9.5.2. Procesando XML con DOM ...............................................................296 9.6. 301 9.6. Bases de datos ................. .... ......................................... ........... .. .............301 9.6.1. rawQuery() ...... .................. ........................ .. ..304 304 9.6,1. Los métodos query() y rawQueryQ 305 9.7. 9.7. Utilizando la clase ContentProvider ............... ...... ...................................305 9.7.1. Conceptos básicos .............. .. .. .................... ......................................306 306 9. 7.1.1. El modelo de datos ...........................................................................306 306 9.7.1.1. 9. 7. 1.2. LasURI Las URJ ............................................................................................306 306 9.7.1.2.

9.7.2. 307 9.7.2, Acceder a la información de un ContentProvider .............. ................307 9. 7.2.1. Leer información de un ContentProvider .........................................308 308 9.7.2.1.

12 12

9.7.2.2. Escribir información en un ContentProvider ...................................311 9.7.2.2. 311 9.7.2.3. 9. 7.2.3. Borrar y y modificar elementos de un ContentProvider .....................312 312 9.7.3. 312 9.7.3. Creación de un ContentProvider .......................................................312

9.7.3.1. 9. 7.3.1. Definir la estructura de almacenamiento del ContentProvider .......313 313 9.7.3.2. 9. 7.3.2. Extendiendo la clase ContentProvider .............................................314 314 9.7.3.3. 9. 7.3.3. Declarar el ContentProvider en AndroidManifest.xml ....................318 318 9.7.4. Acceso a PuntuacionesProvider desde Asteroides Asteroides ... ........................319 319

CAPÍTULO 10. Internet: sockets, HTTP y servicios servicios web web ............. ................321 321 10.1. Comunicaciones en Internet mediante sockets .... ..................................322 322

10.1.1. 1 0.1 .1. La arquitectura cliente/servidor ........................................................322 322 10.1.2. 322 10.1.2. ¿Qué es un socket? ..........................................................................322

10.1.2.1. Sockets stream (TCP) .....................................................................323 323 10.1.2.2. Sockets datagram (UDP) ...............................................................323 323

10.1.3. Un ejemplo de un cliente 1 / servidor de ECHO ECH0 ... .... .. ........ .................324 324 puntuaciones ................................326 326 110.1.4. 0.1.4. Un servidor por sockets para las puntuaciones 330 110.2. 0.2. La web y el protocolo HTTP ....................................................................330

10.2.1. 1 0.2.1. El protocolo HTTP ................... ................ ................ ........ ......... ........330 330 10.2.2. Versión 1.0 del protocolo HTTP ......................... ..............................332 332 10.2.2. 334 10.2.3. Utilizando HTTP desde Android .................................................. ... ..334

10.3. Servicios web ............................. ..... ............................................. .. .........339 10.3. 339 10.3.1. Alternativas en los servicios web ................... .............. ................... ..339 339 10.3.1.1. 10.3.1. 1. Servicios web basados en SOAP ....................................................340 340 REST.. ...................................................341 341 10.3.1.2. Servicios web basados en REST.

10.3.2. Acceso a servicios web de terceros ............................................ .....345 10.3.2. 345 10.3.3. Diseño e implantación de nuestro servicio web ... ....... .. ...... .............349 349

10.3.3.1. Instalación del servidor de servicios web ......................................349 349 351 10.3.3.2. Creación un servicio web en Eclipse .............................................35! 10.3.3.3. Explorando el servicio web desde Eclipse .....................................354 354 10.3.3.4. Explorando el servicio web desde HTML ......................................358 358 10.3.3.5. Utilizando el servicio web desde Asteroides ..................................360 360

13

CAPÍTULO 11. Publicar Aplicaciones ........................................................... 365 365 11 .1. Preparar y testear tu aplicación ..............................................................366 11.1. 366 11 .1.1. Preparar la aplicación para distintos tipos de dispositivo 366 11.1.1. dispositivo ................. 366 11.1.2. Testear la aplicación .......................... ............................................ ... 368 368 11 .2. Crear un certificado digital y firmar la 11.2. la aplicación .................................... 370 370 11 .3. Publicar la aplicación ............................................................................... 372 11.3. Publicarla 372 11 .3.1. Publicar en lnternet... 11.3.1. Publicaren Internet ........................................................................ 372 372 11 .3.2. Publicar en Google Play Store ......................................................... 373 11.3.2. Publicaren 373 11 .4. Asteroides: 11.4. Asteroides: detectar victoria y derrota .....................................................377 377

ANEXO A. Referencia Java .............................................................................. 379 379 ANEXO B. Referencia: la clase View y sus descendientes ........... ............ ...... .391

14

Lista Lista de de acrónimos acrónimos AIDL API AVD DOM OTO DTD FTP GPS HTTP lOE IDE JDK JRE JSON JVM MIME NDK NOK OpenGL PCM RAM REST RPC SAX SDK SMS SOA SOAP SQL TCP Ul ül URL

Android Interface tnterface Definition Language

Application Programming Interface Android Virtual Device Modelo de Objetos del Documento Document Type Definition File Transfer Protocol Global Positioning System Hypertext Transfer Protocol lntegrated Integrated Development Environment Java Development Kit Java Runtime Environment JavaScript Object Notation Java Virtual Machine Multipurpose Internet Mail Extensions Native Development Kit Open Graphic Library Pulse-Code Modulation Random Access Memory REpresentational State Transfer

Calis Remote Procedure Cal/s Simple API forXML for XML Software Developers Kit Short Message Service Service-Oriented Architecture Simple Object Access Protocol Structured Query Language Transmission Control Protocol User Interface Universal Resource Locator

15

16

URI

Uniform Resource ldentifier Identifier

USB

Universal Serial Bus

W3C

Worfd World Wide Web Consortium

WSDL

Web Services Oescription Descrlption Language

WWW www

World Wide Web Worfd

XML

Extensible Markup Language

¿Cómo este libro? libro? ¿Cómo leer leer este Este libro quiere ser una una guía guía para para aquellos aquellos lectores lectores que que pretendan pretendan introducirse introducirseen en la programación de Android. Android. Se Se ha ha estructurado estructurado en en 11 11 capítulos capítulos que que abordan abordan aspectos específicos especificas del del desarrollo desarrollo de de aplicaciones. aplicaciones. Resulta Resulta conveniente conveniente realizar realizar una lectura secuencial de de estos estos capítulos, capítulos, dado dado que que muchos muchos de de los los conceptos conceptos que que se abordan serán compredidos compredidos mejor mejor sisi hemos hemos leído leído los los capítulos capítulos anteriores. anteriores. Además, a lo largo del del libro libro se se desarrolla desarrolla una una aplicación aplicación de de ejemplo, ejemplo, elel mítico mítico juego Asteroides. Para que que muchos muchos de de los los ejercicios ejercicios funcionen funcionen correctamente correctamente resulta imprescindible realizar realizar los los anteriores. anteriores. El libro que tienes entre entre las las manos manos no no ha ha sido sido concebido concebido solo solo para para ser ser leído. leído. Es Es más bien una guía guía estructurada estructurada que que te te irá irá proponiendo proponiendo una una serie serie de de ejercicios, ejercicios, actividades, videos explicativos, explicativos, test test de de auto auto evaluación,... evaluación,... Todo Todo este este material material yy muchos más recursos adicionales adicionales están están disponibles disponibles en en lala Web Web recursos www.androidcurso.com. En www.androidcurso.com. En ella ella se se publicarán publicarán las las novedades, novedades, erratas erratas ee información información para complementaria relativas aa este este libro. libro. Por Por lo lo tanto, tanto, resulta resulta imprescindible imprescindible para sacarle partido aa este libro libro un un ordenador ordenador con con el el SDK SDK de de Android Android instalado instaladopara parahacer hacer los ejercicios yy acceso aa Internet Internet para para el el material material en en línea. línea. A lo largo largo del libro se utilizan utilizan los los siguientes siguientes iconos iconos para para indicar indicar los los tipos tipos de de actividades: actividades:

~Objetivos:

Antes de de empezar empezar cada cada capítulo capi;uto lee Objetivos: Antes lee con con detenimiento detenimiento lala introducción y los objetivos. objetivos.

m Poli[Media] : Más Poli[Media]: Más de de 50 50 videos videos grabados grabados por por el el autor autor del del libro libro donde se exponen de forma forma didáctica didáctica los los aspectos aspectos clave clave del del sistema sistema Android. Android. Se Se utiliza una moderna herramienta herramienta desarrollada desarrollada en en la la Universidad Universidad Politécnica Politécnica de de Valencia que te permitirá permitirá ver ver simultáneamente simultáneamente las las presentaciones presentaciones yy alal profesor profesor mientras se desarrollan los los conceptos conceptos de de cada cada capítulo. capítulo.

Ejercicio paso a paso: La La mejor mejor forma forma de de aprender aprender es es haciendo. haciendo. No No tendrás más que irir siguiendo siguiendo los los pasos pasos uno uno tras tras otro otro para para descubrir descubrir como como se se resuelve el ejercicio ejercicio propuesto. propuesto. Para Para que que no no se se ta ta haga haga pesado pesado teclear teclear todo todo elel código, te proponemos que que lo lo copies copies yy peges peges desde desde la la página página Web Web del del curso. curso.

17

$

0

Práctica: Este * Este será será el el momento momento de de que que tomes tomes lala iniciativa iniciativa yy trates trates de de se propone. propone. Recuerda Recuerd a que que para para aprender aprenderhay hayque quepracticar. practicar. resolver el problema que se

j: "ffii Solución: Solución: Te será de de ayuda ayuda si si tienes tienes problemas problemas alal resolver resolver una una práctica, o simplemente quieres quieres comparar comparar tu tu solución solución con con otra otra diferente. diferente.

i)

<;"'";;(~ Nota sobre Java: Si Si no no dominas dominas el el lenguaje lenguaje de de programación programación Java Java no no tendrás problema en seguir el el libro. libro. Cada Cada vez vez que que aparezca aparezca algún algún concepto concepto complejo sobre Java, trataremos trataremos de de aclararlo. aclararlo.

T Recursos adicionales: Te Te proporcionamos proporcionamos lala información información clave clave que que te ayudará en el desarrollo desarrollo de de tus tus aplicaciones. aplicaciones.

@;Enlaces Enlaces de interés: Internet Internet te te será será de de gran gran ayuda ayuda para para complelar completar lala información necesaria para ndroid. Te para programar programar en en AAndroid. Te proponemos proponemos las las páginas páginas más interesantes de cada cada apartado. apartado.

Preguntas de repaso yy reflexión: reflexión: ¿Has ¿Has comprendido comprendido correctamencorrectamente los aspectos claves? Sal Sal de de dudas dudas haciendo haciendo los los test test de de autoevaluación. autoevaluación.

« Referencias rápidas: Utiliza Utiliza los los anexos anexos para para localizar localizar rápidamente rápidamente esa palabra clave o clase clase que que no no recuerdas. recuerdas.

18

De forma adicional, en la Web www.androidcurso.com encontrarás: •

Tutoriales sobre Java: ¿Sabes lo que es la herencia, el el polimorfismo oo la la sobrecarga en Java? Si no dominas el lenguaje de programación Java Java te te recomendamos realizar alguno de los tutoriales propuestos.

•

Código abierto de proyectos Android: Muchos Muchos alumnos alumnos que que han han realizado un curso basado en este libro han tenido la la generosidad generosidad de de recomendamos que que compartir sus proyectos con todos nosotros. Te recomendamos consultes la lista de proyectos disponibles de código abierto, puedes puedes aprender mucho estudiando su código. Cuando termines de leer leer este este libro, también tu podrás hacer un proyecto como los que se muestran.

•

Material adicional sobre Android: Encontrarás Encontrarás además nuevos nuevos Poli medias, referencias, ... no incluidos en el Libro. tutoriales, Polimedias, referencias,...

•

Foros: Puedes comunicarte con otras personas y consultar cualquier cualquier duda que se te plante en un apartado o ejercicios del libro.

•

Cursos online: Si te interesa ampliar tu formación puedes puedes matricularte matricularte en en cursos sobre Android impartidos por la Universidad Politécnica de Valencia.

19

CAPÍTULO CAPÍTULO l. 1. Visión y entorno Visión general general y entorno de de desarrollo desarrollo

La telefonía móvil está cambiando la sociedad actual de una forma tan significativa como lo ha hecho Internet. Esta revolución no ha hecho más que empezar, empezar, los nuevos terminales ofrecen unas capacidades similares a las de un ordenador personal, lo que permite que puedan ser utilizados para leer nuestro correo o navegar por Internet. Pero a diferencia de un ordenador, un teléfono móvil siempre está en el bolsillo del usuario. usuario. Esto permite un nuevo abanico de aplicaciones mucho más cercanas al usuario. usuario. De hecho, hecho, muchos autores coinciden en que el nuevo ordenador personal del siglo veintiuno será un terminal móvil. El lanzamiento de Android como nueva plataforma para el desarrollo de aplicaciones móviles ha causado una gran expectación y está teniendo una importante aceptación, tanto por los usuarios como por la industria. En la actualidad se está convirtiendo en la alternativa estándar frente a otras plataformas como iPhone, ¡Phone, Windows Phone o BlackBerry. BlackBerry. A lo largo de este capítulo veremos las características de Android que lo hacen competidores. Se explicará también cómo instalar y trabajar con diferente de sus competidores. el entorno de desarrollo (Eclipse+ SDK). (Eclipse + Android SDK).

~Objetivos:

• Objetivos:

•

Android, destacando los aspectos que lo Conocer las características de Android, hacen diferente de sus competidores.

•

Estudiar la arquitectura interna de Android.

• Aprender a instalar y trabajar con el entorno de desarrollo (Eclipse + Android SDK). SDK). •

Enumerar las principales versiones de Android y aprender a elegir la más idónea para desarrollar nuestras aplicaciones. aplicaciones.

21 21

El gran libro de Android • Crear una primera aplicación y estudiar la estructura de un proyecto en Android. Android. • Conocer donde podemos conseguir documentación sobre Android. Android. • Aprender a utilizar las herramientas disponibles para delectar detectar errores en el código. código.

1.1. que Android ea especial? 1.1. ¿Qué ¿Qué hace hace que Android sea especial? Como hemos comentado, comentado, existen muchas plataformas para móviles (iPhone, (iPhone, Symbian, Symbian, Windows Phone, Phone, BlackBerry, BlackBerry, Palm, Palm, Java Mobile Edition, Edition, Linux Mobile Moblle (LiMo), (LiMo), etc.); etc.); sin embargo Android presenta una serie de características que lo combina, en una misma solución, hacen diferente. diferente. Es el primero que combina, solución, las siguientes cualidades: cualidades: • Plataforma realmente abierta. Es una plataforma de desarrollo libre abierto. Una de sus grandes ventajas es basada en Linux y de código abierto. que se puede usar y "customizar" el sistema sin pagar royalties. royalties. • Portabilidad asegurada. Las aplicaciones finales son desarrolladas en Java, Java, lo que nos asegura que podrán ser ejecutadas en una gran variedad de dispositivos, dispositivos, tanto presentes como futuros. futuros. Esto se consigue gracias al concepto de máquina virtual. • Arquitectura basada en compor compo entes inspirados en Internet. Por XML, lo que ejemplo, ejemplo, el diseño de la interfaz de usuario se hace en XML, permite que una misma aplicación se ejecute en un móvil de pantalla reducida o en un netbook. netbook. • Filosofía de dispositivo siempre conectado a Internet. • Gran cantidad de servicios incorporados. Por ejemplo, ejemplo, localización redes, bases de datos con SQL, SQL, basada tanto en GPS como en redes, voz, navegador, navegador, multimedia, multimedia, etc. reconocimiento y síntesis de voz, etc. • Aceptable nivel de seguridad. Los programas se encuentran aislados unos de otros gracias al concepto de ejecución dentro de una caja que hereda de Linux. Linux. Además, Además, cada aplicación dispone de una serie de permisos que limitan su rango de actuación (servicios de localización, localización, acceso a Internet, Internet, etc.). etc.). • Optimizado para baja potencia y poca memoria. Por ejemplo, ejemplo, Android utiliza la Máquina Virtual Dalvik. Dalvik. Se trata de una implementación de Google de la máquina virtual de Java optimizada para dispositivos móviles. móviles. • Alta calidad de gráficos y sonido. Gráficos vectoriales suavizados, suavizados, animaciones inspiradas en Flash, Flash, gráficos en 3 dimensiones basados en OpenGL. Incorpora los codees estándar más comunes de audio y vídeo, vídeo, AAC, etc. incluyendo H.264 (AVC), MP3, MP3, AAC, etc.

22

Visión general yy entorno de desarrollo Como hemos visto, visto, Android combina características muy muy interesantes. interesantes. No No obstante, estándar de de obstante, la pregunta del millón es, ¿se convertirá Android en el estándar (S.O.) esta pregunta pregunta habrá habrá que que sistema operativo (S O.) para móviles? Para contestar aa esta de Apple yy cuál es es la la respuesta esperar un tiempo para ver la evolución del iPhone de S.O. para móviles. móviles. de Windows con el lanzamiento de su nuevo S.O. En conclusión, conclusión, Android nos ofrece una forma sencilla sencilla y novedosa novedosa de de lo largo de de este este texto texto implementar potentes aplicaciones para móviles. móviles. A lo trataremos de mostrar de la forma más sencilla para conseguirlo. conseguirlo.

1.2. Los orígenes orígenes 1.2. Los Google adquiere Android Inc. lnc. en el año 2005. 2005. Se trataba de una pequeña pequeña compañía que acababa de ser creada, creada, orientada a la la producción de aplicaciones la creación creación de de para terminales móviles. móviles. Ese mismo año empiezan aa trabajar en la una máquina virtual Java optimizada para móviles (Dalvik VM). VM). En el año 2007 se crea el consorcio Handset Alliance11 con el el objetivo objetivo de desarrollar estándares abiertos para móviles. móviles. Está formado por Google, Google, Intel, lntel, Texas Instruments, lnstruments, Motorola, T-Mobile, T-Mobile, Samsung, Samsung, Ericsson, Ericsson, Toshiba, Toshiba, Vodafone, Vodafone, NTT DoCoMo, otros. Una pieza clave de de los objetivos objetivos de de esta DoCoMo, Sprint Nextel y otros. alianza es promover el diseño y difusión de la plataforma Android. Android. Sus miembros miembros se han comprometido a publicar una parte importante de de su propiedad intelectual intelectual como código abierto bajo la licencia Apache v2.0. v2.0. del Android SDK. SDK. Al año En noviembre del 2007 se lanza una primera versión del octubre, Google Google siguiente aparece el primer móvil con Android (T-Mobile G1). G1). En octubre, licencia de código código abierto libera el código fuente de Android, principalmente bajo licencia núcleo). Ese mismo mes, mes, se abre Android Market Market Apache (licencia GPL v2 para el núcleo). aplicaciones. En abril del 2009, Google lanza la versión para la descarga de aplicaciones. versión 1.5 1.5 del SDK que incorpora nuevas característica como el teclado en en pantalla. pantalla. A finales finales del 2009 se lanza la versión 2.0 2.0 y durante el 2010 201 O las las versiones 2.1, 2.1, 2.2 2.2 yy 2.3. 2.3. Durante el año 2010, 201 O, Android se consolida como uno uno de de los sistemas operativos para móviles más utilizados, con resultados cercanos al al iPhone, iPhone, ee EE.UU. incluso superando al sistema de Apple en EE.UU. 4.x tanto tanto para En el 2011 se lanzan la versión 3.x específica para tabletas y 4.x móviles como para tabletas. tabletas. Durante este año, año, Android se se consolida consolida como como la plataforma para móviles más importante, importante, alcanzando una una cuota de mercado mercado superior al 50%. En 2012, 2012, Google cambia su estrategia en su tienda de de descargas descargas online, remplazando Android Market por Google Play Store, Store, donde donde en un un solo portal unifica la descarga de aplicaciones como de contenidos. contenidos.

11

http://www.openhandsetalliance.com http://www openhandseíalliance com

23

_...

El gran libro de Android

--

.,,,, ... llu •

Poli[Media]: Introducción a la la plataforma plataforma para para móviles móvilesAndroid. Android. Pol¡[Media |: Introducción Preguntas de repaso repaso yy reflexión: reflexión: Características Características yy orígenes orígenes de de Android.

1.3. Comparativa con con otras otras plataformas plataformas 1.3. Comparativa En este apartado apartado vamos vamos aa describir describir las las características características de de las las principales principales Dado la la gran gran cantidad cantidad de de datos datos plataformas móviles móviles disponibles disponibles en en la la actualidad. actualidad. Dado Deesta esta que se indican, indican, hemos hemos utilizado utilizado una una tabla tabla para para representar representar la la información. información. De más sencillo sencillo comparar comparar las las distintas distintas plataformas. plataformas. forma resulta más

Poli[ Media]: Comparativa Comparativa de de las las principales principalesplataformas plataformas WtÉík Poli[MedÍaJ: para móviles. móviles. Wüz para

.•.. ~ ,í ~

Compañía Núcleo del SO Familia CPU soportada Lenguaje de programación

24

Apple MacOS X ARM Objective-C, Objective-C, C++

Android

Windows i/Vindows Phone 7 40 4.0 Open Handset Windows Alliance Windows Wndows CE Linux ARM, MIPS, ARM, MIPS, ARM Power, Power, x86 Java, Java, C++

'

. .

•

IP Apple iOS51 ¡OS 5.1

.

C#, C#, muchos

l

•. symbian symbian

BlackBerry 057 OS 7 RIM

.·

Symbian 95 9.5 Symbian Symbian Foundation Foundation

Mobile OS

Mobile OS

ARM

ARM

Java

C++

Visión general yy entorno de desarrollo

symbian Apple iOS ¡OS 51 5.1

Android 4.0 40 Software libre 6 ^^ablerto^ y abierto

Windows Phone 7

BlackBerry BlackBerry OS 7 OS7

Symbian Symbían 9.5 95

Propietaria Propietaria

Propietaria Propietaria

Software libre libre Software

Licencia de software

Propietaria

Año de lanzamiento

2007

2008

2010

2003

1997

Motor del navegadorweb vegador web

WebKit

WebKit

Pocket lnter• • net Explorer

WebKit

WebKit

Soporte Flash

No

Sí

No

Si

Sí

HTML5

Sí

Sí

Parcial

Sí

No

Tienda de aplicaciones

App Store

Google Play

Windows >118 Marketplace

BlackBerry • 1 •■'World A it 11 • App

Ovi Store

Número de aplicaciones

400.000

300.000

50.000

30.000

50.000

Coste publicar

$99 al año

$25 una una vez vez $25

$99 al al año año $99

Sin Sin coste coste

$1 $1 una una vez vez

Plataforma de desarrollo

Mac

Windows, Mac, Linux

Windows

Windows, Windows, Mac

Windows, Mac, Linux

Interfaz ersonalizable personalizable

No

Si

Sí

Sí

Sí

Sí

Depende del fabricante

Depende del fabricante

Sí

Sí

No

Sí

No

Sí

Sí

Sí

No

No

Sí

No

Modelo único

Muy alta

Baja

Baja

Muy alta

Capacitativa

Capacitiva /resistiva

Capacitativa Capacitativa

Capacitativa /resistiva

Capacitiva Capacitiva /resistiva

Sí

Sí

No

No

Sí

Actualizaciones automáticas deiS.O. delS.O. Soporte memoría moria externa Fabricante

~ctualizaciones

único Variedad de dispositivos Tipo de antalla Ilantalla Aplicaciones nativas

Tabla 1: Comparativa de las principales plataformas plataformas móviles. móviles.

Otro aspecto fundamental aa la hora hora de de comparar comparar las las plataformas plataformas móviles móviles es es su su mercado. En la siguiente cuota de mercado. siguiente gráfica gráfica podemos podemos ver ver un un estudio estudio realizado realizado por por la la empresa Gratner Group, donde donde se se muestra muestra la la evolución evolución del del mercado mercado de de los los sistemas operativos para para móviles móviles según según el el número número de de terminales terminales vendidos. vendidos. Podemos destacar: destacar: el importante importante descenso descenso de de ventas ventas de de la la plataforma plataforma Symbian Symbian de de Nokia; de BlackBerry; BlackBerry; como como la la plataforma plataforma de Nokia; el declive continuo de de Windows Windows parece parece que no despega; despega; como Apple tiene tiene afianzada afianzada una una cuota cuota de de mercado mercado yy ha ha

25

El gran libro de Android un importante importante repunte repunte aa finales finales del del 2011 2011.. Finalmente, Finalmente, destacamos destacamos experimentado un el espectacular ascenso ascenso de de la la plataforma plataforma Android, Android, que que lele ha ha permitido permitidoalcanzar alcanzaren en dos años una cuota de de mercado mercado superior superior alal 50%. 50%. 60%

· -- - - - - - · - - --- - - - - - - -- - - - - -

50% 40% 30%

-

symbian

-

Android

Apple ¡OS

~ AppleiOS

20%

-

BlackBerry BiackBerry

-

Windows Phone

10% 0%

2009 2010 2010 2010 2010 2010 2010 2011 2011 2011 2011 2011 2011 2011 2011 Q4 Q1 Q2 Q3 Q3 Q4 Q4 Q1 Q1 Q2 Q2 Q3 Q3 Q4 Q4 Figura 1: Cuota de de mercado mercado de de los los sistemas sistemas operativos operativospara paramóviles móviles hasta el 2011 en el el mundo mundo (fuente: (fuente: Gratner GratnerGroup). Group).

Se han realizado otros tipos tipos de de estudios estudios que que miden miden lala actividad actividadde delos losusuarios usuarios en Internet. En En estos casos casos se se comprueba comprueba como como los los usuarios usuariosde deAndroide Android eiPhone ¡Phone son los más activos, mientras mientras que que los los usuarios usuarios con con otras otras plataformas, plataformas, como como Symbian, utilizan sus sus terminales terminales de de forma forma más más convencional. convencional.

Preguntas Prequntas de repaso y reflexión : Plataformas para móviles.

1.4. 1.4. Arquitectura Arquitectura de de Android Android El siguiente gráfico muestra muestra la la arquitectura arquitectura de de Android. Android. Como Como se se puede puedever, ver, está está formada por cuatro capas. capas. Una Una de de las las características características más más importantes importantes es es que que todas las capas están están basadas basadas en en software software libre. libre.

26

Visión general y entorno de de desarrollo desarrollo Aplicaciones

Entorno de aplicación

I Manejador de recursos I Manejador de actividades

Sistema de vistas Manejador notificaciones

Content Froviders Librerías nativas

Sistem C

OpenCORE

Surface manager

V.ebKH

SGL

OpenGL ES

FteeType

SQLite

SSL

Manejador de ventanas Runtime de Android

Maquina virtual Datvik Core Líbraries

Núcleo Linux

Figura 2: Arquitectura de de Android. Android.

1.4.1. El núcleo Linux Linux está formado formado por por el el sistema sistema operativo operativo Linux, Linux, versión versión 2.6. 2.6. El núcleo de Android está servicios como como la la seguridad, seguridad, elel manejo manejo de de lala memoria, memoria, elel Esta capa proporciona servicios multiproceso, la pila pila de protocolos protocolos yy el el soporte soporte de de drivers driverspara para dispositivos. dispositivos. actúa como como capa capa de de abstracción abstracción entre entre elel hardware hardwareyy elel Esta capa del modelo actúa Por lo lo tanto, tanto, es es la la única única que que es es dependiente dependientedel del hardware. hardware. resto de la pila. Por Runíf/ne de Android Android 1.4.2. Runtime el concepto concepto de de máquina máquina virtual virtual utilizado utilizado en en Java. Java. Dado Dado las las Está basado en el los dispositivos dispositivos donde donde ha ha de de ejecutarse ejecutarse Android Android (poca (poca memoria memoriayy limitaciones de los no fue fue posible posible utilizar utilizar una una máquina máquina virtual virtual Java Java estándar. estándar. procesador limitado) no decisión de de crear crear una una nueva, nueva, lala máquina máquina virtual virtual Dalvik, Dalvik, que que Google tomó la decisión respondiera mejor a estas estas limitaciones. limitaciones. de la la máquina máquina virtual virtual Dalvik Dalvik que que facilitan facilitan esta esta Algunas características de recursos son: son: que que ejecuta ejecuta ficheros ficheros Dalvik Dalvik ejecutables ejecutables(.dex) (.dex)(formato (formato optimización de recursos ahorrar memoria). memoria). Además, Además, está está basada basada en en registros. registros. Cada Cada optimizado para ahorrar su propio propio proceso proceso Linux Linux con con su su propia propia instancia instancia de de lala máquina máquina aplicación corre en su al kernel kernel de de Linux Linux algunas algunas funciones funciones como como threading threading yy elel virtual Dalvik. Delega al manejo de la memoria a bajo bajo nivel. nivel. También se incluye en el el Runtine Runtine de de Android Android el el "core "core libraries" libraries" con con lalamayoría mayoría de las librerías disponibles disponibles en en el el lenguaje lenguaje Java. Java.

27

El gran libro de Android

1.4.3. Librerías nativas Incluye un conjunto de librerías en C/C++ usadas en varios componentes de Android. Están compiladas en el código nativo del procesador. Muchas de las librerías utilizan proyectos de código abierto. Algunas de estas librerías son: son: •

System e library: una derivación de la librería BSD de e C library: C estándar (libe), adaptada para dispositivos embebidos basados en Linux.

•

Media Framework: librería basada en PacketVideo's OpenCORE; soporta codees de reproducción y grabación de multitud de formatos de audio, vídeo e imágenes MPEG4, H.264, H.264, MP3, MP3, AAC, AMR, JPG y PNG. PNG.

•

Surface Manager: Manager: maneja el acceso al subsistema de representación gráfica en 2D y 3D.

•

WebKit: soporta un moderno navegador web utilizado en el navegador Android y en la vista webview. webview. Se trata de la misma librería que utiliza Google Chrome y Safari de Apple.

•

SGL: motor de gráficos 2D. 2D.

• Librerías 30: 3D: implementación basada en OpenGL ES 1.0 API. Las librerías utilizan el acelerador hardware 3D si está disponible, disponible, o el software altamente optimizado de proyección 3D. 3D. •

FreeType: fuentes en bitmap y renderizado vectorial.

•

SQLite: SQLite potente y ligero motor de bases de datos relacionales relaciónales disponible para todas las aplicaciones. aplicaciones.

•

SSL: proporciona servicios de encriptación Secure Socket Layer. Layer.

1.4.4. Entorno de aplicación Proporciona una plataforma de desarrollo libre para aplicaciones con gran riqueza e innovaciones (sensores, localización, localización, servicios, barra de notificaciones, etc.). Esta capa ha sido diseñada para simplificar la reutilización de componentes. Las aplicaciones pueden publicar sus capacidades y otras pueden hacer uso de ellas (sujetas a las restricciones de seguridad). seguridad). Este mismo mecanismo permite a los usuarios remplazar componentes. componentes. Una de las mayores fortalezas del entorno de aplicación de Android es que se aprovecha el lenguaje de programación Java. El SDK de Android no acaba de ofrecer todo lo disponible para su estándar del entorno de ejecución Java (JRE), (JRE), pero es compatible con una fracción muy significativa de la misma. Los servicios más importantes que incluye son: son:

28

•

Views: componentes). Views: extenso conjunto de vistas (parte visual de los componentes).

•

Resource Manager: Manager: proporciona acceso a recursos que no son en el código. código.

Visión general yy entorno de de desarrollo desarrollo • Activity Manager: Manager: maneja maneja el el ciclo ciclo de de vida vida de de las las aplicaciones aplicaciones yy proporciona un sistema sistema de de navegación navegación entre entre ellas. ellas. •

Notification Manager: Manager: permite permite aa las las aplicaciones aplicaciones mostrar mostrar alertas alertas persopersoNotification nalizadas en la barra barra de de estado. estado.

• Content Providers: Providers: mecanismo mecanismo sencillo sencillo para para acceder acceder aa datos datos de de otras otras aplicaciones (como los contactos). contactos).

1.4.5. Aplicaciones Aplicaciones Este nivel está formado por por el el conjunto conjunto de de aplicaciones aplicaciones instaladas instaladas en en una una máquina máquina Android. las aplicaciones aplicaciones han han de de ser ser ejecutadas ejecutadas en en lala máquina máquinavirtual virtual Dalvik Dalvik Android. Todas las para garantizar la la seguridad seguridad del del sistema. sistema. Normalmente, las aplicaciones aplicaciones Android Android están están escritas escritas en en Java. Java. Para Para desarrollar aplicaciones aplicaciones en en Java Java podemos podemos utilizar utilizar el el Android Android SDK. SDK. Existe Existe otra otra opción consistente en desarrollar desarrollar las las aplicaciones aplicaciones utilizando utilizando C/C++. C/C++. Para Para esta esta el Android Android NDK NDK (Native (Native Development DevelopmentKit). Kit). opción podemos utilizar utilizar el

Ü

Poli[Media]: La arquitectura arquitectura de de Android. Android. Poli Medía : La

Preguntas de repaso yy reflexión: reflexión: La La arquitectura arquitectura de de Android. Android.

e

Enlaces de interés: Android, Android, /OS, iOS, tiempos tiempos de de respuestas respuestas yy por por de interés: qué nada es gratis en en sistemas sistemas informáticos. informáticos. (Ricardo (Ricardo Galli). Galli). Interesante artículo artículo que que explica explica varios varios aspectos aspectos relacionados relacionados sobre sobre elel funcionamiento interno interno del del sistema sistema operativo operativo Android: Android: http://gallir. wordpress. com/20 11 /12/0 7/android-ios-tiempos-de-respuestashttp://qallir.wordpress.com/2011/12/07/android-ios-tiempos-de-resDuestasy-por -q ue-nada-es-g ratis-en-sistemas-i nformaticos/ v-por-que-nada-es-qratis-en-sistemas-informaticos/

1.5. Instalación Instalación del 1.5. del entorno entorno de de desarrollo desarrollo Para el desarrollo de las las aplicaciones aplicaciones vamos vamos aa poder poder utilizar utilizar un un potente potenteyymoderno moderno entorno de desarrollo. desarrollo. Al igual igual que que Android, Android, todas todas las las herramientas herramientas están están basadas basadas en software libre. libre. Aunque Aunque existen existen varias varias alternativas alternativas para para desarrollar desarrollar aplicaciones aplicaciones texto se se supondrá supondrá que que estamos estamos trabajando trabajando con con elel software software en Android. Android. En este texto enumerado aa continuación; continuación: • Java Runtime Environment Environment 5,0 5.0 oo superior. superior. •

IDE for for Java Java Developers). Developers). Eclipse (Eclipse IDE

29

El gran libro de Android • Android SDK (Google). (Google). •

Eclipse Plug-in (Android Development Toolkit- ADT). ADT).

Describiremos, continuación, el proceso a seguir para instalar el software Describiremos, a continuación, anterior. desarrollo. La anterior. Te proponemos dos alternativas para instalar el entorno de desarrollo. separado, la segunda es instalar primera es instalar cada componente por separado, MOTODEV Studio que incorpora todos estos componentes y alguna herramienta adicional.

1.5.1. Instalación de los componentes por separado Si ya tienes instalado Eclipse en tu ordenador puedes completar la instalación Plug-in. De esta forma mantendrás tu añadiendo Android SDK y Eclipse Plug-in. configuración actual y simplemente añadirás nuevas funcionalidades. funcionalidades. Si no es tu caso te recomendamos pasar al siguiente apartado e instalar MOTODEV Studio. Studio.

1.5.1.1. Instalación de la máquina virtual Java Este software va a permitir ejecutar código Java en tu equipo. equipo. A la máquina virtual Java, Java Runtime Java también se la conoce como entorno de ejecución Java, Environment (JRE) o Java Virtual Machine (JVM). (JVM). Muy posiblemente ya tengas instalada la máquina virtual Java en tu equipo. equipo. Si es así puedes pasar directamente al punto siguiente. siguiente. En caso de dudas, dudas, puedes pasar también al punto siguiente. Al concluirlo te indicará si la versión de la máquina virtual Java es incorrecta. incorrecta. En caso necesario, necesario, regresa a este punto para adecuada. instalar la versión adecuada. Para instalar la máquina virtual Java accede a httD.//iava http://java.com/es com/es /download/ y descarga e instala el fichero correspondiente a tu sistema operativo. operativo.

1.5.1.2. Instalación de Eclipse Eclipse resulta el entorno de desarrollo más recomendable -ecomendable para Android, Android, es libre y además es soportado por Google (ha sido utilizado por los desarrolladores de Google para crear Android). Android). La versión mínima es la 3.3.1 3.3.1..

Ejercicio paso a paso: Instalación de Eclipse. Para instalar Eclipse hay que seguir los siguientes pasos: pasos: 1.

Accede a la página http://www.eclipse.ora/downloads/ http://www.eclipse.org/downloads/ y descarga la última versión de "Eclipse IDE para desarrolladores Java". Java". Verás que se utilizados, como encuentra disponible para los sistemas operativos más utilizados, Windows, Windows, Linux y Mac OS. OS.

NOTA: en este texto hemos utilizado la versión Helios para Windows 32 bits (fichero: "ec/ipse-java-indigo-win32.zip "eclipse-java-indigo-win32.zip "). ").

30

Visión general yy entorno entorno de de desarrollo desarrollo 2.í.

software no no requiere requiere una una instalación instalación específica, específica, simplemente simplemente Este software descomprimir los los ficheros en en la la carpeta carpeta que que prefieras. prefieras. Si Si así así lolo deseas deseas un acceso acceso directo directo del del fichero fichero eclipse.exe eclipse.exe en en elel escritorio escritorio oo puedes crear un en el menú inicio. inicio.

NOTA: Si al ejecutar Eclipse te aparece aparece el elsiguiente siguiente mensaje: mensaje:

A Java Runtime Envwonment (JRE) or Java Devetopment Kit (JDK) must m u~ be b~ avarlabte availablt: rn in order ord~ to to run: run Eclipse. Eclip~. No NoJava J4vavirtual virt061machine machine wa:< found after afte.r seatchtng searchlng tbe the fottowing followinglocations: was found tocstioRS C:\PfDgram FitesXec lipsejee\jre\bin\javaw.c)íe 0\P·mgram Files\ecli:pseje.e\jre\bin\j~w. rxe javaw.exe inin your iav•w.exe your current current PATH PATH A Javil Runtim~ Eovironme:nt (JRE} or Java. Oe\fefopme:nt Kit {JOKJ

tenemos instalada instalada la la máquina máquina virtual virtualJava Java (o (o la la versión versión no noes es lala Nos indica que no tenemos adecuada). Para solucionarlo solucionarlo regresa regresa al alpunto punto anterior. anterior.

3.

Eclipse comenzará comenzará preguntándonos preguntándonos que que carpeta carpeta queremos queremos Al arrancar Eclipse En esta esta carpeta carpeta se se almacenarán almacenarán los los proyectos proyectos utilizar como workspace. En su ubicación ubicación para para Eclipse. Es Es importante importante que que conozcas conozcas su que crees en Eclipse. poder hacer copias de de seguridad seguridad de de los los proyectos. proyectos.

S*l«ct a workspace ¿ctipie itam yc-nt ftojects tn a foicei caüeá a vwrtspací. CKoose » v*c«fopscí fotder to om fot thís teísion wotitptuo: cn.UsefS^to:«M\v»rt>rt:$p4íc Uít tt«í sí the

4.

«oa do not sík <»^»o

Aparecerá una un vistazo vistazo alal una ventana ventana de de bienvenida. bienvenida. Ciérrala Ciérrala yy dele dele un entorno de desarrollo. desarrollo.

1.5.1.3. Instalar Android Android SDK SDK de de Google Google El siguiente paso va aa consistir consistir en en instalar instalarAndroid Android SDK SDK de de Google, Google.

% Ejercicio paso aa paso: paso: Instalación Instalación de de Android Android SDK. SDK. i. 1.

Accede a la siguiente siguiente página página http://developer.android.com/sdk http://developer.android.com/sdkyydescarga descargaelel fichero correspondiente correspondiente aa tu tu sistema sistema operativo. operativo.

". NOTA: En este texto hemos hemos utilizado utilizado el elfichero fichero "android-sdk_rI2-windows.zip "android-sdk_r/2-windows.zip".

31

El gran libro de Android Android 2. 2.

no requiere requiere una una instalación instalación específica, específica, simplemente simplemente Este software no descomprimir los ficheros ficheros en en la la carpeta carpeta que que prefieras. prefieras.

NOTA: En algunos alRunos sistemas sistemas tendremos tendremos problemas problemas cuando cuando la la ruta ruta donde donde se se

descomprime los ficheros ficheros contiene contiene un un espacio espacio en en blanco. blanco.

3.

programa sdk SDK Manager. rv1anage:r. Ejecuta el programa

NOTA: Es posible que te te aparezca el el siguiente siguiente error: error:

\ fetchr-s Ktps ¡//eS-sr-í. gcK^c.co»r!/^<írt»á<¡repG«fe> ifeposfát'pwi | Faé&d fefch Uftt rsasoñ;toHTTPS SSt httiK;/í<3-stó.«íso^.cam^ár<^^s>sitsifyA«pfiis:tofy.w*á, m
En tal caso, hay que forzar al al programa prowama aa utilizar utilizar el el protocolo protocolo http http en en lugar lugar del del sigue los los siguientes siguientespasos: pasos: ello sigue protocolo https. Para ello

4. 4.

•

Re.fresh Sources. Sources. Cierra la ventana Refresh

•

ventana Choose Choose Packages Packages to to Install. Insta//. Pulsa Cancel en la ventana

•

SDKand and Settings en en la la parte parte izquierda izquierda de de la la ventana ventana Android AndroidSDK Selecciona Settings A VD Manager. Manager.

•

checkbox Forcé Force https://... https:/1. .. sources sources to to be befetched fetchedusing usinghttp://... http:/1. .. Marca el checkbox

•

Apply. Pulsar Save and Apply.

•

ejecutar el elprograma p rograma SDK. SDK Manager. Manager. Cierra yy vuelve aa ejecutar

Seleccionar los paquetes paquetes aa instalar. instalar. Seleccionar

¡ y: ¿Adroid SCK PfcüftHm-tMtt, i; inVv Ovjíiinwítlífcrx* A., O.<\n:uoid2.U, fM~. •~. An»«>i4 ¿.IX APtd, 1i X X SOK ~Mf<>rm Anáoal A>1ifoi:d22. U. API APJ"3 AH? í « 50.< An4«c«JiX. AK ?. «e.. ,\Pttlt:: í vV'SI.n:~tJtfo•v·,t,n..~I(I">1U', Atvíioai }2:. /vPÍ*. re.. ( Al>ll í vv"Sm:l)Wfo:mAAih"cdl.S S0« Plitfo.--. A»á«>:d U. API 3. »„ : VV Sís.r.·>:;:(iks !UíIC$ SOS SOKAPs 13, «visión 11 .. A...

.

vSQ:tPiiUc:m~Mtc:d3l,.AP11i, s

flttf~~
¡ x~Yl•lfo::::l.f,:s.~J.O:, APIU. f

...- ~YI•rt~4n~l.J.~t.Vt1Q,

SE)i(

ft.-

~.sm:~tfo""-'~o;.Jll

lt:.

u, ~:

~

;\P~J_l J~ISI()n

Liu!'l$t Pdvlíífts D<»tHético && tkífvsc faxfatae.gAKriRte'g gfiftKPitosfSS fcv, This ivh: 4 ¿eytatitncy icí; º - A:;4««dSDK 'IDt:: Tcoli, (eviíio^ íí j &divc:Deygiptism: AiiWví for VKimtoy/S Sií«rSM«8 SMAÍ:» »í.sé¿3 5 c? 1 £k«á>4Sfc^(??Oé«í6í «-SSwtJMií ~ ·- . ·-. P~b1Jil: I:!CMt~t~tl

ArAuítí SDK Piatfí.m-too:^ (tviiií« 6 -~

kdt:.J«t~DKP~t'lm.f>l~ ~isb-16

T~ ~<.ki9(

-

A.-~4N>If

~dqlmdtnty

T<~•h,. (~~l;!

.t...'t..".í~tM·WiMIWoiS .Sit~Ht..M

SHA!:Uv..ÍIIS.VIo:"J'!.:k.~h&.a~~~.Wtf

Aparecerá una ventana ventana donde donde podremos podremos seleccionar seleccionar los los paquetes paquetes aa instalar. deseas puedes puedes instalar instalar todos todos los los paquetes paquetes (Accept (AcceptAlí)Al~ ; en en instalar. Si lo deseas

32

Visión general yy entorno de desarrollo este caso el proceso de instalación instalación puede tardar tardar más más de de una una hora. hora. Si Si no no dispones de tanto tiempo puedes seleccionar seleccionar solo solo algunos algunos paquetes, paquetes, por por ejemplo los que se muestran en la captura anterior. anterior. Más Más adelante adelante podrás podrás instalar más paquetes si necesitas necesitas otras otras plataformas plataformas de de desarrollo desarrollo uu otras máquinas virtuales. virtuales. 5.

Crea un nuevo dispositivo virtual virtual Android Android (AVD): (AVD}: un un dispositivo dispositivo virtual virtual Android te permite emular en tu ordenador ordenador cualquier cualquier tipo tipo de de dispositivos dispositivos móvil. De esta forma podrás probar probar tus aplicaciones aplicaciones en en gran gran variedad variedad de de tabletas. teléfonos y tabletas.

6.

Selecciona Virtual Devices en la parte parte izquierda izquierda de de la la ventana ventana Android Android SDK SDK andA VD Manager. Pulsa a continuación continuación el botón botón New. New. Aparecerá Aparecerá la la siguiente siguiente and AVD ventana: ventana:

Ñame MiPWrAVO MiPiwerAVD T«9«fc j AstúrQKÍ í 4 - AP} Uvy* 4 CPWm r~~~.i::?~;~?.:~~....~.-~..~~- -~~~-~~C~A&t; t~~

'f.vgd.:

@Sire t) fll<: .......................................................,

o Swtt-in;

Defautt (ti

Proptríy Vaíae V.llut: Ahiteiíttá LCD eUnitty ¿tO 1>10 Max \fM VM apptícawon Max ap~atlt!n he*,,, hu... ¿i 2:4 Prop~rt¡

Abrtu
Donde tendremos que introducir los siguientes siguientes datos: datos:

•

Ñame: Nombre Nombre que quieras Name: quieras dar dar al nuevo nuevo dispositivo dispositivo virtual. virtual.

•

Target: Versión SDK que soportará el el dispositivo. dispositivo.

•

SD Card: Podemos introducir el el tamaño tamaño de de la la tarjeta tarjeta SD SO usada usada SO en el emulador y de forma opcional indicar indicar el el fichero fichero donde donde almacenará los datos. datos. No debes excederte excederte en en la la cantidad cantidad de de memoria, ésta se reserva en el disco memoria, disco duro, duro.

•

Snapshot: Si lo seleccionas podrás podrás congelar congelar la la ejecución ejecución del del dispositivo en un determinado instante. instante. Más Más tarde tarde podrás podrás retomar la ejecución en ese ese mismo mismo instante, instante, sin sin tener tener que que esperar a que se inicie el dispositivo. dispositivo.

•

Skin: Podremos seleccionar la la resolución de de la la pantalla, pantalla, indicando indicando uno de los valores predefinidos predefinidos o una una resolución resolución personalizada. personalizada.

• Hardware: Permite definir las las características características hardware hardware del del dispositivo. si dispone dispone de de GPS, GPS, dispositivo. Podemos indicar cosas como si

33

El gran libro de Android teclado físico, físico, etc. etc. No No es es imprescindible imprescindible que que definas definas estas estas si quieres quieres probar probar un un programa programa que que características. decir, si características. Es decir, haga uso del GPS GPS no no resulta resulta imprescindible imprescindible que que en en elel AVD AVD hayas indicado que dispone dispone de de GPS. GPS. Create AVD. Una vez introducida la la configuración configuración pulsa pulsa el el botón botón CreateAVD.

7.

Arranque el dispositivo. dispositivo.

lis..t .-1lsli.t'1qAívJratfí Vutuai O*vkix Ot'<.•iu-1-foe»te¿l atC:\i}ie>'s\jtC!n**\.4n(ííokí\if*d Liit af «róting ---IO:C;,:tt':d --------AVON.smt! ; AVD Ñame TargetN«m« Ptartcwm API lewet ~tfo:tm APIL~I ,:CPU/ABI CP':'N..& • MiPitflefA- AndívkilU : VY MsPitnerA~, ÍJ&Ui 4.4 A8M (««w*»...... gj

Avaitábie packagfcs Stning? Ab«?yt

Andr~id VJ:Jt-.J~I

(:\Us:~~1.\¡tcm\·41:1'U1so-t<.I\~J

Ti!tgetN~me .~mdsoid1..6

A?.M {•~~;,

~---------·-------~ V' A Y~lid o!.r..d:1'0i~ Virtwl 0t'>&..~. ~Ú A t~abl~ Andmld Virtual Ob\c.f'~

v A valiít Ar^tttíd Vírtuat Devíce. A ftp&tabl* Anáiexá VirUial K An Anátoxj Vírttíei f «led totokted. efatis' to10see lite Vírtwl Dwce thit thatfaile:f krcd.Cíftk Clitk'D ' Dda:íl$' the«roí. ftros,

)(

AuArtdro~

Otv~(e

$U

Una vez creado el el emulador emulador (AVD), (AVD), podremos podremos ponerlo ponerlo en en ejecución ejecuc1on seleccionándolo de de la la lista lista yy pulsando pulsando el el botón botón Start... Start ... Aparecerá Aparecerá lala ventana Launch Options. Optíons. Pulsa Pulsa el el botón botón Launch. Launch. Puede Puede tardar tardar unos unos minutos en arrancar. arrancar.

j.*

i U s b 1 8 J ___ i¥ ó ¡A 5 io \f G H i ❖ Z ik IcTv 8

[Ai

7 ¡y j k

\t jr K \u \t

■

a !ft fiL ifiy i Í
i i>

NOTA: El emulador mostrado mostrado no no está está previsto previsto para para duplicar duplicar un un dispositivo dispositivo en en particular, sino para para tratar tratar algunas algunas de de las las características características principales. principales. Algunas Algunas características de hardware hardware no no están están disponibles disponibles en en el el emulador, emulador, por por ejemplo, ejemplo, elel multi-touch o los sensores.

34

Visión general y entorno de de desarrollo desarrollo

1.5.2. Instalación del del plug-in plug-in Android Android para para Eclipse Eclipse (ADT) (ADT) El último paso consiste consiste en en instalar instalar el el plug-in plug-in Android Android para para Eclipse, Eclipse, también tambiénconocido conocido como ADT. Este software desarrollado desarrollado por por Google, Google, instala instala una unaserie seriede decomplementos complementos en Eclipse, de forma forma que que el el entorno entorno de de desarrollo desarrollo se se adapte adapte alal desarrollo desarrollo de de aplicaciones para Android. Android. Se Se crearán crearán nuevos nuevos botones, botones, tipos tipos de de aplicación, aplicación, vistas, vistas, etc., para integrar Eclipse Eclipse con con el el Android Android SDK SDKque queacabamos acabamosde deinstalar. instalar.

P

Ejercicio paso paso aa paso: paso; Instalación Instalación del delplug-in plug-inAndroíd Androidpara para Eclipse (ADT).

Para instalar el plug-in plug-in Android Android sigue sigue los los siguientes siguientes pasos: pasos; 1.

Arranca Eclipse yy selecciona selecciona He/p>/nsta/1 Help>lnstallNew NewSoftware. Software.

2. 2,

En el cuadro cuadro de de diálogo diálogo Avai/ab/e Available Software Software que que aparece, aparece, haz haz clic clic en en Add ... En el cuadro de Add... de diálogo diálogo Add Add Site Site que que sale sale introduce introduce un un nombre nombre para el sitio remoto (por (por ejemplo, ejemplo, P/ug-in Plug-in Android) Android) en en elelcampo campoName. Ñame. En En el campo Location, introduce introduce la la siguiente siguiente URL: URL: http://dl-ssl.google .com/android/eclipse/ http://dl-ssl.google,cora/android/eclipse/

NOTA: Si tienes algún problema problema en en adquirir adquirir el elplug-in, plug-in, puedes puedes intentar intentarutilizar utilizarhttps https en el URL en vez de http. Finalmente K. Finalmente pulsa pulsa O OK.

cuadro de de diálogo diálogo Available Available Software Software debe debe aparecer aparecer Ahora en el cuadro Developer Too/s Tools en en la la lista. lista. AvaUabte Software Chíck the it«ms that you

to msts» ▼j

Worfc with; Anarotü find mcrt software bywotking yrith the

Adó,.. \ pttftrtfíces.

; typ* í-fié? text I?; í&í Tocts • W1 ~00 D«vetep«r ~·ptrToal~ l!il ít> Android Andn,¡d Dl>MS Ü ¡4? DDMS

W} ~ And«Hd Wi ^ Android Dtvdop~t Devetopment·rools Toot» H?; Android Hi~uchy Hi«r«rchy Vi~u Viewer ~ ~ Andrcld AnsjfOíd tsacns'ftw p.¡ $ Amhcicn,~·tv1ew

Soi«<{ Ai! i : Dosotea A» í

i2.y.y,vií)110D2alS2y-i3S4íI np.o.vm10628I92&- i m 21 12.0.D.y50110é>28192§Í38431 ll.O.O.v2611Jl6l81929·13843l 12J),0.v201I<»2S292$-13M51 Wl.O.vl01106281929·1J8431 126.0:...l011062819N-H801

12.Q.O.vl!lll06Ul1~~1380l

4 itwi seitoted

o...íls

; j Hifirnt•llei:l «he«dy miwlted m Show oniy (mst veritcm cf ervwUbie software D ^ Group ítems by cstegory What ~ tisurftírnMIIfdt O Show software appfit:abl~ appítíabíe t.ototafg« tsrgetBT~o.mnen.t envuonrrtent B snow oniy o~ s:oftwan @ Contad al m Contafl ai) up
f «f

Cancel

35

El gran libro de Android 3.

Selecciona los paquetes a instalar y pulsa Next. Ahora aparecen listadas las características de Android DDMS y Android Development Tools. Tools.

4.

Pulsa Next para leer y aceptar la licencia e instalar cualquier dependencia y pulsa Finish. Finish.

5.

Reinicia Eclipse.

S. 6.

Configura Eclipse para que sepa donde se ha instalado el Android SDK. SDK. Windows>Preferences... .. . y Para ello entra en las preferencias en Windows>Preferences selecciona Android del panel de la izquierda. Ahora pulsa Browse... Browse ... para selecciona el SDK Location y elige la ruta donde hayas descomprimido Android SDK. SDK. Aplica los cambios y pulsa OK. OK.

General $t> Gene»}

.. ¡~ffii(j)

Suild BuM OOMS DDMS Editcrs Editors launch launch IcgCat lcgCat UsageSt•. Usa^c Stdtsts

Ant p Ant

~

Android Preferentes SDK location.' C;\Andfotd\andro»d-sdk;-wlndows | Sfowsfc-w Mote The list of SDK Target5 beíov? h onfy reíoaded once you hit 'Apply' or 'OK'. Target Mame

Vendor

Ándfoídl.5 Andtoidl.S Andfcld LS Andtoidl.6

Android Sour
Andtoid 23.3 Android 233

t>p Help

Install/lípdate r•P !nstalVUpdate

Android3J. Android 32

p P Java p Maven t> Maven

Pletfcrm API... 3 44 10 10 13 13

15 1.5 1.6 2.33 233 3.2 32

Restorc Defauits i

p~ Mylyn Myf)
1.5.3. Instalación con MOTODEV St udio Studio MOTODEV Studio for Android es un entorno de desarrollo creado por Motorola para el desarrollo de aplicaciones Android. Android. Se basa en Eclipse y añade una serie de características adicionales. sencilla. adicionales. Es la opción de instalación más sencilla.

Recursos adicionales: Características adicionales de MOTODEV Studío Studio no incluidas en Eclipse. Instalación más sencilla: Un solo instalador y conseguirás consegwras disponer de Eclipse IDE, lOE, herramientas Java y plugins de Androi-j Android perfectamente integrados. integrados. Si ya tienes Eclipse instalado puedas puedes plugin. instalar también MOTODEV Studio como plugin.

36

Visión general y entorno de desarrollo configure~ Configure» MpMwuMj liiiiiM

Validación Validación de de la la aplicación: aplicación: Detectar Detectar yy reparar reparar condiciones condiciones inadecuadas, tales como permisos permisos que que faltan faltan yy configuraciones configuraciones con las las especificaciones especificaciones del del dispositivo. dispositivo. que están en conflicto con Fragmentos de código: Agrega código código para para resolver resolver tareas tareas frecuentes. Ejemplo: enviar SMS, mostrar un un Toast, Toast, hacer hacer vibrar vibrar el el teléfono, etc.

s···a B Q

cupcake Cupcake Gestor de bases de de datos: Permite Permite ver ver yy editar editar las las bases bases de de i ·L aplicaciones Android. Android. -Q. Load 0ac| datos SQLite para tus aplicaciones = ···.Q EJ MB200

□H avd ············ Emulador Emulador integrado integrado en en el el entorno entorno de de desarrollo: desarrollo: Prueba Prueba tus tus aplicaciones sin cambiar del entorno de de desarrollo desarrollo al al emulador emulador del del p11, GB2.3.3 ,-or, o o terminal. Video Tutoriales: MOTODEV Studio dispone dispone de de muchos muchos tutoriales tutoriales que se puede ver desde el interior del del entorno entorno de de desarrollo. desarrollo.

Traducido al castellano: Si Si tu tu ingles ingles no no es es muy muy bueno bueno puedes puedes instalar la versión en en castellano castellano

^

ñ 11

la creación de aplicaciones: aplicaciones: Crea Crea nuevos nuevos Asistentes para la NeMWkfeet proyectos y clases esenciales esenciales de de Android Android mediante mediante sencillos sencillos asistentes. 4kt*emActMt¥ as'stentes ^ ÜIL

~ Test

i

Deja que que Studio Stud/o MOTODEV MOTODEV Asistente de generación de código: Deja Java, Sólo Sólo tiene tiene que que describir describir genere parte del código repetitivo de Java. la lógica de negocio. Herramientas de diagnóstico: Utiliza las las avanzadas avanzadas herramientas herramientas de diagnóstico para detectar problemas de de memoria memoria yy probar probar las las aplicaciones antes de su distribución.

• ··... • Traducción automática de aplicaciones: Si Si quieres quieres que que tu tu idiomas, esta esta herramienta herramienta aplicación esté disponible en múltiples idiomas, te facilitará el trabajo. !tSJflá~Et'J!l'~· ~··fJ)J ··· ·. • te Transíate celjs) facilitará el trabajo.

necesitas algo algo más más de de velocidad velocidad Escribe aplicaciones nativas: Si necesitas con Native Native Development Development Kit Kit puedes escribir aplicaciones nativas con (NDK).

37

El gran libro de Androíd Android

e ~

Práctica: Studío for Android. Android. Práctica: Instalación de MOTODEV Studio

1.

(http://developer.motoAbre la página Web MOTODEV Studio for Android (http://developer.motorola. com/tools/motodevstudio/). rola.com/tools/motodevstudio/).

2.

Descarga el software adecuado según según la la versión versión de de tu tu sistema sistema operativo. operativo.

3.

Sigue las instrucciones de instalación. instalación.

Recursos adicionales: adicionales: Teclas de acceso acceso rápido rápido imprescindibles. imprescindibles. Ctri+O: no resueltas. resueltas. Ctrl+O: Añade imports de las clases no

Ctrl+F: Formatea automáticamente el código. Ctri+F: código. Ctri+Espacio: completar. Ctrl+Espacio: Auto completar.

$

Enlaces de interés: interés: • Página oficial de Eclipse: Eclipse: Podrás encontrar todas todas las las versiones versiones ee información sobre los proyectos proyectos Eclipse. Eclipse. http://www.eclipse.org/

•

Mí Interesante si si quieres quieres sacarle sacarle el el Mi primera hora con Eclipse: Interesante máximo provecho a esta herramienta, herramienta, aunque mucho mucho de de lo lo que que se se explica no resulta imprescindible para el el curso. curso. http://ubuntulife.files.wordpress.com/2008/03/intro eclipse http:l/ubuntulife.files.wordpress.com/2008/03/intro eclipse espanol.pdf espanol.pdf

•

MOTODEV Studio for Android: Puedes Puedes verificar verificar si si hay hay nuevas nuevas versiones en la página oficial y visionar visionar video-tutoriales. video-tutoriales. http://developer.motorola.com/docstools/motodevstudio/ http://developer.motorola.com/docstools/motodevstudio/

1.6. Las versiones versiones de de Android Androi yy niveles niveles de de API API 1.6. Las Antes de empezar a proyecto en Android hay hay que que elegir elegir la la versión versión del del sistema sistema para la que deseamos realizar la la aplicación aplicación. Es Es muy muy importante importante observar observar que que hay hay clases y métodos que que están disponibles a partir partir de de una una versión. versión. Si Si las las vamos vamos aa usar, mínima necesaria. necesaria. usar, hemos de conocer la versión mínima Cuando se ha lanzado una nueva plataforma plataforma siempre siempre ha ha sido sido compatible compatible con con las las versiones anteriores. anteriores. Es decir, solo se se añaden añaden nuevas nuevas funcionalidades funcionalidades y, y, en en el el caso caso

38

Visión general yy entorno entorno de de desarrollo desarrollo de modificar alguna funcionalidad, funcionalidad, no no se se elimina, elimina, se se etiquetan etiquetan como como obsoletas obsoletas pero pero se pueden continuar utilizando. utilizando. A continuación se describen describen las las plataformas plataformas lanzadas lanzadas hasta hasta lala fecha fecha con con una una breve descripción descripción de de las las novedades novedades introducidas. introducidas. Las Las plataformas plataformas se se identifican identificande de El nivel nivel de de API API tres formas alternativas: alternativas: versión, versión, nivel nivel de de API API yy nombre. nombre. El enteros comenzando comenzando desde desde 1.1. Para corresponde a números números enteros Para los los nombres nombres se se han han elegido postres en orden orden alfabético alfabético CupcaKe Gupcake (vi.5), (v1 .5), Donut Donut (vi.6), (v1.6), Éclair Éclair (v2.1), (v2.1), Ice Cream Cream (v2.4), (v2.4), etc. etc. Las Las Froyo (v2.2), Gingerbread Gingerbread (v2.3), (v2.3), Honeycomb Honeycomb (v3.0), (v3.0), Ice las letras letras AA yy B,8 , no dos primeras versiones, versiones, que que hubieran hubieran correspondido correspondido aa las no recibieron nombre.

1.6.1. Android 1.0 1.0 Nivel Nivel de de AP11 API 1 (septiembre (septiembre 2008) 2008) Primera versión de de Android. Android. Nunca Nunca se se utilizó utilizó comercialmente, comercialmente, por por lolo que que no no tiene tiene desarrollar para para esta esta plataforma. plataforma. mucho sentido desarrollar

1.6.2. Android 1.1 1.1 Nivel Nivel de de API API 22 (febrero (febrero 2009) 2009) No se añadieron apenas apenas funcionalidades, funcionalidades, simplemente simplemente se se fijaron fijaron algunos algunos errores errores queremos desarrollar desarrollar una una anterior. Es Es la la opción opción aa escoger escoger sisi queremos de la versión anterior. aplicación compatible compatible con todos todos los los dispositivos dispositivos Android. Android. No No obstante obstante apenas apenas existen usuarios con esta esta versión. versión.

1.6.3. Android 1.5 1.5 Nivel Nivel de de API API 33 (abril (abril 2009, 2009, Cupcake) Cupcake) Es la primera primera versión versión con con algún algún usuario usuario (un (un 1,3% 1,3% en en julio julio del del en novedades, incorpora incorpora la la posibilidad posibilidad de de teclado teclado en 2011). 2011). Como novedades, pantalla con predicción predicción de de texto, texto, los los terminales terminales ya ya no no tienen tienen que que ÉÉÚSItikk. tener un teclado físico, así así como como la la capacidad capacidad de de grabación grabación widgets de de avanzada de audio audio yy vídeo. vídeo. También También aparecen aparecen los los widgets escritorio y Uve live folders. Incorpora Incorpora soporte soporte para para bluetooth bluetooth estéreo, estéreo, por lo que permite permite conectarse conectarse automáticamente automáticamente aa auriculares auriculares bluetooth. Las transiciones entre bluetooth. entre ventanas ventanas se se realizan realizan mediante medianteanimaciones. animaciones.

1.6.4. Android 1.6 1.6 Nivel Nivel de de API API 44 (diciembre (diciembre 2009, 2009, Donut) Donut) Permite capacidades capacidades de de búsqueda búsqueda avanzada avanzada en en todo todo elel gestures yy multi-touch. multi-touch. Permite Permite dispositivo. También incorpora incorpora gestures dispositivo. También J la síntesis de texto aa voz. voz. También También facilita facilita que que una una aplicación aplicación pueda trabajar con diferentes diferentes densidades densidades de de pantalla. pantalla. Soporte Soporte 4 un nuevo nuevo atributo atributo X"' para resolución de pantallas pantallas WVGA. 'NVGA. Aparece Aparece un XML, onClick, que puede \ XML, puede especificarse especificarse en en una una vista. vista. Se Se mejora Play Store, antes antes Android Android Market, Market, permitiendo permitiendo una una búsqueda más sencilla de de aplicaciones. aplicaciones. Soporte Soporte para para CDMA/EVDO, CDMNEVDO, 802.1x 802.1x yy VPNs. Mejoras en la aplicación aplicación de de la la cámara. cámara. VPNs.

39

El gran libro de Android

1.6.5. 2.0 Nivel Nivel de de API API 55 (octubre (octubre 2009, 2009, Éclair) Éclair) 1.6.5. Android 2.0 Esta versión de API apenas cuenta cuenta con con usuarios, usuarios, dado dado que que la mayoría de fabricantes pasaron pasaron directamente directamente de de lala versión 1.6 a la 22.1. novedades cabría cabría destacar destacar que que 1. Como novedades para manejar manejar bluetooth bluetooth 2.1 2.1 . Nueva Nueva incorpora un API para funcionalidad que permite permite sincronizar sincronizar adaptadores adaptadores para para íi Ofrece un conectarlo a cualquier cualquier dispositivo. dispositivo. Ofrece un servicio servicio Vv ■ ■■■ i'--r la gestión gestión de de contactos contactos yy ofrece ofrece más más centralizado de manejo manejo de cuentas. cuentas. Mejora Mejora la Se optimiza optimiza la la velocidad velocidad de de hardware. hardware. Se Se aumenta aumenta elel número número ajustes en la cámara. Se del navegador navegador yy de tamaños de ventana yy resoluciones resoluciones soportadas. soportadas. Nueva Nueva interfaz interfaz del soporte para HTML5. HTML5. Mejoras Mejoras en en el el calendario calendario yy soporte soporte para para Microsoft Microsoft Exchange. Exchange. La clase MotionEvent MotionEvent: ahora soporta soporta eventos eventos en en pantallas pantallas multitáctil. multitáctil.

1.6.6. 2.1 Nivel Nivel de de API API 77 (enero (enero 2010, 201 O, Éclair) Éclair) 1.6.6. Android 2.1 Se considera una actualización actualización menor, menor, por por lo lo que que le le siguieron siguieron llamando llamando Éclair. Éclair. Destacamos el reconocimiento de de voz voz que que permite permite introducir introducir un un campo campo de de texto texto teclado. También También permite permite desarrollar desarrollar fondos fondos de de pantalla pantalla sin necesidad de utilizar utilizar el teclado. animados. información sobre sobre la la señal señal de de lala red red actual actual que que animados. Se puede obtener información posea el dispositivo. dispositivo. En el el paquete paquete WebKit WebKit se se incluyen incluyen nuevos nuevos métodos métodos para para en Web. Web. También También se se permite permite obtener obtener datbs almacenadas almacenadas en manipular bases de de datos en WebView. WebView. Incorpora Incorpora mecanismos mecanismos permisos de geolocalización geolocalización yy modificarlos modificarlos en para administrar la la configuración configuración de de la la caché caché de de aplicaciones, aplicaciones, almacenamiento almacenamiento la resolución de de la la pantalla. pantalla. También web y modificar la También se se puede puede manejar manejar vídeo, vídeo, historial de navegación, navegación, vistas personalizadas, personalizadas, etc. etc.

1.6.7. Android 2.2 2.2 Nivel Nivel de de API API 88 (mayo (mayo 2010, 2010, Froyo) Froyo) Como característica más destacada destacada se se puede puede indicar indicar la la mejora de velocidad de de ejecución ejecución de de las las aplicaciones aplicaciones la CPU CPU de de 22 aa 55 veces veces más más rápido rápido (ejecución del código de la de acuerdo acuerdo aa varios varios benchmarks). benchmarks) . Esto Esto que en la versión 2.1 de introducción de de un se consigue con la introducción un nuevo nuevo compilador compilador JIT JIT de la máquina Dalvik. Dalvik.

^

jÉSl

Se añaden varias mejoras mejoras relacionadas relacionadas con con el el soporte de de Adobe Adobe Flash Flash 10.1 10.1 yy la la navegador Web, Web, como el soporte incorporación del motor motor Javascript Javascript V8 V8 utilizado utilizado en en Chrome, Chrome, oo la la incorporación incorporación del del campo de "subir fichero" en un un formulario. formulario. El desarrollo de aplicaciones aplicaciones permite permite las las siguientes siguientes novedades: novedades: se se puede puede preguntar al usuario usuario si si desea desea instalar instalar una una aplicación aplicación en en un un medio medio de de almacenaalmacenamiento externo (como una una tarjeta tarjeta SD), SD), como como alternativa alternativa aa lala instalación instalación en en lala Las aplicaciones aplicaciones se se actualizan actualizan de de forma forma memoria interna del del dispositivo. dispositivo. Las un servicio servicio para para lala automática cuando aparece una una nueva nueva versión. versión. Proporciona Proporciona un la propia propia aplicación aplicación para para copia de seguridad de de datos datos que que se se puede puede realizar realizar desde desde la el mantenimiento mantenimiento de de sus sus datos. datos. Por Por último, último, facilita facilita que que las las garantizar al usuario usuario el el reconocimiento reconocimiento de de voz voz yy que que terceras terceras partes partes aplicaciones interaccionen interaccionen con con el proporcionen nuevos motores de de reconocimiento. reconocimiento.

40

Visión general yyentorno entorno de de desarrollo desarrollo Se mejora la conectividad: conectividad: ahora ahora podemos podemos utilizar utilizar nuestro nuestro teléfono teléfono para para dar dar (tethering), tanto tanto por por USB USB como como por por Wi-Fi. Wi-Fi. acceso a Internet aa otros otros dispositivos dispositivos (tethering), También se añade el soporte soporte aa Wi-Fi Wi-Fi IEEE IEEE 802.11n. 802.11 n. Se añaden varias mejoras mejoras en en diferentes diferentes componentes: componentes: en en elel API API gráfica gráfica OpenGL OpenGL ES se pasa a soportar soportar la la versión versión 2.0. 2.0. También También puede puede realizar realizar fotos fotos oo vídeos vídeos en en cualquier orientación orientación (incluso (incluso vertical) vertical) yy configurar configurar otros otros ajustes ajustes de de lala cámara. cámara. Para Para finalizar, permite definir finalizar, definir modos modos de de interfaz interfaz de de usuario usuario ("automóvil" ("automóvil" yy"noche") "noche")para paraque que el modo modo seleccionado seleccionado por porelel usuario. usuario. las aplicaciones se configuren configuren según según el

9 (diciembre 1.6.8. Android 2.3 Nivel Nivel de de API API9 (diciembre 2010, 2010, Gingerbread) Gingerbread) Debido al éxito de Android Android en en las las nuevas nuevas tabletas, tabletas, ahora ahora soporta mayores tamaños tamaños de de pantalla pantalla yy resoluciones resoluciones (WXGA (WXGA y superiores). nuevo interfaz interfaz de de usuario usuario con con un un diseño diseño Incorpora Incorpora un nuevo las mejoras mejoras de de la la interfaz interfaz de de usuario usuario actualizado. Dentro de de las actualizado. Dentro de la la funcionalidad funcionalidad de de "cortar, "cortar, copiar copiaryy destacamos la mejora de pantalla con con capacidad capacidad multitáctil. multitáctil. pegar" y un teclado en pantalla Incluye soporte nativo nativo para para varias varias cámaras, cámaras, pensado pensado en en la segunda cámara usada usada en en videoconferencia. videoconferencia. La La incorporación incorporación de de esta esta segunda segunda cámara ha propiciado la la inclusión inclusión de de reconocimiento reconocimiento facial facial para para identificar identificar alal usuario del terminal. La máquina virtual Dalvik Dalvik para para Android Android introduce introduce un un nuevo nuevo recolector recolector de de las pausas pausas de de la la aplicación, aplicación, ayudando ayudando aa garantizar garantizaruna unamejor mejor basura que minimiza las animación y el aumento de de la la capacidad capacidad de de respuesta respuesta en en juegos juegos yy aplicaciones aplicaciones similares. Se trata de similares. de corregir corregir así así una una de de las las lacras lacras de de este este sistema sistema operativo operativo móvil, que en versiones versiones previas previas no no ha las aplicaciones aplicaciones ha sido sido capaz capaz de de cerrar cerrar bien bien las el desarrollo desarrollo de de código código nativo nativo en desuso. Se dispone dispone de de mayor mayor apoyo apoyo para para el (NDK).También se mejora mejora la la gestión gestión de de energía energía yy control control de de aplicaciones. aplicaciones. YY se se cambia el sistema de ficheros, ficheros, que que pasa pasa de de YAFFS YAFFS aa EXT4. EXT4. el soporte soporte nativo nativo para para telefonía telefonía sobre sobre Entre otras otras novedades novedades destacamos destacamos el Internet VolP/SIP. VoiP/SIP. El soporte soporte para para reproducción reproducción de de vídeo vídeo WebMA/P8 WebMNP8 yycodificación codificación de audio AAC. AAC. El El soporte soporte para para la la tecnología tecnología NFC. NFC. Las Las facilidades facilidades en en elel audio, audio, los desarrolladores desarrolladores de dejuegos. juegos. El gráficos y entradas entradas para los El soporte soporte nativo nativopara paramás más sensores (como giroscopios giroscopios yy barómetros) barómetros) yy un un gestor gestor de de descargas descargas para para las las descargas largas.

1.6.9. Android 3.0 Nivel Nivel de de AP111 API 11 (febrero (febrero 2011, 2011, Honeycomb) Honeycomb) Para mejorar la experiencia experiencia de de Android Android en en las las nuevas nuevas tabletas tabletas se lanza la versión versión 3.0 3.0 optimizada optimizada para para dispositivos dispositivos con con nueva interfaz interfaz de de usuario usuario ha ha sido sido pantallas grandes. grandes. La nueva completamente rediseñada rediseñada con con paradigmas paradigmas nuevos nuevos para para lala interacción, navegación interacción, navegación yy personalización. personalización. La La nueva nueva interfaz interfaz se pone a disposición disposición de de todas todas las las aplicaciones, aplicaciones, incluso incluso las las construidas para versiones anteriores anteriores de de la la plataforma. plataforma.

=

41

El gran libro de Android Android Las principales novedades novedades de de este este SDK SDK son: son: Con el objetivo de de adaptar adaptar la la interfaz interfaz de de usuario usuario aa pantallas pantallas más más grandes grandes se se incorporan las siguientes siguientes características: características: resolución resolución por por defecto defecto WXGA WXGA 30 con con widgets widgets rediseñados, rediseñados, nuevos nuevos componentes componentes yy vistas, vistas, (1280x800}, escritorio 3D (1280x800), escritorio soltar, nuevo nuevo cortar cortar yy pegar, pegar, barra barra de de notificaciones mejoradas, mejoradas, arrastrar arrastrar yy soltar, acciones para que que las las aplicaciones aplicaciones dispongan dispongan de de un un menú menú contextual contextua! siempre siempre presente y otras características características para para aprovechar aprovechar las las pantallas pantallas más másgrandes. grandes. Se mejora la reproducción reproducción de de animaciones animaciones 2D/3D 20/30 gracias gracias alal renderizador renderizador El nuevo nuevo motor motor de de gráficos gráficos Rederscript Rederscript saca saca un un OpenGL acelerado por por hardware. hardware. El gran rendimiento de de los los gráficos gráficos en en Android Android ee incorpora incorpora su su propia propiaAPI. API. Primera versión de de la plataforma plataforma que que soporta soporta procesadores procesadores multinúcleo. multinúcleo. La La máquina virtual Dalvik Dalvik ha ha sido sido optimizada optimizada para para permitir permitir multiprocesado, multiprocesado, lolo que que incluso aquellas aquellas que que son son de de las aplicaciones, aplicaciones, incluso permite una ejecución ejecución más más rápida rápida de de las hilo único. único. Se incorporan varias mejoras mejoras multimedia, multimedia, como como listas listas de de reproducción reproducción M3LI M3U aa través de HTTP Uve Sreaming, Sreaming, soporte soporte aa la la protección protección de de derechos derechos musicales musicales (DRM) y soporte para para la transferencia transferencia de de archivos archivos multimedia multimedia aatravés travésde de USB USBcon con los protocolos MTP MTP yy PTP. PTP. En esta versión se añaden añaden nuevas nuevas alternativas alternativas de de conectividad, conectividad, como como las las nuevas APIS de Bluetooth Bluetooth A2DP A2DP yy HSP HSP con con streaming streaming de de audio. audio. También También se se permite conectar teclados completos completos por por USB USB oo Bluetooth. Bluetooth. El uso de los dispositivos dispositivos en en un un entorno entorno empresarial empresarial es es mejorado. mejorado. Entre Entre las las novedades introducidas destacamos destacamos las las nuevas nuevas políticas políticas administrativas administrativas con con encriptación del del almacenamiento, almacenamiento, caducidad caducidad de de contraseña contraseña yy mejoras mejoras para para administrar los dispositivos dispositivos de de empresa empresa de de forma forma eficaz. eficaz. optimizada para para tabletas, tabletas, Android Android 3.0 3.0 es es A pesar de la nueva interfaz interfaz gráfica gráfica optimizada compatible con las las aplicaciones aplicaciones creadas creadas para para versiones versiones anteriores. anteriores. La La tecla tecla de de menú, en las las nuevas nuevas tabletas, tabletas, es es remplazada remplazada por por un un menú menú que que menú, inexistente en aparece en la barra barra de de acción. acción.

1.6.1 O. 1.6.10.

Android 3.1 3.1 Nivel Nivel de de AP112 API 12 (mayo (mayo 2011) 2011) Android

Permite manejar dispositivos dispositivos conectados conectados por por USB USB (tanto (tanto host host como como dispositivo). dispositivo). Protocolo de transferencia de de fotos fotos yy vídeo vídeo (PTP/MTP) (PTP/MTP) yy de de tiempo tiempo real real (RTP). (RTP).

1.6.11.

Android 3.2 3.2 Nivel Nivel de de AP113 API13 (julio üulio 2011) 2011) Android

Optimizaciones para distintos distintos tipos tipos de de tableta. tableta. Zoom Zoom compatible compatible para para aplicaciones aplicaciones SO. de tamaño fijo. Sincronización Sincronización multimedia multimedia desde desde SD.

42

Visión general yy entorno de desarrollo

1.6.12.

Android 4.0 Nivel Nivel de de AP114 API14 (octubre (octubre 2011, 2011, Ice Cream Sandwich)

La característica más importante es que que se se unifican unifican las las dos dos versiones anteriores (2.x para teléfonos yy 3.x 3.x para para tabletas) tabletas) en una sola compatible con cualquier tipo tipo de de dispositivo. dispositivo. Entre las características más interesantes interesantes destacamos: destacamos: interfaz de de usuario usuario totalmente totalmente Se introduce un nuevo interfaz renovado. ejemplo, se remplazan los los botones botones físicos físicos por por renovado. Por ejemplo, botones en pantalla (como ocurría en las las versiones versiones 3.x). 3.x). Nuevo API de reconocedor facial que que permite, permite, entre entre otras otras muchas muchas en el el reconocimiento reconocimiento de de aplicaciones, teléfono. También También se se mejora mejora en aplicaciones, desbloquear el teléfono. en cuanto cuanto pulsamos pulsamos el el botón. botón. voz. Por ejemplo, se puede empezar a hablar hablar en Aparece un nuevo gestor de tráfico de de datos datos por Internet, Internet, donde donde podremos podremos ver ver el consumo de forma gráfica yy donde podemos podemos definir definir los los límites límites aa ese ese consumo consumo la para evitar cargos inesperados con la la operadora. operadora. Incorpora Incorpora herramientas herramientas para para la edición de imágenes en tiempo real, con herramientas herramientas para para distorsionar, distorsionar, manipular manipular e interactuar con la imagen al momento momento de de ser ser capturada. capturada. Se Se mejora mejora el el API API para para comunicaciones por NFC y la integración integración con con redes redes sociales. sociales. En diciembre del 2011 aparece una una actualización actualización de de mantenimiento mantenimiento (versión (versión 4.0.2) que no aumenta el nivel de API.

1.6.13.

Android 4.0.3 Nivel 15 (diciembre Nivel de de API AP115 (diciembre 2011) 2011)

Se introducen ligeras mejoras en algunas algunas APIs APis incluyendo incluyendo el el de de redes redes sociales, sociales, En marzo marzo calendario, ortográfico, texto aa voz voz yy bases bases de de datos datos entre entre otros. otros. En calendario, revisor ortográfico, 4.0.4. de 2012 aparece la actualización 4.0.4.

1.6.14.

Elección de la la plataforma plataforma de de desarrollo desarrollo

A la hora de seleccionar la la plataforma plataforma de de desarrollo desarrollo hay hay que que consultar consultar sisi necesitamos alguna característica especial especial que que solo solo esté esté disponible disponible aa partir partir de de una una versión. Todos los usuarios con versiones inferiores la seleccionada seleccionada no no podrán podrán versión. inferiores aa la instalar la aplicación. aplicación. Por lo tanto, tanto, es es recomendable recomendable seleccionar seleccionar la la menor menor versión versión posible que nuestra aplicación pueda soportar. soportar. Por Por ejemplo, ejemplo, si si nuestra nuestra aplicación aplicación necesita utilizar varios cursores simultáneos simultáneos en en la la pantalla pantalla táctil táctil (multi-touch), (multi-touch) , tendremos que utilizar la versión 1.6, 1.6, al al ser ser la la primera primera que que lo lo soporta. soporta. Pero, Pero, la la versiones anteriores. anteriores. Para Para ayudarnos ayudarnos aa tomar tomar aplicación no podrá ser instalada en versiones la decisión de que plataforma utilizar utilizar puede puede ser ser interesante interesante consultar consultar los los porcentajes de utilización22..

2

http://developer.android.com/resources/dashboard/platform-versions.html http://developer.android.com/resources/dashboard/platform-versions.html

43

El gran libro de Android Plataforma Andrcid • AiKfcoM Z,$A~

3

0.3%

Android Android 1.6 1.6

4

0.7%

Android Android 2.1 2.1 3.8 Android Android 2.2 2.2 ÉM á$.í Android . . . . 2.3 _ 3. Androld2 -árid»W4.2 Android Android 2.3.2 2.3,2 Ff An&QKÍ 4 0 Android Android 2.3.3 2 3.3 r AndtSídt.S Andr0ld . . .. 237 Android 2.3.7 4- Amjrfd 1.6 3.0 Android 3.0 SÜ ■ Aíüjfoid 2 1 Android Android 3.1 Android 3.1 Android Android 3.2 32 Android 4.04.0 Android --A«j»tó2.2 AridfiOíd Anclroid 2,2 2.2 Android Android 4.0.2 4.0.2 Android Android 4.0.3

*

AndreW 2,1 ♦

Nivel API Porcent.

Android 1.5 1.5 Android

7

6.0%

8

23.1%

9

0.9%

10

63.2%

11

0.1%

12

1.0%

13

2.2%

14

0.5%

15

2.4%

Figura 3: Dispositivos Android según plataforma instalada, instalada, que han accedido a Google Google Play Store durante dos semanas terminado el 2 de abril de 2012. 2012

SP

' ' • '■ , „ . ;

■ ' -

■i

■

w» i fifi s mi ii/is mi i»is «i/oí »« 2C12

I %m «aioi fttns

11 At'
11 Anctmid 3.2 11 Mdrtifd 4.0.3

wis mm me

Figura 4: Evolución del porcentaje de dispositivos Android Androld según la plataforma instalada, hasta el 2 de abril de 2012.

Tras estudiar las gráficas podemos destacar el reducido número de usuarios que utilizan las versiones 1.x (1 %). Por lo tanto, puede ser buena idea utilizar la (1%). la versión 2.1 para desarrollar nuestro proyecto, dado que daríamos cobertura al 99% de los terminales. Las versiones 3.x, con un 3,3%, han tenido muy poca difusión y presentan una clara tendencia a disminuir. disminuir. Las versiones 4.x, con un 2,9%, todavía son minoritarias pero es previsible que este porcentaje vaya incrementando. incrementando.

44

Visión general y entorno de de desarrollo desarrollo

e

Enlaces de interés: interés: • Android developers: developers: Plataform Plataform Versions: Versions: Estadística Estadística de de dispositivos Android Android según según plataforma plataforma instalada, instalada, que que han han accedido accedido a Android Market. http://developer.android.com/resources/dashboard/platformhttp://developer.andro¡d.com/resoürces/dashboard/platformversions.html

• Android developers: SDK: SDK: En En el el menú menú de de lala izquierda izquierda aparecen aparecen links a las principales versiones versiones de de lala plataforma. plataforma. Si Si pulsas pulsas sobre sobre ellos encontrarás una descripción descripción exhaustiva exhaustiva de de cada cada plataforma. plataforma. http://developer.android.com/sdklindex.html http://developer.android.com/sdk/index, html

Preguntas de repaso repaso yy reflexión: reflexión: Las Las versiones versionesde deAndroid. Android.

1. 7. Creación 1.7. Creación de de un un primer primer programa programa de desarrollo desarrollo nos nos facilita facilita mucho mucho lala creación creaciónde deprogramas. programas. Esto Esto Utilizar un entorno de importante en en Android, Android, dado dado que que tendremos tendremos que que utilizar utilizar una una es especialmente importante Gracias al al plug-in plug-in Android Android que que hemos hemos instalado instaladoen en elel gran variedad de ficheros. Gracias entorno de desarrollo Eclipse, Eclipse, la la creación creación yy gestión gestión de de proyectos proyectos se se realizará realizaráde de forma muy rápida, acelerando acelerando los los ciclos ciclos de de desarrollo. desarrollo.

Poli[Med.ia]: Puli[Media |; Un Un primer primerproyecto proyecto Android. Android. 1. 7 .1. Creación del 1.7.1. del proyecto proyecto proyecto Android Android sigue sigue los los siguientes siguientespasos: pasos: Para crear un primer proyecto

Ejercicio paso aa paso: paso: Crear Crear un un primer primerproyecto. proyecto. 1.

New >> Project. Project. Si Si el el plug-in plug-in de de Android Android se se ha ha instalado instalado Selecciona File > New cuadro de de diálogo diálogo que que aparece aparece debe debe tener tener un un correctamente, el cuadro directorio llamado Android Android que que debe debe contener contener Android AndroidProject. Project.

2.

Selecciona Android Project Project yy pulsa pulsa Next. Next.

45

El gran libro de Android Qh New Project

wizard Select 6a wizHrd

lllliJ ES mmmÁ/

Wisards: Java Pfoiecl Java Proiecl Project from Existing Exisling Ant An^ Buildfile Buildíile ! ···eyi~ Plug-in Project Projecl G.It General B ·· @} Android

á

· · ~ !!!~!!oject

Android T est Proiecl ' $ Gt? CVS cvs !±l ·@p Java $ ..·G'i? Plug-in Development ffi .. G.ifr EExamples xamples

3.

Rellena los detalles del del proyecto proyecto con con los los siguientes siguientes valores: valores: Project ..~: Ho J.a _!\1u r:do Project namr: ñame: HolaMundo BuildTa.rgec 5 BuildTargeC:: l~nd.l"o.id Android 1. 1.5

A.P Pl i ca t i on nñame: anie : Hola Application Hola,, l\1undo Mundo Package name . e x ampl e .holamundo ñame:: com com.example.holamundo Cr eate lictivit.v aMundo Create Activity:: Hol HolaMundo l·fin Min SDK Version Versión:: 33

Pmject Project name: na me HoJaMundo HotaMundo Contents Contents (f¡ ü? Create new Eiew projec.t project ¡n in workspace

source ® 0 Create project from existing source tecatíon ~ k Use default default location

46

Visión general y entorno de desarrollo Buitd Target Target Ñame Android11 P] Android 11 rJ W\ Androioql€ Google APIs TI Pj Androi
Build Target

Vender Android Open Sourcc Project Android Optn Source Android Open Source Projec:t Projiect Google Inc. Googlc.ln<. Android Opm Source Andrcwd Open Source Projrd Project Gocglelnc. Google Inc. Android Sourcr Project Projec:t Android OpM Open Source Google Inc. Google:ln<. Android Open Source Android Open Source PmjKt Project G<><>glelnc. Googl e Inc. Android Open Source Android Open Source Project Project Google Inc. Googl
Android Open Sour<€ Project

Platfonr» Platform 11 1.5 13 15 15 1.6 16 1.6 16 26 2.0 26 2.0 2.1lJ 2fiJ 2.01 2,01 2J-upd 21-upd.w... 21-upd 21-upd....• 22 2.2 21 2.2 23 23 23 23 11

API...•• APJ 22 33 33 4 4 55 5 S 5 6 66 77 77 88 88 99 99

St•ndar
A continuación vemos una pequeña descripción descripción para para cada cada campo: campo: Project Name: Ñame. Es el nombre nombre del del proyecto. proyecto. Se Se creará creará un un directorio directorio con con elel mismo nombre que contendrá los ficheros ficheros del del proyecto. proyecto. Build Target Target. Es la versión de de la la plataforma plataforma con con la la que que será será compilada compilada lala aplicación. Normalmente ha ha de coincidir coincidir con con el el valor valor introducido introducido en en Min Min SDK Version. Versión.

Application Name: Ñame Es el nombre nombre de de la la aplicación aplicación que que aparecerá aparecerá en en elel App/ication la barra barra superior superior cuando cuando esté esté en en dispositivo Android. Tanto en la instalará en en el el menú menú de de programas. programas. ejecución, como en el icono que se instalará Package Name: Ñame. Indicamos el paquete paquete con con el el espacio espacio de de nombres nombres utilizado utilizado Debemos utilizar utilizar las las reglas reglas de de los los espacios espacios de de por nuestra aplicación. Debemos nombre en el lenguaje de programación programación Java. Java. Las Las clases clases que que creemos creemos Esto también también establece establece el el nombre nombre del del paquete paquete estarán dentro de él. Esto aplicación generada. generada. donde se almacenará la aplicación

JJ i

sssssí' Nota sobre Sobre Java: Java; El El nombre nombre del del paquete paquete debe debe ser ser único único en en todos todos los los <.....,..;::::::. paquetes instalados en el sistema; por ello, ello, es es muy muy importante importante utilizar utilizar para para tus tus aplicaciones un dominio de de estilo estilo estándar estándar en en los los paquetes. paquetes. El El espacio espacio de de nombres "com.example" está reservado para para la la documentación documentación de de ejemplos. ejemplos. Cuando desarrollas tu propia aplicación, aplicación, debes debes utilizar utilizar un un espacio espacio de de nombres nombres que sea apropiado.

47

El gran libro de Androíd Android Create Activity. Activity: Este Este es es el el nombre nombre cié de la la clase clase que que será será generada generada por por elel plug-in. Esta Esta será una una subclase subclase de de Activity Activity de de Android. Android. Una Una actividad actividades es clase que que se se puede puede ejecutar ejecutar yy modificar. modificar. Se simplemente una clase Se pueden pueden en diferentes diferentes actividades. actividades. Una Una crear las diferentes diferentes pantallas pantallas de de usuario usuario en actividad casi siempre se se utiliza utiliza como como base base para para una una aplicación. aplicación. Min SDK Versión. Version: Este Este valor valor especifica especifica el el mínimo mínimo nivel nivel del del API API que que aplicación. Si Si el el nivel nivel del del API API introducido introducido coincide coincide con con elel requiere tu aplicación. proporcionado por por uno uno de de los los targets targets disponibles, disponibles, entonces entonces se se Build Target. Target. Si Si una una aplicación aplicación requiere requiere seleccionará automáticamente automáticamente Build un nivel del del API superior superior al al nivel nivel soportado soportado por por el el dispositivo, dispositivo, entonces entonces la aplicación no será será instalada. instalada. Otros campos. campos: La casilla casilla de de verificación verificación Use Use default default location /ocation permite permite del disco disco donde donde se se crean crean yy almacenan almacenan los los ficheros ficheros de de cambiar la ruta del los proyectos. proyectos.

aunque elel Build Build Target Target Podremos ejecutar ejecutar sobre sobre la la plataforma plataforma Android Android 1.5, 1.5, aunque seleccionado sea la la plataforma plataforma 1.1. 1.1. Estos Estos no no tienen tienen que que coincidir coincidir ya ya que que una una aplicación construida construida con la la librería librería de de la la plataforma plataforma 1.1 1.1 se se ejecutará ejecutará normalmente normalmente en plataformas superiores superiores aa esta, esta, pero pero no no al al revés. revés. Deberías tener visible el el explorador explorador de de paquetes paquetes aa lala izquierda. izquierda.Abre Abre elel fichero fichero HolaMundo.java (situado en en HolaMundo Ho/aMundo >> src src >> com com.example.HolaMundo). Debe example.HolaMundo). Debe tener este aspecto: aspecto: package com.example.holamundo; com.example.holamundo; import android.app.Activity; c.ndroid. app .Act.ivit.y; import android.os.Bundle; android.os.Bundle ; public class HolaMundo extends extends Activity Activity {{

/** Called when the activity activity is is first first ci'eated. created. */ */ @Override ©Override public void onCreate(Bundle onCreate(Bundle savedlnstanceState) savedinstanceState) { super .onCreate(savedlns tanceState); super.onCreate(savedlnstanceState); setContentView (R. ( R. layout. layout .¡nain) mai.n) ;;

} } Comenzamos declarando el el paquete paquete con con el el espacio espacio de de nombres nombres utilizado utilizado por por nuestra aplicación. A continuación continuación indicamos indicamos los los "import" "import" con con las las clases clases que que aplicación. A su vamos a utilizar. utilizar. Esto Esto nos nos evitará evitará tener tener que que poner poner delante delante de de cada cada clase clase su espacio de nombres. nombres. Hola~,l undo extiende extiende de de activity. Activity. Una Una actividad actividad es es una una Observe que la clase HolaMundo entidad de aplicación aplicación que que se se utiliza utiliza para para representar representar una una pantalla pantalla de de nuestra nuestra usuario interactúa interactúa aplicación. Más Más adelante adelante crearemos crearemos más más actividades, actividades, pero pero elel usuario El método método onCreate oncreate()() se se llamará llamará por por elel sistema sistema con una de ellas ellas cada vez. vez. El su ejecución ejecución -es -es donde donde se se debe debe realizar realizar lala inicialización inicializaciónyy Android cuando se inicie inicie su

48

Visión general y entorno de de desarrollo desarrollo la configuración de de la la interfaz interfaz del del usuario. usuario. Una Una actividad actividad no no precisa precisa tener tener una una interfaz de usuario, pero pero la la suele suele tener. tener. Antes de este método método se se ha ha utilizado utilizado lala anotación anotación
del programa programa 1.8. Ejecución del Una vez creada esta primera primera aplicación aplicación veamos veamos dos dos alternativas alternativaspara paraejecutarla. ejecutarla.

en el el emulador emulador 1.8.1. Ejecución en la aplicación aplicación sigue sigue los los siguientes siguientes pasos: pasos: Para ejecutar la

paso: Ejecución Ejecución en en el el emulador. emulador. Ejercicio paso aa paso: 1.

Selecciona Run ). Run >> Run Run (Ctri-F11 (Ctrl-F 11).

2.

Application. El El ADT ADT de de Eclipse Eclipse creará creará automáticamente automáticamente Escoge Android Application. configuración de de ejecución ejecución para para tu tu proyecto proyecto yy lanzará lanzará elel una nueva configuración inicialización del del emulador emulador puede puede ser ser algo algo lenta, lenta, por por esta esta emulador (la inicialización no cerrar cerrar el el emulador). emulador). Una Una vez vez que que elel emulador emulador esté esté razón es mejor no algo parecido parecido aa la la siguiente siguiente figura. figura. cargado, debes ver algo

en un un terminal terminal real real 1.8.2. Ejecución en tus programas programas en en un un terminal terminal real real resulta resultaposible posibledesde desdeelelSDK. SDK. Ejecutar y depurar tus No tienes más que que usar usar un un cable cable USB USB para para conectarlo conectarlo alal PC. PC. Resulta Resulta instalado un un driver driver especial especial en en elel PC. PC. Puedes Puedesencontrar encontrar imprescindible haber instalado en la la carpeta carpeta android-sdk-windows\usb_driver android-sdk-windows\usb_driver del del SDK SDK un driver genérico en lo más más probable probable es es que que tengas tengas que que utilizar utilizar elel driver driver del del Android. Aunque lo fabricante.

i

Ejercicio paso a paso: Ejecución Ejecución en en un un terminal terminalreal. real.

49

El gran libro de Android 1.

Abre Android SDK and AVD A VD Manager yy asegúrate asegúrate que que esta está instalado instalado el el paquete USB Driver. Driver. En caso contrario contrario pulsa pulsa en en Available Available Packages Packages ee instálalo. instálalo.

tsfiJUií 7:42 AM

Android SOK and Available Packages

SDK location; C:\Progf am FtfeíXandroid-sdk-wtndowsV instafled ln:s. t \lleó Packages Packa!J~.s •i. Googl:e APis by by Google GO"ogle Inc., loe., Android Andfoid API API7, fe-.ñsion 11 %Googf e APIs 7. revisión 1i.Googl:e APis by by Google Googte: Inc.. Jnc., Android Android API AP17, fevision 11 % Google APIs 1, revisión t. Google APIs APls by by Google G:oogte Inc., Jnc., Android Android API API7. 7, revisión revision i1 % Google APls by by Google Googte Inc., lnc., Android Android API API7, 7, revisión revios:ion I1 •t4-Google % Google APIs iü üsb i'i Us:b Driver Driver package, package,. revisión re•i_s_io : _n_3l _ __ · Oescffption ·····oo'cc·····•'o'·c·"·•·'·'c·· ' .c.,., .• Description ·· 1

Posiblemente este driver genérico no no sea sea adecuado adecuado para para tu tu terminal terminal yy tengas que utilizar el el del del fabricante. fabricante. Si Si no no dispones dispones de de él, él, puedes puedes buscarlo en: en: http://developer.android.com/sdkloem-usb.html http://developer.android.oom/sdk/oem-usb.html

50

Visión general yy entorno de de desarrollo desarrollo 2.

En el terminal accede accede al al menú menú Settings Settings >> Aplications Aplications >> Development Development yy asegúrate que la la opción USB USB debugging debugging está está activada. activada.

iJ Bf¡)jii¡Q:¡tt\ :

lillJ~ (.1j 4:50 4:50PM ÜJ® (3 PM ''"'·· y¡; .:·c~u..· ,. F

USB debugging De-bug mode wtum US8 :s H.mnected

Stay awake Srri'en w1H

n€'v~r

s¡eep Vihl!l? (harging

Allow mock locations Allow mock

locatlcn~

Ll Ll

•

3.

cable USB. USB. Conecta el cable

4.

que hay hay un un nuevo nuevo hardware hardware yy te te pedirá pedirá que que lele indiques indiques elel Se indicará que controlador. controlador.

NOTA: En Windows si indicas un un controlador controlador incorrecto incorrecto no nofuncionará. Además lala funcionará. Además conectes el el cable cable no no te te pedirá pedirá la la instalación instalación del del controlador. controlador. Para Para próxima vez que conectes desinstalar el controlador sigue sigue los los siguientes siguientespasos: pasos:

1.l. 2. 3.

Desinstala controlador. Des instala el controlador. Accede al registro del del sistema sistema (Inicio (Inicio >> Ejecutar Ejecutar >> RegEdit). RegEdit). Busca Busca lala siguiente clave y bórrala: bórrala: "vid "vid_Obb4&pid_Oc02". 0bb4&pid_()c02 ". Vuelve al paso paso 33 del ejercicio. ejercicio.

1.9. Elementos de de un un proyecto proyecto Android Android 1.9. Elementos «^Ül ür Poli[Media]: Poli[Media]: Elementos Elementos de de un un proyecto proyecto Android. Android. Un proyecto Android está está formado formado básicamente básicamente por por un un descriptor descriptor de de lala aplicación aplicación (AndroidManifest.xmí),, el código (AndroidManifest.xml) código fuente fuente yy una una serie serie de de ficheros ficheros con con recursos. recursos.Cada Cada elemento se almacena almacena en en una una carpeta carpeta específica. específica. Aprovecharemos Aprovecharemos elel proyecto proyecto un proyecto proyectoAndroid: Android: que acabamos acabamos de crear crear para para estudiar estudiar la la estructura estructura de de un src: que contiene contiene el el código código fuente fuente de de la la aplicación. aplicación. Como Como puedes puedes src. Carpeta que en un un espacio espacio de de nombres. nombres. observar los ficheros Java Java se se almacenan almacenan en

gen. Carpeta que gen: que contiene contiene el el código código generado generado de de forma forma automática automática por por elel SDK. Nunca hay SDK. hay que modificar modificar de de forma forma manual manual estos estos ficheros. ficheros. Dentro encontraremos el siguiente siguiente fichero; fichero:

51

El gran libro de Android R.java: R.java Define una clase que asocia los recursos de la aplicación con identificadores. identificadores. De esta forma los recursos podrán ser accedidos desde Java. Java .

..* ¡4i.,. HolaMundo HoJ.~,MMn9:91 (H src src "a (2J

..a m com.examp l'es.hol.amundo B convexamp

[[¡ HolaMyndo.java Hol•a Mu ndoJava (2

"a ~ gen g:en {Geneiated [Gene:rated Java Fies] Files] ~ les.holamundo * B com.examp com.examples.holamurtdo

m

t> [[¡ R.java mA Android 1.1 ^AndroidlJ @:;. a•s sets & assets _.a & ~ res a ~ drawable .11. ~ icon.png ÍIB icon.png .11. layout a ~ tayout [gj main.xml ^ ma:in,xmf á ¡;&¡} vatues .11. va l!u:es [gj string. s .xml sttings.xm! ,g: AndroidManifest.xml AndroirfMantfest,xmS ~ d efault.properti.es 3 defaultpiroperttes ¡, l>

JAR, el API de Android según la versión seleccionada. Android x.x. x.x: Código JAR, seleccionada. assets: assets: Carpeta que puede contener una serie arbitraria de ficheros o carpetas que podrán ser utilizados por la aplicación (ficheros de datos, externos, fuentes, fuentes, etc.). datos, ficheros JAR externos, etc.). A diferencia de la carpeta res, res, nunca se modifica el contenido de los ficheros de esta carpeta. res: res. Carpeta que contiene los recursos usados por la aplicación. aplicación. drawable: drawable En esta carpeta se almacenan los ficheros de imágenes y descriptores de imágenes. imágenes. layout: layout Contiene ficheros XML con vistas de la aplicación. aplicación. Las vistas nos permitirán configurar las diferentes pantallas que compondrán la interfaz de usuario de la aplicación. aplicación. Serán tratadas en el el siguiente capítulo. capítulo. menu: menú: Ficheros XML con los menús de la aplicación.

values: valúes También utilizaremos ficheros XML para indicar valores del tipo string, estilo. De esta manera podremos cambiar los string, color o estilo. valores sin necesidad de ir al código fuente. fuente. Por ejemplo, ejemplo, nos permitiría traducir una aplicación apl cación a otro idioma. idioma anim: animaciones. anim Contiene ficheros XML con descripciones de animaciones. xm/: aplicación. xml: Otros ficheros XML requeridos por la aplicación.

52

Visión general y entorno de desarrollo raw: raw Ficheros adicionales que no se encuentran en formato XML. doc: doc. Documentación asociada al proyecto. AndroidManifest.xml: Android. En En él él se se AndroidManifest.xml. Este fichero describe la aplicación Android. indican las actividades, intenciones, servicios yy proveedores proveedores de contenido de la aplicación. aplicación. También se declaran los permisos que requerirá la aplicación. aplicación. Se indica indica la versión mínima de de Android para poder ejecutarla. default.properties: generado automáticamente automáticamente por el SDK. SDK. Nunca Nunca default.properties: Fichero generado hay que modificarlo. la versión del API API yy modificarlo. Se utiliza para comprobar la otras características cuando se instala la aplicación en el terminal. terminal. NOTA: Como se acaba de ver, el uso de XML es ampliamente utilizado utilizado en en las aplicaciones Android. Android También es conocido el excesivo uso de espacio espacio que que supone /a.fi/osqfia utilizar este formato para almacenar información. if!formación. Esto parece contradecir la filosofía de Android que intenta optimizar al máximo los recursos. Para solucionar solucionar el .ficheros XML son compilados a un formato más eficiente antes antes de ser ser problema, los ficheros transforidos transferidos al terminal móvil.

1.1 O. Componentes de una una aplicación aplicación 1.10. Componentes de Existen una serie de elementos clave que resultan imprescindibles imprescindibles para para desarrollar desarrollar Android. En este apartado vamos aa realizar una una descripción descripción inicial inicial aplicaciones en Android. de algunos de los más importantes. A lo largo largo del del libro se se describirán describirán con con más más detalle las clases Java que implementan cada uno de estos componentes. componentes.

1.10.1.

Vista (View) {View)

Las vistas son los elementos que componen la interfaz interfaz de de usuario usuario de de una una aplicación. Son por ejemplo, un botón, una entrada de texto,... texto, ... Todas Todas las las vistas van a ser objetos descendientes de la clase View, yy por por tanto, tanto, pueden pueden ser ser Java. Sin embargo, embargo, lo lo habitual habitual va aa ser definir definir las las vistas vistas definidos utilizando código Java. los objetos objetos por nosotros nosotros aa utilizando un fichero XML y dejar que el sistema cree los partir de este fichero. Esta forma de trabajar es muy similar aa la la definición definición de de una una página web utilizando código HTML.

1.10.2.

Layout

Un Layout es un conjunto de vistas agrupadas de una determinada determinada forma. Vamos Vamos a disponer de diferentes tipos de Layouts para para organizar las las vistas de de forma lineal, lineal, cuadricula o indicando la posición absoluta en cuadrícula absoluta de cada vista. Los Los Layouts también View. Igual que las las vistas, los los Layouts Layouts son objetos descendientes de la clase View. habitual de de definirlos definirlos es es pueden ser definidos en código, aunque la forma habitual utilizando código XML.

53

El gran libro de Android Android

1.1 0.3. 1.10.3.

Actividad (Activity) (Activity) Actividad

Una aplicación en Android va aa estar estar formada formada por por un un conjunto conjunto de deelementos elementosbásicos básicos aplicación. En En de visualización, visualización, coloquialmente coloquialmente conocidos conocidos como como pantallas pantallas de de lala aplicación. Android cada uno uno de de estos estos elementos, elementos, oo pantallas, pantallas, se se conoce conoce como como actividad. actividad. Su Su la creación creación del del interfaz interfaz de de usuario. usuario. Una Una aplicación aplicación suele suele función principal es es la actividades para para crear crear el el interfaz interfaz de de usuario. usuario. Las Las diferentes diferentes necesitar varias actividades actividades creadas serán serán independientes independientes entre entre sí, sí, aunque aunque todas todas trabajarán trabajarán para para un un objetivo común. Toda Toda actividad actividad ha ha de de pertenecer pertenecer aa una una clase clase descendiente descendiente de de Activity.

1.10.4.

Servicio Servicio (Serv/ce) (Servíce)

Un servicio es un un proceso proceso que que se se ejecuta ejecuta "detrás", "detrás", sin sin lala necesidad necesidad de de una una demonio en en Unix Unix oo aa un un servicio servicio interacción con el usuario. usuario. Es Es algo algo parecido parecido aa un un demonio en Windows. En Android disponemos disponemos de de dos dos tipos tipos de de servicios; servicios: servicios servicios locales, locales, servicios remotos, remotos, que pueden ser utilizados utilizados por por aplicaciones aplicaciones del del mismo mismo terminal terminal yy servicios que pueden ser utilizados utilizados desde desde otros otros terminales. terminales. Los Los servicios servicios son son estudiados estudiadosen en el capítulo 8. 8.

1.1 0.5. 1.10.5.

Intención (/nfení) (lntent) Intención

Una intención representa representa la la voluntad voluntad de de realizar realizar alguna alguna acción; acción; como como realizar realizar una una llamada de teléfono, teléfono, visualizar visualizar una una página página web. web. Se Se utiliza utiliza cada cada vez vezque quequeramos: queramos: ••* •m •■

Lanzar una actividad. actividad. Lanzar un servicio. servicio. Lanzar un anuncio de de tipo tipo broadcast. broadcast. Comunicarnos con un servicio servicio

Los componentes lanzados lanzados pueden pueden ser ser internos internos oo externos externos aa nuestra nuestra aplicación. aplicación. las intenciones intenciones para para el el intercambio intercambio de de información información entre entre estos estos También utilizaremos las componentes. componentes. En muchas ocasiones una una intención intención no no será será inicializada inicializada por por lala aplicación, aplicación, sisi no no por el sistema, por por ejemplo, ejemplo, cuando cuando pedimos pedimos visualizar visualizar una una página página web. web. En En otras otras su propia propia intención. intención. Para Para ello ello ocasiones será necesario necesario que que la la aplicación aplicación inicialice inicialice su objeto de de la la clase clase Intent. lntent. se creará un objeto

1.1 0.6. 1.10.6.

Receptor de de anuncios anuncios (Broadcast (Broadcast receiver) receiver) Receptor

Un receptor de anuncios anuncios recibe recibe yy reacciona reacciona ante ante anuncios anuncios de de tipo tipo broadcast. broadcast. Existen muchos originados originados por por el el sistema, sistema, como como por por ejemplo ejemplo Batería Batería baja, baja, Aunque, las las aplicaciones aplicaciones también también puede puede lanzar lanzar un un anuncio anuncio Llamada entrante,... entrante, ... Aunque, broadcast. interfaz de de usuario, usuario, aunque aunque pueden pueden iniciar iniciar una unaactividad actividad para para broadcast. No tienen interfaz anuncio. atender a un anuncio.

54

Visión general yy entorno de desarrollo

1.10.7.

Proveedores de de contenido {Contení (Content Provider) Provider)

La compartición de información entre teléfonos móviles móviles resulta resulta un un tema tema vital. vital. Android define un mecanismo estándar estándar para que que las las aplicaciones aplicaciones puedan puedan de comprometer la la seguridad seguridad del del sistema sistema de de compartir datos sin necesidad de ficheros. mecanismo podremos acceder a datos datos de de otras otras aplicaciones, aplicaciones, ficheros. Con este mecanismo como la lista de contactos, o proporcionar proporcionar datos datos a otras otras aplicaciones. aplicaciones. Los Los Contení Content 9. Provider son estudiados en el capítulo 9.

1.11. Documentación yy ApiDemos ApiDemos 1.11. Documentación Aunque en este libro vas a aprender mucho, mucho, resultaría imposible imposible tocar tocar todos todos los los aspectos de Android a un elevado nivel nivel de de profundidad. profundidad. Por Por lo lo tanto, tanto, resulta resulta imprescindible que dispongas de fuentes de de información información para para consultar consultar los los aspectos aspectos que vayas necesitando. necesitando. En este este apartado te proponemos proponemos dos dos alternativas: alternativas: el el acceso acceso estudio de de ejemplos. ejemplos. a documentación sobre Android y el estudio

1.11.1.

Donde encontrar documentación documentación

Puedes encontrar una completa documentación documentación del SDK SDK de de Android, Android, incluyendo incluyendo de recursos en en (siempre (siempre que que referencia de las clases, conceptos clave y otro otro tipo de hayas instalado la documentación on-line): on-line):

... \ andro id - s dk -win d ows \ doc s \index. html ...\android-sdk-windows\docs\index. Esta documentación también está disponible disponible en línea línea a través través de de Internet: Internet: http://developer.android.com/ Muchos de los recursos utilizados en este este libro puedes puedes encontrarlos encontrarlos en: en: http://www.androidcurso.com/ la Web de Puedes encontrar información referente a este libro libro en en la de la la editorial: editorial: http://libroweb.alfaomega.com. mx http://libroweb.alfaomeaa.com.mx

1.11.2.

La aplicación ApiDemos

Otra opción muy interesante para aprender aprender nuevos nuevos aspectos aspectos de de programación programación consiste en estudiar ejemplos. ejemplos. Con este este propósito se se ha ha instalado instalado en en el el SDK SDK de de Android una aplicación, ApiDemos, formada por cientos cientos de de ejemplos, ejemplos, donde donde no no el API API de de Android, Android, sino sino que que solo podrás ver las funcionalidades disponibles disponibles en el además podrás estudiar su código. Para crear un proyecto con esta aplicación sigue sigue los los siguientes siguientes pasos: pasos: Selecciona File > New > Project e indica indica Android Android Project. Project. Pulsa Pulsa Next Next yy aparecerá aparecerá

un cuadro de diálogo similar similar al siguiente: siguiente:

55

El gran libro de Android Project name: ñame: Api.Demos ApiDemos Pro.jed ,. Contente C<:>ntent>

' e0 .Cre:ate proj:ed in Create new new project ir* wocrks:pace workspace

;

Cre:ate proje:ct 0 Create project from from existíog existing soorce: source

~D

t!J u~ default defauft t:ocatíon [7] Ose locatico

i.óiratiort; i

i Í BfO'yVSe .s

# Create project from existing sample ▼|

Samples: [ApiDemos Butld Target Target Ñame 0] Android 1 i Android 15 H Android 15 1*1 Android 2.0

Vender Android O¡>en Android Open Sou.rce Source Project Project Android Open Open Source Source l'r<>ject Project Android Android O¡>en Open Source Source Project Project Android Android Android O¡>en Open Source Source Project Project

Plstform 1.1 U 15 15 15 1.6 2.0 2j0

API... 0 2 i 3 4 1 5

Has de marcar la opción opción Create Create from from existing existing sample sample yy seleccionar seleccionarun un nivel nivelde de ejemplos aumenta aumenta aa medida medida que que aumentamos aumentamos elel nivel nivelde deAPI. API.AA API. El número de ejemplos selecciona uno uno de de los los ejemplos ejemplos en en Samples: Samples: en en nuestro nuestro caso caso continuación selecciona ApiDemos. Pulsa Finish Finish para para crear crear el el proyecto. proyecto. Si no ha habido ningún ningún error error ya ya puedes puedes ejecutar ejecutar ApiDemos. ApiDemos. Verás Verás como como los los diferentes ejemplos se organizan organizan por por carpetas. carpetas. En En elel nivel nivel superior superiortenemos: tenemos: 1. 1.

App: Ejemplos aa nivel nivel de de aplicación aplicación trabajando trabajando con con las las clases clases Activity, Activity,

Alarm, Dialog y Service. Service. Alarm, 2. 2.

Content; Describe Describe cómo cómo leer leer datos datos desde desde ficheros, ficheros, recursos recursos yy archivos archivos Content:

XML 3. 3.

Graphics: Gran cantidad cantidad de de ejemplos ejemplos gráficos, gráficos, tanto tantoen en2D 2Dcomo comoen en3D. 3D.

4. 4.

Media: Reproducción Reproducción de de audio audio yy vídeo vídeo con con las las clases clases MediaP/ayer MediaPlayer yy VideoView. VideoView.

5. 5.

OS: Ejemplos de de cómo cómo utilizar utilizar diferentes diferentes servicios servicios del del sistema sistema operativo, operativo, como VIBRATOR_SERVICEy VIBRA TOR_ SER VICE y SENSOR_SERVICE. SENSOR_SERVICE.

6. 6.

Text: Diferentes ejemplos ejemplos de de manipulación manipulación de de texto. texto. Nos Nos muestra, muestra, por por ejemplo, como conseguir que que parte parte de de un un texto texto se se convierta convierta en en un un link, link, que habrá automáticamente una una URL URL oo una una llamada llamada de deteléfono. teléfono.

7. 7.

Views: Views; Android utiliza utiliza como como elemento elemento básico básico de de representación representación lala clase clase View (vista). Tenemos aa nuestra nuestra disposición disposición gran gran cantidad cantidad de de descendientes de esta esta clase clase para para representar representar una una interfaz interfaz gráfica gráfica (botones, ... ). Visualiza (botones, cajas de de texto, entradas, entradas,...). Visualiza estos estos ejemplos ejemplos para para comprobar las diferentes posibilidades. posibilidades.

Una vez seleccionado un un ejemplo, ejemplo, sisi quieres quieres estudiar estudiar su su código, código, búscalo búscaloen enlala carpeta src. Para organizar organizar mejor mejor el el código código se se han han creado creado diferentes diferentesespacios espaciosde de nombre de paquetes.

56

Visión general general yy entorno entorno de de desarrollo desarrollo .. };§.\ ApiDemos íJl AptDemos ■~> ^ a\ Androíd Android 1.5 15 4 ~SJC

~ Jli com.example.android.apis ,|^ com.example.android.apís >~ ,al ^ com.example.android.apis.anjmation com.example.android.apis.animation p~ jj .example.android .apts.app Ja1 com com.example.android.apis.app p. JH .example.and roid .apts.appwi dget b JD com com.example.android.apis .appwidget .-a 0 lt1 com.example.android.apvs.cantent com.e> [/] p¡:, jjj pk.java [[¡ R^sourcesSam ResnurcesSample.java p¡, ¡|] llJ StyledText.java StyledText.java p~ lH ,fD com.example.andfold.apts.graphícs com.example.a.ndroid.a.pis.graphics m .example.and roid .apis.g raph ics.kube t>p JH Jli co com.example.android.apis.graphics.tcube l>p JP ~ com.example.androld.apis.graphics.spritetext com.example.android.apis.graphic:s.spritetext p~ Jg J;li com.exampk.android.apis.media com.example.android.apis.media p~· ,fD com .ocample.a nd roid .a pi s.os com.e> Jli com.examplc.android.apis.view gen ~ g• en IGcnerated [G~n<:r~t<:d Java Jan Ríes] Files]

~ ~ ;§. as~ets

> @7 res ¡i¡w tests p¡:, ^ :g; AndroidManifest.xml •0 And roid M an ifest.xm I ¡ default.propertíes IEJ defau:ltproperties

NOTA: Si cuando ejecutas ejecutas la la aplicación aplicación no no te te deja dejayy te te indica indicael elsiguiente siguienteerror: error: [2821-12-07 13:42:04 - ApiDesnos] Installing ApiOecos.apk... [2811-12-07 [2~11 - 12 - 67 23:42:14 13~42~ 14 -- ¿piPefaos] ,t..pit:l(:t."«>~ l Re-in&tallation ~~- ins.t~lhtit..:m faiied faihá due du~ lo tv sifferent -~if1€1'c?:nt· appiicatiofi ~pdic:at~o~~ signaturas. si.g'l.:.tur•(:s, [2011 • 22. -0? 13:42.;2.4 T.Wt»; Thir» PftU.·U·-(:>1 H c41.;1.4 ■.. 4piD««»os1 Apit~!<] You You «ust. ~J!'-it p«rfor« r..t:rf<.":il'"f.'l a~ frsll unjnst.all unln!'-it~ll of of thí? tht:- applicatixjr. ar;-¡lir.atifl.r., WAkfí. WARfH.tXi; T~hwill \Villr« 1"'~ [2811-12-8? p.9ll uninstali t.l'lim.t<.\U ct^.exasspiíf,androíd.apis' c
.11

13 ~ 42~14

c.~J:u:d~ci ·:

Es porque ya existe existe una una aplicación aplicación con con el el mismo mismo nombre nombre de de paquete paquete (com. example. andró id. apis). Además, (com.examp/e.android.apis). Además, ha ha detectado detectado que que la la aplicación aplicación ha hasido sidofirmada firmada con un certificado digital diferente diferente al al que que estás estás utilizando. utilizando. Se soluciona desinstalando antes antes la la aplicación. aplicación. Tienes Tienes dos dos opciones: opciones: •

Como lo hacemos hacemos con con nuestro nuestro teléfono: teléfono: Ajustes/Aplicaciones/Administar Ajustes/Aplicaciones/Administar Aplicaciones/ApiDemos/Des instalar. Aplicaciones/ApiDemos/Desinstalar.

• Desde la línea de comando: Adh adb uninstall uninstal l com.example.android.apis. com. example. android. apis. Este problema aparece cuando se se ejecuta ejecuta ApiDemos ApiDemos en en un un dispositivo dispositivo donde dondeya yaestá está instalado. También si instalado. si hemos hemos ejecutado ejecutado una una aplicación aplicación en en nuestro nuestro teléfono teléfono yy El nuevo nuevo entorno entorno utiliza utiliza un un certificado certificado digital digital cambiamos de entorno de desarrollo. desarrollo. El diferente por lo que no permite permite remplazaría. remplazar/o.

1.12. 1.12. Depurar Depurar 1.12.1.

Depurar Depurar con con Eclipse Eclipse

El plug-in de de Android Android para para Eclipse Eclipse tiene tiene una una excelente excelente integración integración con con elel depurador de de Eclipse. Eclipse. Introduce Introduce un un error error en en tu tu código código modificando modificando elel código códigofuente fuente de HolaMundo Holat,lundo para que tenga tenga este este aspecto: aspecto:

57

El gran libro de Android publ ic class HolaMundo EolaMundo extends exte n ds Activ ity {{ public Activity /** Called when the activity is first created. */ wherl ac=tivity

@0verride

@Ov~:::rr.id~:::

publ í c void vo i d onCreate(Bundle savedlnstanceState) savedinstanceState) public ssuper.onCreate(savedlnstanceState); u per .onCreate(savedlns t anceState); Object Ob j ect oo == nuil; n ull; o. toStdng í); () ; o.toString setContentView(R.layout setContentView (R . layout.. main); rnain) ;

{

} 1 Este cambio introduce un Nui/PointerException NullPointerException en tu código. código. Si ahora ejecutas tu aplicación, te aparecerá esto:

1

1

ii 11 Forcé dose emulador. Pulsa "Force "Forcé clase" cióse" para finalizar la aplicación y cerrar la ventana del emulador. Para averiguar más sobre el error, inserta unn punto de ruptura (breakpoint) en el código fuente en la línea Object o = null; (el breakpoint se introduce haciendo = nuil; doble clic en la barra de la izquierda). izquierda). Entonces selecciona Run 1 / Debug History 1/ Ho/aMundo debug. Tu aplicación se reiniciará en el emulador, emulador, HolaMundo para entrar en modo debug. pero esta vez quedará suspendida cuando alcance el punto de ruptura que se ha introducido. introducido. Entonces puedes recorrer el código en modo Debug, Debug, igual que se haría en cualquier otro entorno de programación. programación.

1.12.2.

Depurar con mensajes Log

La clase Log proporciona un mecanismo para depurar nuestros programas o para verificar el funcionamiento de los objetos que estamos utilizando. utilizando. Disponemos de continuación: varios tipos de mensajes tal y como se muestra a continuación: Errors. Errors. Warnings. Warnings. Log. i i o: { l: lnformation. Information. Log . d () : Debugging. Log.dí): Debugging. Log v (): () : Verbose. Verbose. Log.. v Log. (l : Log.ee ():

Log.. w w {); Log () :

Ejercicio paso a paso: Depurar con mensajes Log. Log.

58

Visión general yy entorno de de desarrollo desarrollo 1.

clase HoiaMundo Holal'lundo introduciendo introduciendo lala línea línea que que aparece aparece en en Modifica la clase negrita: negrita: public clasa class HolaMundo Holafvlundo extends extends Activity Activity {{ / ** Called when the activity activity is is first first created. c reated. */ *Í /**

SOverride public void onCreate(Bundle onCreate \Bundle savedlnstanceState) savedinstanceState ) { Log.d("HolaMundo","Entramos Log . d (" HolaMundo" , "Entramos en en onCreate"); onCreate"} ; super .onCreate(savedinstanceState); super.onCreate(savedlnstanceState); Object o == nuil; null ; o. toStr.i.ng {) ; o.toStringO setContentView(R.layout.mai n) ; setContentView(R.layout. rnain);

2.

} } Ejecuta la la aplicación. aplicación. Aparecerá Aparecerá un un error. error. de Log Log desde desde Eclipse Eclipse accede accede al al menú menú Window Window/1Show Show Para ver el fichero de View 1 ... /1 Android Android /1 LogCat. LogCat. / Others Others...

S3

^ Prep^s

(2) ® Q © © j t

............................................................................................................................................

pid !í Ti*e Ti-..e pid !··¿03—0$ ::.:.::)·:;! . 29.0€-$S ::;i. ~1[ ·;~. ÚU ,; ~~, {:¡¡;¡ «SO C3··1S 20.06 :1.;)f·S5 i':'<-1 S:::J i : C3--0S 55 6^4 060 ¡ 03-00 Z0 ?CI Olí; :w _00 ts í'M n:HI 300 r,l-;l!l' :'JS ;s 694 f.s.t OSO l:lisf' ij 0306 20l ;l 08.55 d.OE: 55 SS {Id CJ---:)3 20:0fc i: 03—08 600 ¡ ^ F~@*····g'''··:Z.:y ~J-ot:

~-~'4.

:;'}4

t

tag tag d.?.· Andtrj'idS-Jíit AndroidRunt i!*e tedroidSunttMS .\r.dl·::·i·:l!l:Jt&!llt!;' áodroidíhi&tixe l> ü.ds. o~

J.:.~ J..~'f'

l.::dr-~:;.dr;~m:t i.::~
A~dr;.~idR>~.r: ~ ~ :ac~

~~-T---·.-.,,... .-~w;?

-

-

Hessage

I tty • J.ang. Ku • 3 Pointftr'fixc.s-pr. ion cctóe. >Ufaplia. hcie&udx.'c:id caiCt-axtaí jioiaAiuiit; ,:,¡;_,;¡_:·oli1 ep-p e¡:-:;: 1natrua«ntation.ceil&ctivityOaCractsiíastr •. android >t iiii&raxá rtpp Áct iwitvThrswJ j>«; £oY»I.*ur:!".¿iAc;t». vliyí^Ovív

.~~ <..."'t.'J!< (:''M~t;~• lt:• h:,.·,l::.t.n.ü•)·,.~ J.cl~J..:;..,to~.·~~d ~.;.:..Cl'!$l.~..,(i.ci.:.Ju."'..h··~-:

In~!:.r:Jz...e:-:•.~. :lor

:!!:

ce1lt.ct:•nt9"0:~Croee.r.eo:I:l5t:­

.\\."JT?,r.,.....d ¡....-,¡ {l.'!'l:l..'S.U!':Uo!<.-.~~·~i.Lj,o'(4\c.;.~·~

· , -··-·------m.

-

....

-

•, ••,•,o•.o•.mw.o•.w.~.······•'•'''•'•"•" " ,~----., ''' • • . , , ,.,.,.,,.,.,.•

-~-,.,.,.,,._.._,.,,,·,·.····y··,·,·.·,w¡:¡;•i

LogCat puede utilizarse utilizarse para para detectar detectar errores errores oo problemas problemas en en elel código. código.

Por ejemplo, si no tenemos muy muy claro claro qué qué parte parte del del código código causó causó elel error error del ejemplo anterior, anterior, podemos podemos buscar buscar el el último último error error yy ver ver cuál cuál fue fue lala En el el siguiente siguiente cuadro cuadro se se llamada de nuestro nuestro código código que que lo lo generó. generó. En muestra como el error error lo lo ha ha ocasionado ocasionado "holaAndroid.java:10". "holaAndroid.java:10".

59

CAPÍTULO 2. CAPÍTULO 2.

Diseño de la la interfaz interfaz de de usuario: usuario: Diseño de Vistas y Layouts Layouts Vistas y

El diseño de de la interfaz interfaz de de usuario usuario cobra cobra cada cada día día más más importancia importancia en en elel desarrollo desarrollo de una aplicación. aplicación. La La calidad calidad de de la la interfaz interfaz de de usuario usuario puede puede ser ser uno uno de de los los factores que conduzca conduzca el el proyecto proyecto al al éxito éxito oo al al fracaso. fracaso. Si has realizado alguna alguna aplicación aplicación utilizando utilizando otras otras plataformas, plataformas, advertirás advertirás que que el diseño de la interfaz interfaz de de usuario usuario en en Android Android sigue sigue una una filosofía filosofía muy muy diferente. diferente.En En Android la interfaz de de usuario usuario no no se se diseña diseña en en código, código, sino sino utilizando utilizando un un lenguaje lenguaje HTML. de marcado similar al HTML. A lo largo de este capítulo capítulo mostraremos mostraremos una una serie serie de de ejemplos ejemplos que que te te permitirán permitirán entender el diseño de de la la interfaz interfaz de de usuario usuario en en Android. Android. Aunque Aunque no no será será lala forma forma habitual de trabajar, trabajar, comenzaremos comenzaremos creando creando el el interfaz interfaz de de usuario usuario mediante mediantecódigo. código. De esta forma comprobaremos comprobaremos como como cada cada uno uno de de los los elementos elementos del del interfaz interfaz de de usuario (vistas) realmente realmente son son objetos objetos Java. Java. Continuaremos Continuaremos mostrando mostrando cómo cómo se se de usuario usuario utilizando utilizando código código XML. XML. Pasaremos Pasaremos luego luego aa ver ver las las define el interfaz de herramientas de diseño diseño integradas integradas en en Eclipse. Eclipse. Se Se describirá describirá elel uso uso de de Layouts Layoutsque que nos permitirá una correcta correcta organización organización de de las las vistas vistas yy como como elel uso uso de de recursos recursos alternativos nos nos permitirá permitirá adaptar adaptar nuestra nuestra interfaz interfaz aa diferentes diferentes circunstancias circunstanciasyytipos tipos este capítulo capítulo también también comenzaremos comenzaremos creando creando lala aplicación aplicación de de de dispositivos. dispositivos. En este ejemplo desarrollada desarrollada aa lo lo largo largo del del curso, curso, Asteroides. Asteroides. Crearemos Crearemos lala actividad actividad principal, donde simplemente simplemente mostraremos mostraremos cuatro cuatro botones, botones, uno uno de de los los cuales cuales arrancará una segunda segunda actividad actividad para para mostrar mostrar una una caja caja Acerca Acerca de... de... AA continuación, continuación, estilos yy temas temas yy los los aplicaremos aplicaremos aa estas estas actividades. actividades. Para Para aprenderemos aa crear crear estilos terminar el capítulo, capítulo, propondremos propondremos varias varias prácticas prácticas para para aprender aprender aa utilizar utilizar diferentes tipos de vistas vistas yy Layouts. Layouts.

~Objetivos: Objetivos:

•

se realiza realiza el el diseño diseño del del interfaz interfaz de de usuario usuario en en una una Describir cómo se aplicación Android. Android.

61

El gran libro de Android •

mostrar sus sus atributos atributos más más importantes. importantes. Aprender a trabajar con vistas yy mostrar

•

de Layouts que que nos nos permitirán permitirán organizar organizar las las vistas. vistas. Enumerar los tipos de

•

recursos alternativos. alternativos. Mostrar cómo se utilizan los recursos

•

Aprenderemos a crear estilos estilos yy temas temas para para personalizar personalizar nuestras nuestras aplicaciones.

•

las vistas vistas desde desde el el código código Java. Java. Mostrar cómo interactuar con las

•

TabLayout. Describir el uso de Tablayout.

2.1. Creación Creación de de una una interfaz interfaz de de usuario usuario por por código código 2.1. Veamos un primer ejemplo de de cómo cómo crear crear una una interfaz interfaz de de usuario usuario utilizando utilizando exclusivamente código. Esta Esta no no es es la la forma forma recomendable recomendable de de trabajar trabajarcon conAndroid, Android, sin embargo resulta interesante para para discutir discutir algunos algunos conceptos. conceptos.

Ejercicio paso a paso: paso. Creación Creación del del interfaz interfaz de de usuario usuario por por código. código. 1.

Abre el proyecto creado en el el capítulo capítulo anterior anterioryy visualiza visualiza Ho/aMundo.java. HolaMundo.java.

2.

Comenta la última sentencia sentencia del del programa programa yy añade añade las las tres tres que que se se muestran a continuación en en negrita: negrita: package com.example.holamundo; com.example.holamundo; import android.app.Activity; android.app.Activity ; import android.os.Bundle android.os.Bundle;; public class HolaMundo extends extends Activity Activity {{ i/** •·• Se llama cuando se crea la Ilam.a se crea la actividad actividad por por primera primera vez. vez. *"/ */ @Ov e rrid e ©Override public void onCreate(Bundle savedinstanceState) savedlnstanceState) { super.onCreate(savedinstanc eState); super.onCreate(savedlnstanceState); íisetContentView(R.layout.main); //setContentView (R. layout .tnain) ; TextView texto= texto = new TextView(this); TextView(this); texto.setText(" Hello, texto.setText("Helio, Android"); Android"); setContentView(texto);

} }

~t

.c;;;""'r""'~ Nota sobre Java: Para poder poder utilizar utilizar el el objeto objeto TexView TexView has has de de importar importar un un nuevo paquete, para ello añade id. widge t . añade al al principio principio import import andro android. widget. TextView;. Otra alternativa es es pulsar pulsar Ctrl-Shift-0, Ctrl-Shift-O, para para que que se se añadan añadan automáticamente los paquetes que faltan. faltan

62

Diseño de la interfaz intertaz de usuario: Vistas y y Layouts La interfaz de usuario de Android está basada en una jerarquía de objetos descendientes de la clase view (vista). (vista). Una vista es un objeto que se puede dibujar y se utiliza como un elemento en el diseño de la interfaz de usuario (un botón, una imagen, una etiqueta de texto como el utilizado en el ejemplo, ... ). Cada uno de estos elementos se define como una subclase de ejemplo,...). la clase vtew; view; la subclase para representar un texto es Textview.

Textview. El ejemplo comienza creando un objeto de la clase Textv t ew. El constructor de la clase acepta como parámetro una instancia de la clase context context (contexto). (contexto). Un contexto es un manejador del sistema que proporciona servicios como la resolución de recursos, obtención de acceso a bases de datos o preferencias. preferencias. La clase Activity es una subclase de context, Context, y como la clase HelloAndroid es una subclase de Activity, también es tipo context. Por ello, puedes pasar this (el objeto actual de la clase HolaMundo} HolaMundo) como contexto del TextView. Textview. Después se define el contenido del texto que se visualizará en el TextView Textview mediante setText (CharSequence). (charsequence). Finalmente, mediante setContentView setcontentview () {) se indica la vista utilizada por la actividad.

3.

Ejecuta el proyecto para verificar que funciona.

2.2. 2.2. Creación Creación de de una una inteñaz interfaz de de usuario usuario usando usando XML XML En el ejemplo anterior hemos creado la interfaz de usuario directamente en el código. código. A veces puede ser muy complicado programar interfaces de usuario, ya que pequeños cambios en el diseño pueden corresponder a complicadas modificaciones en el código. código. Un principio importante en el diseño de software es que conviene separar todo lo posible el diseño, diseño, los datos y la lógica de la aplicación. aplicación. Android proporciona una alternativa para el diseño de interfaces de usuario: los ficheros de diseño basados en XML. Veamos uno de estos ficheros. Para ello res/layout/main.xml de nuestro proyecto. Se muestra a accede al fichero res/layoutlmain.xml continuación. continuación. Este layout o fichero de diseño proporciona un resultado similar al del ejemplo de diseño por código anterior:

<"?xml version=".7 . . 0 " encoding=" u t: f-8 ""?>
andruid:orientation=" ver~ical "

android: llayout_width= a y o ut _ width= ""fiH_parent" Lill_pa.rent; " android: llayout_height= a yout_ h e ight = •" fi f.i 1.2_parent .1..1_ parent: ""> >

text:::: '' Ct}st:ring/ flello "í > c/LinearLayouts

63

El gran libro de Android Resulta sencillo interpretar su su significado. significado. Se Se introduce introduce un un elemento elemento de de tipo tipo LinearLayout.; LinearLayout; como se estudiará estudiará más más adelante adelante su su función función es es contener contener otros otros elementos de tipo view. Este LinearLayout LinearLayout tiene tiene cuatro cuatro atributos. atributos. El El primero, primero, xmlns: xmins: android, es una declaración declaración de de un un espacio espacio de de nombres nombres de de XML XML que que

utilizaremos en Android (este (este parámetro parámetro solo solo es es necesario necesario especificarlo especificarlo en en elel atributo indica indica que que los los elementos elementos se se van van aa distribuir distribuir primer elemento). El siguiente atributo siguientes permiten permiten definir definir el el ancho ancho yy alto alto de de lala vista. vista. En En de forma vertical. Los dos siguientes el ejemplo se ocupará todo el el espacio espacio disponible. disponible. Dentro del LinearLayout solo tenemos tenemos un un elemento elemento de de tipo tipo TextView. Textview. Este Este dispone de tres atributos. Los Los dos dos primeros primeros definen definen el el ancho ancho yy alto. alto. El El último último indica indica el texto a mostrar. No se ha ha indicado indicado un un texto texto en en concreto concreto sisi no no una una referencia, referencia, "@string/heiio". Esta referencia referencia ha ha de de estar estar definida definida en en elel fichero fichero "@string/hello". reslvalueslstrings.xml. resA/alues/strings.xml. Si abres abres este este fichero, fichero, tienes tienes el el siguiente siguiente contenido: contenido:

cstring ">Hello World, laMundo! c/string> Hello World, Ho HolaMundo! Ho l a , Mundo< ist:r.~j_ng> Hola, Mundo 1

11

11

11

11

Esta es la práctica recomendada en en Android Android para para la la inserción inserción de de textos textos en en tu tu aplicación, dado que facilita su su localización localización aa la la hora hora de de realizar realizar lala traducción traducción aa otros idiomas. idiomas. Es decir, utilizaremos utilizaremos los los ficheros ficheros layout layout para para introducir introducir el el diseño diseñode de los interfaces y el fichero strings strings para para introducir introducir los los textos textos utilizados utilizados en en los los distintos distintos idiomas. idiomas.

Ejercicio paso a paso: Creación Creación del del interfaz interfaz de de usuario usuario con con W**

X ML. XML

1.

Para utilizar el diseño diseño en en XML XML regresa regresa al al fichero fichero HolaMundo.java HolaMundo.java yy antes (elimina (elimina las las tres tres últimas últimas líneas líneas yy deshaz los cambios que hicimos antes quita el comentario).

2.

Ejecuta la aplicación yy verifica verifica el el resultado. resultado. Ha Ha de de ser ser muy muy similar similar alal anterior. anterior,

3.

Modifica algún valor del fichero fichero res/va/ueslstrings.xml. res/vatues/strings.xmi

4.

Vuelve a ejecutar la aplicación aplicación yy visualiza visualiza el el resultado. resultado. Analicemos ahora la línea en la que que acabas acabas de de quitar quitar el el comentario: comentario; setContentView(R . layout . main); setContentViewÍR.layout.main);

Aquí, main corresponde a Aquí, R.layout. r.layout.main a un un objeto objeto v.iew view que que será será creado creado en en tiempo tiempo de ejecución a partir del recurso recurso main.xml. main.xml. Trabajar Trabajar de de esta esta forma, forma, en en comparación comparación no quita quita velocidad velocidad yy requiere requiere menos menos espacio. espacio. El El p/ugplugcon el diseño basado en código, no in In de Eclipse crea automáticamente esta esta referencia referencia en en la la clase clase Rr del del proyecto proyecto aa partir partir de todos los elementos de la la carpeta carpeta res. res. Abre Abre el el fichero fichero llamado llamado gen/R.java. gen/R.java. Este Este fichero será similar al que se se muestra muestra aa continuación: continuación:

64

Diseño de la interfaz de de usuario: usuario; Vistas Vistas yy Layouts Layouts com.example.holamundo; package corn. exampl e. holamundo; public final final class class RR {{ public static final final class class attr attr {{

}} public static final final class class drawable drawable { public static final final int int i.con=Ox7f020000 icor¡=0x7f020000;;

} final class class layou layout public static final t {{ public static final final int int main=Ox7f030000; ínain-0x7f030000; } public static final final class class string string {{ public static final final int int app_narne=Ox7f040001; app_name=0x7f040001; final int int he1.1o=Ox7f040000; i-ieilo=0x7f040000; public static final

fichero se se genera genera automáticamente. automáticamente. Nunca Nunca debes debes editarlo editarlo de de forma forma NOTA: Este fichero manual. claro que que las las referencias referencias de de lala clase clase Rr son son meros merosnúmeros númerosque que Has de tener claro informan al gestor de de recursos, recursos, que que datos datos ha ha de de cargar. cargar. Por Porlolotanto tantono nose setrata tratade de verdaderos objetos, objetos, estos estos serán serán creados creados en en tiempo tiempo de de ejecución ejecuciónsolo solocuando cuandosea sea necesario usarlos.

Ejercicio paso aa paso: paso: El E/ fichero fichero R.java. R.java. 1.

llamado gen/R.java gen/R.java de de tu tu aplicación. aplicación. Abre el fichero llamado

2.

fichero mostrado mostrado previamente. previamente. ¿Qué ¿Qué diferencias diferencias Compáralo con el fichero encuentras?

3.

HolaMundo.java yy reemplaza reemplaza R.layout r . layout.. main mainpor porelelvalor valor Abre el fichero Ho/aMundo.java numérico al que corresponde corresponde en en R.java. R.java.

4.

nuevo el el proyecto. proyecto. ¿Funciona? ¿Funciona? ¿Crees ¿Crees que que sería sería adecuado adecuado Ejecuta de nuevo numérico? dejar este valor numérico?

5.

puede cambiar cambiar en en un un futuro. futuro. Por Por lolo tanto, tanto, para para evitar evitar Este valor puede vuelve aa remplazarlo remplazado por por R. r.layout layout. .main. main . problemas futuros vuelve

.-...

"1Téjs'J. 7 -'".-

11,1 Poii[Media]: Un primer proyecto Android.

Poli[Media]: Un primer proyecto Android.

Preguntas de repaso repaso yy reflexión: reflexión; Diseño Diseño del delinterfaz interfazde de usuario yy el fichero fichero R.java. R.java.

65

El gran libro de Android visual de de las las vistas vistas 2.2.1. Edición visual editar los los layouts layouts oo ficheros ficheros de de diseño diseño en en XML. XML. En En elel Veamos ahora como editar paquetes abre abre el el fichero fichero resl/ayoutlmain.xml. res/layout/main.xml. Verás Verásque queen enlalaparte parte explorador de paquetes central aparecen aparecen dos dos lengüetas: lengüetas: Layout Layoutyy main.xml. main.xml. ElElplugpluginferior de la ventana central permite dos dos tipos tipos de de diseño: diseño: editar editar directamente directamente elel código códigoXML XML in de Android te permite main.xml) oo realizar realizar este este diseño diseño de de forma forma visual visual (lengüeta (lengüeta Grafícal Gráfica! (lengüeta maín.xml) Layout). Layout). Veamos cómo se se realizaría realizaría el el diseño diseño visual: visual: ¿ mAir> x/rt < j lócate ▼ i j Androjc Editing corftg: cefauft i.lm WV5A tNexus ▼ Portfí » iNoD> ▼ ÜayU ▼jTheme i : Palette U? fwm Wtdgeli

▼ C reata».

tid Linear! ayo ut al TextView - Helio

Ú 'ext D Layouts ^3 Compoaáte Qj Image-í & yj Time & Date LJ Tfansitiofts LJ Advanced Custom & litwary Views ProMems | # Javadoc i ^ Declaration; © Consots: Q Devices Property Véíue ■a g Tflt @stnng/hc:ic T ut appea1anct ~ext appearancf ------ · Tetó color rert··,~h>~ ---·- - - - · - ··

se visualiza visualiza una una lista lista con con todos todos los los elementos elementosde delalavista. vista. En el marco derecho se ha incluido incluido un un listado listado con con las las vistas vistas disponibles. disponibles. En En este este En el anexo 8B se ha momento solo hay dos: un un r,inearr..ayout LinearLayout que que contiene contiene un un Text.View. Textview. En Enelelmarco marco central aparece una una representación representación de de cómo cómo se se verá verá elel resultado. resultado. En En lala parte parte varios controles controles para para representar representar esta esta vista vista en en diferentes diferentes superior aparecen varios Cuando diseñamos diseñamos una una vista vista en en Android, Android. hay hay que que tener tener en en configuraciones. Cuando cuenta que desconocemos desconocemos el el dispositivo dispositivo final final donde donde será será visualizada visualizada yy lala específica elegida elegida por por el el usuario. usuario. Por Por esta esta razón razón,, resulta resultaimportante importante configuración específica que verifiques que la la vista vista se se ve ve de de forma forma adecuada adecuada en en cualquier cualquier configuración. configuración. Podemos seleccionar la la configuración configuración regional regional (loca/e}, (lócale), lala versión versión de de Android Android utilizada, el tamaño en en pulgadas pulgadas yy lala resolución resolución del del dispositivo, dispositivo, orientación orientación horizontal (lanscape) (lanscape) oo vertical vertical (portraít}, (portralt), configuración configuración de de utilización utilización (escritorio (escritoriooo automóvil), configuración configuración según según la la hora hora del del día día (diurna (diurna oonocturna) nocturna)yycómo cómose severá verá automóvil}, aplicar un un tema. tema. nuestra vista tras aplicar Para editar un elemento elemento selecciónalo selecciónalo en en el el marco marco de de laladerecha derechayypincha pinchasobre sobre él en la ventana de de previsualización. previsualización. Al Al seleccionarlo seleccionarlo puedes puedes modificar modificaralguna algunade de

66

Diseño de la interfaz de usuario: Vistas y Layouts sus propiedades en el marco que aparece en la parte inferior. inferior. Si este marco no está visible, visible, pulsa con el botón derecho sobre el elemento en el marco de la derecha y seleccionas Properties, aparecerá el marco en la parte inferior con la lista de propiedades. Para activar esta vista accede al menú Windows W/ndows > Show View > Others ... .. > General > Properties. Dele un vistazo a las propiedades disponibles para TextView TextVIew y modifica alguna de ellas. En muchos casos te aparecerá un desplegable con las opciones disponibles. El marco de la izquierda te permite insertar de forma rápida nuevos elementos a la vista. Puedes arrastrar cualquier elemento a la ventana de previsualización o al marco Outline. Outline.

Ejercicio paso a paso: Creación visual de Vistas. 1.

Crea un nuevo proyecto con nombre PrimerasVistas. PrimerasVistas. Selecciona la versión 1.6 e introduce org. example exampie.. primerasvistas en Package name. ñame.

2.

Abre el fichero res/layoutlmain.xml. res/layout/main.xml.

3.

Desde la paleta de la izquierda arrastra los siguientes elementos: TroggleButton, CheckBox, ProgressBar y RatingBar.

4.

Selecciona la primera vista que estaba ya creada (Textview) y pulsa el botón para eliminarla. eliminarla.

5.

Set Horizontal Orientation) para conseguir Pulsa el primer botón lll.l QH ((Set que el LinerLayout r..inerr..ayout donde están las diferentes vistas tenga una orientación horizontal. Comprobarás que no caben todos los elementos. elementos.

6.

Pulsa el siguiente botón S 623 (Set Vertical Orientation) para volver a una orientación vertical.

7.

Selecciona la vista TroggleButton. Pulsa el botón siguiente al que acabamos de utilizar (Trodgle Fi/1 FUI Width). Wldth). Conseguirás que el ancho del botón se ajuste al ancho de su contenedor.

8.

Pulsa el botón siguiente (Trodgle Fi/1 FUI Height). Conseguirás que el alto del botón se ajuste al alto de su contenedor. El problema es que el resto de elementos dejan de verse. verse. Vuelve a pulsar este botón para regresar a la configuración anterior (también puedes pulsar Ctrf-Z). Ctrl-Z).

9.

Selecciona la vista CheckBox. CheckBox. Pulsa el botón siguiente al que acabamos ...). Conseguirás que el ancho del botón se de utilizar (Change Margins Margins...). ajuste al ancho de su contenedor. En la entrada Al/ All introduce "20px".

10. 10. Pulsa el botón siguiente (Change Gravity) Gravlty) y selecciona Center Horizontal.

11. Observa como hay un espacio sin usar en la parte inferior del Layout.

El gran libro de Android Es equivalente a poner Layout Weights =1 para todas las vistas de este Layout. Esta propiedad será modificada en el siguiente punto. Layout. 12. Pulsa el botón siguiente (Change (Changa Layout Weights) e introduce el valor 2. 2. Selecciona la vista TroggieButton Tros;gleButton y usando este mismo botón, introduce el valor 0.5. 0.5. Selecciona la vista ProgressBar e introduce el valor 4. 4. Como puedes observar estos pesos permiten ajustar la altura de las vistas.

ÍX 'ii 13. Utiliza los siguientes botones ®,. ~ ~

1

Et

~ para ajustar el zoom. zoom.

14. Utiliza los botones de la barra superior para observar cómo se representará el Layout en diferentes circunstancias: circunstancias:

jportfait ▼ ¡No Dock *

[sJin VWGA(NexusOm

Theme

El primer desplegable permite escoger entre diferentes tamaños de resolución. El siguiente visualiza en vista vertical (Portrait) u pantalla 1/ resolución. horizontal (Landscape). Los dos siguientes permiten definir diferentes modos de visualización (Card Dock significa que esta activado el modo automóvil y Nigth time el modo noche). noche). Estos modos están disponibles a partir de (a la versión 2.2. 2.2. El último desplegable permite ver cómo quedaría el Layout tras aplicar un tema. tema. 15. Si no está visible la vista de Eclipse Propiedades, actívala utilizando el menú Ventana/Mostrar Vista/Otras..../General/Propiedades. .!General/Propiedades. 16. Selecciona la vista checkBox CheckBox y observa las diferentes propiedades que podemos definir. definir. Algunas ya han sido definidas por medio de la barra de botones. botones. En concreto, y siguiendo el mismo orden que en los botones, hemos modificado: content, Layout height = = modificado: Layout width= wrap contení, wrap_content, wrap_content, Layout margin = 20px, Layout gravity = center_horizontal y Layout weights =2. -2. 17. Busca la propiedad Text ye el valor "CheckBox" por "Guardar Texf y sustit sustituye size por "9pt". automáticamente" y Text Texf s/ze 18. El resultado final obtenido se muestra a continuación: continuación:

OK:Ouar
|" ¥

4^ ■

Layouts Vistas yyLayouts Diseño de la interfaz usuario: Vistas de usuario: interfaz de Pulsa "main.xmf'.Pulsa nombre"main.xmt'. con nombre inferior con parte inferior la parte de la lengüeta de 19. Pulsa sobre la lengüeta XML. código XML. adecuadamente elel código formatee adecuadamente que formatee para que Shift-Ctr/-F para las teclas Shiñ-Ctri-F continuación. muestra aa continuación. Este código se muestra encoding= Utf-8 "?> v e rsion=""J1.0 .ica.l"> t l'f~.r." ientation= r android:o androi.d:layout._weight.=" android:layout_weight="0.5"/> android:text.Size android: textSize== ".9pt"/> weight=""4"/> android:layou t _weight= android:layout (9+ i d./rat in f-¡Barl "0.5 "/'> t _weight android:layou android: layout_ weight== "0.5 >
Ir

ll

11

11

11

resultado. el resultado. ver el para ver proyecto para 20. Ejecuta el proyecto 20.

texto. de texto. entrada de de entrada Vistas de paso: Vistas Ejercicio paso aa paso: 1. 1.

entrada tipo entrada de tipo Añade en la parte vista de una vista anterior una Layout anterior del Layout superior del parte superior de una de esta una de esta Debajo de Plain) . Debajo (Text Plain). normal (Text tipo normal de tipo EditText , de de texto EditText, palabra tipo palabra de tipo una de de una seguida de Name) seguida (Person Ñame) tipo nombre yy apellido (Person texto. detexto. entradas de de entradas tipos de otros tipos con otros así con Continua así secreta (Password). Continua

2.

Ejecuta la aplicación. aplicación.

3.

tipo un tipo mostrará un se mostrará entrada se una entrada de una texto de el texto introducir el al introducir Observa, como al diferente. de teclado diferente.

69

El gran libro de Android

Recursos adicionales: adicionales; Tipos Tipos de de vista vista yy sus sus atributos. atributos. Consulta el Anexo 8B para para conocer conocer una una lista lista con con todos todos los los descendientes descendientesde delala clase Vi ew y sus atributos. view atributos.

Preguntas de repaso repaso yy reflexión: reflexión: Las Las vistas vistas yysus susatributos. atributos.

2.3. 2.3. Layouts Layouts Si queremos combinar varios varios elementos elementos de de tipo tipo vista vista tendremos tendremos que que utilizar utilizarun un Un Layout Layout es es un un contenedor contenedor de de una una oo más másvistas vistasyycontrola controla objeto de tipo Layout. Un su comportamiento y posición. posición. Hay Hay que que destacar destacar que que un un Layout Layoutpuede puedecontener conteneraa otro Layout y que es es un un descendiente descendiente de de lala clase clase View. View. La La siguiente siguientelista listadescribe describe los Layout más utilizados utilizados en en Android: Android:

LinearLayout LinearLayout. Dispone Dispone los los elementos elementos en en una una fila fila oo en en una unacolumna. columna. Tab/eLayout TableLayout: Distribuye Distribuye los los elementos elementos de de forma forma tabular. tabular. RelativeLayout: RelativeLayout. Dispone Dispone los los elementos elementos en en relación relación aa otro otroooalalpadre. padre. AbsoluteLayout: Posiciona Posiciona los los elementos elementos de de forma forma absoluta. absoluta. FrameLayout FrameLayout. Permite Permite el el cambio cambio dinámico dinámico de de los los elementos elementosque quecontiene. contiene.

vale más más que que mil mil palabras, palabras, pasemos pasemosaa mostrar mostrarcada cadauno uno Dado que un ejemplo vale en acción. acción. de estos layouts en LinearLayout es el layout layout más más utilizado utilizado en en la la práctica. práctica. Distribuye Distribuyelos loselementos elementos uno detrás de otro, bien bien de de forma forma horizontal horizontal oo verticaL vertical.
android : layout___.width= " wrap_conten t • android: layout_ height= "WT d P .... conten t " /> android:layout_height="wrap_content"/> l> texto cu.a.l.c¡u.i cualquiera 11



70

Br

Diseño de la interfaz interfaz de de usuario: usuario: Vistas Vistas yy Layouts Layouts TableLayout distribuye los los elementos elementos de de forma forma tabular. tabular. Se Se utiliza utiliza lala etiqueta etiqueta TableRow cada vez que que queremos queremos insertar insertar una una nueva nueva línea. línea. "> android; layout_width= ¡,



Un checkBox|

N

.:Ana.logC l o ck «ñnalogClock

I

android: layout_width= "wrap_content" ;.n:ap_ contenc: " android:layout_width=" android: layout_height= "rtv·ra_p_content " /> android:layout_height="wrap_content"/>

5 :

< Ch.eckBox «CheckBox

í i IJi

android: layout_width= layout_vJidth= "wrap_._conl:ent" ";vraP.....content " android: layout_height= " wraP.....conU!nt " android:layout_height="wrap_content" android: text= " Un checkBox"/> checkFJo.x " /> android:text="Un

}Jotón " /> android:text="Un
"

Un texto cualquiera ,

•

-

.

1

v,

d,.

L/V-

android:t.ext:;:;" Un texto ttxto cualquiera"/> cualq-uiera " /> android:text="Un

RelativeLayout permite Re/ativeLayout permite comenzar comenzar aa situar situar los los elementos elementos en en cualquiera cualquiera de de los los cuatro lados del contenedor contenedor ee irir añadiendo añadiendo nuevos nuevos elementos elementos pegados pegadosaaestos. estos.
xmlns: android= "http://scheinas. rr h t tp : l/schemas . .. .. xmlns;android= android: layout._heiqht= " fill_oarent android:layout ,_height= "fiil _parent"" android:layout ,_width= "íi android: layout_width= " f i 1l ll_„parent ....Pc1Tent "> ">

android:layout alignParentTop="true"/>

Un checkBox"/>

I


aandroid:id="@+ n dro i d: id= " (iJ.+ íd/Button0. 1' id/ButtcnOl" andr oid: layo ut _width="wrap_content" width= "tvrap_ conc:ent" android:layout andr·oid: layout)leight= " :vrap_cont:ent android:layout _height="wrap_cont ent"" andro id:text="" Un botón" .i:Jot6n/l android:text=

I

1

android : layout__below="@+id/CheckBoxOl"/> below="@+íd/CheckBox01" /> android:layout

. i» •■

,


71

El gran libro de Android andro.id: layout_he.ight.= " <,;r.ap .. content" android:Iayout_height-"wrap_content" android:layout alignParentBottom»"true" and roid : layou t .....alignParentBot tom= "true" android: text = " Un t:f}Xto i era " l> android:text»"Un texto cua.!.qu cualguiera"/>

AbsoluteLayout permite indicar indicar las las coordenadas coordenadas (x,y) (x,y) donde donde quE>remos queremosque quese se visualice cada elemento.

·' android; layout__width= "fill_parent <:AnalogClock android:layout_y="50px"/> <:CheckBox android: layout....Y= "50px" /> nalogClock cAnalogClock android: layout .....widt h= *wrap_content" "w·ra_p _ content:·" android:layout_width= andro id : layout_height= layout_ height= "wrap__conten "t•irap___ccmten "/> "/> android: 11

ÜflC ck£ox !-

checkBox " /> android;text="Un < Textvi. ~:::w
l > '

~

'

l

it

'

••

; cattíiíí; H 0« 1

2.

Utiliza un TabieLayout TableLayout para realizar un diseño similar al siguiente: siguiente:

1 I 2

3.

4 I 5

6

7 18

9

Utiliza un AbsoluteLayout para realizar un diseño similar al siguiente. siguiente. Ojo, Ojo, AbsoluteLayout lo encontrarás en la paleta Advanced y no en la de Layouts. Trata de reutilizar el Layout creado en el punto anterior. anterior.

BBBg

74

4.

Visualiza el resultado obtenido en el punto anterior en diferentes tamaños de pantalla. ¿Ha sido una buena idea usar AbsoluteLayout? ¿Se te ocurre otra forma de realizar este diseño de forma que se visualice correctamente en cualquier tipo de pantalla?

5. 5.

Trata de hacer el ejercicio anterior utilizando LinearLayout.

6. 6.

Visualiza el resultado obtenido en diferentes tamaños de pantalla. pantalla. ¿Has resuelto el problema?

Diseño de la interfaz ínterfaz de usuario: Vistas yy Layouts

e

Preguntas de repaso y reflexión: Los Layouts. Layouts.

Enlaces de interés: • Helio, Views: Views\ Colección de sencillos tutoriales para practicar con diferentes tipos de vistas: (http://developer.android.com/resources/tutorials/views/index.html) • Common Layout Objects: Objects: Descripción de los tipo de Layouts más importantes. importantes. (http://developer.android.com/guide/topics/ui/layout-objects.html) (http://developer.android.com/auide/topics/ui/lavout-obiects.html)

También podemos utilizar otras clases de Layouts, que son descritas a continuación: continuación: Scroi/View. ScrollView. Visualiza una columna de elementos; cuando estos no caben en pantalla se permite un deslizamiento vertical. Horizonta/Scroi/View. HorizontaIScrollView. Visualiza una fila de elementos; cuando estos no caben en pantalla se permite un deslizamiento horizontal.

a

%

D 1 —~ 1 TabHost TabHost: Proporciona una lista de ventanas seleccionables seleccionadles por medio de etiquetas que pueden ser pulsadas por el usuario para seleccionar la visualizar. Se estudia al ai final del capítulo. capítulo. ventana que desea visualizar. 1

ListView Visualiza una lista deslizable verticalmente de varios elementos. elementos. Su ListView. compleja. Se verá un ejemplo en el capítulo siguiente. utilización es algo compleja. -

Wekome ro Vokin Voícln Weltome to

W. ~ "iGk The Voícln

De hace 190 días \t
89 ,, •rr

••

'

)ose jóse L.

De hace 93 días

• mí

GridView. GridView Visualiza una cuadrícula deslizable de varias filas y varias columnas. columnas.

75

El gran libro de Android

ViewFiipper. ViewFlipper. Permite visualizar una lista de elementos de forma que se visualice uno cada vez. vez. Puede Puede; ser utilizado para intercambiar los elementos cada cierto intervalo de tiempo tiempo.

2.4. Asteroides 2.4. Una Una aplicación aplicación de de ejemplo: ejemplo: Asteroides A lo largo de este libro vamos a ir creando una aplicación de ejemplo que toque Android. Comenzamos en este capítulo creando los aspectos más significativos de Android. una serie de vistas que nos permitirán diseñar un sencillo interfaz de usuario. usuario.

~Práctica: ^

1. I.

Asteroides. Práctica: Creación de la aplicación Asteroides.

datos: Crea un nuevo proyecto con los siguientes datos: Project ñame: name: Asteroides Build Target: Android 1.6 l•pplication hsteroides Application name: ñame: Asteroides Pac kage ñame: name: org.example.asteroides org . exampl e.asteroides Package Create Activity: Asteroides Min SDK Versión: Version: 3

NOTA: En el desarrollo del ejemplo hemos indicado que para poder ejecutar la aplicación necesitamos como versión mínima el SDK 3, correspondiente a la versión 1.5. No obstante, vamos a utilizar la versión del SDK 1. 6, dado que nos proporciona 1.6, ciertos beneficios respecto a versiones anteriores (por ejemplo iconos de la aplicación en diforentes resoluciones). Esto es perfectamente posible, pero hay que tener diferentes resoluciones). precaución de no utilizar ninguna característica que no sea compatible con la versión 1.5. 2.

76

Abre el fichero res/LayouVmain.xml res/Layout/main.xml y trata de crear una vista similar a la que ves a continuación. L.inearLayout que continuación. Ha de estar formada por un MnearLayout contiene un Texview Texvie w y cuatro But.ton. Button. Trata de utilizar recursos para introducir los cinco textos que aparecen. aparecen.

Diseño de la interfaz de usuario: Vistas yy Layouts

Confhjurar

\

Solución: 3. 3,

siguiente: El fichero main.xml ha de ser similar al siguiente: Odip " Odip "/> android:text="@string/Arrancar"/> "(~+-id/But:con 02" android: text= figurar"/ android:text="&string/Acercada"/>

77

El gran libro de Android android:text="Sstring/Salir"/> 1/



4. 4.

contenido: El fichero res/strings.xml ha de tener el siguiente contenido: Jugar Configurar<./s t :ring> Configurar Acerca n a me = "llce:rcad.e " >Acerca de Salir "Bali.r ">Sal i r •tstring name= cstring name="tituloAplicacíon">Asteroides Hello cstring name="he11o ">Hel lo World, Wo rld, Asteroides! Astero ides! c/string > Asteroides <íst:rin9'> Asteroides 11

2.4.1. Recursos alternativos Una aplicación Android va a poder ser ejecutada en una gran variedad de dispositivos. dispositivos. El tamaño de pantalla, pantalla, la resolución o el tipo de entrada puede variar mucho de un dispositivo a otro. Por otra parte, parte, nuestra aplicación ha de estar preparada para diferentes modos de funcionamiento, como el modo automóvil o el modo noche, noche, y para poder ser ejecutada en diferentes idiomas.

A la hora de crear el interfaz de usuario hemos de tener en cuenta todas estas circunstancias. Afortunadamente, Afortunadamente, la plataforma Android nos proporciona una alternativos. herramienta de gran potencia para resolverlo, resolverlo, el uso de los recursos alternativos.

~Práctica:

Asteroides. Práctica: Recursos alternativos en Asteroides,

78

1.

Ejecuta la aplicación creada en el punto anterior en el emulador.

2.

Los teléfonos móviles basados en Android permiten cambiar la configuración en apaisado y en vertical. Para conseguir este efecto con el emulador pulsa Ctri+F11. Ctrl+F11. Si observas el resultado de la vista que acabas de diseñar en vertical no queda todo lo bien que desearíamos. desearíamos.

Diseño de la interfaz interfaz de de usuario: usuario: Vistas Vistas yy Layouts Layouts Para resolver este problema problema Android Android te te permite permite diseñar diseñar una una vista vista la configuración configuración horizontal horizontal yy otra otra para para vertical. vertical. diferente para la 3.

Crea la carpeta res/layout-land. resllayout-land.

4.

Copia en ella el fichero main.xml. main.xml. Para Para ello ello selecciona selecciona el el fichero fichero yy pulsa pulsa la carpeta carpeta destino destino yy pulsa pulsa Ctrl-V. Ctrf- V. Ctri-C. Ctrl-C. Selecciona la

5.

Crea una vista similar similar aa la la que que ves ves aa continuación: continuación: formada formada por por un un LinearLayout que contiene un un TexView TexView yy un un TableLayout TableLayout con con dos dos Button Button por columna. columna.

ii-usrj

Asteroides Wl Configurar '.<ííí' ■m*. ;

6.

la aplicación aplicación yy observa observa como como lala vista vista se se ve ve Ejecuta de de nuevo nuevo la correctamente en las las dos dos orientaciones. orientaciones.

Solución: Has de obtener un código código XML XML similar similar al al siguiente: siguiente: android:padding== "30dip">

<. Text.View "20dip "/> android: layout_marginBot.tom= android:stretchColumns= "* ">
79

El gran libro de Android andr·oid: layout_h eight= "¡,,rap_con/:,-,•n!."" andró id: layout_he.lght= "wrap_coatent" android: layout_width= "f:i ll_oarent:" android;layout_width="fill_parent" android: text = u@st:rin r;_r/Arrancar '' / > android:Cext="@string/Arrancar"/> 1/

<íTable:ROW> <'l'ableROW> @+.iei/Button03 " android:text="&string/Acercade"/> android:text="Qstring/Salir"/>

<íTableLayout.> < / Li nearLayout.> NOTA: Para conseguir en un TableLayo Tablehayout, ut, que las columnas se ajusten a todo el "*". BtretchColumna="0" stretchColwnns= "O" significa que ancho de la tabla poner stretchColwnns= stretchColumna-"*". asigne el ancho sobrante a la primera columna. stretchColumns= stretchColwnns="" 1" significa que asigne el ancho sobrante a la segunda columna. stretchColwnns="*" columna, atret chCol ujnna=" * " significa que asigne el ancho sobrante entre todas las columnas. Android utiliza una lista de sufijos para expresar recursos alternativos. alternativos. Estos sufijos pueden hacer referencia a la orientación del dispositivo, dispositivo, al lenguaje, lenguaje, la región, píxeles, la resolución entrada,... región, la densidad de píxeles, resolución,, el método de entrada,... Por ejemplo, ejemplo, si queremos traducir nuestra aplicación al inglés, inglés, español y francés. defecto, crearíamos tres versiones francés. Siendo el primer idioma el usado por defecto, directorios: del fichero strings.xml y lo guardaríamos en los siguientes tres directorios: res/values/str.i.ngs xml res/values/strings.. xm.1 res /values ---es/ strings .xml res/values-es/strings.xml res/val u es- fr/ str ings.xml res/valúes-fr/strings.xml

Ejercicio paso a paso: Traducción de Asteroides.

80

1.

Crea la carpeta reslvalues-en. res/values-en.

2.

Copia en ella el fichero strings.xml. strings.xml.

3.

Traduce en este fichero todas las cadenas al inglés. inglés.

4.

Ejecuta la aplicación en el emulador y verifica que la aplicación está en inglés. inglés.

Diseño de la interfaz interfaz de de usuario: usuario: Vistas Vistas yyLayouts Layouts 5.

Vamos a cambiar la la configuración configuración de de idioma idioma del del emulador. emulador. Para Para ello, ello, accede al escritorio escritorio (pulsando (pulsando el el botón botón con con forma forma de de casa). casa). En En lala parte parte un botón botón que que permite permite desplegar desplegar un un menú menú con con todas todas las las inferior aparecerá un aplicaciones instaladas. instaladas.

Ble 5:30 PM I

SgA Emáíl

hoíó Mundo

Gálltír/ GoogfeMáps

Hó-la, Andró id

j^tSoy

jungoi

Jutgoi

tunar tand&r Messagirig

Pelotíta

6. 6.

mmm

prueba

B Musíc

Sensor»

Abre la aplicación aplicación Settings Settings yy desciende desciende hasta hasta encontrar encontrar Lócale Loca/e && text. text. Dentro de esta opción opción selecciona selecciona Select Select lócale. loca/e. Selecciona Selecciona ahora ahora Spanlsh Spanish.

NOTA: Observa que en otros otros idiomas idiomas permite permite seleccionar seleccionar tanto tanto el el idioma idioma como como lala el español español no. no. región. Por desgracia, desgracia, para para el

7.

Ejecuta de nuevo nuevo la la aplicación aplicación yy observa observa cómo cómo ha ha traducido traducido elel texto. texto.

Otro ejemplo de utilización utilización de de recursos recursos diferenciados diferenciados lo lo podemos podemos ver ver alal crear crear una aplicación con Eclipse Eclipse aa partir partir de de la la versión versión 1.6 1.6 de de Android. Android. En En este este caso caso no no creará una única carpeta carpeta drawable drawable para para almacenar almacenar el el icono icono de de lala aplicación, aplicación,sino sino la densidad densidad de de píxeles píxeles del del dispositivo: dispositivo: tres según la res/ dravJable -hdpi/ icon. png res/drawable-hdpi/icon.png res/drawable-mdpi/icon.png res/drawable-mdpi/icón.png res/drawable-Idpi/icon.png res/drawable-ldpi/icon.png

Resulta posible indicar indicar varios varios sufijos sufijos concatenados; concatenados; por por ejemplo: ejemplo: res/values - en - rUS/strings.xml res/values-en-rüS/strings.xml res/va lues-en-rUK/strings.xml res/values-en-rUK/strings.xml

Pero cuidado, Android Android establece establece un un orden orden aa la la hora hora de de encadenar encadenar sufijos. sufijos. Puedes encontrar una lista lista de de estos estos sufijos sufijos en en lala documentación documentación del del SDK: SDK: ...../android-stík-windows/docs/guide/topi ./ android- sdk - windows/ docs! guide/ topics 1resources / resources es/resources/resourcesilBn.html#AlternateResources i18n.html#AlternateResources

81

El gran libro de Android disponibles también también puedes puedes pulsar pulsar con con elel botón botón derecho derecho Para ver los sufijos disponibles recursos yy seleccionar seleccionar New New >> Other Other... Android>>Android Android sobre una carpeta de recursos .. . >>Android XML File. Esta opción opción te te permite permite crear crear un un nuevo nuevo fichero fichero XML XML yy poner poner elel sufijo sufijo deseado de forma yy orden orden correcto. correcto. WhaUype rtseurce-configura. h on would What typ-e of of resourcc configurattoo woufdyou you 1~? Ukél

Avsiíable Quafifrers

Scret:n Size:

Avaifable Qualitiers

~:~rc~~~t;;·c~d~····· Country Code

(ID Net.votl: Metwork Code Code l:r.l

Small Normal La.r e

f □ Language «fii Region Región ;';; ~glanguage

@Roti<> Ori~ntation

_.

d l^Ü1 Pixet Dcnsrty ~Pr
F1 fS!EJ

-

-,"'}-,,,.

~ Poli[Media]: Uso de recursos alternativos en Androíd.

Poli[Med¡a |; Uso de recursos alternativos en Android

u#?'

Práctica: Creando Creando un un Layout Layoutpara para tabletas tabletasen enAsteroides. Asteroides.

Si ejecutas la aplicación aplicación Asteroides Asteroides en en una una tableta tableta observarás observarás que queeleltamaño tamaño de los botones es demasiado demasiado grande. grande. 1.

Trata de hacer hacer un un Layout Layout alternativo alternativo aa main.xml, main.xml, que que sea sea utilizado utilizado en en pantallas de tamaño xlarge xiarge (7-10,5 (7-10,5 pulgadas). pulgadas).

2. 2.

Si lo deseas también también puedes puedes personalizar personalizar elel fondo fondode delalapantalla pantalla(atributo (atributo background}, ... background), los tipos de de letras, letras, colores, colores,...

3.

Verifica que que la la aplicación aplicación se se visualiza visualiza correctamente correctamente en en todos todos los lostipos tipos de pantalla, tanto en en horizontal horizontal como como en en vertical. vertical.

Preguntas de repaso repaso yy reflexión: reflexión: Recursos Recursos alternativos. alternativos.

2.5. 2.5. Estilos Estilos y y temas temas Si tienes experiencia con con el el diseño diseño de de páginas páginas Web Web habrás habrás advertido advertido grandes grandes similitudes entre HTML HTML yy el el diseño diseño de de Layouts. Layouts. En En los los dos dos casos casos se se utiliza utiliza un un lenguaje de marcado yy se se trata trata de de crear crear diseños diseños independientes independientesdel deltamaño tamañode delala

82

Diseño de la interfaz de usuario; usuario: Vistas yy Layouts pantalla donde serán visualizados. En En el el diseño diseño web, web, resultan resultan clave clave las las hojas hojas de de permiten crear crear un un patrón patrón de de diseño diseño yy aplicarlo aplicarlo aa estilo en cascada (CSS) que permiten varias páginas. Cuando diseñes los los Layouts Layouts de de tu tu aplicación aplicación vas vas aa poder poder utilizar utilizar unas herramientas similares conocidas como como estilos estilos yy temas. temas. Te Te permitirán permitirán crear crear patrones de estilo que podrán ser utilizados utilizados en en cualquier cualquier parte parte de de la la aplicación. aplicación. Estas herramientas te ahorrarán mucho mucho trabajo trabajo yy te permitirán permitirán conseguir conseguir un un diseño diseño aplicación. homogéneo en toda tu aplicación.

2.5.1. Los estilos Un estilo es una colección de de propiedades propiedades que que definen definen el el formato formato que que tendrá tendrá una una Un vista. Podemos especificar cosas como tamaño, tamaño, márgenes, márgenes, color, color, fuentes, fuentes, etc. etc. Un estilo se define en ficheros XML, diferente diferente al al fichero fichero XML XML Layout Layout que que lo lo utiliza. utiliza. código: Veamos un ejemplo. ejemplo. El siguiente código:

Es equivalente a escribir: escribir:

Habiendo creado en el fichero res/values/styles.xml reslva/ues/sty/es.xml con con el el siguiente siguiente código: código: ! < ?xml version="l.G vers ion=" l. O" encoding= "utf- 8" ·? > parent-"©android:style/TextAppearance.Médium"> "android: layout e= name=''android: layout....width" >fill_parent >fill_parent wrap_content< / iitero> tem> wrap_content #OOFFOO naroe=" andzuid:text.C~lor"> #OOFFOO roonospace monospace

Observa como un estilo puede heredar heredar las las propiedades propiedades de de un un padre padre (parámetro (parámetro parent) y a partir de estas propiedades propiedades realizar realizar modificaciones. modificaciones.

2.5.1.1. Heredar de un estilo propio propio Si vas a heredar de un estilo definido definido por por titi no no es es necesario necesario utilizar utilizar el el atributo atributo parent. Por el contrario, puedes puedes utilizar utilizar el el mismo mismo nombre nombre de de un un estilo estilo ya ya creado creado yy

un sufijo. sufijo. Por Por ejemplo: ejemplo: completar el nombre con un punto más un

83

El gran libro de Android Crearía un nuevo estilo que sería igual a MiEstiio t-hEst iJ.o más la nueva propiedad indicada. A su vez puedes definir otro estilo a partir de este: cstyle name="MiEst i lo.grande.negrita">

Práctica: Creando un estilo en Asteroides. 1. 1.

Asteroides. Abre el proyecto Asteroides.

2.

TextoAsteroides.. Crea un nuevo estilo con nombre TextoAsr.eroides

3.

Aplícalo al titulo título que aparece en el Layout main.xml. main.xml.

4.

Crea un nuevo estilo con nombre TextoAs teroides. Botones. Este ha de TextoAsteroides.Botones. modificar alguno de los atributos anteriores y añadir otros, como pading.

5. 5.

Aplícalo a todos los botones del Layout.

6.

Visualiza el resultado. resultado.

2.5.2. Los temas Un tema es un estilo aplicado a toda una actividad o aplicación, en lugar de a una vista individual. Cada elemento del estilo solo se aplicará a aquellos elementos cod e Fo nt solo afectará al texto. donde sea posible. posible. Por ejemplo, ejemplo, codeFont. Para aplicar un tema a toda una aplicación edita el fichero AndroidManifest.xml y añade el parámetro android:theme android: theme en la etiqueta application: !


84

1.

Asteroides. Abre el proyecto Asteroides.

2.

Aplica a la actividad principal el tema android:styie/Theme.oiaiog a ndroid: l?tyle/Theme. Dial og tal y como se acaba de mostrar. mostrar.

3.

resultado. Visualiza el resultado.

Diseño de la interfaz ínterfaz de de usuario: usuario: Vistas Vistas yy layouts Layouts

Práctica: Creando un un tema tema en en Asteroides. Asteroides.

1.

Abre el proyecto Asteroides. Asteroides.

2.

Crea un tema con nombre nombre TemaAsteroides TemaAsteroides que que herede herede de de android: android: style/Theme styie/Theme.. NoTitleBaL NoTitieBar. Este Este tema tema no no muestra muestra lala barra barracon conelel nombre nombre de la aplicación.

3.

Aplica este tema a la la aplicación. aplicación.

Poli[Media]: Poli[Media |; Estilos Estilos yy temas ternas en en Android. Android. 2.6. 2.6. Uso Uso práctico práctico de de Vistas Vistas y y Layouts Layouts En este apartado vamos vamos aa aprender aprender aa usar usar varios varios tipos tipos de de vistas vistasyyLayouts Layoutsdesde desde un punto de vista práctico. práctico. También También empezaremos empezaremos aa escribir escribir código código que que será será ejecutado cuando ocurran ocurran ciertos ciertos eventos: eventos:

Ejercicio paso a paso: paso: Un Un botón botón con con gráficos gráficos personalizados. personalizados. 1.

Crea un nuevo nuevo proyecto proyecto con con nombre nombre MasVistas. MasVistas. Selecciona Selecciona lala versión versión example. masvistas. 1.6 y en Package name ñame introduce introduce org. org.exampie.masvistas.

2.

fichero boton.xml boton.xml en en lala carpeta carpeta res/drawable/. res/drawable/. Para Para ello ello Crea el fichero el menú menú Archivo/Nuevo!Android Archivo/Nuevo/Android XML XML File File yy pon pon en en File: File: puedes utilizar el en tipo tipo Drawable. Drawable. Reemplaza Reemplaza elel código código por por elel "botón" y selecciona en siguiente: < i te m android: drawable= '' (q.d.r:a;,1.rable/J:.)oton__pul sado " > android:state_pressed="true" /> < i tem android: drawable = ~~ t?-d.r-aiAral;l e/l:.>ot:·on_n.or:rnal " / /> > «item android:drawable»"@drawable/boton_normal" 11

Este XML define un un recurso recurso único único gráfico gráfico (drawable) (drawable) que que cambiará cambiará en en función del estado del botón. botón. El El primer primer <ítem> define define lala imagen imagen usada usada cuando se pulsa el el botón, botón, el el segundo segundo <ítem> <¡tem> define define lala imagen imagen usada usada cuando el botón tiene el el foco foco (cuando (cuando el el botón botón está está seleccionado seleccionadocon con lala

85

El gran libro de Android rueda de desplazamiento o las teclas de dirección), dirección}, el tercero la imagen en estado normal. Los gráficos, y en concreto los drawables, serán estudiados en el capítulo 4. 4.

NOTA: El orden de los elementos es importante. Cuando se va a dibujar se recorren los ítems en orden hasta que se cumpla una condición. Debido a que "boton normal" es el último, sólo se aplica cuando las condiciones siate_pressed y "boton_normal" stateyressed y statejócused cumplen. state Jócused no se cumplen. 3.

Descarga las tres 1magenes imágenes que aparecen a continuación de www.androidcurso.com. El nombre que ha de tener cada fichero aparece debajo: debajo:

boton_norma. jpg boton_norma,jpg

boton_con_foco.jpg

boton_pulsado.jpg bot.on_puJ.sado. jpg

4. 4.

res / drawable/ del proyecto. Arrastra estas imágenes a la carpeta res/drawabie/

5.

ml . Abre el fichero res/layout/main res/layout/main.. xxml.

6. 6.

Elimina el Textvíew 'l'extView que encontrarás dentro del LinearLayout. L i n earLayout .

7.

Selecciona el LinerLayout e introduce en el atributo Background el valor #FFFFFF. #FFFFFF.

8.

Arrastra una vista de tipo Button dentro del LinearLayout.

9.

Background Selecciona el atributo Back ground y pulsa en el botón selector de recurso (con puntos suspensivos). Selecciona Drawable/boton. Drawab/e/boton.

10. Modifica el atributo Text para que no tenga ningún valor. 11. Introduce en el atributo onClick sePulsa (ojo; este atributo solo onciick el el valor aePuisa está disponible a partir de la versión 1.6). 1,6). MasVistasActivity.java final, antes de la 12. Abre el fichero MasVistasActivity.j ava e introduce al final, última llave, el código: código: public void seFulsa(View sePu1sa(View view){ view) { Toast.mak<·/text:( this , "Pulsado", npulsado 11 , Toast. T oast.LENGTH_SJ/OR.T) o v;(} ¡ Toast .inakeText (thía, LENGTH__SHORT) .sh . show();

} NOTA: Pulsa Ctrl-Shift-0 para que se añadan automáticamente los paquetes que faltan en la sección import. i m.r•ort.

86

Diseño de la interfaz ínterfaz de usuario: usuario; Vistas Vistas yy Layouts Layouts El método anterior será será ejecutado ejecutado cuando cuando se se pulse pulse elel botón. botón. Este Estemétodo método se limita a lanzar un un Toast, Toast, es es decir, decir, un un aviso aviso que que permanece permanece un un cierto cierto tiempo sobre la pantalla pantalla yy luego luego desaparece. desaparece. Los Los tres tres parámetros parámetrosson: son: 11 para el contexto utilizado, coincide coincide con con lala actividad; actividad; 22 para para elel texto texto aa mostrar y 3 para el tiempo tiempo que que permanecerá permanecerá este este texto. texto. Los Los conceptos conceptos de actividad y contexto serán serán desarrollados desarrollados en en elel siguiente siguientecapítulo. capítulo. 13. Ejecuta el proyecto yy verifica verifica el el resultado. resultado. 14. El código resultante resultante para para el el fichero fichero main.xml main.xmlse se muestra muestraaacontinuación: continuación:
android:orientation="vertical" android:orientation="ver~ical" android: layout_width= "Lill_parent~" "fiil_pdrer.it" android: layout_height= •"fill_parent* t'ill_pa:ceni: • android;layout_height= android: background= " ifFF'FFFF"> android:background="HFFFFFF"> android:onClick="sePulsa"/>

2.6.1. Acceder yy modificar modificar las las propiedades propiedades de de las vistas por código código

ll*

Ejercicio paso a paso: paso: Acceder Accederyy modificar modificarlas laspropiedades propiedades de las vistas por código código

1.

main.xml creado creado en en el el ejercicio ejercicio anterior. anterior. Abre el Layout main.xml

2.

de vistas, vistas, dentro dentro de de Text Text Fields, Fields, busca busca Number Number(Decimal) (Decimal)yy En la paleta de arrástralo encima del botón botón rojo. rojo.

3.

atributos de de esta esta vista: vista: Hint Hint == "Introduce "Introduce un un número", número", Modifica algunos atributos id = "@+id/entrada"

4.

de vistas, vistas, dentro dentro de de Form Form Widgets, Widgets, busca busca Button Buttonyyarrástralo arrástralo En la paleta de encima del botón rojo.

5.

algunos atributos atributos de de esta esta vista: vista: Haz Haz que que su su ancho anchoocupe ocupetoda todalala Modifica algunos pantalla, que su texto sea sea "0". "0".

6.

de vistas, vistas, dentro dentro de de Form Form Widgets, Widgets, busca busca Large Large Text Text yy En la paleta de arrástralo debajo del del botón botón rojo. rojo.

7.

Modifica algunos atributos atributos de de esta esta vista: vista: TextColor Textcolor == #OOOOFF, #0000FF, Text Text =='"', Hint ="Resultado", = "Resultado", id= "@+id/salida". "@+id/salida".

87

El gran libro de Android 8.

MasVistaActivity.java. Vamos Vamos aa añadir añadir dos dos nuevas nuevas Abre el fichero MasVistaActivityjava. propiedades a la clase. clase. Para ello copia el el siguiente siguiente código código al 31 principio principio de de oncreate}: la clase (antes del método oncreate): private prívate EditText entrada; private prívate TextView salida;

9.

Copia al final del método oncreate las las siguientes siguientes dos dos líneas; líneas: eentrada n trada= findViewByid(R.id.entrada); = (EditText) findViewByld(R.id.entrada); sa li da ~ {TextView) (TextVie;v) findViewByldfR.id.salida); fi.ndViewByTd (R. id. salida); salida

110. O. Como se explicó al principio del del capítulo, capítulo, las las diferentes diferentes vistas vistas definidas definidas en main.xml, objetos Java Java cuando cuando se se ejecuta ejecuta main.xml, son creadas como objetos setContentView (R . layout layout..main) main ) .. Si Si queremos queremos manipular manipular algualgusetContentview (R. nos de estos objetos hemos de de declararlos declararlos (paso (paso 8) 8) yy asignarles asignarles el el objeto correspondiente. Para ello, hay hay que que introducir introducir el el atributo atributo id id en en xml xml y utilizar el método ffindViewByid(R. id . valor_en_atrijbuto_id). valor_en_atributo_id ) . indViewById(R. id. Este método devuelve un objete objeto de de la la clase view, view, no no obstante obstante los los (entrad a y salida) sa l ida) no no son son exactamente exactamente de de esta esta objetos declarados (entrada na asignación asignación directa. directa. En En estos estos casos casos clase por lo que Java no permite una hemos de utilizar una conversión de de tipo tipo (type cast) para para poder poder hacer hacer la la al respecto respecto leer leer el el apartado apartado asignación. información al asignación. Para más información Polimorfismo del tutorial de Java Esencial. Esencial. 11. Introduce en el atributo onciick onCHck del del botón botón con con id id botono botono el el valor valor "sePulsaO". "sePulsad". 12. Añade el siguiente método al final de de la la clase clase MasvistasActivity. i"iasvistas.r~.ctivity. publ ic voíd void sePulsaO(View view){ view) { public entrada.setText(entrada.getText()+"O"); entrada.setText(entrada.getText() + "0" ) ;

/ Lo que hace es asignar como textos de entrada el el resultado resultado de de concatenar concatenar al texto de entrada el carácter "0". "0".

13. Añade al botón con texto "0" "O" el atributo atributo tag =="0". "0".

14. Modifica el método sePulsaO se Pulsao de de la la siguiente siguiente forma: forma: public voíd void sePulsaO(View sePulsaO{View view){ view) { entrada.setText(entrada . getText()+(String)view.get'I'ag ()); entrada.setText(entrada.getText()+(String)view.getTag());

} El resultado obtenido es equivalente equivalente al al anterior. anterior. En En algunos algunos casos casos será será interesante utilizar un mismo método método como como escuchador escuchador de de eventos eventos de de varias vistas. vistas. Podrás averiguar la vista vista que que causó causó el el evento, evento, dado dado que que el ejemplo ejemplo sabemos sabemos que que esta es pasada como parámetro del del método. método. En el en el atributo tag ta9 guardamos el carácter carácter aa insertar. insertar. El El atributo atributo tag tag puede puede ser usado libremente por el programador programador para para almacenar almacenar un un objeto objeto de de la la hemos almacenado un un objeto objeto string, string, por por clase object. En nuestro caso hemos lo que necesitamos una conversión conversión de de tipo. tipo.

88

-

------ - - - - -

Diseño de la interfaz de de usuario: usuario: Vistas Vistas yy Layouts Layouts forma de de trabajar trabajar en en la la práctica práctica para para no no tener tener que que crear crear un un NOTA: Utiliza esta forma método onClick onCiick para cada botón botón de la la calculadora. calculadora.

15. Modifica el código código de de sePulsa sePulsa con con elel siguiente siguiente código: código: public void sePulsaíView sePulsa(View view){ view) { salida.setText(String. valueOf( salida.setText ÍString.valueOf{ Float .parseFloat(entrada.getText() .toS tring ()) *2 .0)); Float.pai-seFioat{entrada.getText().toString())*2.0));

} En este código el valor de de entrada entrada es es convertido convertido en en Float, Float, multiplicado multiplicado por dos y convertido en String String para para ser ser asignado asignado aa salida. sal ida. 16. proyecto yy verifica verifica el el resultado. resultado. 16. Ejecuta el proyecto

2. 7. Uso Uso de de TabLayout Tablayout 2.7. Para crear una interfaz interfaz de de usuario usuario con con pestañas, pestañas, es es necesario necesario utilizar utilizar TabHost TabHost yy El TabHost debe debe ser ser el el nodo nodo raíz raíz para para el el diseño, diseño, que que contendrá contendrá tanto tanto El el Tabwidget TabWidget para la visualización visualización de de las las pestañas, pestañas, como como un un FrameLayout FrameLayout para para de la la ficha. ficha. mostrar el contenido de Tab~.¡idge t. Tabwidget.

Puedes implementar implementar el el contenido contenido de de dos dos maneras: maneras: usando usando las las pestañas pestañas para para intercambiar puntos de de vista vista dentro dentro de de la la misma misma actividad, actividad, oo puedes puedes utilizar utilizar las las pestañas para cambiar cambiar entre entre actividades actividades totalmente totalmente independientes. independientes. En este apartado, apartado, vamos vamos aa crear crear una una interfaz interfaz de de usuario usuario con con pestañas pestañas que que utiliza una única actividad. actividad. Para Para hacerlo hacerlo con con diferentes diferentes actividades actividades para para cada cada pestaña puedes seguir seguir el el tutorial: tutorial: http://developer.android.com/resources/ http://developer.android.com/resources/ tutorials/views/hello-tabwidget.html tutorials/views/hello-tabwidqet.html

Ejercicio paso aa paso: paso: Uso Uso de de TabLayout. TabLayout. 1.

Crea un nuevo nuevo proyecto proyecto con con nombre nombre TabLayout. TabLayout. Selecciona Selecciona lala versión versión name introduce introduce org.example.tablayout. org. example. tablayou t. 1.6 y en Package ñame

2.

Remplaza el código código de de main.xml main.xml por por el el siguiente: siguiente:

c?xml version=" 1.0 e ncoding="utf-8"?> cTabEost cTabHost xmlns tp:: //schenias. x mlns:: android= "bt "ht:t:p //sche1nas .android. android. com/apk/res/android" coln / a.pif/res/and.roid" aandroid: ndroid: id= ""@android abhost ¡sandroi d:: iid/t d/tahhos t "" android:layout android: layout __width="fill_parent" width= • fill_par:ent • android: layout __height="fill _height= "fill_oarent "> android:layout __parent">
89

El gran libro de Android android: layout_ height = " fi .I.l __parent: "> android:layout_height="fill_parent">
android:id="Sandroid:id/tabs"

android : id= ''@andru.ie~ : .icl/tabs ~·

andr·oid: layout_width= " f.i.l.I_pa.rent: android:layout_width="fill parent"" android: layout_height = "¡,,rap_contenc" android; layout_height= " wi ap_con i:en t:" // >> 1 ayout jieightt = ""fill_parent
aandroid:layout n dro i d: layout._wid th= " till_pa.r:ent "> width="fill_parent">
android : layou t ..width= f i l l _parent" android:layout width= "• fill_parent" android : layout _ h eight = • fill. ..._r:>.:Jrent • android:layout_height="fill_.parent" andro id:text=''"esto esto es una tina pestarla' !> android:text= pestaña" /> " ,' > fill_..parenC 1

> android:text="esto <.Tex.t.View andr oid : i d = " @+.id/ t a.bJ.La.:yout < / F rameLay ou t. > .::./LinearLa yout~>

1'

u

Como puedes observar se ha creado un TabHost debe ser el nodo raíz para el diseño, que contiene dos elementos combinados por medio de un Linea rLayout. . El primero es un Ta.b~-Hdget. línearLayout. Tabwidget para la visualización de las pestañas yy el segundo es un FrameLayout para mostrar el contenido de la ficha. Frame Layout hay tres elementos, elementos, cada uno de los ficha. Dentro de este FrameLayout cuales contendrá las vistas a mostrar para cada una de las lengüetas. lengüetas. Tienes que tener especial cuidado con los atributos id. El TabHost debe llamarse siempre ""@android: @android: id/tabhosc", i d/tabhosr. ", mientras que el Tabwidget TabvHdget ha de llamarse ""Sandroid:id/tabsDe @android : id/taL>s ". De esta forma, forma, el sistema conocerá la finalidad de cada uno de estos elementos. ele mentos. Por otra parte, parte, cada una de las vistas de contenido introducidas dentro del FrameLayou t han de tener un id id del FrameLayout asignado por ti, ti, como ""S+íd/tablLayout @ ' id/ t ablLayou t ".

90

Diseño de la interfaz interfaz de de usuario: usuario: Vistas Vistas yyLayouts Layouts 3. 3.

funcione resulta resulta imprescindible imprescindible introducir introducir código. código. Para que un TabLayout funcione TabLayoutActivity.java yy remplaza remplaza el el código código por porelelsiguiente. siguiente. Abre el fichero TabLayoutActivity.java public class TabLayoutActivity TabLayoutActivity extends extends TabActivity TabAc tivity {{ the activity activity is is first first created. created. */ */ /** Called when the @Override ■aOverride public void onCreate(Bundle onCreate(Bundle savedlnstanceState) savedinstanceState) { super.onCreate(savedinstanceState); super.onCreate(savedlnstanceState); setContentView(R. layout. rr.ain) setContentView(R.layout. main );; TabHost tabHost == getTabHost(); getTabHost(); tabHost. addTab (tabHost. newTabSpec ( " t abl '') . setindicator ( tabHost.addTab(tabHost.newTabSpec("tabl").setlndicator( "Titulo 1 ", nuil).setContent(R.id.tablLayout)); null) .setContent(R.id .tab1Layout )); "Título 1", tabHost.addTab(tabHost.newTabSpec( "tab2 ") .setindicator( tabHost.addTab(tabHost.newTabSpec("tab2").setlndicator( "Título 2", 2 ", nuil).setContent(R.id.tablLayout)); null) . setContent(R . id .tab2Layout )); tabHost . addTab(tabHost . newTabSpec( "tab3 ") .setlndicator( tabHost.addTab(tabHost.newTabSpec("tab3").setlndicator( "Ti tulo 3", 3 ", nuil).setContent(R.id.tabJLayout)); null) . setContent(R . id. tabJLayout )); "Título

} } Observa como la la clase creada creada extiende extiende de de TabActivity TabActivity en en lugar lugar de de Activity han añadido añadido varias varias líneas líneas alal final final del del método método Activity.. Además, se han onCreatee o. oncreat ( ) . La primera primera línea línea obtiene obtiene la la actividad actividad que que muestra muestra las las pestañas mediante mediante getTabHost g e tTa b Hos t (). (l . Luego Luego añadimos añadimos tantas tantas pestañas pestañas como nos interese. interese. Para Para cada cada una una se se crea crea indicando indicando un un tag tag (newTa b Sp ec ()), ( l ), se le le asocia asocia un un título título yy un un icono icono (setlndicator (set i ndi cator(}) () ) yyse se (newTabSpec (se t con ten t ()). ( l ). el contenido contenido (setContent indica donde está el

NOTA: Los iconos disponibles en en el el sistema sistema yy cómo cómo crear crear nuevos nuevos icono icono será será capítulo. estudiado en el siguiente capítulo. 4.

proyecto yy verifica el resultado. resultado. Ejecuta el proyecto verifica el

2.7.1. Uso de de la la etiqueta etiqueta <ínclude> en en Layouts Layouts Un diseño basado en TabLayout TabLayout puede puede requerir requerir ficheros ficheros xml xml muy muy extensos. extensos. Para Para organizar correctamente el el trabajo trabajo yy reutilizar reutilizar diseños diseños previos previos puede puede ser ser de de gran gran ayuda la etiqueta

Ejercicio paso aa paso: paso: Uso Uso de de la la etiqueta etiqueta en en Layouts. Layouts. 1.

Empezaremos realizando realizando una una copia copia del del fichero fichero MasVistas/res/layout/ MasVistas/resllayoutl main.xml a TabLayout/res/layout/boton_rojo.xml. TabLayoutlresllayoutlboton_rojo.xml. Para Para ello ello selecciona selecciona elel Vistas/res/layout. Te primer fichero y pégalo en en la la carpeta carpeta Mas MasVistas/resllayout. Te pedirá pedirá un un nuevo nombre escribe escribe boton_rojo.xml. boton_rojo.xml. Arrastra Arrastra el el nuevo nuevo fichero fichero hasta hasta lala carpeta TabLayout/resllayout. TabLayout/res/layout.

91

El gran libro de Android 2.

7, Realiza el mismo proceso con uno de los Layout creado en el punto 7, donde se diseñaba el teclado de una calculadora. En nuestro proyecto ha de llamarse ca/cu/adora.xml. calculadora.xml.

3.

Realiza el mismo proceso con el Layout creado en el punto 6. 6. En nuestro proyecto ha de llamarse primer_layout.xml. primerJayout.xml.

4.

Añade el atributo android: (~+.Íd/tal)lLayout: " en el LinearLayout LinearLayou t android; id= ""@+íd/tablLayout" botón_rojo.xml. el atributo android: raíz de botón_rojo.xml. Añade andro id: id= "@• id/tab2Layout " en ca/culadora.xml @í·idltal.J3Layout " en "@*-id/tab2Layout" calculadora.xml y ""@+id/tab3Layout" primer_layout.xml. primerJayout.xml.

5.

Abre el fichero main.xml y remplaza el FrameLayout por: por: android:layout_height-"£ill_parent"> c:::include layout ::-: "@ " ~.ila)lOUt/hot:on_rojou/> layout::-: "tiila_yout/calculadoLa "/> <ínclude layout::-: "C~la_yout:/primeL"_la_yout "/ > cinclude layout»'@layout/primer_layout"/>



< /Frarr1eLayout>

6.

Ejecuta el proyecto y verifica el resultado. Ojo: si pulsas alguno de los resultado. Ojo: botones es posible que no funcione. Recuerda que no hemos copiado el código. código. Has podido comprobar cómo hemos conseguido un diseño muy complejo grande. De esta forma, forma, sin la necesidad de crear un xml demasiado grande. diferentes. Además tenemos el código xml separado en cuatro ficheros diferentes. ha sido muy sencillo reutilizar diseños previos. previos.

92

CAPÍTULO 3. CAPÍTULOS.

Actividades Actividades e e Intenciones Intenciones

En este capítulo seguiremos trabajando con con el el diseño diseño del del interfaz interfaz de de usuario. usuario. En En lugar de tratar aspectos de diseño diseño visual, visual, como como hicimos hicimos en en el el capítulo capítulo anterior, anterior, vamos a tratar temas más más relacionados relacionados con con el el código. código. En En concreto, concreto, nos nos centraremos en las Actividades Actividades y los los Intentos. Intentos. Estudiaremos Estudiaremos también también dos dos herramientas de gran utilidad para cualquier cualquier aplicación: aplicación: los los menús menús contextuales contextúales yy la definición de parámetros de de configuración. configuración. Además, Además, se se tratará tratará un un tipo tipo de de vista vista stview. muy práctica aunque algo compleja de de manejar: manejar: Li Listview. Nos vamos a centrar en el ejemplo de de aplicación aplicación que que estamos estamos desarrollando, desarrollando, diferentes actividades. actividades. AA continuación continuación se se muestra muestra elel Asteroides, para añadirle diferentes esquema de navegación entre las actividades actividades que que queremos queremos crear: crear:

93

El gran libro de Android

~Objetivos: Objetivos;

•

Describir cómo el interfaz de de usuario usuario en en una una aplicación aplicación Android Android estará estará actividades. formado por un conjunto de actividades.

•

Mostrar como desde una una actividad actividad podemos podemos invocar invocar aa otras otras yy cómo cómo ellas. podemos comunicarnos con ellas. Permitir incorporar aa nuestras nuestras aplicaciones aplicaciones ciertos ciertos elementos elementos prácticos prácticos como son los menús o las preferencias. preferencias.

• •

Describir cómo podemos utilizar utilizar yy crear crear iconos iconos en en nuestras nuestras aplicaciones. aplicaciones.

•

en Android Android: ListView. ListView. Estudiar una vista muy útil útil en

•

Describir el uso de intenciones intenciones para invocar invocar actividades actividades estándar estándar en en Android. Android.

3.1. de nuevas nuevas actividades actividades 3.1. Creación Creación de El concepto de actividad en Android representa representa una una unidad unidad de de interacción interacción con con el el usuario. que coloquialmente coloquialmente llamamos llamamos una una pantalla pantalla de de la la aplicación. aplicación. usuario. Corresponde a lo que Una aplicación suele estar formada por por una una serie serie de de actividades, actividades, de de forma forma que que el el usuario puede ir navegando entre actividades. actividades. En En concreto, concreto, Android Android suele suele disponer disponer de de un botón (físico o en pantalla) que nos nos permite permite volver volver aa la la actividad actividad anterior. anterior. Toda actividad ha de tener una una vista vista asociada, asociada, que que será será utilizada utilizada como como interfaz interfaz de usuario. usuario. Esta vista suele suele ser de de tipo tipo Layout aunque aunque también también puede puede ser ser una una el siguiente siguiente ejemplo. ejemplo. vista simple, como se verá en el conjunto de de actividades actividades independientes, independientes, Una aplicación estará formada por por un conjunto es decir se trata de de clases independientes independientes que que no no comparten comparten variables, variables, aunque aunque todas trabajan para un objetivo objetivo común. común. Otro Otro aspecto aspecto importante importante es es que que toda toda .n.ct.ivity. de Activity. actividad ha de ser una subclase de Las aplicaciones creadas en los los ejemplos ejemplos hasta hasta ahora ahora disponían disponían de de una una única única actividad. Esta era creada automáticamente automáticamente yy se se le le asignaba asignaba la la vista vista definida definida en en res/Layout/main.xml. actividad era era arrancada arrancada al al comenzar comenzar la la aplicación. aplicación. AA res/Layout/main.xml. Esta actividad medida que nuestra nuestra aplicación aplicación crezca va va aa ser ser imprescindible imprescindible crear crear nuevas nuevas esta apartado describiremos describiremos como como hacerlo. hacerlo. Este Este proceso proceso se se puede puede actividades. actividades. En esta resumir en cuatro pasos: pasos:

94

•

Crear un nuevo Layout para la la actividad. actividad.

•

Act i vity. En En esta esta clase clase tendrás tendrás Crear una nueva clase descendiente de de Activity. visualizar es es el el desarrollado desarrollado en en el el punto punto que indicar que el Layout aa visualizar anterior.

•

aplicación sea visible visible será será necesario necesario activarla activarla desde desde otra otra Para que nuestra aplicación actividad. actividad.

•

en De forma obligatoria tendremos que que registrar registrar toda toda nueva nueva actividad actividad en AndroidManifert.xml. AndroidManifert. xml

Actividades e Intenciones Veamos un primer ejemplo de cómo cómo crear una una nueva nueva actividad actividad en en la la aplicación aplicación Asteroides. Asteroides.

ür

paso: Implementación Implementación de de una una caja caja Acerca Acerca de. de. Ejercicio paso a paso:

Vamos a crear una caja Acen;a .. . yy visualizarla Acerca de de... visualizarla al al pulsar pulsar el el botón botón adecuado. adecuado. 1.

En primer lugar crea el fichero fichero res/layoutlacercade.xml. res/layout/acercade.xml. Para Para ello ello pulsa pulsa con con el botón derecho sobre una una carpeta carpeta res/layout, res/layout, selecciona selecciona New New >> Other Other... ... Selecciona Android > Android XML XML File e indica indica acen;ade.xml acercade.xml en en File. File.

2.

Selecciona la lengüeta de de edición edición en en XML XML yy copia copia el el siguiente siguiente contenido: contenido: encod.ing= "utf-8 "?> cTextView principal."> JI

3.

una nueva nueva actividad, actividad, que que será será la la responsable responsable de de Creamos ahora una ello se se crea crea el el fichero fichero AcercaDe.java. AcercaDe.java. Botón Botón visualizar esta vista. Para ello src/org. example. asteroides yy seleccionamos seleccionamos New New >> Class. Class. derecho sobre srclorg.example.asteroides Remplaza el código por: package or·g. examp l e. a s tero i des; org.example.asteroides; import android.app.JI.ctivi ty¡ android.app.Activity; import android.os.Bundle ; android.os.Bundle;

extends Activity Activity {{ public class AcercaDe extends í** / /'** Called when the activity activity is is fir·st first created. created. **/ @Ovel.·r.i de public void onCreate (Bundle ©Override onCreate(Bundle savedi nstanceState) {{ savedlnstanceState) super .onCreate(savedinstanceState); super.onCreate(savedlnstanceState); setContentView(R.layout.acercade); setContentView(R.layout.acercada) ; } } 4.

un método método en en la la clase clase Asteroides.java Asteroides java que que será será Pasemos ahora a crear un ejecutado cuando sea pulsado el el botón botón Acerca Acerca de. de. public void lanzarAcercaDe(View vview){ i ew ) { this , AcercaDe.class}; Intent ii = = new Intent:( Intent(this, AcercaDe.class); startActivity(i);

}

95

El gran libro de Android

i}


Para asociar este método al botón edita el Layout main.xml. main.xml. Selecciona de... el botón Aderca de ... y en la vista de Eclipse Properties busca el atributo onC/ick lanzarAcercaDe. onClick e introduce el valor lanzarAcercaoe.

6.

Pasa a la edición xml pulsando en la lengüeta main.xml y observa como correspondiente, se ha añadido el atributo: atributo: en la etiqueta c But ton > correspondiente, android :onClick== '1 dnzarAcer caDe " android:onClick="1anzarAcercaDe" 1

7.

Ejecuta ahora la aplicación y pulsa en el botón Acerca de. Observarás que el resultado no es satisfactorio ¿Qué ha ocurrido?

8.

El problema es que toda actividad que ha de ser lanzada por una aplicación ha de ser registrada en el fichero AndroidManifest.xml. AndroidManifest.xml. Para registrar la actividad, actividad, abre AndroidManifest.xml y selecciona la lengüeta Application. En Aplication Nades ... y selecciona Nodes pulsa el botón Add Add... Activity. Activlty. Rellena los campos de la derecha tal y como se muestra a continuación: continuación;

a •Aplicación (Actívity) !! ~ .Ap .···. · .t.ic.aci~n('A · ,c.•t¡.,~---~ b;;J;i4;;iJ ÍA] ,J.Acere3De ~ I!;erc~D~ (Actrvity) (A>:;)ói\
-~AJ

[a] The ~ The actlvrty actr
k4t%~J!!Hif~

ltsQ!l:\Ythlil

9.

.Acere •D•

Theme

mm

m

m

m

m

' '''''''' ' '''''''''''''

6%t~;;irij k~~-;;J

Label

Acerca de .............. LiJR~~

Icon

·-------·--···· ¡&!Slli!!~wJ

Observa como en el fichero xml se añade la siguiente línea: línea:

octivity

cactivi~y

android:name=". AcercaDe " android:name=".AcercaDe" android:label="Acerca ..."/> android:labe l ="_i.\c<:~'.rca de df: .. . "!>

10. 10, Ejecuta de nuevo el programa. programa. El resultado ha de ser similar al mostrado a continuación: continuación:

96

-

---------------

Actividades e Intenciones

La vista mostrada en el el ejemplo ejemplo anterior anterior no no parece parece muy muy atractiva. atractiva. Tratemos de mejorarla aplicando aplicando un un tema. tema. Como Como vimos vimos en en elel capítulo capítulo anterior un tema es una colección colección de de estilos estilos que que define define elel aspecto aspecto de de una activad o aplicación. Puedes Puedes utilizar utilizar alguno alguno de de los los temas temas disponibles disponibles en Android o crear el tuyo tuyo propio. propio. 11. En este caso utilizaremos utilizaremos uno uno de de los los de de Android. Android. Para Para ello ello abre abre selecciona la la lengüeta lengüeta Application. Application. En En Aplication Aplication AndroidManifest.xml y selecciona Nodes pulsa sobre AcercaDe yy aa la la derecha derecha introduce introduce elel valor: valor: ®android:style / Theme.Dialog en ©android¡style/Theme.Dialog en el el campo campo Theme. Theme. 12. Si lo prefieres edita edita directamente directamente el el fichero fichero AndroidManifest.xml AndroidManifest.xmlpara paraque que incluya: incluya: android:theme="Sandroid:style/Theme.Dialog"/>

13. Ejecuta de nuevo el el programa programa yy observa observa cómo cómo mejora mejora la la apariencia: apariencia:

Un escuchador escuchador de de evento evento por porcódigo. código. Ejercicio paso a paso: Un atributo andro android nos permite permite asignar asignar desde desde Como acabamos de ver el atributo i d ::onciick o nc lic k. nos un Layout xml un método que que será será ejecutado ejecutado al al hacer hacer clic clic en en una una vista. vista. Resulta Resulta muy muy sencillo y además está disponible disponible en en cualquier cualquier descendiente descendiente de de lala clase clase view. view. Sin Sin embargo esta técnica presenta presenta dos dos inconvenientes. inconvenientes. En En primer primer lugar, lugar, solo solo está está

97

El gran libro de Android disponible a partir de la versión 1.6 de Android. En En segundo segundo lugar, lugar, solo solo está está disponible disponible onciickí). view tiene otros eventos eventos ((onLongClickO, i e k ( ) . La clase vi ew tiene onLongCl i e k ( ) , para el evento oncl onFocuschange ( l , onKey () , .. . ) para los que no onPocusChange(), onKeyí),...) no se han han definido definido un un atributo atributo xml. xml. Entonces, qué hacemos si queremos trabajar con con una una versión anterior anterior aa 1.6 1.6 oo definir definir un evento distinto de onclick (). La respuesta la encontrarás onClickO. encontrarás en en el el siguiente siguiente ejercicio: ejercicio:

1. 1.

Asteroides.java y añade las líneas líneas que aparecen aparecen subrayadas: subrayadas: Abre la clase Asteroídes.java public class .A steroides exten ds .Z\ct ivi ty {{ Asteroides extends ñctivity private prívate But.ton Button bAcercaDe hAcercaDe;; @Cverride (Bundle savedinst.anceStat.e) SOverride public void oncr·eate onCreate(Bundle savedlnstanceState) super,onCreate(savedlnstanceState) super .onCreate(savedi nstanceState);; setConcentView(R . layout.main); setContentView(R.layout.main); bAcercaDe =(Button) indViewByid(R.id. buttonOJ); ^(Button) ffindViewByld(R.id.button03); bAcercaDe.setOnClickListener (new OnClickListener() bAcercaDe.setOnClickLlstener(new OnClickListener() public void onClick(View onCllckíView view) { lanzarAcercaDe(nu l l );; lanzarAcercaDe(nuil)

{

|

l

En el capítulo 5 se estudiarán con más más detalle los los escuchadores escuchadores de de evento. evento.

Práctica: Práctica; El botón Salir. Queremos que cuando se pulse el botón Salir se ejecute el ini sil ( ) ; Salirse el código: código: ffinisni) De esta forma la actividad terminará al pulsarlo. pulsarlo. 1.

Realiza este trabajo utilizando un escuchador de de evento evento por por código. código. 2.

Hazlo ahora con el atributo xml android: onclick. android:oncück.

3.

Verifica que el resultado es el mismo en ambos ambos casos. casos.

3.2. idades 3.2. Comunicación Comunicación entre entre acti actividades Cuando una actividad ha de lanzar a otra actividad actividad en en muchos muchos casos casos necesita necesita enviarle cierta información. Android nos permite permite este este intercambio intercambio de de datos datos utilizando el mecanismo descrito a continuación: Cuando lances una actividad usa el siguiente código: Intent inte nt =- new lntent(this, _CLASE. class ); intent Intent'this, MI MI_CLASE.class); 11 11 u suario 11 , 11 ) ; intent.putE.xtra{ Pe p.i. to Perez intent.putExtraí"usuario", "Pepito Perez");

98

Actividades ee Intenciones intent. pu tExtra ( "eda.d '' , 27) ; intent.putExtra("edad", startActivity (intent); startActivity(intent);

En la actividad lanzada podemos recoger los datos de la siguiente forma: forma: Bundle extras == getlntent().getExtras{); getintent() .getExtras(); String s = = extras.getScring("usuario"); extras.getString("usuario"); int ii == extras.getlnt("edad"); extras . getint( " edad");

Cuando la actividad lanzada termina también podrá devolver datos que podrán ser recogidos por la actividad lanzadora de la siguiente manera. Int ent intent Intent

Intent{(this, this , t·H_CLASE. class ) ; = new Intent MI__CIjASE.clasa)

=

startActivi.tyForResult(intent, startActivityForResult(intent, 1.234); 1234) ;

@Override int requestCode, ©Override protected void onActivityResult ((int int resultCode, Intent data) data){{ if {requestCode==l234 ___ OK) {{ (requestCode==1234 & resultCode==RESUL'I'_ resultCode==J?£:S!7LT_OA') String res res= data.getExtras() .getStrin9("resultado"); = data.getExtras().getStringC'resultado");

} } En la actividad llamada has de escribir: Intent intent i ntent = = new Intent(); intent .putExtra ("resultado" , "valor·" ); intent.putExtra("resultado","valor"); setResult (R.ESUL1'_0K setResult{RESULT_OK,, intent); finish(}; finish();

+M0 &

Práctica: Comunicación entre actividades. actividades.

Crea un nuevo proyecto con nombre ComunicacionActividades. Comunicación Actividades. 1.

El Layout de la actividad inicial ha de ser similar al que se muestra a la siguiente. izquierda de la imagen siguiente.

2.

Introduce el código para que cuando se pulse el botón "Verificar" se actividad. A esta actividad se le pasará como arranque una segunda actividad. parámetro el nombre introducido en el Edi tText . EditText.

3.

El Layout correspondiente a la segunda actividad se muestra a la derecha. derecha.

4.

Al arrancar la actividad el texto del primer TextView Textview ha de modificarse para que ponga "Hola "+nombre recibido+"¿Aceptas las condiciones?"

5.

botones, de forma que se En esta actividad se podrán pulsar dos botones, devuelva a la actividad principal el string "Aceptado" o "Rechazado", según el botón pulsado. pulsado. Al pulsar cualquier botón se regresará a la actividad anterior. anterior.

El gran libro de Android 6. 6.

En la actividad principal se modificará el texto del último Textview para que ponga "Resultado: Aceptado" o "Resultado: Rechazado", según lo recibido.

Rechazar

Preguntas de repaso y reflexión: Comunicación entre actividades. actividades.

3.3. Añadiendo un 3.3. Añadiendo un menú menú Android permite asignar menús a las actividades que se despliegan pulsando el botón menú del terminal. Este tipo de menús resultan muy interesantes en dispositivos con pantallas pequeñas dado que no ocupan parte de la pantalla, es decir, están ocultos hasta que se pulsa la tecla de menú.

_ .... .~,~~

•

Poli[Media]: Poli[Media |: Añadiendo un menú en Android.

Ejercicio paso a paso; paso: Añadiendo un menú a Asteroides. Android permite asignar menús a las actividades que se despliegan pulsando el botón menú del terminal. Podemos asignar un menú de este tipo a nuestra actividad de forma muy sencilla. sencilla. 1.

Asteroides. Abre el proyecto Asteroides.

Actividades ee Intenciones 2.

Pulsa con el botón derecho derecho sobre sobre esta esta carpeta carpeta de de recursos recursos yy selecciona selecciona New > Other... Other... Selecciona Android Android >> Androld Android XML XML File. File.

3.

el campo campo File File yy selecciona selecciona que que queremos queremos Introduce el valor menu.xml en el crear un fichero de tipo tipo menú. menú.

4.

lista vacía de elementos elementos de de menú. menú. Pulsa Pulsa en en el el botón botón Add... Add. .. Aparecerá una lista

5.

de tipo Item. ltem. Introduce Introduce el el valor valor @+id/conf¡g @+id/config en en el el campo campo Añade un elemento de Id, el valor Configuración en en el el campo campo Title Title yy @android:drawable/ @android:drawablel ic_menu_preferences en el campo Icón. /con.

6.

Repite el proceso para introducir introducir un un nuevo nuevo ítem ítem con con Id Id tomando tomando el el valor valor @+id/acercaDe, Title Titfe con el el valor valor Acerca Acerca de... de ... ee Icón /con con con el el valor valor @android:drawablelic_menu_info_details @android:drawable/ic_menu_info_details..

ci Android Menú . g¡ Menu

m @ A; ; (T) (g) Az Attríbutes for cossBg (Item)

' Mentí fíements ....... .............. ............

Attributes for conf'og (Item}

M:~~[k;~~·~

, fll acercaDe (Item)

CIJ that available (T) Base attributes attributes th at aare re avai labf e to aialli Item objects. objects. ltem

Id

~;;) í "p I Down : [|m.cBPumJ

@+íd/conf [ Browse..>Í

Menú categooy category Menu Order Order in m categooy category Title

Configura t [;:§ Brovose.» Configurac! ~,ti¡{¡J

Title condensed Title condensed

·-·--···-········-~ [<§t9li\"!t-,wJ

!con Al. p habetic Alpha betic shortcut

7.

i Browse... I

Pulsa la lengüeta .xml. fichero xml xml resultante resultante se se muestra muestra aa continuación: continuación: xml. El fichero c?xml version="l .O "" encoding="utf-S encoding=" utf-8 "?> "? > co.rn/ar.)k/.rt.-:s/andro.i.ci ''> xmlns : android= "ht.tp://schemas. < 1.t.em. android: title= t it.l.e= "Configuración " Conf.1:gurac.ión " <.ltem android: id= • tiJ.;..ic'i/ con.fg • android:id=id/confg" aandroid; ndro id : icon= i con= "Sandroid:drawab.le/ic_jnenu__preferenees {ªand.rD .id: drarAla.b.l ~a/ .i. c_lTi{·?Tl ilJJ.r-f:~ f f?.r.~·f.-?.nC~..":~S "/> "1 > e
lt

android: id= "i?-f id/acercaDe"

android:id=" @-~.id/acercaDe"

android ; icon= *@android:drawable/i ,,(ªandrD.id :drar.va.lJ.l f.·:/.ic_i!ienu_.info_d.eta .il.s "/> android;icon= c_menu_i nfo_deta11s"/>

La apariencia de este menú se muestra muestra a continuación: continuación:

101

El gran libro de Android 8.

Para activar el menú has de introducir el siguiente código al final de Asteroides.java: Asteroides, java.

©Override public @Override p ublic boolean onCreateOptionsMenu(Menú onCreateOptionsMenu(Menu menú) menu) {{ super.onCreateOption sMenu (menu); super.onCreateOptionsMenu(menú); Menuinflater etMenuinflater(); Menulnflater inflater == ggetMenuInflater(); inflater . inflate(R . menu. menu , menú); menu); inflater.Ínflate(R.menú.menú, return -> el menú ya está visible **// ret urn true; /** ;~· * true -> } ®Override p ublic boolean onOptionsItemSelected(Menultem onOptionsitemSelected(Menuitem item) ©Override public witch (item.getltemld()) (i t em . getitemid()) { sswitch case R.id.acercaite: R . id. ace.n::aDe: lan zarAcercaDe(); lanzarAcercaDe(); bbreak; reak ;

{{

} retur n true; /'** /** true -> - > consumimos c onsumimos el ítem, no se propaga*/ propaga* / return

} 9.

Ejecuta el programa yy pulsa el botón MENU del terminal. En la parte inferior de la pantalla ha de aparecer los dos ítems de menú como se muestra en la figura anterior.

3.4. Creación uso de de iconos iconos 3.4. Creación y y uso En el apartado anterior hemos creado un menú que hacía uso de dos iconos. iconos. Se Android, es decir, utilizaban iconos disponibles en el sistema Android, decir, se han utilizado recursos del sistema Android. Android . Otra alternativa es crear tus propios iconos y almacenarlos en la carpeta res/drawable. refJ / drawable.

utilidad. La siguiente En Android se utilizan diferentes tipos de iconos según su utilidad. tabla muestra los más importantes: importantes: Tipo de iconos

Finalidad

Lanzadores

Representa la aplicación en la pantalla principal del dispositi o. dispositivo.

Menú

Se muestran cuando presione el botón Menú. Menú. Cada actividad puede definir su propio menú. menú.

Barra de acciones

A partir de la versión 3.0 con el aumento de pantalla de las tabletas las actividades pueden disponer de una barra de iconos siempre visible. visible.

102

Ejemplos

«y

y ^

<~~twnw R ■■ Conf'glH aoon Ace1 ca de "

-

Actividades e e Intenciones Tipo de iconos

Finalidad

Barra de estado

Barra con pequeños iconos que nos alertan de notificaciones ..

Pestañas

Las pestañas (Tabs) nos permiten seleccionar entre varias vistas. vistas.

Otros

También es muy frecuente el uso de iconos en cuadros de dialogo y en ListView.

Ejemplos

0 1 fl 0 0 0

e

Dtater

Cafl tog

Contacrs

Tabla 1: Tipos de iconos en Android. Android.

Si estás interesado en utilizar iconos sistema, encontrarás el ¡conos disponibles en el sistema, inconveniente de no poder seleccionar el que te interese de forma sencilla. sencilla. Recuerda como en el punto 6 del último ejercicio, cuando introducías el campo /con ... para Icón en la definición de un ítem de menú, menú, no disponía del botón Browse Browse... lista. Para conocer los iconos disponibles te poder seleccionar el icono desde una lista. recomendamos que utilices el primer enlace de la lista mostrada a continuación. continuación. Si por el contrario decides diseñar tus propios iconos has de tener en cuenta algunos aspectos. aspectos. En primer lugar, recuerda que Android ha sido concebido para ser utilizado en dispositivos con gran variedad de densidades gráficas. gráficas. Este rango puede ir desde 100 pixeles/pulgada (ldpi) (Idpi) hasta 340 pixeles/pulgada (xhdpi). (xhdpi). Por lo tanto, resulta interesante que plantees tus diseños con una resolución como mínimo de 300 pixeles/pulgada. Cuando se represente en un dispositivo el sistema reajustará el tamaño del icono para que se ajuste al espacio disponible y, por supuesto, supuesto, siempre es conveniente realizar una reducción en lugar de tener que ampliar. ampliar. Ahora bien, bien, en muchos casos este reajuste automático de tamaño puede no ser se satisfactorio (en el siguiente ejercicio se muestra un ejemplo). En estos casos, podremos hacer usos de los recursos alternativos y crear diferentes iconos casos, para diferentes densidades gráficas. gráficas. Para ayudarte en esta tarea puedes utilizar la herramienta Android Asset Studio que se incluye en la siguiente lista de enlaces. enlaces. En segundo lugar, tu aplicación va a ser ejecutada dentro de un sistema donde se utilizan ciertas guías de estilo. Si quieres que tus iconos no desentonen lee la documentación que se indica a continuación. continuación.

E@ 5=

Enlaces de interés:

Lista de recursos drawable: En la documentación oficial de Android no aparece un listado con los recursos disponibles. Para ver gráficamente todos los recursos drawabe drowabe del sistema puedes acceder a la siguiente página: http://androiddrawableexplorer.appspot.coml híln://androiddrawahleexplorer.appspot.com/

103

El gran libro de Android lla util izando Android Asset Studio: Puedes crear tus propios iconos de forma senci sencilla utilizando la siguiente herramienta online: index. htnil http://android-ui-lttils.googlecode.com/hg/asset-sttldioídistí http://androkl-w-utils.iiooetecode.com/he/asset-stttdio/dist/index.htinl

Guía de estilo para iconos: La siguiente página describe las guías de esti lo para estilo los iconos en las distintas versiones de Android: Android: http://developer. android. com/ com/euide/practices/ui Unes/icón tan, html guíde/áractices/ui anide guidelinesí icon des design. http://deve/oper.

w®!"' Ejercicio paso a paso: Creación de iconos íconos personalizados. personalizados. Si te gusta el diseño o lo consideras interesante para tu formación, formación , pueden resultar de gran utilidad las herramientas descritas anteriormente. anteriormente. Veamos un empresa, nos acaba de pasar el ejemplo práctico: práctico: El diseñador gráfico de nuestra empresa, icono asociado para iniciar a la aplicación q e estamos diseñando (launcher icon). que icón).

Aplicación El problema es que no estamos seguros de que se va a ver correctamente para las diferentes densidades gráficas que podemos encontrar en los dispositivos Android. Android. Para asegurarnos que esto sea así realizaríamos los siguientes pasos: pasos: 1.

Descarga el gráfico anterior de www.androidcurso.com www.androidcurso com y llámale icon.png.

2.

Studio: Accede a Android Asset Studio: http://android-ui-utils.googlecode.com/hg/asset-studio/distlindex.html httD.//android-ui-utils.qooqlecode.com/hq/asset-studio/dist/index. html

3.

icons. Selecciona la opción Launcher icons.

4.

Pulsa sobre el botón lmage Image y selecciona el fichero anterior. anterior,

5.

En la sección Output images podrás previsualizar como quedarán las imágenes para las cuatro densidades gráficas de Android. Android.

ApilCi ( ktn

104

Actividades e e Intenciones

6.

El resultado solo es aceptable para la opción xhdpi. xhdpi. En el resto de los casos ha desaparecido alguna línea o el texto no se lee. lee. Va a ser imprescindible retocar estos iconos. iconos.

.

.

7.

^ . , . i! O Downloild Download .ZIP 1 Descarga el fichero pulsando en ' l.i.

8.

Retoca el icono hdpi para que se vean todas las líneas azules. azules.

9.

Retoca el icono mdpi y ldpi Idpi para que se pueda leer el texto "Aplicación".

10. Asigna los iconos retocados a las carpetas adecuadas (resldrawable) {res/drawable) de una aplicación (por ejemplo la creada en la sección "Comunicación entre actividades"). 11. Visualiza el resultado instalando la aplicación en diferentes dispositivos con diferentes densidades gráficas. gráficas.

a

a

1. 1,

Práctica: Creación de íconos Asteroides. iconos pera Asteroides. Repite los pasos indicados en el ejercicio anterior para crear un icono que sea utilizada para iniciar la aplicación Asteroides. Asteroides.

3.5. Añadiendo preferencias de usuario usuario 3.5. Añadiendo preferencias de Android nos facilita la configuración de nuestro programa, al permitir añadir una lista de preferencias que el usuario podrá modificar. Las preferencias también pueden ser utilizadas para que tu aplicación almacene de forma permanente función . información. En el capítulo 9 se estudiará cómo realizar esta función.

n

PoH[Media]: Android. Poli[Media |: Añadir preferencias en Android.

Ejercicio paso a paso: Añadiendo preferencias a Asteroides. Asteroides. 1.

Abre el proyecto Asteroides. Asteroides.

2.

Pulsa con el botón derecho sobre la carpeta res y selecciona la opción Other... New > Other ... Selecciona Android > Android XML File. File.

3.

Completa los siguientes campos Resource Type: Preference, Preference, File: preferencias.xml. reslxmllpreferencias.xml. preferencias.xml. Se creará el fichero res/xml/preferencias.xml

4.

Selecciona la lengüeta preferencias.xml para editar el fichero en xml.

105

El gran libro de Android 5.

Introduce el siguiente código: código: c?xml version=" 1. O" encoding="utf-8"?> encoding="utf -8" ·?>
android: key= 1'_prefel~encias_px-inci_pal 11 >> android;key="preferencias_principal" cCheckBoxPreference
11

android:summary=" E;n. cuantos trozos troz os se ddivide .i v.it:ie un android: summary» "En

as t e roide~~ asteroide"

android:defaultValue=" "/ > android:defaultValue= "33 "/> c/PreferenceScreen>

El resultado que obtendremos se muestra a continuación: continuación :

Reproducir música Se réprodyié mói&a (te Tipo de gráficos ( :e escoge lé ?&pres«íiTpon tí# ios gráficos

oiEaaEQR vectorial

Número de Fragmentos tu ttcMios iro¿os 5« divide un asteroide

bítmap bitrnap

6.

Para almacenar los valores del desplegable has de crear el fichero lres/va/ues/arrays.xml contenido: /res/values/arrays.xml con el siguiente contenido: c:resources> name= t i_pos Gr-af.i co.s > vectorial item>vectorial c/item> 11

106

11

Actividades e e Intenciones < iitem>bitmapb i tmap t em> < iitem>3D 3D< / item> i tem> name = " t iposG.r·a r.i.cosV,71 or:t=.·:s >
{

-!t

Ctrl-Shifí-O, para que que automáticamente se se añadan añadan
9.

No hay que olvidar AndroidManifest . xrnl. AndroidManifest.xml.

registrar

toda toda

nueva nueva

actividad actividad

en en

la opción de de menú menú añade añade el el siguiente siguiente 10. Para activar la configuración desde la onOptionsiteniSelectedO código en el fichero Asteroides.java en el método onoptio nsitemSelec t e d ( l dentro del switch. case R.id.config: R.id. confi g : Intent ii = this , Preferencias. class ); = new Intent( Intent(this, Preferencias.class); startActivity(i); break break;;

puedes lanzar lanzar las las preferencias preferencias 11. Arranca la aplicación y verifica que puedes mediante la opción de menú correspondiente. acceder aa las las preferencias preferencias 12. Modifica Asteroides.java para que se pueda acceder botón con con texto texto Configurar. Configurar. tanto desde el menú como desde el botón

107

El gran libro de Android

3.5.1. Organizando preferencias Cuando el número de preferencias es grande resulta resulta interesante interesante organizarlas organizarías de de forma adecuada. Una opción consiste en dividirlas dividirlas en en varias varias pantallas. pantallas. De De forma forma la primera pantalla, pantalla, se se abra abra una una nueva nueva que cuando se seleccione una opción en la pantalla de preferencias. Para anidar las las preferencias preferencias usa usa el el siguiente siguiente esquema: esquema: c PreferenceScreen>

.../> cCheckBoxPreference -1> cEditTextPreference .../> android;title="Modo multijugador"> cCh eckBoxPreference -!> .../> c/PreferenceScreen>

{•> * » m m ■ Práctica: Organízando Organizando preferencías preferencias (/). (I). 1.

Crea una nueva lista de preferencias cP:r·eferenceScreen> dentro dentro de de la la lista de preferencias del fichero reslxmllpreferencias.xml. res/xml/preferencias.xml.

2.

android: title el el valor "Modo "Modo multijugador". multijugador". Asígnale al parámetro android:

3.

Crea tres elementos dentro de esta lista: lista: Activar Activar multijugador, multijugador, Máximo Máximo de de jugadores y Tipo de conexión. Para este ultimo han han de de poder poder escogerse escogerse los valores: valores: 8/uetooth, Bluetooth, Wi-Fi e Internet.

Otra opción para organizar las preferencias preferencias consiste consiste en en agruparlas agruparlas por por categorías. Con esta opción se visualizarán en en la la misma misma pantalla, pantalla, pero pero separadas separadas por grupos. Has de seguir el siguiente esquema: c PreferenceScreen> cCheckBoxPreference /> cEditTextPreference > android:Citle-"Modo multijugador"> /> c«CheckBoxPreference Chec kBoxPreference -.../> cEditTextPreference .../>

A continuación se representa la forma en la la que que Android Android muestra muestra las las categorías: categorías:

108

Actividades e e Intenciones

Reproducir música

Sí reprociuce oí&acs ds fc:1d<) fcodo

:~f:' fi:
Tipo de gráficos

•

tos gráficos Jdf!(CJS Ss fícogí l::!la frr:pres~r;tCDúfl í pres«níí non d~ de los

S~ ~~<:OJ?.

Número Numero de Fragmentos :;u&HO~ esoícs t~ 01:(::; x )"=! ::.11\•ldt J~tt: oUe En cuantos divide ti!'! un astei alele

(n

Activar modo multijugaei muitijugac. •| Máximo de Jugadores jugadores Tipo de conexión

é

a

1.

Práctica: Organizando preferencias (//). (II). Modifica la práctica anterior para que en lugar de de mostrar mostrar las las propiedades en dos pantallas, las muestre en una sola, tal y como se se muestra en la imagen anterior.

3.5.2. Como se almacenan las preferencias de usuario Si modificas un valor de una preferencia, este quedará almacenado almacenado de de forma forma dispositivo. Para conseguir esta persistencia persistencia Android Android utiliza utiliza un un permanente en el dispositivo. la carpeta carpeta fichero xml que se almacena en el sistema de ficheros. Se utiliza la de esta esta carpeta, shared_prefs para almacenar los ficheros de preferencias. Dentro de se utiliza utiliza el el fichero fichero para almacenar las preferencias de usuario se nombre,. del .paquete_preferences.xml, donde hay que remplazar nombre . paquete_preferences.xml, remplazar nombre . paquete por el paquete que contiene la aplicación. Esto nombre.. del del.paquete Esto significa significa que solo puede haber unas preferencias de usuario por aplicación. Como Como se se de preferencia, preferencia, pero pero aa estudiará en el capítulo 9 pueden haber otros ficheros de directamente por por diferencia de las preferencias de usuario no pueden ser editadas directamente el usuario sino que hay que acceder a ellas por código.

Ejercicio paso a paso: Donde se almacenan las preferencias de usuario. de crear: crear: Veamos donde se han almacenado las preferencias que acabamos de

1.

Para navegar por el sistema de ficheros de un dispositivo (tanto virtual virtual como como real) accede al menú Windows > Show View > Others Others...... >> Android >File > File

Expl. Expl.

109

El gran libro de Android Androíd 2.

Busca el siguiente siguiente fichero: fichero: /data/data/org.examples.asteroide/shared_prefsl /data/data/org. examples. asteroide/sharedjprefs/ org. examples. ex ampies, asteroide asteroide_preferences. xml. _preferences.xml.

IH Probíem s © Consolé Qp Emú lato j Cl LogCat \ Q Resourc s Cls i Mame

Expl .

: Píopertt i

Si1e St2e , [)ate Date

i>

2010-03-02 2010-03-0Z 2010-06-04 2010·0641 2010-06-07 2010-06-07 2010-06-07 2010-06-07 2010 ·06·09 2010-06-09

ip.co.omfonsoft.openwnn yg» org.example.Shape.Drawñble 1• ¡B. org.exampl-e.Shape_Drawable a ~ org org.example.asteroides ..e:xampl·e.a.steroides. !> ¡B. Iíb m?5 Mb j WS shared_prefs íM org.e3e8fnpl«.asfeeroi d€S_preferen ces.xml p org.exsmpíe.locationtest ~

®¡;. ¡p.co.cmron>oft.openwnn

Irme Time 08:32 0832

15;22 17«4 17;04 17:04 14.-01 14:01 266 2010-06-05 1431 2010-03-10 2010 ·G3 ·10 06:56 06:56

<111

15o2Z 1H l4

Sesrch i Q Des ices ^ B l á •§ i - ^ Info **■ P r:rm~s.icns Jnfo Permi&sions .l. drwxr-xr-x d:rwxr-xr-x drwxr-xr-x ctrvvxr-xr-x drwxr-xr-x d:rVt'Xr-xr-x drwxr-xr-x drwxr-xr-x df1NXrWX--X drwxrwx—x íül -rw-rw—-d~v,;r-xr-x drvvxr-xr-x -

3.

Pulsa el botón del del disquete disquete para para descargar descargar elel fichero. fichero.

4.

Tiene que que ser ser similar similara: a: Visualiza su contenido. Tiene 11

11

3.5.3. Accediendo aa los los valores valores de de las las preferencias preferencias necesario acceder acceder aa los los valores valores de de las laspreferencias preferenciaspara paraalterar alterar Por supuesto, será necesario el funcionamiento de nuestra nuestra aplicación. aplicación. El El siguiente siguiente ejemplo ejemplo nos nos muestra muestracomo como realizarlo: publ ic void mostrarPrefe re ncias() { public mostrarPreferenciasí){ edPreferences( SharedPreferences pref pref == getShar getSharedPreferences< "org. example . asteroides.___ preferences", PFI.IVll.TE) ; "org.example.asteroides preferences", lvJC>DE_ MQDE_PRIVATE); Stri.ng ca : "" +-f- pre f ..getBoolean("música" getBoolean("musi.ca", ,true ) String s"' s = "músi "música: pref true)

.getSt.rin<:J ( "graf i cos ", "? " ) ; +", gráficos: "+ " + pref pref.getString("gráficos; Toas t . makf:Tex t: ( thi s , s, t . LEi"iJGTH_ SJIORT) . show { ) ¡ Toast.¡nakeText(this, s, Toas Toast.LENGTH_SHORT).show();

} La función comienza creando creando el el objeto objeto pref pref de de lala clase clase SharedPrefer·ences SharedPref erencesyy le asigna un fichero de preferencias, preferencias, abriéndolo abriéndolo en en modo modo privado privado (solo (solo nuestra nuestra acceso). A A continuación continuación crea crea elel string string ss yy leleasigna asignalos losvalores valores aplicación tiene acceso). de dos de las () yy las preferencias. preferencias. Se Se utilizan utilizan los los métodos métodos pret. pref getBoolean .getBoolean() pret. get.Stri ng ( l, que pref.get.str.ingo, que disponen disponen de de dos dos parámetros: parámetros: elel valor valor de de key key que que queremos buscar (("música" "mu,3ica " yy "graLcos" } yy el "gráficos") el valor valor asignado asignado por por defecto defectoen en caso de no encontrar esta esta key key.. Finalmente se visualiza visualiza el el resultado resultado utilizando utilizando lala clase clase Toast. Toast. Los Los tres tres parámetros indicados son son el el contexto contexto (nuestra (nuestra actividad}, actividad), elel string stringaamostrar mostraryyelel tiempo que se estará mostrando mostrando esta esta información. información.

110

Actividades ee Intenciones Intenciones

m ■ Ejercicio paso aa paso: paso: Accediendo Accediendo aa los los valores valores de de las las preferencias. preferencias. 1.

anterior en en la la clase clase Asteroides. Asteroides. Copia la función anterior

2.

un botón. botón. Por Por ejemplo, ejemplo, Jugar. Jugar. Asígnala a un

3.

también el el resto resto preferencias preferencias que que hayas hayas introducido. introducido. Visualiza también

S—T Preguntas de repaso yy reflexión: reflexión : Menús Menús yy preferencias. preferencias.

3.6. Añadiendo una una lista lista de de puntaciones puntaciones en en Asteroides Asteroides 3.6. Añadiendo Muchos videojuegos permiten permiten recordar recordar las las puntuaciones puntuaciones de de partidas partidas anteriores, anteriores,de de jugador puede puede tratar tratar de de superar superar su su propio propio récord récord oo mejorar mejorar elel de de esta forma, forma, un jugador otros jugadores. jugadores. En el capítulo 99 estudiaremos estudiaremos varios varios métodos métodos para para que que esta esta información información se se almacene permanentemente permanentemente en en el el sistema. sistema. En En elel capítulo capítulo 10 1Oestudiaremos estudiaremos como como podemos compartirlo utilizando utilizando Internet. Internet. En En este este capítulo capítulo nos nos centraremos centraremos en en representar esta lista de de puntuaciones puntuaciones de de forma forma atractiva atractiva utilizando utilizandolalavista vistaListview. Listview. Vamos a intentar que que el el mecanismo mecanismo de de acceso acceso aa esta esta lista lista de de puntuaciones puntuaciones sea lo más independiente independiente posible posible del del método método final final escogido. escogido. Con Con este este propósito, propósito, vamos a definir la interfaz interfaz AimacenPuntuaciones. AlmacenPunt.u ac i ones.

Ejercicio paso aa paso: paso: El interfaz interfaz AimacenPuntuaciones. AlmacenPuntuaciones. 1.

aplicación Asteroides. Asteroides. Abre la aplicación

2.

Pulsa con el el botón botón derecho derecho sobre sobre lala carpeta carpeta de de código código (srclcom.example.asteroides) selecciona New New >>Interface. (src/com.example.asteroides) yy selecciona Interface.

3, 3.

En el campo Ñame Name introduce introduce AimacenPuntuaciones AlmacenPuntuaciones yy pulsa pulsa Finish. Finish.

4, 4.

Introduce el código que Introduce que se se muestra muestra aa continuación: continuación: public interface interface AimacenPuntuaciones AlmacenPuntuaciones {{ public void v o íd guardarPuntuacióníint guardarPuntuacion( int puntos,String ptm tos , St.ring nombre,long notnbre, long fecha); fecha); public publ ic Vector Vector listaPuntuaciones(int l istaPuntuac i o n es{ ínt cantidad); cantidad);

}

111

El gran libro de Android

j) á>

<:-:::asüssss*' Nota sobre Java: La interfaz inlerfaz es una clase abstracta pura, es decir una clase donde se indican los métodos pero no se imple implementa menta ninguno (en este caso se dice que los métodos son abstractos). Permite al programador de la clase establecer la estructura de esta (nombres de métodos, sus parámetros yy tipos que retorna, pero no el código de cada método). Una interfaz también puede contener constantes, es decir campos de tipo static yy final.

Las diferentes clases que definamos para almacenar puntuaciones han de implementar esta interfaz. interfaz. Como ves tiene dos métodos. métodos. El primero para guardar la puntuación de una partida, con los parámetros puntuación obtenida, obtenida, nombre del jugador y fecha de la partida. partida. La segunda es para obtener una lista de puntuaciones previamente almacenadas. almacenadas. El parámetro cantidad indica el número máximo de puntuaciones que ha de devolver. 5. 6.

Veamos a continuación una clase que utiliza esta interfaz. interfaz. Para ello crea en el proyecto la clase AlmacenPuntuacionesArray.

6.

Introduce el siguiente código: código; public class AlntacenPuntuacionesArray PúmacenPuntuacionesArray implements AlvnacenPuntuacionesf Alrr.-'lcenPuntuaciones {

private VectorcString> puntuaciones; p unt uaciones; prívate Vector public AlmacenPuntuacionesArray;) AlmacenPuntuacione sArray() {{ puntuaciones -~ new Vector(); VectorcString>(); puntuaciones.add( " J.2 3 000 Pepito Pepi to Domingez"); Domj_nge z''i; puntuaciones.add("123000 ppuntuaciones,add("111000 u nt uac i o n es.add( " lllOOO Pedro Martínez"}; Marti n ez•); puntuaciones.add("OllOOO Pérez " i; puntuaciones.add("011000 Paco Pérez");

} l"üOverride i c void gua rdarPuntuacion( int puntos, ©Override publ public guardarPuntuacioníint String nombre, nombre , loag long fecha)

{

puntu aciones.add(O, punto puntuaciones.add(0, puntoss +t· "" "" + nombre);

} @üvex:dck VectorcString> listaPuntuaciones

return

puntuaciones ; puntuaciones;

} } Esta clase almacena la lista de puntuaciones en un vector de String. String. Tiene el inconveniente de que al tratarse de una variable local, cada vez que se cierre la aplicación se perderán penderán las puntuaciones. puntuaciones. El constructor inicializa el array e introduce tres valores. valores. La idea es que aunque todavía no esté programado el juego y no podamos jugar, jugar, tengamos ya algunas puntuaciones para poder representar reoresentar una lista. lista. El método

112

Actividades e e Intenciones guardarPunt.uacion guardarPuntuacion () (> se limita a insertar en la la primera primera posición posición del del array un String con los puntos y el nombre. La La fecha no es es almacenada. almacenada. El método listaPuntuaciones lístaPuntuaciones () o devuelve el vector de de String String entero, entero, sin tener en cuenta el parámetro cantidad que debería limitar limitar el el número número de Strings devueltos. devueltos.

7.

En la actividad Asteroides tendrás que declarar una variable variable para para almacenar las puntuaciones: puntuaciones; public static AlmacenPuntuaciones aalmacén lmacen == new AlmacenPuntuacionesArrayí); AlmacenPuntuacionesP.rray () ;

J,

<""7'":;::::r Nota sobre Java: El modificador static permite compartir compartir el el valor valor de de una una variable entre todos los objetos de la clase. Es decir, decir, aunque aunque se se creen creen varios varios objetos, objetos, solo existirá una única variable almac2n almacén compartida por todos todos los los objetos. objetos. El El fuera de de la la clase. clase. Por Por lo lo modificador public permite acceder a la variable desde fuera Para acceder acceder aa esta esta variable variable tanto, no será necesario crear métodos getters yy setters. Para de un un punto yy el el no tendremos más que escribir el nombre de la clase seguida de nombre de la variable. Es decir Asteroides. almacen almacén.

8.

puntuaciones obtenidas, obtenidas, Para que los jugadores puedan ver las últimas puntuaciones modifica el cuarto botón del layout main. xml para que main.xmi que en lugar lugar del del texto texto modifica los los ficheros ficheros "Salir" se visualice "Puntuaciones". Para ello modifica res/values/strings. También sería interesante que que cambiaras el el fichero fichero res/values ·-en/ strings. res/values-en/strings.

9.

botón para para que que llame llame al al método: método; Modifica el escuchador asociado al cuarto botón public void lanzarPunr.uaci.ones (Vi.ew view) {{ lanzarPuntuaciones(View Intent ii = Intent( this , Puntuaciones .class); - new Intent(this, Puntuaciones.class); startActivity(i);

} 10. De momento no te permitirá ejecutar la aplicación. Hasta que que en en el el siguiente siguiente no será posible. apartado no creemos la actividad Puntuaciones no 3.7. 3. 7. La vista ListView Listview visualiza una lista deslizable verticalmente de de varios varios elementos, elementos, Una vista ListView Layout .Su .Su utilización utilización es es algo algo donde cada elemento puede definirse como un Layout en la la siguiente siguiente figura: figura: compleja, pero muy potente. Un ejemplo lo podemos ver en Welcome 10 Voicln The Voicín De hace 190 días Vo-cfn Hntdquartm Necesitas que te ayude? Support De hace 173 días k Volcin Headauarters, Barceiona, Spam I lose l. ^P>

De hace 93 dtas

113

El gran libro de Android Listview los siguientes siguientes cuatro cuatro pasos: pasos: El uso de un Li s tView conlleva los •

Diseñar un Layout que lo contenga contenga al al LListview. i stvie~".

•

que se se repetirá repetirá en en la la lista. lista. Diseñar un Layout individual que

•

Implementar una actividad que lo lo visualice visualice el el Layout Layout con con el el ListView. Listview.

•

de los los Layouts Layouts individuales individuales según según nuestros nuestrosdatos. datos. Personalizar cada una de

Veamos estos pasos con más detalle: detalle: s tView dentro Para utilizar un Li Listview dentro de de un un Layout Layout has has de de usar usar lala siguiente siguiente estructura: estructura:

< FrameLayout>
android : id=''@andrvid: .id;'.l.ist N android:id="Sandroid:id/list"

... . ~ . /> / >
/ >



Donde tenemos un FrameLayout FrameLayout que que me me permite permite visualizar visualizar dos dos posibles posibles elementos, uno u otro, pero no no los los dos dos simultáneamente. simultáneamente. El El primero primero es es elel L.istView Listview que se visualizará cuando haya haya algún algún elemento elemento en en la la lista. lista. El El segundo segundo puede puede ser ser cualquier tipo de vista y se se visualizará visualizará cuando cuando no no existan existan elementos elementos en en lala lista. lista. ElEl sistema controla la visibilidad visibilidad de de forma forma automática, automática, solo solo has has de de tener tener cuidado cuidado de de identificar cada uno de los elementos elementos con con el el valor valor exacto exacto que que se se muestra. muestra.

NOTA: Recuerda que para crear nuevos nuevos identificadores identificadores debes debes utilizar utilizar la la expresión expresión "@ ". El "@ ·+.icl/nornhre_.i t i d/nonthre^J elent:i den t i f.icador ti csdor". El carácter carácter @ @ significa significa que que se se trata trata de de un un identificador de recurso (es (es decir decir se se definirá definirá en en la la clase clase Rjava). R.java). El El carácter carácter ++ significa que el recurso ha de de ser ser creado creado en en este este momento. momento. En En este este caso caso hemos hemos utilizado identificadores que que ya ya han han sido sido definidos definidos en en el el sistema sistema (es (es decir decir @andro.id: Sandroid: significa que es un un recurso recurso definido definido en en la la clase clase android.Rjava). android.R.java). Una vez creado el Layout Layout que que contiene contiene el el ListView Listview tendremos tendremos que que visualizarlo en una actividad. Para Para este este propósito propósito utilizaremos utilizaremos un un tipo tipo de de actividad actividad especial, ListActivity. También tendremos que indicar indicar al al sistema sistema cada cada uno uno de de los los Layaouts Layaouts individuales individuales que contendrá el Listview. Esto (). Esto lo lo haremos haremos llamando llamando al al método método set:ListAdapter setListAdapterO. Existen varias alternativas con con diferentes diferentes grados grados de de dificultad. dificultad. Para Para una una mejor mejor comprensión iremos mostrando tres ejemplos ( l, de ejemplos de de uso uso de de setListAdapter setListAdapterO, de más más sencillo a más complejo. fc®© 16 3S SiíD 16:32 ©ES

114

Actividades e Intenciones Las capturas anteriores muestran muestran los los tres tres ListView ListView que que vamos vamos construir. construir. El El de de la izquierda se limita a mostrar una una lista lista de de Strings. Strings. El El del del centro centro visualiza visualiza una una lista lista de un Layout diseñado por por nosotros. nosotros. Aunqu,e Aunque este este Layout Layout tiene tiene varios varios componentes (una imagen y dos dos textos), textos), solo solo cambiamos cambiamos uno uno de de los los textos. textos. En En elel último ejemplo cambiaremos también también la la imagen imagen de de cada cada elemento. elemento.

3.7.1. Un ListViewque ListView que visualiza una una lista lista de de Strings Strings

Ejercicio paso a paso: Un LístView ListView que que visualiza visualiza una una lista lista de de Strings. 1.

El Layout que utilizaremos en en Asteroides Asteroides para para mostrar mostrar las las puntuaciones puntuaciones se llamará puntuaciones. xml. En puntuaciones.xmi. En el el se se incluye incluye una una vista vista ListView. Listview. Crea el Layout con el siguiente código: código: aandroid:layout_height="fill_parent"> n droid:text.Size= "1 0pt " " Í>


android:: layout layout__width= "fill_jparent" android ....width= "f i ll__parent " android:layout_ height=" Odip " android:layout_height="Odip" android:layout_ weight=" 1"> android:layout_weight="1"> android :drawSelectorOnTop= " .fa.lse" Í>
a.ndroid: id= " @a.nd.r-oi.ci: .id/em¡Jty " android:id="©android;id/empty" android:layout_width= android: layout_width= ""fill_parent" fi..U .....Parent" android : layout_height= "" f.i.l.I ...].)a.rent" android:layout_height= fi 1 .¡.....parent"

android: text = "No > androiol:text= "No hay puntuac:i.ones puntuaciones"" 1/> <íLinearLayout>

115

El gran libro de Android 2.

crear la la actividad actividad Puntuactones Puntuaciones para para visualizar visualizar elel Necesitamos ahora crear Crea una una nueva nueva clase clase en en tu tu proyecto proyecto ee introduce introduce elel Layout anterior. Crea siguiente código: ppublic ubl i c cla ss Puntuaci.oneE class Puntuaciones extends extends List:Activity ListActivity {{ public void onCreate (EundJ.e .,¡¡override SOverride void onCreate(Bundle savedinst.anceState) savedlnstanceState) super . oncr·eate ( savedi ns tanceState) ; super.onCreate(savedlnstanceState); setContentVtew(R.layout.puntua c iones); setContentView(R.layout.puntuaciones); setListAdapter(new this , setLis'cAdapter (new ArrayAdapter( ArrayAdapter íthis, androi.d. R. layout. s.ímp.le ___ .l. .i st _____ .?~ tt:mt ___ .1. android.R. layout. siinple_list_item_l,

{

1

.l\sterotdes. alma e en . .1. t st.aPunt.uac iones (.J. O) ) ) ; Asteroides.almacén.listaPuntuaciones(10)i);

} } que vaya vaya aa visualizar visualizar un un ListView Listview ha ha de de heredar heredar de de Toda actividad que Li.stActi.vi ty. Además, ha stAdapter() para ListActivity. ha de de llamar llamar alal método método setLi. setListAdapterO para indicar la lista de elementos elementos aa visualizar. visualizar. Este Este método método funciona funcionade dediferente diferente manera según los parámetros parámetros que que se se indiquen indiquen (ver (versobrecarga sobrecargaen enJava). Java). En En utilizado una una de de las las posibilidades posibilidades más más sencillas, sencillas, usar usarcomo como el ejemplo se ha utilizado de la la clase Clase ArrayAdapter. ArrayAdapter. Un Un ArrayAdapter ArrayAdapter actúa actúa parámetro un objeto de un ListView ListView yy el el suministrador suministrador de de información, información, en en este este como puente entre un de la la lista lista se se define define como como un un Strings Strings de de un un array. array. ElEl caso, cada elemento de constructor de esta clase clase tiene tiene tres tres parámetros: parámetros: El El primer primer parámetro parámetroes esun un cont.ext context con información sobre sobre elel entorno entorno de de lala aplicación. aplicación. Utilizaremos Utilizaremos como contexto la la misma misma actividad actividad que que hace hace lala llamada. llamada. ElEl segundo segundo parámetro es un Layout, Layout, utilizado utilizado para pa'a representar representarcada cadaelemento elementode delalalista. lista. en lugar lugar de de definir definir uno uno nuevo, nuevo, utilizaremos utilizaremos una unaya yadefinido definido En este ejemplo, en El último último parámetro parámetro es es un un array array con con los los strings strings aa mostrar. mostrar. en el sistema. El istaPu.ntuaciones (O ¡ que Para ello, llamamos al al método método 1listaPuntuaciones que nos nos devuelve devuelve esta lista del objeto estático estático al.macen almacén de de lala clase ClaseAsteroides. Asteroides. 3. 3.

Recuerda que que toda toda nueva nueva actividad actividad ha ha de de ser ser registrada registrada en en Android1'1anifest AndroidManif est... xnü xml..

4.

Prueba si funcionan funcionan las las modificaciones modificaciones introducidas. introducidas.

3. 7 .2. Un ListView que 3.7.2. que visualiza visualiza Layouts Lsyouts personalizados personalizados Vamos a personalizar el el Listview Listview anterior anterior para para que que cada cada elemento elementode delalalista listasea sea Layouf definido por por nosotros. nosotros. Para Para ello ello sigue sigue los los siguientes siguientespasos: pasos: un Layout

®

1. 1.

Ejercicio Ejercicio paso paso aa paso: paso: Un Un ListView ListViewque que visualiza visualiza Layouts Layouts personalízados. personalizados. Remplaza la clase clase anterior anterior por: por: public xtends ListActivity public class Puntuaciones Puntuaciones eextends ListActivity {{ @(rverride oíd oonCreate(Bundle n CreateíBundle savedlnstanceState) •SOverride public vvoid savedlnstanceState) super .onCreate(savedlnsta nceState);; super.onCreate(savedlnstanceState) setContentView (R. J.ayout .puntuac.iones); setContentView(R,layout.puntuaciones);

116

{

Actividades e Intenciones setListAdapter( new P.rrayhdapter ( this , ArrayAdapter{this, layout . element o_ lista, R. layout. elemento__lÍ8ta, R. id. titulo, R.id.título. Asteroides.almacen.listaPuntuaciones(lO))i; Asteroides.almacén.listaPuntuaciones(10)));

} } Como hemos explicado, la la clase clase ArrayAdapter ArrayAdapter permite permite insertar los datos desde desde un un array array de de stri.ng string en en nuestro nuestro Listview. Listview. En En este ejemplo se utiliza un un constructor constructor con con cuatro cuatro parámetros: parámetros: thia: this: es el contexto, con con información información sobre sobre el el entorno entorno de delalaaplicación. aplicación. R . layout. el emento_ list a : es r.layout.eieinento_iieta: es una una referencia referencia de de recurso recurso aa lala vista vista

que será utilizada repetidas repetidas veces veces para para formar formar lala lista. lista. Se Se define define a continuación. R . id. titulo: identifica r.id. identifica un un id id de de la la vista vista anterior anterior que que ha ha de de ser ser un un TextView. Textview. Su texto será será reemplazado reemplazado por por el el que que se se indica indica en en elel siguiente parámetro. Aste:núdes.a J.macen. listaPuntuaciones(lO): vector Asteroides.almacén.listaPuntuaciones{10): vector de de String String que serán serán visualizados visualizados en en cada cada uno uno de de los los con los textos que Text view. Esta lista Textview. lista es es obtenida obtenida accediendo accediendo aa lala clase clase Asteroides a su variable variable estática estática almacen almacén llamando llamando aa su su método listaPuntuaciones lista.Puntuaciones () {).. 2.

de definir definir el el Layout Layout que que representará representará cada cada uno uno de de los los Ahora hemos de Crea el el fichero fichero res/Layoutlelemento_lista.xml res/Layout/elementoJista.xml con con elementos de la lista. Crea el siguiente código: android:layout_height="?android:attr/listPreferr:editemHeight" > android:src="®drawable/asteroide2"/> : id="®+id/titulo" /> <
117

El gran libro de Android android: t.ext="Otro Texto" Tex.to" android:layout_toRightOf= "@id/icono" android:Iayout_toRightOf="®id/icono" android:layout_below="®id/titul.o" and roí d: 1 ayout_be.l ow= " ® id /1 i tul o " android:layout_alignParentBottom=" true" android:layout_alignParentBottom="true" android:gravity= "center"/> android:gravity="center"/> <:/RelativeLayout>

Este Layout representa una imagen a la izquierda con dos textos a la superior. Para combinar estos derecha, uno de mayor tamaño en la parte superior. elementos se ha escogido un Relat iveLayout, iveLayout. , donde el ancho se establece a partir de un parámetro de configuración del sistema ?android : attr/listPrefen·edltemHeight . El primer elemento que ?android:attr/listPreferreditemHeight. contiene es un imageview I rnageviev" alineado a la izquierda. izquierda. Su alto es la misma que el contenedor (f ( fill~oarent) iii_parent) mientras que el ancho se establece con el mismo parámetro que el alto del contenedor. Por lo tanto la imagen será cuadrada. 3.

Las imágenes utilizadas en la aplicación Asteroides puedes descargarlas de www.androidcurso.com. Copia el fichero asteriode2.png a la carpeta res/drawable. resldrawable.

4.

resultado. Ejecuta la aplicación y verifica el resultado.

3.7.3. Un ListView con nuestro propio adaptador En el ejercicio anterior hemos visto como podíamos asociar un Layout definido por Listview y personalizar uno de sus textos. Si queremos algo más nosotros al Lístvíew adaptable, como cambiar las fotos o cambiar varios textos, textos, tendremos que escribir nuestro propio adaptador de List.Vi.ew Llstview extendiendo la clase Base.Adapter. BaseAdapter. En esta clase habrá que sobrescribir los siguientes cuatro métodos: métodos: View getview;int getView (int position, posit.ion, View convertView, convert.View, V.lewGroup ViewGroup parent) Vlew

Este método ha de construir un nuevo objeto view con el Layout correspondiente a la posición position y devolverlo. devolverlo. Opcionalmente podemos partir de una vista base convertView para generar más rápido las vistas. vistas. El último parámetro corresponde al padre al que la vista va a ser añadida. añadida. getCount () int getCount()

Devuelve el número de elementos de la lista. (int position) Object getitem getltem{int

Devuelve el elemento en una determinada posición de la lista. getitemid(int position) long getltemldíint

Devuelve el identificador de fila de una determinada posición de la lista. lista. Veamos un ejemplo: ejemplo:

Ejercicio paso a paso: Un ListView LístVíew con nuestro propio adaptador. adaptador. 118

Actividades e e Intenciones 1.

Crea la !a clase MiAdaptador.java MiAdaptadorjava en el proyecto con el siguiente código: código: public class !VliAdaptador BaseAdapter { MiAdaptador extends BaseAdapcer private final Activity actividad; prívate private final Vector<;String> VectorcString> lista; prívate public MiAdaptador(Activity actividad, actividad. Vector lista) {{ super(); super() ; this .actividad = = actividad; this.actividad this.lista = = lista;

}
} @Override getitem(int argO) {{ ©Override public Object getltem(int return lista.elementAt(argO); l ista .elementAt(argO);

} ®Override public long getltemld(int getitemid(int. position) {{ ©Override return position; }

}

119

El gran libro de Android En el constructor de la clase se indica la actividad donde se ejecutará y la lista de datos a visualizar. visualizar. El método más importante de esta clase es getview ( l el cual tiene que construir los diferentes Layouts que serán getviewí) añadidos en la lista. lista. Comenzamos construyendo un objeto view a partir del código xml definido en e/emento_lista.xml. elementojista.xml. Este trabajo se realiza por Luego, se modifica el texto de uno medio de la clase Layoutinfiater. Layoutinflater. Luego, arrsy que se pasó en el constructor. de los Textview Text.View según el array constructor. Finalmente, se obtiene un número al azar (Math.roundO) (rvra th. round (} ) y se asigna uno de los tres gráficos de forma aleatoria. aleatoria.

2. 2.

Puntuac i ones la llamada al constructor de Remplaza en la clase Puntuaciones ArrayAdapter ArrayAdapter por: por: set.ListAdapter( new MiAdaptador(this, setListAdapter{new MiAdaptador{this. Asteroi.des .almacen .listaPuntuaciones(J.O))); Asteroides.almacén.1istaPuntuaciones(10))!¡

Ejecuta la aplicación y verifica el resultado. resultado.

NOTA: En algunos casos el adaptador ha de trabajar con listas muy grandes o estas listas han de ser creadas desde un servidor. En estos casos es mejor ir solicitando la información información a medida que se va representando. representando. Un ejemplo se muestra en la aplicación ApiDemos Ap.i.Demos descrita en el capítulo 1, en la actividad: com . example.android.apis.view.L i st13 com.example.android.apis.view.Listl3

3.7.4. 3.7.4. Detectar una pulsación sobre un elemento de la lista Un Listview puede tener diferentes componentes que nos permitan interaccionar usuario. Por ejemplo, ejemplo, cada elemento definido en getviewí) con el usuario. getview () puede tener botones para diferentes acciones. acciones. Hay un tipo de interacción muy sencilla de definir. definir. La clase ListActivity tiene un método que es invocado cada vez que se pulsa sobre un elemento de la lista. utilizarlo. lista. El siguiente ejercicio ilustra cómo utilizarlo.

Ejercicio paso a paso: Detectar una pulsación sobre un elemento de la lista.

5* 1.

Añade el siguiente método a la clase Puntuaciones.java: Puntuaciones.java: @Override onListitemClick(ListView listview, l istVi e w, ®Override protected void onListlteraClick(Listview posi.U.on, long id) { V.iew view, v.i.ew, int position, View super .onLi stitemCl ick(listView, view, vi.ew , position, position , id); super.onListltemClick(listview, Object o == getListAdapter getListAdapter() () .getitem(position); .getltemíposition) ,Toast.makeT■ext {this, "Selección: Toast.makeText.( t his , "Selecc ión: " + Integer.toString(position) Integer.toSt.ring(posi.tion) o.toString() ,Toast.LENGTH_LONG) . show(); + " - " + o,toString(),Toast.LENGTHLONG).show();

} 2.

120

Ejecuta la aplicación y verifica el resultado. resultado.

Actividades ee Intenciones Intenciones

3.8. Las Intenciones Intenciones 3.8. Las Una intención representa representa la la voluntad voluntad de de realizar realizar alguna alguna acción acción oo tarea; tarea; como como realizar una llamada de de teléfono teléfono oo visualizar visualizar una una página página web. web. Una Una intención intención nos nos permite lanzar lanzar una actividad actividad oo servicio servicio de de nuestra nuestra aplicación aplicación oo de de una una aplicación aplicación diferente. tipos de de intenciones: intenciones: diferente. Existen dos tipos •

Intenciones explícitas: explícitas: se se indica indica exactamente exactamente elel componente componente aa lanzar. lanzar. Intenciones típica es es la la de de irir ejecutando ejecutando los los diferentes diferentes componentes componentes Su utilización típica Asteroides internos de una aplicación. aplicación. Por Por ejemplo, ejemplo, desde desde la la actividad actividad Asteroides lanzamos AcercaDe por por medio medio de de una una intención intención explícita. explicita.

•

Intenciones implícitas: pueden pueden solicitar solicitar tareas tareas abstractas, abstractas, como como "quiero "quiero Intenciones implícitas: un mensaje". mensaje". Además Además las las intenciones intenciones se se tomar una foto" foto" o "quiero "quiero enviar enviar un de ejecución, ejecución, de de forma forma que que el el sistema sistema mirará mirará cuantas cuantas resuelven en tiempo de aplicaciones han han registrado la la posibilidad posibilidad de de ejecutar ejecutar ese ese tipo tipo de de actividad. actividad. al usuario usuario lala actividad actividad que que Si encuentra varias el el sistema sistema puede puede preguntar preguntar al utilizar. prefiere utilizar.

Además, ha estudiado estudiado en en el el apartado apartado Comunicación Comunicación entre entreactividades actividadeslas las Además, como se ha intenciones ofrecen un servicio servicio de de paso paso de de mensajes mensajes que que permite permite interconectar interconectardatos datos En concreto concreto se se utilizan utilizan intenciones intenciones cada cada vez vezque quequeramos: queramos: entre actividades. actividades. En •

Lanzar una actividad actividad (startActivity (startActi vi ty {)). () ).

•

servicio (startservice (stanservice ()). () ). Lanzar un servicio

•

Lanzar un anuncio anuncio de de tipo tipo broadcast broadcast (sendBroadcast (sendBroadcast (;). () ).

• Comunicarnos con un un servicio servicio (bindservíce (bindService ()). () ). En muchas ocasiones ocasiones una una intención intención no no será será inicializada inicializada por por lala aplicación, aplicación,sisino no ejemplo, cuando cuando pedimos pedimos visualizar visualizar una una página página Web. Web. En por el sistema, por ejemplo, En otras otras ocasiones será será necesario necesario que que la la aplicación aplicación inicialice inicialice su su propia propia intención. intención. Para Paraello ello objeto de de la la clase clase Intent. lntent. se creará un objeto Cuando se crea una una Intención Intención (es (es decir, decir, se se instancia instancia un un objeto objeto de de tipo tipo intent) Intent) esta contiene información información de de interés interés para para que que el el sistema sistema trate trate adecuadamente adecuadamente lala intención o para el el componente componente que que recibe recibe la la intención. intención. Podemos Podemos destacar destacar lala siguiente información: información: Nombre del componente: componente: Identificamos Identificamos el el componente componente que que queremos queremos lanzar lanzarcon con intención. Hay la intención. Hay que que utilizar utilizar el el nombre nombre de de clase clase totalmente totalmente cualificado cualificado (org. example. asteroides. AcercaDe) que que queremos queremos lanzar. lanzar. El El nombre nombre del del (org.exampie.asteroides.AcercaDe) componente es opcional. opcional. En En caso caso de de no no indicarse indicarse se se utilizará utilizará otra otra información información de la intención para para obtener obtener el el componente componente aa lanzar. lanzar.AA este este tipo tipo de de intenciones intenciones se les conocía como intenciones intenciones explícitas. explicitas. Acción: Una cadena de de caracteres caracteres donde donde indicamos indicamos lala acción acción aa realizar realizar (o (o en en caso de un Receptor de anuncios anuncios (Broadcast (Broadcast receiver) receiver) la la acción acción que quetuvo tuvo lugar lugar yy queremos reportar). reportar). La La clase clase intent Intent define define una una serie serie de de constantes constantes para para acciones genéricas genéricas que que son son listadas listadas aa continuación. continuación. No No obstante, obstante, además además de de estas podemos definir definir nuevas nuevas acciones: acciones:

121

El gran libro de Android

Constante

Componente a Acción lanzar

ACTION AC i ION CALL

Actividad

Inicializa Iníciaiiza una llamada de teléfono. teléfono.

ACTION EDIT

Actividad

Visualiza datos para que el usuario los edite. edite.

ACTION ACTION

~~AIN

MAIN

Actividad

Arranca como actividad principal de una tarea. tarea, (sin datos de entrada y sin devolver datos)

l>.CTION ACTION SYNC

Actividad

Sincroniza datos en un servidor con los datos de un dispositivo móvil.

ACTION- BATTERY- LOW

Receptor de anuncios

Advertencia de bacteria baja.

ACTION HEADSET plug PLUG action headset

Receptor de anuncios

Los auriculares han sido conectados o desconectados.

ACTION- SCREEN SCREEN- ON ON ACTION

Receptor de anuncios

La pantalla es activada. activada.

ACTION action_timezone_changed - TU.1EZONE- CHANGED

Receptor de anuncios

Se cambia ¡a la selección de zona horaria. horaria.

Tabla 2: Acciones estándar de las Intenciones. Intenciones.

También puedes definir tus propias acciones. acciones. En este caso has de indicar el paquete de tu aplicación como prefijo. prefijo. Por ejemplo: ejemplo: org.exampie.asteroides. org. example. asteroides. ~1UESTRA PUNTUACIONES. MUESTRA_PONTCJAC IOKES. Datos: Referencia a los datos con los que trabajaremos. trabajaremos. Hay que expresar estos datos por medio de una URI (el mismo concepto ampliamente utilizado en Internet). tel:963228525, http://www.androidcurso.com, Internet). Ejemplos de URis URls son: son: tel:963228525. content://call log/calls .. . En muchos casos resulta importante saber el tipo de content://cali loa/calis... datos con el que se trabaja. trabaja. Con este propósito se indica el tipo MIME asociado decir, se utiliza el mismo mecanismo que en Internet. Ejemplos de a la URI, URI, es decir, text/xml , image/jpeg, image/jpeg , audio/mp3 , . .. tipos MIME son text/xml, audio/mp3,... Categoría: Complementa a la acción. acción. Indica información adicional sobre el tipo de lanzado. El número de categorías puede ser componente que ha de ser lanzado. arbitrariamente ampliado. ampliado. No obstante, obstante, en la clase Intent mtent se definen una serie de categorías genéricas que podemos utilizar.

122 122

Constante

Significado

CATEGORY BROWSABLE

La actividad lanzada puede ser con seguridad invocada por el navegador para mostrar los datos referenciados por un enlace - por ejemplo, ejemplo, una imagen o un mensaje de correo electrónico. electrónico.

Actividades e e Intenciones Constante

Significado

CATEGORY GADGET CATEGORY_GADGET

La actividad puede ser embebida dentro de de otra actividad actividad que aloja gadgets.

CA1'EGORY HOI·1E CATEGORY_HOME

La actividad muestra la pantalla de inicio, inicio, la la primera primera pantalla que ve el usuario cuando el dispositivo dispositivo está está encendido o cuando la tecla HOME es presionada.

CATEGORY LAUNCHER

La actividad puede ser la actividad inicial de de una una tarea tarea yy se muestra en el lanzador de aplicaciones de de nivel nivel superior.

CATEGORY category PREFERENCE preference

es un un panel panel de de preferencias. preferencias. La actividad aa lanzar es

Tabla 3: Categorías estándar de las Intenciones.

Una categoría suele utilizarse junto con con una acción acción para para aportar aportar información información adicional. Por ejemplo, indicaremos ACTION_t-1AIN agtion_ main aa las las actividades actividades que que pueden pueden utilizarse como puntos de entrada de una aplicación. aplicación. Indicaremos Indicaremos además además CATEGORY_LAUNCHER category launcher en la actividad que que será escogida escogida por por defecto defecto para para ser ser lanzada en primer lugar. Extras: Información adicional que será recibida por por el el componente componente lanzado. lanzado. Está Está Estas colecciones colecciones de de valores valores formada por un conjunto de pares variable/valor. Estas se almacenan en un objeto de la clase Bundle. Bundie. Su Su utilización utilización ha ha sido sido descrita descrita en la sección Comunicación entre actividades. actividades. Recordemos Recordemos cómo cómo se se introducían estos valores en un Intent. mtent. intent.putExtra("usuario", intent.putExtra{"usuario", "Pepito Perez"l; Perez"); intent . putExtra("edad", 27); intent.putExtra{"edad", 27);

nuevas actividades aprendimos aprendimos aa lanzar lanzar una una En el apartado Creación de nuevas constructor Intent intent (Context (Context contexto, contexto, actividad de forma explícita utilizando el constructor ciass clase) . Por ejemplo, para para lanzar lanzar la la actividad actividad AcercaDe Acercaoe escribíamos: escribíamos: Class Intent intent = this , AcercaDe. class ); = new Intent( Intentíthis, AcercaDe.class); startActivity(intent); startActivity{intent);

podemos usar usar el el constructor constructor Para lanzar una actividad de forma explícita podemos Intent (String n, uri ÍString actio action, Uri uri). uri). Por ejemplo: ejemplo:

= new Intent(Intent.ACTION_DIAL, Intent(Intent.ACTION_DIAL, Intent intent = URI.pa:rse("t.el:962849347"); URI.parse ("tel:96284S347") ; startActivity(intent); startActivity(intent) ;

startActivityForResuit o si si esperamos esperamos que que la la También se puede utilizar star tAc tivi t yForResult () actividad nos devuelva datos.

Ejercicio paso a paso: paso; Uso de intenciones implícita. implícita. 1.

Crea un nuevo proyecto con nombre Intenciones. Intenciones.

123

El gran libro de Android 2.

El Layout de la la actividad actividad inicial inicial ha ha de de estar estar formado formado por por cinco cincobotones, botones, tal y como se muestra aa continuación: continuación:

abrir jágkia Web trinad»de Teletono Goigfe

man Jar Correo i 3.

actividad principal principal ee incorpora incorpora los los siguientes siguientesmétodos: métodos: Abre la actividad public void pgi·ieb pgWeb (Víew ÍView ··.riew) view) {{ Intent intent: (lnt:en t .ACTION_VIEvi, intent ~- new new lntent IntentÍIntent.ACriON__VIEW, Ud . . parse ( "ht tp: //wvvw . androidcurso. com/") ) ; Uri.parse("http://www.androidcurso.com/")) startActivity(intent); startActlvity(intent);

} public void llamadaTelefono(View llaraadaTelefono(View view) view) {{

Intent Intent int.ent intent == new new Intent Intent (Intent..ACTION_C.l.\I_,L, (Intent .ACTIOK__CALL, Uri. . parse("te1.:962849347")); Uri.parse{"tel:962849347")); startActivity(intent); startAct ivity(intent);

public void googleMaps (View view) googieMaps(View view) { Intent (Intent . ACTION_VIEI'l, Intent int.ent intent == new new Intent Intent(Intent.ACTIQK_VIEW, Uri. p arse ( "9eo: 41. 656313, ··O. 877351")) ; Uri.parse("geo:41.656313,-0.877351"));

startAct.ivity(intent); startActivity(intent);

} public void void tomarFoto(View toraarFoto(View view) view) {{ Intent intent "android. media.. act ion. Il'
startActivity(intent); startActivity(intent);

mandarCorreo(View public void mandarCorreo( View vview) iew) {{ Int.ent nt ~= new (Intent . .ACTION_SF.ND) ; Intent inte intent new Intent Intent(Intent.ACTION_SFM)); intent . set:'I'ype("text/plain"); intent.setType í"text/plain"); intent .. putExtra (Inte nt. EXTRA....SSüBJECT, L13JECT, "asunto"); intent.putExtra(Intent.EXTRA "asunto"); intent. putExtra ( Intent. EXTRA____TEXT, ; intent.putExtra(Intent.EXTRA TEXT, "texto "texto del del correo") correo"); intent . putExtra(Int.ent.EXTHA_ Et
124

Actividades e e Intenciones 4.

onclick de cada uno de los botones al método Asocia el atributo onciick correspondiente, correspondiente.

5. 6.

Si ejecutas esta aplicación en un emulador es muy posible que el botón mandar Correo o Google Maps no funcione. funcione. La razón es que no hay ninguna aplicación instalada en el emulador que sea capaz de realizar este tipo de acciones. problemas, Abre el AVD A VD Manager y acciones. Si tienes estos problemas, crea un dispositivo virtual con Google API. Estos dispositivos incorporan Google, como la además de las API de Android, algunas de las API de Google, de Google Maps (Estas API se estudiarán más adelante). adelante).

6.

Ejecuta la aplicación en un terminal real. Observa como el botón mandar Correo te permite seleccionar entre diferentes aplicaciones con esta funcionalidad. funcionalidad.

0 Email

JP;: Mensajes A WhatsApp WhatsApp ~~

'S' •

Wi-Fi

Este resultado puede variar en función de las aplicaciones instaladas.

NOTA; NOTA: En el capítulo 7 se estudiará el tema de la seguridad. seguridad Aprenderás como has de solicitar el permiso adecuado si quieres que tu aplicación llame por teléfono o acceda a Internet. Internet. Cuando estas acciones no las realizas directamente, si no que las pides a través de una intención, no es tu aplicación quien las realiza y por tanto no has de pedir estos permisos.

adicionales; Tabla con Intenciones que podemos Recursos adicionales: utilizar de aplicaciones Google. Google. Aplicación

Browser

URI URÍ

http ://d/recc/or)_ web http://dirección_ https:lldirección _ web h\Xps\lldlrección_web 1111 "" (cadena vacía) http ://dirección_ web http:lldirección_ https:lldirección_ web https :lldirección_web

Acción VIEW WEB_

SEARCH

—

Resultado

Abre una ventana de navegador con una URL. Abre el fichero en la ubicación indicada navegador. en el navegador.

125

El gran libro de Android Androíd Aplicación

URI

tel.número teléfono tel:mímero

Dialer

Resultado

Acción CALL

Realiza una llamada de teléfono. teléfono. Los números validos se definen en IETF RFC 3966. Entre estos se incluye: incluye: tel:2125551212 y tel:(212)5551212. Necesitamos el premiso android. pe:nnission. C.Z\.LL_PHONE android.permission.CALL_PHONE

te\:número_teléfono tel :número_teléfono voicemail: voicemail:

DIAL

Introduce un número sin realizar la llamada.

Google Maps

geo:latitud,longitud geo.latitud,longitud geo:lat,long?z=zoom geo:O,O?q=dirección geo:0,07g=dlrección geo:O,O?q=búsqueda geo.0,0?g=búsqueda

VIEW

Abre la aplicación Google Maps para una localización determinada. determinada. El campo z especifica el nivel de zoom.

Google Streetview

google.streetview: cbll=latitud,longitud& cb\\=latitudJongitud& cbp=1 ,yaw„pltch,zoom& ,yaw, pitch,zoom& mz=mapZoom

VIEW

Abre la aplicación Street View para la ubicación dada. dada. El esquema de URI se basa en la sintaxis que utiliza Google Maps. Maps. Solo el campo cb/1 cbll es obligatorio. obligatorio.

llegar a

a

a

Práctica Práctica:: Uso de intenciones implícitas. implícitas. 1.

Crea nuevos botones en la aplicación del ejercicio anterior y experimenta anterior. A con otro tipo de acciones y URL. Puedes consultar la tabla anterior. continuación tienes algunas propuestas: propuestas:

2.

WEB_ SEARCH. ¿Encuentras alguna diferencia? Compara las acciones VIEW view y web_search.

3.

CALL y dial. DIAL. ¿Encuentras alguna diferencia? Compara las acciones call

4.

Experimenta con Google Streetview

3.8.1. La etiqueta Cuando creamos una nueva actividade, servicio o receptor broadcast podemos ai sistema que tipo de intenciones implícitas pueden ser resueltas con informar al nuestro componente. componente. Para conseguir esto utilizaremos un filtro de intenciones de AndroidManifest.xml. mediante la etiqueta AndroldManifest.xml. Cuando desarrollamos una aplicación lo habitual es utilizar intenciones explicitas, explícitas, que son resueltas utilizando el nombre de la clase. clase. Por lo tanto, tanto, si vamos a llamar a nuestro componente de forma explicita, explícita, no tiene sentido crear un filtro de intenciones. intenciones.

e

Enlaces de interés: Aprender más sobre intenciones. intenciones. •

Deve/opers - Reference: C/ass lntent: Android Developers Class Intent:

http://developer.android.com/reference/android/content/lntent.html http://developer.android.com/reference/android/contenUintent.html

126

•

lntent Filters: Android Developers - Dev Gide: lntents Intents and Intent

•

http://developer.android.com/guide/topics/intents/intents-filters.html http://developer.android.com/quide/topics/intents/intents-fiiters html

CAPÍTULO CAPÍTULO 4. 4.

Gráficos Gráficos en en Android Android

Android nos proporciona, aa través través de de su su API API gráfica, gráfica, una una potente potente yyvariada variadacolección colección de funciones que pueden pueden cubrir cubrir prácticamente prácticamente cualquier cualquier necesidad necesidad gráfica gráfica de de una una aplicación. Podemos destacar destacar la la manipulación manipulación de de imágenes, imágenes, gráficos gráficos vectoriales, vectoriales, animaciones, trabajo con con texto texto oo gráficos gráficos en en 3D. 3D.

introducen algunas algunas de de las las características características más más significativas significativas En este capítulo se introducen del API gráfico de Android. Nos Nos centraremos centraremos en en el el estudio estudio de de las las clases clases utilizadas utilizadas para el desarrollo de de gráficos gráficos en en 2D. 2D. En En el el capítulo capítulo 22 se se describió describiócómo cómose se utilizaban utilizaban las vistas como elementos elementos constructivos constructivos para para el el diseño diseño del del interfaz interfaz de de usuario. usuario. Disponíamos de una amplia amplia paleta paleta de de vistas. vistas. No No obstante, obstante, en en muchas muchas ocasiones ocasionesva va a ser interesante diseñar diseñar nuestras nuestras propias propias vistas. vistas. En En este este capítulo capítulo veremos veremos cómo cómo hacerlo. hacerlo. Trataremos de aplicar lo lo aprendido aprendido en en un un ejemplo ejemplo concreto, concreto, lala representación representaciónde de gráficos en Asteroides. Asteroides. Se Se utilizarán utilizarán dos dos técnicas técnicas alternativas, alternativas, los los gráficos gráficos en en mapa mapa de bits y en formato formato vectorial. vectorial. Al Al final final del del capítulo capítulo se se describen describen las las herramientas herramientas disponibles en Android Android para para realizar realizar animaciones. animaciones. En En concreto concreto se se describirán describirán las las las animaciones animaciones de de propiedades. propiedades. Por Por supuesto, supuesto, resultaría resultaría animaciones Tween yy las todas sus sus funciones funciones para para gráficos, gráficos, por por lolo que que se se recomienda recomienda alal imposible abarcar todas lector que consulte la la documentación documentación de de Android Android para para obtener obtener una una descripción descripción pormenorizada.

Objetivos: •

Enumerar las distintas APIS APIS gráficas gráficas para para 2D 2D yy 3D 3D disponibles disponiblesen en Android. Android.

•

las principales principales clases clases para para gráficos gráficos en en 2D 2D Describir cómo se utilizan las (canvas, (Canvas, Paint y Path}. Path).

•

Introducir la clase Drawable Drawabie yy utilizar utilizar muchos muchos de de sus sus descendientes descendientes (BitmapDrawable, GradienDrawable, GradienDrawable, etc.). etc.).

127

El gran libro de Android aplicaciones. Estudiar cómo crear nuevas vistas yy utilizarlas en distintas aplicaciones.

•

• Aplicar gran parte de lo aprendido en un ejemplo concreto: Asteroides. Asteroides. Describir las herramientas de Android para crear animaciones.

•

4.1. 4.1. Clases Clases para para gráficos gráficos en en Android Android Antes de empezar a trabajar con gráficos conviene familiarizarse con con las clases clases que que nos van a permitir crear y manipular gráficos en Android. A A continuación, continuación, se se introducen algunas de estas clases:

--

,.,.....

... "..,,.., iim Poli[MedÍa]: AP/s para gráficos en Android. •Wür Poli[Media]:

4.1.1 4.1.1.. Canvas canvas representa una superficie donde podemos dibujar. dibujar. Dispone Dispone de de una una La clase canvaB texto, etc. etc. Para Para serie de métodos que nos permiten representar líneas, círculos, texto, Pain t ) donde definiremos dibujar en un canvas necesitaremos un pincel ((Paint) definiremos el el color, color, el el grosor de trazo, trazo, la transparencia, etc. También podremos definir definir una una matriz matriz de de 3x3 3x3 (Matri x ) que nos permitirá transformar coordenadas aplicando (Matrix) aplicando una una translación, translación, escala o rotación rotación.. Otra opción consiste en definir definir un área conocida conocida como como Clip, Clip, de de forma que los métodos de dibujo afecten solo a esta área. Veamos, a continuación, algunos métodos de la clase canvas canvas.. No No se trata trata de un un listado exhaustivo y muchos de estos métodos pueden trabajar trabajar con con otros otros parámetros, por lo tanto se recomienda consultar la documentación del SDK SDK para para una información más detallada. Para dibujar figuras geométricas: geométricas: ddrawCircle(float r awCirclel float ex, float cy, floa t rad i o , Paint float radio, Paint pincel pincel)) drawüval(Rect.F drawOval(RectF ovalo, Paint. Paint pincel) drawRect(RectF l) drawRect. (SectF rectl rect, Paint pince pincel) drawPoint ( float xx,, float yy,, Pain drawPoint(float Paintt pincel) drawPointBi float[S)] pts, Paint drawPoints(float Paint pincel)

Para dibujar líneas y arcos: drawLine( float iniX, i Y, float drawLine(float inix, float in iniY, float finX, finX, float float finY, finY, Paint. pincel) drawLines ( float [] punt.os, drawLines(float[] puntos, Paint pincel) ddrawArc(RectF rawl-1.rc (Rec t F ovalo loat iiniAnglulo, n i An glulo, float n glulo, ovalo,, ffloat float aanglulo, boolean usarCentro, Paint pincel) ddrawPath(Path r awPath(Path ttrazo, razo, Paint pincel pincel))

Para dibujar texto: drawText(String texto, float float x, float y, Paint Paint pincel)

128

Gráficos en Android Androíd drawTextOnPath(String texto, Path Path trazo, trazo, float float desplazamHor, desplazamHor, float desplazamVert. desplazamVert, Paint. Paint pincel) pincel) drawPosText(String texto, float[] float [] posicion, posición, Paint Paint pincel) pincel)

Para rellenar todo el canvas (a no no ser ser que que se se haya haya definido definido un un Clip): Clip): drawColor(int color) drawARGB(int drawARGBÍint alfa, int rojo, rojo, int int verde, verde, int int azul) azul) drawPaint(Paint pincel)

Para dibujar imagines: drawBitmap(Bitmap drawBitmap(Bitraap bitmap, Matrix matriz, matriz, Paint Paint pincel) pincel)

Si definimos un Clip, solo se dibujará en en el el área área indicada: indicada: boolean clipRect(RectF rectangulo) rectángulo) boolean clipRegion(Region clipRegion(Región region) región) boolean clipPath(Path trazo) ti-azo)

Definir una matriz de transformación (Matrix) (Matrix) nos nos permitirá permitirá transformar transformar coordenadas aplicando una translación, escala escala oo rotación: rotación: settvlatrix(fvlatrix setMatrix(Matrix matriz) Matrix getMatrix() getMatrixí) concat(Matrix matriz) translate(float transíate(float despazX, despazX, float float despazY) despazY) scale(float escalaX, float float escalaY) escalaY) rotate(float grados, float float centnJX, centroX, float float centroY) centroY) skew(float despazx, despazX, float float despazY) despazY)

Para averiguar el tamaño del canvas: int int

getEeight() getHeight!) getWidth () getWidthO

Poli[ Media]:|: La clase canvas en Androíd. PolílMedia Android.

Creación de una una vista vista personalizada. personalizada. Ejercicio paso a paso: Creación donde se se crea crea una una vista vista que que es es dibujada dibujada A continuación, se muestra un ejemplo donde por código por medio de un canvas. 1.

con nombre nombre EjemploGraficos. EjemploGraficos. El El nombre nombre del del Crea un nuevo proyecto con example.ejemplograficos. paquete debe ser org. example . ej emplograf ices.

2.

Remplaza el código de la actividad por: por: public clasa class EjemploGraficosActivity EjemploGraficosActivity extenda extends Activity Activity {

129

El gran libro de Android ©Override public void onCreate(Bundle savedlnstanceState) ssuper.onCreate(savedlnstanceState); uper. onC:ceate ( sav·edlnstances tate} ; setContentView( n e w EjemploView( this )); setContentView (new Ej eruploView {this) !;

publ ic class class EjemploView extends extend s View {{ public ppublic ub lic EjemploView (Context contexc) context) { super (context); super(context); } @Overr:ide ©Override void protected vo i d onDraw(Canvas canvas) {{ //Dibujar aquí í/Dibujar

Comienza con la creación de una Activity, pero en este caso, caso, el objeto view que asociamos a la actividad mediante el método setcontentView setcontentview () o no está definido mediante XML. Por el contrario, contrario, es creado mediante Ej emp l oView. código, código, a partir del constructor de la clase EjemploView. La clase EjemploView extiende view, view, modificando solo el método onDraw o ( l responsable de dibujar la vista. vista. A lo largo del capítulo, capítulo, iremos viendo ejemplos de código que pueden ser escritos en este método. método. 3.

Si ejecutas la aplicación no se observará nada. nada. Aprenderemos a dibujar en esta canvas utilizando el objeto Pa i nt descrito en la siguiente sección. sección. Paint

~)

......_-~' Nota sobre Java; Java: Siempre que en un ejemplo aparezca un error indicándote que no se puede resolver un tipo, pulsa Ctrl-Shift-0 Ctrl-Shift-O para añadir los impar/ import de forma automática. automática.

4.1.2. 4.1.2. Paint Como acabamos de ver, ver, la mayoría de los métodos de la clase canvas utilizan un parámetro de tipo Pa.i.nt. Paint. Esta clase nos permite definir el color, color, estilo o grosor del trazado de un gráfico vectorial.

_...

-

, .,_,,~

•

130

Poli[Media]: Androíd. Poli Medía : La clase dase Paint en Android.

Gráficos en Android

Ejercicio paso a paso: paso: Uso de la clase Paint. Paint. 1.

Escribe dentro de onDraw del ejercicio anterior el código siguiente: siguiente: Pa i nt pincel pincel= Pai nt() ; Paint = new Faintí); ppincel.setColor(Color.BLCffi) incel.setColor (C'ol o r .ELUE) ; ppincel.setStrokeWidth(8); inc el . s e t St r okeWidth (B) ; pinc e l. s e t Styl e(Style . STROKE) ; pincel.setStyle(Style.STROKE); canvas.drawCirc l e(150 , 150, 1100, 00 , pincel); canvas.drawCircle(150,

-~t

<;,"';":::::. Nota sobre Java: mpor t el sistema te Java: Si pulsas Ctrl-SIIift-0 Ctrl-Shift-O para añadir los iimport advertirá que la clase style S tyl e está definida en dos paquetes diferentes: !;;hoose type to to smport import ¿hoose type

Page 1 of 1

^ :• andrcid.graphlcs^Paf nt.Styte fl. alJ9wi~-graeh!~l'aintS~~. F

G raphics.PathDashPathEffectStyle © ' aandrcid.g ndrc id .graphics.PathDashPathEffectStyle

j

Te preguntará cuál de los dos quieres importar. importar. No suele resultar complicado resolver este problema si analizas el contexto en el que estás trabajando. trabaj ando. En nuestro caso estamos utilizando la clase Pa in r: por lo que la primera opción es la adecuada. Paint Si alguna vez te equivocas en esta selección, lo normal es que aparezcan errores en el código. En este caso, debes deshacer y seleccionar la otra opción.

2.

resultado. Ejecuta la aplicación para ver el resultado.

Eclipse, prueba otros valores 3. Aprovechando la opción de autocompletar de Eclipse, para color. Color. Y Style. style.

4.

Prueba otros métodos de dibujo, drawLi n e () ( 1 o drawpoint drawPoint (). () . dibujo, como drawLine

4.1.2.1. Definición de colores bits. Estos bits son divididos Android representa los colores utilizando enteros de 32 bits. alfa, rojo, en 4 campos de 8 bits: alfa, rojo, verde y azul (ARGB, (ARGB, usando las iniciales en inglés). inglés). Al estar formado cada componente por 8 bits, bits, podrá tomar 256 valores diferentes. diferentes. rojo, verde y azul son utilizados para definir el color, color, mientras Los componentes rojo, que el componente alfa define el grado de transparencia con respecto al fondo. Un valor de 255 significa un color opaco y, y, a medida que vayamos reduciendo el valor, el dibujo se irá haciendo transparente. transparente. Para definir un color tenemos las siguientes opciones: opciones:

131 131

El gran libro de Android int color; color = Color. BUJE'; Color.BLUE; //Azul opaco opaco //Azul color = Color.argb(l27, Color.argb(127, O, 0, 255, 255, 0); 0); //Verde //Verde transparente transparente color· = Ox7FOOFFOO; //Verde color 0x7F00FF00; //Verde transparente transparente .getColor(R.color.color_Círculo) ; color = getResources() getResources{).getColor(R.color.color__Circulo); una adecuada adecuada separación separación entre entre programación programación yy diseño, diseño, se se Para conseguir una la última última opción. opción. Es Es decir, decir, no no definir definir los loscolores coloresdirectamente directamenteen en recomienda utilizar la el fichero fichero de de recursos recursos res/val res/vaiues/colors.xmi: código, sino utilizar el u es/ colors. xml: vers i on = "l.O'' "utf-8"?> # "coior_circuio">#7fffff00

observar los los colores colores han han de de definirse definirse en en elel fichero fichero col coiors.xmi Como puedes observar ors . xml mediante sus componentes componentes ARGB ARGB en en hexadecimal. hexadecimal.

•—

Ejercicio paso paso aa paso: paso: Definición Definición de de colores. colores.

1.

Modifica el ejercicio ejercicio anterior, anterior, añadiendo añadiendo alal final final de de onDraw OnDraw elel código código siguiente: siguiente: pincel.setColor(Color l27,255,0,0)); pincel. setColor (Color..argb( arg£){127, 255, 0, 0) ) ; canvas.drawCircle(lSO, cativas.drawCircle(150, 250, 250, 100, 100, pincel); pincel);

2.

el color color rojo rojo seleccionado seleccionado es es mezclado mezclado con con elel color color de de Observa cómo el fondo. fondo. Prueba otros valores valores de de alfa. alfa

3.

Reemplaza la primera primera línea línea que que acabas acabas de de introducir introducirpor: por: píncel.setColor(Ox7FFFOOOO); pincel.setColor(0x7FPF0000) ; Observa cómo el el resultado resultado es es idéntico. idéntico.

4.

el fichero fichero res/values/colors res/vaiues/coiors. .xmi un nuevo nuevo color colorutilizando utilizandoelel Define en el xml un siguiente código: version= "1.0" encoding="utf~-· 88"?>

#7f > # 7fffff00 ■ccolor name=" name= "color_circulo f f f f 00 o:::resoul~ ces>

5.

Modifica el ejemplo ejemplo anterior anterior para para que que se se utilice utilice este este color colordefinido definidoen en los los recursos: recursos: pincel.setColor(getResources() . getColor(R.color.color_circulo)); pincel.setColor(getResources().getColor(R.color.color_circulo));

132

Gráficos en Android

4.1.3. Path La clase Path permite definir un trazado trazado aa partir partir de de segmentos segmentos de de línea línea yy curvas. curvas. Una vez definido puede ser dibujado con drawPath (Path, Paint.). con canvas. canvas.drawPath(Path, Paint). Un Un Path path también puede ser utilizado para para dibujar dibujar un un texto texto sobre sobre el el trazado trazado marcado. marcado.

Ejercicio paso a paso: Uso Uso de de la clase clase Path. Path. 1.

Remplaza dentro de onDraw del ejercicio ejercicio anterior anterior el el código código siguiente: siguiente: Path trazo == new Path(); Pathí); t.razo.addCircle(l50, trazo.addCircle(150, 150, 150, 100, 100, Direct.ion.CCW); Direction.CCW) ; canvas. drawColor (Color. ¡.¡HITE); canvas.drawColor(Color.WHITE)¡ Paint pincel == new Paint(l; Paint O; pincel . setColor(Color pincel. setColor (Color.. BLUE); SLCÍB) ; pincel . setStrokeWidth(B); pincel.setStrokeWidth{8); pincel.setStyle{Style.STROKE); pincel.setStyle(Style.STROKE) ; canvas.drawPath(trazo, pincel); pincel.setStrokeWidth(l); pincel.setStrokeWidth(1); pincel.setStyle(Style.F.TLL); pincel.setStyle(Style.FILL); pincel.setTextSize(20); pincel. setTypeface (Typeface . 8ANS_8E'RJF) ; pincel.setTypeface(Typeface.SANS_SERIF); canvas.drawTextOnPath("Desarrollo de de aplicaciones aplicaciones para para móviles con Android", Android", trazo, trazo, 10, 10, 40, 40, pincel); pincel);

2.

El resultado obtenido ha de ser:

\~e:>UdP

0"

0° ·

'21

ti/)

o

í'lo 0

V ..., V~

\ ,¡., 1 % ~

iJ.J

~

a

3

o< .-·

~

\"o

))-1 /Jet ro id ^ürcud 3.

Modifica en la segunda línea ion. ce¡.;¡ (contrario linea el parámetro parámetro Direct Direction.ccw (contrario aa las las agujas del reloj) por Direct ion. cw (a Direction.cw (a favor favor de de las las agujas agujas del del reloj) reloj).. Observa el resultado.

133

El gran libro de Android 4.

Modifica los parámetros significado. comprendas su significado.

de

canvas. canvas . dravrextc-nPath dra1>."fextOnPath í) {) hasta

que

5.

¿Podrías dibujar el texto a favor de las agujas del reloj, pero por fuera del círculo?

Ejercicio paso a paso: paso; Un ejemplo de Path más complejo. 1. 1.

Remplaza las dos primeras líneas del ejemplo anterior por: Path trazo =~ new Path(); PathO ; trazo . moveTo(50, 100); trazo.moveTo{50, trazo.cubicTo(60,70, 150,90, 200,110); trazo.lineTo{300,200); trazo.lineTo(300,200);

2. 2.

El resultado obtenido debe ser similar a: a:

^esarroj/o^

El trazo comienza desplazándose a las coordenadas (50,100). (50,1 00). Luego introduce una curva cúbica o Bézier hasta la coordenada (200, 11 0). Una (200,110). control, el primero (60,70) permite curva Bézier introduce dos puntos de control, controlar cómo arranca la dirección del comienzo de la curva y el segundo manera, (150,90) la dirección del final de la curva. Funciona de la siguiente manera, si trazas una recta desde el comienzo de la curva (50, 100) hasta el primer (50,100) punto de control (60,70), la curva se trazará tangencialmente a esta recta. recta. Finalmente, (200, 11 O) hasta Finalmente, se añade una línea desde las coordenadas (200,110) (300,200). (60,70)

.l 0,1 00)

(150,90) ¿200,110)

(300,200) r(300,200)

134

Gráficos en Android 3.

¿Por qué aparece una separación entre la "p" y la la "1"? "I"? ¿Qué ¿Qué dos dos parámetros del siguiente gráfico tendríamos que modificar para para que esta separación no estuviera? (Solución: (150,90) => (150,65}) (150,65))

4.1.4. Drawable La clase Drawable es una abstracción que representa "algo que que puede puede ser ser dibujado". dibujado". Esta clase se extiende para definir gran variedad de de objetos objetos gráficos gráficos más más específicos. específicos. Muchos de ellos pueden ser definidos como recursos usando usando ficheros ficheros XML. Entre ellos tenemos los siguientes:

BitmapDrawable: Imagen basada en un fichero gráfico (PNG o JPG). Etiqueta Etiqueta XML XML .

ShapeDrawable: Permite realizar un gráfico a partir de primitivas primitivas vectoriales, vectoriales, como como .. . ) o trazados ((path). Path). No formas básicas (círculos, cuadrados, cuadrados,...) No puede ser ser definido definido mediante un fichero XML. LayerDrawable: LayerDrawable: Contiene un array de Drawable que son visualizados según según el el orden del array. El índice mayor del array es el que se representa representa encima. encima. Cada Cada Drawable puede situarse en una posición determinada. Etiqueta XML list>..

StatelistDrawable: StateListDrawable Similar al anterior pero ahora podemos usar usar una una máscara de de bits y podemos seleccionar los objetos visibles. Etiqueta XML . .

botones o fondos. fondos. GradienDrawable: Degradado de color que puede ser usado en botones TransitionDrawable: Una extensión de LayerDrawabJ..es LayerDrawabies que permite un efecto de de fundido entre la primera y la segunda capa. Para iniciar la transición hay hay que que ( int tiempo). Para visualizar la llamar a startTransition startTransítioníint la primera primera capa hay hay que llamar a resetTransitionO resetTransi t ion () .. Etiqueta XML . . AnimationDrawable: AnímationDrawable: Permite crear animaciones frame a trame frame a partir partir de de una una serie serie Dra-...;able. Etiqueta XML de objetos Drawable.

clase orawable, Drawable, oo uno uno de de sus sus También puede ser interesante que uses la clase descendientes, como base para crear tus propias clases gráficas. Además de ser dibujada, la clase Drawable proporciona proporciona una una serie de de No todo todo mecanismos genéricos que permiten indicar cómo ha de ser dibujada. No orawable ha de implementar todos los mecanismos. Veamos los más importantes: Drawable importantes:

rectángulo donde donde ha de de ser ser El método setBounds(xi,yi,x2,y2) setBounds (xl, yl, x2, y2) permite indicar el rectángulo dibujado. Todo Drawable debe respetar el tamaño solicitado por por el cliente, es decir, decir, dibujado. debe permitir el escalado. Podemos consultar el tamaño preferido preferido de de un un orawable Drawable mediante los métodos getlntrinsicHeight (} {) y getintrinsicWidth getlntrinsicWidth (). (). getPadding(Rect) los márgenes márgenes El método getPadding (Rect) nos proporciona información sobre los recomendados para representar contenidos. Por ejemplo, un orawabJ.e Drawable que que intente ser un marco para un botón, debe devolver los los márgenes márgenes correctos correctos para para localizar las etiquetas, u otros contenidos, en el interior del botón. botón.

135

El gran libro de Android setstate (int (int [J[] li permite permite indicar indicar alal DrawabJ.e Drawabieen enqué quéestado estadoha hade deser ser El método setState dibujado, dibujado, por ejemplo ejemplo "con "con foco", foco", "seleccionado", "seleccionado", etc. etc. Algunos Algunos Drawable Drawabie cambiarán su representación representación según según este este estado. estado. El método setLeve l (intl permite setLevel(int) permite implementar implernentar un un controlador controlador sencillo sencillo para para indicar cómo se representará e . Por representará el el Drawab1 Drawabie. Por ejemplo, ejemplo, un un nivel nivel puede puede ser ser interpretado como una una batería batería de de niveles niveles oo un un nivel nivel de de progreso. progreso. Algunos Algunos Drawable Drawabie modificarán la la imagen imagen basándose basándose en en elel nivel. nivel.

Drawabie puede realizar realizar animaciones animaciones al al ser ser llamado llamado desde desde elel cliente cliente aa su su Un Drawable Drawabie.Caiiback. Todo cliente cliente debe debe implementar implernentar esta esta interfaz interfaz (vía (vía método Drawable . caUba.ck. Todo setCa1lback íDrawable. cal l back) ). El setcaiiback (Drawabie.Caiiback)). El sistema sistema nos nos facilita facilita realizar realizaresta estatarea tareade de de setBackg:r-oundDrawable setBackgroundDrawable(í Drawable) Drawabie) eeImageView. ImageView. forma sencilla a través de

Poli[Media]: PoiS[Med¡a]: La clase clase drawable drawabie en en Androíd. Android. alternativas para para crear crear una una instancia instancia de de Drawable. Drawabie. Puedes Puedes Existen varias alternativas de un un fichero fichero de de imagen imagen almacenado almacenado en en los los recursos recursosdel delproyecto, proyecto, crearla a partir de partir del del diseño diseño basado basado en en XML XMLoo puedes puedescrearla crearlaaapartir partir también puedes crearla aa partir de código. Veamos con más detalle algunas algunas de de las las subclases subclases de deDra·.vable. Drawabie.

4.1.4.1. BitmapDrawab/e BitmapDrawable La forma más sencilla de de añadir añadir gráficos gráficos aa tu tu aplicación aplicación es es incluirlos incluirlosen en lalacarpeta carpeta res/drawable del proyecto. proyecto. El El SDK SDK de de Android Android soporta soporta los los formatos formatos PNG, PNG, JPG JPGyy GIF. GIF. El formato aconsejado aconsejado es es PNG, PNG, aunque aunque sisi elel tipo tipo de de gráfico gráficoasí asílolorecomienda, recomienda, también puedes utilizar JPG. JPG. El El formato formato GIF GIF está está desaconsejado. desaconsejado. Cada gráfico de esta esta carpeta carpeta es es asociado asociado aa un un ID ID de de recurso. recurso. Por Porejemplo, ejemplo,para para el fichero mi . png se ___ imagen. Este mi __ imagen imagen.png se creará creará el el ID ID mi mi_imagen. Este ID ID tete permitirá permitirá hacer hacer referencia al gráfico desde desde el el código código oo desde desde XML. XML.

Ejercicio paso a paso: paso: Dibujar Dibujar un un BítmapDrawable BitmapDrawable de de los los recursos. Busca en Internet un un fichero fichero gráfico gráfico en en codificación codificación png png oo jpg jpg (los (los formatos formatos gráficos usados por por defecto defecto en en Android). Android). 1.

Renombra el fichero fichero para para que que se se llame llame mi_ímagen.png mijmagen.pngoo mi_ímagen.jpg mi_imagen.jpgyy arrastra a res/drawab/e. res/drawable.

2.

Declara la variable ernploView del variable milmagen mi imagen en en lala clase clase Ej Ejempioview del ejercicio ejercicio anterior: private prívate Drawable Drawabie milmagen; miImagen;

136

Gráficos en Android 3.

Escribe las siguientes tres líneas dentro dentro del constructor constructor de esta esta clase: clase: Resources res = context.getResources(); res.getDrawable(R.drawable.mi_imagen);; milmagen ~= res.getDrawable(R.drawable.ini_iínageíj¡ miimagen.setBounds(30,30,200,200) miImagen.setBounds(30,30,200,200);¡

4.

Escribe la siguiente línea en el método onDraw: mi Imagen. draw ( canvas) ¡ miImagen.draw(canvas);

4.1.4.2. GradienDrawable También podemos definir en XML otro tipo de Drawables como GradienDrawable. Por ejemplo, degradado desde el color color blanco blanco ejemplo, el siguiente fichero define un degradado ( FFF'FF'F') a azul (ogooff): ( OOOOFF): (ffffff) xmlns: android= "htt[-): //sc.he.rnas. a.ndroi.d. com/alJk/.res/andro.id ">
android:startColor="#FF'F'F'F'F" android:startColor="#FFFFFF" android:endColor="#OOO OF'F' " android:endColor="iOOOOFF" android:angle="2 70 " /> android:angle="270"

Este tipo de objetos gráficos es utilizado con frecuencia como fondo de de botones botones la dirección dirección del del degradado. degradado. Solo Solo se se o de pantalla. El parámetro angle indica la O, 90, 180 180 y 270. 270. permiten los ángulos 0,

Ejercicio paso a paso: Definir un GradienDrawable. 1.

Asteroides. Abre el proyecto Asteroides.

2.

Crea el siguiente fichero res/drawable/degradado.xml. resldrawableldegradado.xml:

com,lapk/rc:::s/andro:i.d '> xmlns android;angle="270" >
3.

4.

1

de una una vista, para conseguir Introduce la siguiente línea en el constructor de que este drawable sea utilizado como fondo. setBackgroundResource(H..drawable.degradado); setBackgroundResource ÍR.drawable.degradado); Resulta más conveniente definir el fondo de de una una vista vista en su su Layout Layout en en XML en lugar de hacerlo por código. código. Comenta la línea línea introducida introducida en en el punto anterior ee introduce el siguiente atributo en el Layout main.xml. main.xml. android: back.ground= background= "©drawable/degradado "®drawable/ degradado''"

137

El gran libro de Android

4.1.4.3. TransitionDrawable TransitionDrawable Un TransitionDrawable es una una extensión extensión de de LayerDrawablef> Layerorawables que que permite permite un un efecto efecto de fundido entre la primera primera yy la la segunda segunda capa. capa. Para Para iniciar iniciar lala transición transición hay hay que que llamar a startTransition.(int startTransition(iat tiempo) tiempo!.. Para Para volver volver aa visualizar visualizar lala primera primera capa capa hay que llamar a reset.Transit.ion resetTranai t ion ()()..

Ejercicio paso a paso: paso; Definir Definir un un TransítionDrawable. TransitionDrawable. 1.

Crea un nuevo proyecto proyecto con con nombre nombre Transition. Transition.

2.

recursos en en res/drawableltransicion.xml res/drawable/transicion.xmlcon con elelcódigo: código: Crea el siguiente recursos <.?xn1l .1.0"" encoding="utf-B"?> 11

com/apk/res/android" > > android:drawable="@drawable/asteroide3"/>

3.

Remplaza en la actividad actividad el el método método oncreate oncreate por porelel siguiente siguientecódigo: código: ®Override ©Override public void onCreate(Bundle onCreate(Bundle savedinstanceStatei savedlnstanceState) super. onCreate(savedinstanceState); super.onCreate(savedlnstanceState); ImageView image this );; iniage = new ImageView( IraageView (this) setContentVie•.;(image); setContentView(image); 'I'.r:ansitionDrawable n ~- ('I'ransitionDrawable) TransitionDrawable transitio tx-ansition (TransitionDrawable) getResources () . getDrawable (R. drav1abl e . transicion ) ; getResources().getDrawable(R.drawable.transición); image . set imageDrawable(transition); image.setlmageDrawable(transition); transition.startTransition(2000); transition.startTransition(2000);

4.

{

} Si todo funciona funciona correctamente, correctamente, verás verás cómo cómo lala llamada llamada aa transition. startTransition (2000) provoca que transition.startTransition(2000)provoca que lala primera primera imagen imagen se se transforme, a lo largo de de dos dos segundos, segundos, en en la la segunda segunda imagen. imagen.

4.1.4.4. ShapeDrawable ShapeDrawable dinámicamente un un gráfico gráfico mediante mediante primitivas primitivas vectoriales, vectoriales, una una Cuando quieras crear dinámicamente utilizar ShapeDrawable. ShapeDrawable. Esta Esta clase clase permite permite dibujar dibujargráficos gráficos buena opción puede ser utilizar básicas. Un Un ShapeDrawable ShapeDrawable es es una una extensión extensión de de Drawable, Drawable, por porlolo a partir de formas básicas. tanto, puedes utilizar todo todo lo lo que que permite permite Drawable. Drawable.

paso: Definir Definir un un ShapeDrawable. ShapeDrawable. Ejercicio paso a paso: Veamos un ejemplo sobre cómo cómo utilizar utilizar un un objeto objeto shapeDrawable ShapeDrawable para para crear crear una vista a medida.

138

Gráficos en Android 1.

Abre el proyecto EjemploGraficos. EjemploGraficos.

2.

En la clase Ej emploVíew declara Ejempioview declara la la siguiente siguiente variable: variable: pri vate ShapeDr·awable Imagen; prívate ShapeDrawable mi milmagen;

3.

Añade las siguientes tres tres líneas líneas dentro dentro del del constructor constructor de de esta esta clase: clase: míimagen milmagen == new ShapeDrawable(new ShapeDrawablefnew OvalShape()); OvalShape()); miimagen.getPaint() .setColor(OxffOOOOff); milmagen.getPaint().setColor(OxffOOOOff); míima gen.setBounds(lO, 10, milmagen.setBounds(10, 10, 310, 310, 60); 60);

En el constructor, un objeto ShapeDrawable ShapeDrawable es es definido definido como como un un óvalo. óvalo. Se Se le asigna un color y se definen sus sus fronteras. fronteras. 4.

Escribe la siguiente línea línea en en el el método método onoraw: onDraw: míimagen.draw(canvas); miImagen.draw{canvas);

5.

Ejecuta la aplicación yy observa el el resultado. resultado.

Toda nueva vista creada va va aa poder poder ser ser reutilizada reutilizada de de forma forma directa directa por por cualquier programa. Incluso Incluso podrá podrá ser ser usada usada desde desde un un Layout Layout en en XML. XML. No No tienes tienes emploview en más que escribir la clase Ej Ejempioview en un un fichero fichero independiente independiente para para que que lala clase sea visible y utilizar la la siguiente siguiente etiqueta etiqueta en en tu tu r..ayout Layout cuando cuando quieras quieras dibujar dibujar un óvalo. óvalo, android: layout_height="wrap__cont.ent" />

de hacerlo. hacerlo. En el siguiente apartado trataremos de

4.1.4.5. AnimationDrawable Android nos proporciona varios mecanismos mecanismos para para crear crear animaciones animaciones gráficas. gráficas. Una Una estas animaciones animaciones pueden pueden ser ser creadas creadas en en ficheros ficheros XML. XML. En En ventaja a destacar es que estas una de de las las animaciones animaciones más más sencillas, sencillas, las las creadas creadas aa partir partir de de este apartado veremos una utilizaremos la la clase claseAnímatíonDra1vable. AnimationDrawable. una serie de fotogramas. Para ello utilizaremos

Ejercicio paso a paso: Uso Uso de de AnímatíonDrawable. AnimationDrawable. 1.

con nombre nombre Animacion. Animación. Crea un nuevo proyecto con

2.

Crea el siguiente recurso recurso resldrawab/e!animacion.xml. res/drawable/animacion.xml. androíd : oneshot= "false "> />

139

El gran libro de Android
a ndroid :duration= "2 00" /> android:duration="200"

3.

Copia los ficheros misi/1.png, misiH.png, misi/2.png misil2.png y misi/3.png misiIS.png a la carpeta res! res/ drawable. drawable. Los encontrarás en www.androidcurso.com.

4.

por: Remplaza el código de la actividad por: public class AnimacionActivity Activity {{ puhlic Aniltk"'!cionActivity extends .Act.ivit.y AnimationDrawable animacion; animación; @Override puhlic void onCreate(Bundle savedinst.anceSt.ate) SOverride public savedlnstanceState) {{ super.onCreate(savedlnstanceState); super . onCreat.e (savedinst:anceState); animacion (JI.nimationDrawable)getResources() .getDrawable( animación = (AnimationDrawable)getResources().getDrawable{ R.drawable.animación)¡; R.drawable.animacion) Ima geView vista == new ImageVie'\o;( this ); ImageView imageView(this); vista. setBackgroundColor (Color. VJHITE); v/HITE) ; vista.setBackgroundColor(Color. vista.setima9eDrawable(animacionl; vista.setlmageDrawable(animación); vista.setOnClickListenex(new vista.setOnClickListener(new OnClickListener(l OnClickListener{) { puhlic onClick:(View view) { public void onClick(View animacion.st.art.(); animación.start();

} })

;

set.Cont.ent.View{vist.a); setContentView(vista);

animación En este ejemplo se comienza declarando un objeto an i macion de la clase Animat.ionDrawabJ.e. AnimationDrawable. Se inicializa utilizando el fichero XML incluido en los mageview para ser representada recursos. recursos. Se crea una nueva vista de la clase Iimageview animación. Finalmente, por la actividad y se pone como imagen de esta vista anü1acion. se crea un escuchador de evento onclick onciick para que cuando se pulse sobre la

vista se ponga en marcha la animación. animación.

Preguntas de repaso y reflexión: Las clases para gráficos en Android. Android.

4.2. 4.2. Creación Creación de de una una vista vista en en un un fichero fichero independiente independiente Como hemos visto en los ejemplos anteriores, para poder dibujar en Android hemos emploView, descendiente de View. Esta clase tenido que crear una nueva clase Ej Ejemploview, icosActivlty por lo que solo podía ser utilizada EjemploGraficosActivit.y era creada dentro de EjempioGraf desde esta clase. clase. Va a resultar mucho más interesante crear esta clase en un fichero independiente. independiente. De esta forma, forma, podremos utilizarla desde cualquier parte de

140

Gráficos en Android nuestro proyecto, proyecto, o desde otros proyectos. proyectos. Incluso Incluso estará estará disponible disponible en en la la paleta paleta de de ejercicio, te te permite permite verificar verificar este este concepto. concepto. vistas del editor visual. El siguiente ejercicio,

Ejercicio paso aa paso: paso: Creación de de una una nueva nueva Vista Vista independiente. eraploview En este ejercicio vamos vamos aa poner la la clase clase ej E jempl ovi ew en en un un fichero fichero independiente para que pueda ser utilizada utilizada desde desde cualquier cualquier parte. parte. 1.

EjemploGraficos. Abre el proyecto EjemploG ra fieos.

2.

En la clase EjemploGraficosActivity Ejempl oGraf icosActivity selecciona selecciona todo todo el el texto texto correscorresla clase Ejemploview. pondiente a la definición de la Ej e mplovi ew.

3.

derecho sobre sobre src/org.example/ejemplografico srclorg.example/ejemp/ografico yy Pulsa con el botón derecho New/C/ass... selecciona la opción New/Class...

4. Introduce como nombre de la clase clase Ejemploview. Ej empl o Vi e w. 5.

el portapapeles. portapapeles. Pega el texto que has puesto en el

6.

que, al ejecutar la aplicación, aplicación, el el resultado resultado es es idéntico idéntico al al obtenido obtenido Verifica que, en la sección anterior. anterior.

En este apartado aprovechamos para para introducir introducir otros otros aspectos aspectos que que tendrás tendrás que que tener en cuenta para crear nuevas vistas. vistas. Cuando Cuando quieras quieras crear crear una una nueva nueva vista, vista, v i e w, escribir escribir un un constructor constructor yy como como mínimo mínimo tendrás que extender la clase view, sobreescribir los métodos onSizeChangedO onSi zeChanged () yy onDrawO. o n Dr aw (). Es Es decir, decir, tendrás tendrás que que esquema: seguir el siguiente esquema: ppublic ublic class c las s MiVista extends e x t ends View View {{ publ i c MiVista(Context context, con text , AttributeSet At t r ibuteS e t attrs) a ttrs) {{ public super (con text, attrs); a tt r s ); super(context, //Inicializa la vista //Ojo: Aún no se conocen sus dimensiones } @Clve:n:ide tected void vo i d onSizeChanged(int o nSizeChange d (int ancho, ancho, int i n t alto, alto, ©Override pro protected int a nch o_anteri or, int alto_anterior){ al t o_anterior){ int ancho_anterior, //Te informan del ancho y el alto

} ©Override @()verTíde protected p r otected void v oid onDraw(Canvas o nDraw(Canvas canvas) c a nvas) {{ í/Dibuja. aguí aquí la vista //Dibuja } } Observa cómo el constructor utilizado tiene tiene dos dos parámetros: parámetros: El El primero primero de de tipo tipo Cont.ext te permitirá acceder al al contexto contexto de de aplicación, aplicación, por por ejemplo ejemplo para para utilizar utilizar Context El segundo, segundo, de de tipo tipo AttributeSet, Attributesec , te te permitirá permitirá acceder acceder recursos de esta aplicación. El a los atributos de esta vista, vista, cuando sea creada creada desde desde XML. XML. El El constructor constructor es es el el

141

El gran libro de Android vista, pero, lugar adecuado para crear todos los componentes de tu vista, pero, cuidado, cuidado, en este punto todavía no se conoce las dimensiones que tendrá. Android realiza un proceso de varias pasadas para determinar el ancho y alto de cada vista dentro de un Layout. Cuando finalmente ha establecido las dimensiones de una vista llamará a su método onsizeGangedO. onsizeGanged () . Nos indicará como parámetros el ancho y alto asignado. asignado. En caso de tratarse de un reajuste de tamaños, tamaños, por ejemplo si una de las vistas del Layout desaparece y el resto tiene que ocupar su espacio, se nos pasará el ancho y alto anterior. anterior. Si es la primera vez que se llama al espacio, método estos parámetros valdrán O. 0. El último método que siempre tendrás que reescribir es onDrawO. onDraw () . Es aquí donde tendrás que dibujar la vista. vista.

1.

Ejercicio paso a paso: Una Vista que pueda ser diseñada desdeXML. desde XML

Vamos a modificar la vista anterior para que pueda ser utilizada usando un diseño en XML: 1. 1.

Ej empl.oView. para que coincida con el Modifica el código de la clase Ejemploview. siguiente (en negrita se resaltan las diferencias): diferencias): ppublic ublic class cla ss EjemploView Ejempl.oView extends exten ds View prívate ShapeDrawable ShapeDrawabl.e miImagen; miimagen;

{

public EjemploView(Context EjempJ.oView(Contex t context, contex t , AttributeSet attrs) attr s) super (context., attrs); attr s ); super{context, miimagen ShapeDrawable (new OvalShape{)); OvaJ.Shape () ) ; miImagen == new ShapeDrawable(new mi i magen .getPaint{) .setColor(OxffOOOOff); milmagen.getPainc().setColor(OxffOOOOff);

{

} ®Override p r otected void onSi z eChanged(int anc ho , int alto, ©Override protected onSizeChanged(int ancho, int ancho anc h o_ ant erior, iint n t alto_ l{ anterior, alto anterior anterior){ miimagen .setBounds (O , 0, O, anch o, alto); milmagen,setBounds(0, ancho,

}} 010vet.·:ci.d (Canvas canvas) ©Overridee protected void on.Draw onDraw(Canvas mi Imagen. clraw ( canvas) ; miImagen.draw(canvas);

{

} } La primera diferencia es la utilización de un constructor con el parámetro At trHmteset. Este constructor es imprescindible si quieres poder definir la AttributeSet. vista en XML. También se ha añadido el método onsizechanged, para que el óvalo se dibuje siempre ajustado al tamaño de la vista. vista. 2.

142

Abre el fichero main.xml en modo Graphical Graphicat Layout. Layout. En la paleta de vistas dentro de la última sección, sección, observa cómo se ha añadido la nueva vista: vista:

Gráficos en Android f2& & Library Views t_ Custom Si

QJ El EjemploView EjempioView 3.

Arrastra dos elementos de este tipo al Layout.

4.

vistas, tal y Modifica las propiedades que definen el ancho y alto de estas vistas, continuación: como se muestra a continuación: <,org. example exampJ.e.. e ejj emplograf empl.ogra.ficos. emploV.i ew android:layout_height="lOOpx"
android: id= ""!? @-r- id/ej i d/ejf::iirp.7.oV.i<.:·)h'2" e¡np 1 o Vi e w2" android: layout_width= "L.i .l..I_parent: " f.:i 11 _pa.rent " android: layout_ height= "t'ill_paren<:" //> > android:layout_height="fill_parent"

¡SOTA: "wrap_contentNuestra N OTA: No utilices el valor "r,.,TaP .....ccmtent ". Nuestra vista no ha sido programada sop ortar este tipo de valor. para soportar 5.

Ejecuta la aplicación. aplicación. El resultado ha de ser similar a: a:

Helio word

4.3. Creando Creando la la actividad actividad principal principal de de Asteroides Asteroides 4.3. Una vez que conocemos los rudimentos que nos permiten utilizar gráficos en Android vamos a aplicarlos a nuestro ejemplo.

143

El gran libro de Android Androld

Ejercicio paso a paso: Creando la actividad principal de Asteroides. Lo primero que necesitamos es crear una actividad que controle la pantalla del juego propiamente dicho. A esta actividad la llamaremos ,;uego. Juego. 1. 1.

Asteroides. Abre el proyecto Asteroides.

2.

Lo primero que necesitamos es crear una actividad que controle la pantalla del juego propiamente dicho. Crea la clase Juego ,Juego con el siguiente código. código. publ i c class c l ass Juego extends Ac tiv i ty {{ public Activity @Ovcrride o n Create (Bundle savedlnstanceState) savedins tanceState ) ®Override public void onCreate(Bundle super.onCreate(savedinstanceState super.onCreate(savedlnstanceState)) ; setContentView(R.layo ut .juego);; setContentView(R.layout.juego)

{

} } 3.

Necesitaremos un Layout para la pantalla del juego. Crea el fichero res/layout/juego. x ml con el siguiente contenido: contenido: res/layout/ juego. xmi android;layout_height="fill_parent" >

Como puedes observar, observar, cuando diseñamos un Layout en XML, no estamos limitados a escoger los elementos que tenemos en la paleta de vistas; vistas; vamos a utilizar vistas creadas por nosotros. En este ejemplo utilizaremos la vista org. example . asteroides . VistaJuego Vista(Juego que será descrita más adelante. Va a org.example.asteroides. ser esta vista la que lleve el peso de la aplicación. aplicación.

144

4.

android :bac kground asociado Observa que se ha indicado el parámetro android-.background al recurso ©drawable/fondo.
5.

De momento no podremos ejecutar la aplicación hasta haber definido la clase VistaJuego.

Gráficos en Android

4.3.1. La clase Gráfico El juego que estamos desarrollando va a desplazar muchos tipos de gráficos por pantalla: pantalla: asteroides, nave, nave, misiles, misiles, etc. etc. Dado que el comportamiento de todos estos elementos es muy similar, con el fin de reutilizar el código y mejorar su comprensión, comprensión, vamos a crear una clase que represente un gráfico a desplazar por pantalla. A esta nueva clase la llamaremos Grafico Gráfico y presentará las siguientes Drawable. características. El elemento a dibujar será representado en un objeto Drawabie. Como hemos visto, esta clase presenta una gran versatilidad, lo que nos permitirá tmapDrawable) , vectoriales (shapeDrawable), trabajar con gráficos en bitmap (Bi (BitmapDrawabie), (shapeDrawabie), gráficos con diferentes representaciones (stateListDrawable), gráficos animados (Ani mationDra•-.rable). Además, un G:r·afico (AnimationDrawable). Gráfico dispondrá de posición, velocidad de desplazamiento, ángulo de rotación y velocidad de rotación. rotación. Para finalizar, finalizar, un gráfico que salga por uno de los extremos de la pantalla reaparecerá por el extremo contrario, tal y como ocurría en el juego original origina) de Asteroides.

lÉlf 1. 1.

Ejercicio paso a paso: paso; La clase Gráfico. Gráfico.

Crea una nueva clase Grafico Gráfico en el proyecto Asteroides y copia el siguiente código. código. class Gráfico Grafico {{ private í//Imagen /Imagen que dibujaremos dj.bujaremos prívate Drawable drawable; private double posX, posY; //Posición //Velocidad desplazamiento private double incX, incY; i nt ángulo, angulo, rotacion;//Ángulo y velocidad rotación private int rotación;//Angulo y l to; private int ancho, aalto; //Dimensiones de la imagen /íPara determinar coliBión private int radioColision; //Para colisión view.ivaJ.idat.e) //Donde dibujamos el gráfico {usada (usada en view.ivalidate) private View view; /i ii Para determinar el espacio a borrar (view.ivalidate) (vi.ew. i vaU.date) public publ ic static final f ina l iint nt MAX_VELOCIDAD J.!l!X_ VELOCIDAD = 20; public Grafico(View Gráfico(View view, Drawable drawable) drawable){( this .view == view; this.view this .drawable = drawable; this.drawable drawable . getintrinsicWidth(); ancho == drawable.getlntrinsicWidthO; alto== drawable.getlntrinsicHeight drawable.getintrinsicHeight(); alto () ,radioColision = (alto+ancho)/4; (alto+ancho?/4; } public void dibujaGrafico(Canvas canvas}{ canvas){ canvas.save(); canvas.save{); int x=(int) x= (int ) {posX+ancho/2); (posX+ancho/2}; int y=( int ) (posY-ralto/2) (posY+alto/2);; y=(int) canvas.rotate(( float ) angula, ( float ) x,(float) x, (float ) y); canvas.rotate((float) ángulo,(float)

145

El gran libro de Android Androíd drawable .setBounds( ( i n t )posX, ({int)posY, i nt )posY, drawable.setBounds{íint)posX, (íint)posX+ancho, i n t )posX+ancho, {i n t )posY+alto); (int)posY+alto); drawab le.draw( canvas); drawable.draw(canvas); canvas.restore(); canvas.rescore(); int rlnval rinvaJ. = (int) /2 ++ MA.l( íint) l'1ath.hypot Math.bypot (ancho, (ancho, alto) alto)/2 MAX_____'v'ELOCIDAD VELOCIDAD;; view.invalidate(x-rinval, view.invalídate(x-rlnval, y-rinval y-rlnval,, x+rinval, x+rlnval, y+rinval}; y+rlnval);

} publ ic vo i d incrementaPos{ d o ub le factor} public void incrementaPos(double factor){{ posX+=incX posX-f- = incX * factor; factor; 1/ S.i. /,/ Si salimos de J.a la pantalla./ pantalla, corregimos corregimos pos.lcJ.on posición if(posX<-anch o/2} {posX=view.getWidth{)-ancho/2;} if{posX<-ancho/2) {posX=view.getwidth()-ancho/2;} if(posX>view . getWidth() - ancho/2) {{ posX=-ancho/2;} if(posX>view.getWidth()-ancho/2) posX=-ancho/2;} posYi-=incY * factor; factor; posY+=incY if (posY<-alto/2) {posY=view.getHeight{)-alto/2;} if(posY<-alto/2i {posY=view.getHeight()-alto/2;} if (posY>view.getHeight()-alto/2) {posY=-alto/2;} if(posY>view.getHeight()-alto/2! {posY=-alto/2;} angulo += +'= rotacion t or; í//Actualizamos /ActuaJ.izamon ángu}_o ángulo rotación * fac factor; ángulo

publ ic double distancia(Graf ico g) public distancia(Gráfico g) {{ Math.hypotSposX-g.posY, posy-g.posX); hypoi: (posX - g. pos Y, posy - g. posX) ; rretum e turn Math.

} ublic boolean s ion(Grafico g) ppublic boolean verificaColi verificaColision(Gráfico g) { (distancia(g) (radioColision+g.radioColision) rreturn e turn (distancia (g) < (radioColision+g. radioColision)};

2.

4)

Al principio de la clase clase hemos hemos definido definido varios varios campos campos con con elel modificador modificador prívate. Vamos a necesitar acceder aa estos estos campos campos desde desde fuera fuera de de lala clase, por lo que resulta necesario necesario declarar declarar los los métodos métodos get get yy set set correspondientes. Vamos a realizar realizar esta esta tarea tarea de de forma forma automática automática Eclipse. Sitúa Sitúa el el cursor cursor al al final final de de lala clase clase utilizando una herramienta de Eclipse. (a última llave) llave) y pulsa pulsa con con el el botón botón derecho. derecho. Selecciona Selecciona en en (justo antes de la el menú desplegable Source/Generate ... En Source/Generate Getters Getters and and Setters Setters... En lala todos los los campos campos (botón (botón Sellect Sellect Al!) Alí) yy pulsa pulsa OK. OK. ventana de diálogo marca todos Eclipse hará el trabajo por nosotros. nosotros.

..:;,.-z:;::::.' Nota sobre Java: En el el tutorial tutorial Java Java Esencial Esencial 1/ Encapsulamiento Encapsulamiento yy visibilidad visibilidad puedes aprender más sobre los los métodos métodos gel get yy set. set. Lo Lo encontrarás encontrarás en en www.androidcurso.com.

4.3.2. La clase VistaJuego Pasemos a describir la creación creación de de VistaJuego VistaJuego que, que, como como hemos hemos indicado, indicado, es es lala del juego. juego En En una una primera primera versión versión solo solo se se responsable de la ejecución del representarán los asteroides de de forma forma estática: estática;

146

Gráficos en Android

—

Ejercicio paso a paso: La clase VistaJuego. VistaJuego.

1.

Crea una nueva clase vistaJuego VistaJuego en el proyecto Asteroides y copia el siguiente código: código: public class VistaJuego Vist.aJuego extends View {{ //// í//i lili prívate prívate prívate

ASTEROIDES ¡¡lili ////// Vect.or Asteroides; /! Vector // Vector con los Astero.-ides Asteroides ínt numAst.eroides = 55;; //Número int numñsteroides // Número in.-iciaJ. inicial de asteroides ínt int numFragmentos ~= 33;; !! // Fragmentos en que se divide

public VistaJuego(Cont.ext. VistaJuego(Context context, AttributeSet attrs) { super( contex t, a.ttrs); super(context, attrs); Drawable drawableNave, drawableAsteroide, drawableMisil; drawablel•steroide . getResources () . getDrawable ( drawableAsteroide == context context.getResources().getDrawable( R.drawable. asteroidel); R.drawable.asteroidel); Asteroides == new Vector(); VeGtor(}; for (int O; ii < numAsteroides; i++} íint ii =~ 0; !•!•+) { Grafico Grafico( thís , drawableAsteroide); Gráfico asteroide = = new Gráfico(this, asteroide.setincY(Mat.h.random() asteroide.setlncY{Math.random() * 4 - 2); 2) ; asteroide.setincX(Mat.h 4 - 2); asteroide. setlncX (Math..random() randotn() **4-2); asteroide.setAngulo((ínt} h .random() * 360}); asteroide.setAngulo((int) (Mat (Math.random{) 360)); as t eroide.setRotacion(( ínt ) (Math.random() * 8 asteroide.setRotacion((int) 8 -- 4}); 4)); Asteroides.add(asteruide); Asteroides.add(asteroide);

} @Override ínt ancho, int alto, ©Override protected voíd void onSizeChanged( onSizeChanged(int int ancho_anter, alto_anter) {{ ancho_anter , int alto_anter} super. onSizeChanged(ancho, alto, ancho_anter, alt.o_anter}; super.onSizeChanged(ancho, alto_anter); // Una vez que conocemos nuestro ancho yy alt.o. alto, for (Grafico (Gráfico asteroide: Asteroides) {{ asteroide.setPosX(Math.random()* asteroide.setPosX(Math.random<)*

(ancho-asteroide.getAnchoO));

{ancho···asteroide . get~.ncho())};

asteroide.set.PosY(Math.random(}* asteroide.setPosY(Math.random()* (alto-asteroide.getAlto())); (alto-asteroide.getAltoO));

} } @Ove:rridE.o ©Override protected void onDraw(Canvas canvas) super .onDraw(canvas}; super.onDraw ícanvas); (Gráfico asteroide: Asteroides) { for (Grafico

{

asteroide.dibujaGrafico(canvas);

} } } 147

El gran libro de Android Como ves se han han declarado declarado tres tres métodos. métodos. En En elel constructor constructor creamos creamos los los asteroides e inicializamos inicializamos su su velocidad, velocidad, ángulo ángulo yy rotación. rotación. Sin Sin embargo, embargo, resulta imposible iniciar iniciar su su posición, posición, dado dado que que no no conocemos conocemoselel alto altoyyancho ancho de la pantalla. Esta Esta información información será será conocida conocida cuando cuando se se llame llame aa oonSizeChanged n sizecha nged () ().. Observa Observa cómo cómo en en esta esta función función los los asteroides asteroides están están situados de forma forma aleatoria. aleatoria. El El último último método, método, onDraw onDraw{)(),, es eselelmás másimportante importante de la clase vview, i e w, dado dado que que es es el el responsable responsable de dedibujar dibujarlalavista. vista. 2.

Hemos creado una una vista vista personalizada. personalizada. No No tendría tendría demasiado demasiado sentido, sentido, pero podrá ser utilizada utilizada en en cualquier cualquier otra otra aplicación aplicación que que desarrolles. desarrolles. uego. x ml yy observa Visualiza el Layout jjuego.xmi observa cómo cómo lala nueva nueva vista vista se se integra integra perfectamente en el el entorno entorno de de desarrollo. desarrollo.

»n ▼Jlccaíe ^ jn heme |L] ünearlayout @ Vista Juego (or<

3.

Registra la la actividad actividad Juego Juego en en AndroidManifest.xml. AndroidManifest.xml.

4.

Ejecuta la aplicación. Has Has de de ver ver cinco cinco asteroides asteroides repartidos repartidosalalazar azarpor porlala pantalla: pantalla:

4.3.3. Introduciendo la taJuego la nave nave en en Vi VistaJuego El siguiente paso consiste consiste en en dibujar dibujar lala nave nave que que controlará controlará elel usuario usuariopara paradestruir destruir los asteroides.

Práctica: Introduciendo Introduciendo la la nave nave en en VistaJuego VistaJuego 1.

Declara las siguientes variables variables al al comienzo comienzo de de lalaclase clasevistaJuego: VistaJuego: // ///Í

NAVE

/////í

private ave ; /! prívate Grafico Gráfico nnave; // Gráfico Gráfico de de la la nave nave private prívate int giroNave giroNave;; /! // Incremento Incremento de de dirección dirección private prívate float float aceleracionNave aceleracionNave;; // // aumento aumento de de velocidad velocidad /! Iacremento e
148

Gráficos en Android prívate statíc F'iiSO_GlRO_NiiVE = static final ínt int PASO_GIRG_NAVE = S; 5; prívate statíc Sf; static final float PliSO_ACELEF&!CION_l'JlitiE PASO_ACELERAC!ON_NAVE == O. 0.5f;

Algunas de estas variables serán utilizadas en el siguiente capítulo. capítulo. 2.

En el constructor de la clase instancia la variable drawableNave drawableNave de forma similar a como se ha hecho en dr·awableJl.steroide. drawabieAsteroide.

3.

Inicializa también en el constructor la variable nave de la siguiente forma: nave

-= new Grafico(thís, Gráfico(this, drawableNave);

4.

En el método onsicechange () (; posiciona la nave justo en el centro de la vista.

5. 6.

En el método onDraw { l dibuja la nave en el canvas onDrawO canvas..

G. 6.

Ejecuta la aplicación. aplicación. La nave ha de aparecer centrada:

7. 7.

Si cuando situamos los asteroides, alguno coincide con la posición de la nave, el jugador no tendrá ninguna opción de sobrevivir. Sería Seria más nave, interesante asegurarnos de que al posicionar los asteroides estos se encuentran a una distancia adecuada de la nave y, en caso contrario, tratar de obtener otra posición. Para conseguirlo puedes utilizar el siguiente código en sustitución de las dos líneas asteroide. setPosx ((...) ... ) y asteroide.setPosY(_) asteroide . setPosY (...).. do {{ asteroide.setPosX(Math.random()*(anchoasteroide.getAncho())); asteroide.setPosX(Math.random()*(ancho-asteroide.getAncho())); asteroide.setPosY(Math.randomO *(alto-asteroide.getAlto())); asteroide.setPosY(Math.random()*(altoasteroide.getAlto())); (ancho+alto)/5); }} while(asteroide.distancia(nave) while(asteroide.distancia(nave ) << (ancho+alto )/5 );

I-

. .. Ejercicio paso a paso: Evitando que VistaJuego cambie su

representación con el dispositivo en horizontal yy en vertical. 1.

Ejecuta la aplicación. aplicación.

149

El gran libro de Android 2.

orientación la la pantalla pantalla del del dispositivo. dispositivo. En En elel emulador emulador se se Cambia de orientación la tecla Ctri-F11 Ctrl-F11.. consigue pulsando la

3.

Observa cómo cada cada vez vez se se reinicializa reinicializa lala vista, vista, regenerando regenerando los los asteroides. Esto nos nos impediría impediría jugar jugar de de forma forma adecuada. adecuada. Para Para solucionarlo solucionarlo asteroides. edita AndroidManifet.xml. AndroidManífet.xml. En En la la lengüeta lengüeta Application Application selecciona selecciona lala actividad Juego. En los los parámetros parámetros de de la la derecha derecha selecciona selecciona en en Screen Screen orientation: landscape.

4.

nuevo la la aplicación. aplicación. Observa Observa cómo cómo lala actividad actividad Juego Juego será será Ejecuta de nuevo siempre representada en en modo modo horizontal horizontal,, de de forma forma independiente independiente aa lala posición del teléfono.

5.

las propiedades propiedades de de la la actividad actividad Juego. Juego. En En Theme Theme Abre de nuevo las Selecciona android: sLyle/'I'heme. NoTi tleBar. F'ullscree n. selecciona el Valor valor @ «android:style/Theme.NoTitleBar.Pullscreen. Este tema visualizará la la vista vista ocupando ocupando toda toda lala pantalla, pantalla, sin sin lala barra barra de de notificaciones ni el nombre nombre de de la la aplicación. aplicación.

6.

Si en Theme ... yy seleccionas Theme pulsas pulsas el el botón botón Browse Browse... seleccionas elel botón botón circular circular puedes ver ver una una lista lista de de estilos estilos definidos definidos en en elelsistema. sistema. System Resources puedes

NOTA. En algunas instalaciones esta esta lista lista puede puede que que no no tetefuncione. funcione. 7.

Ejecuta la aplicación en en un un terminal terminal real real yy verifica verifica elel resultado. resultado.

NOTA: En un emulador si si cambias cambias la la orientación orientación (Crti-Fll) (Crtl-Fll) esta esta cambiará cambiará igualmente. Se trata de de un un error error de de simulación, simulación, al al no no soportar soportaresta estaconfiguración. configuración.

4.4. 4.4. Representación Representación de de gráficos gráficos vectoriales vectoriales en en Asteroides Asteroides La versión original del juego Asteroides Asteroides se se ejecutaba ejecutaba sobre sobreordenadores ordenadorescon conescasa escasa potencia gráfica. Tal yy como como puedes puedes ver ver aa continuación, continuación, nuestra nuestra nave nave se se representaba con un un simple triángulo. triángulo.

150

Gráficos en Androíd Android Dado que cuando hemos hemos diseñado diseñado la la clase clase Gráfico, Grafico, la la representación representación del del mismo la hemos hemos delegado delegado en en un un objeto objeto Drawabie, orawable, va va aa resultar resultar muy muy fácil fácil cambiar cambiar los gráficos de de la la aplicación aplicación para para que que tengan tengan una una apariencia apariencia más más retro. retro.Simplemente Simplemente utilizando subclase de de Drawabie, Drawable, ShapeDrawable, ShapeDra\oTable, en en lugar lugar de de BitmapDrawable, BitmapDrawable, Utilizando la subclase para cambiar la forma de de dibujar dibujar los los gráficos. gráficos.

Ejercicio paso aa paso: paso: Representación Representación vectorial vectorial de de los /os Asteroides. Asteroides. 1.

Abre la clase vistaJuego. Vista,Juego.

2.

En el constructor remplaza la la línea: línea: drawableAst.ero.ide drawableAsteroide

context. getResources í) . getDrawable ( =~ context.getResourcesO.getDrawable{ R.drawable.asteroidel); R.drawabie.asteroidel); por el siguiente código: código: SharedPreferences contex.t.getSharedPreferences( SharedPreferences pref = context.getSharedPreferences{ "org. ex.ample. asteroides_preferences", Context.MODE_PRIVATE); Context .!1DDE:_PR.Tv:ZlTE) ; "org.example.asteroidesjpreferences", if (pref.getString("gráficos" (pref.getString("graficos",, "0' "0")),equals("0")) .equals("O")) { Path pathAscer-oide pathP..steroide == new new PathO; Path (); pathi\steroide. moveTo ( ( float float ) 0.0) o. 0); patiiAsteroide. float)) 0.3, ((float) path.Asteroide .lineTo { ( float float ) 0.0) O. O); pathAsteroide.lineTo float)) 0.6, ((float) pathJI.steroide .lineTo { ( float o. 3); pathAsteroide.lineTo float)) 0.6, {float (float)) 0.3) pathP..steroide .lineTo o. 2); patiiAsteroide. lineTo ( ( float float)) 0.8, (float)) 0.2) o. 8' {float pathAster·oide .lineTo ( ( float l. o, ((float) float ) 0.4) o. 4); pathAsteroide.lineTo float)) 1.0, path.Asteroide . lineTo ( ( float float ) 0.6) pathAsteroide.lineTo float)) 0.8, ((float) o. 6); path.As teroide .lineTo ( ( fl oat ) 0.9, ( float ) o. 9); pathAsteroide.lineTo float) (float) 0.9) o. 9' path.Asteroide. l ineTo { ( float ( float ) 1.0) l. O); pathAsteroide.lineTo float)) 0.8, (float) path.Asteroide.lineTo{( float ) 0.4, ( float ) 1.0); 0.4, (float) l . O); pathAsteroide.lineTo((float) pathAsteroide.lineTo path.Asteroide .lineTo ( ( float ) 0.0, {float ) 0.6); 0.0, (float) o. 6); pathAsteroide.lineTo((float) pathAsteroide.lineTo path.Asteroide .lineTo ( ( float ) 0.0, 0.0, (float) ( float ) 0.2); pathAsteroide.lineTo pathAsteroide.lineTo((float) o. 2); path.Asteroide.lineTo(( float ) 0.3, 0.3, (float) ( float ) 0.0); 0 . 0); pathAsteroide.lineTo pathAsteroide.lineTo{(float) n ew ShapeDrawable ShapeDrawable{( ShapeDrawable dAsteroi.de == new n e w Pat.hShape Pat.hShape(pathAsteroide, 1, new (pathAsteroide, 1, 1, 11)); D); dAsteroide.getPaint() . set.Color(Color.WHITE); dAsteroide.getPaint{).setColor(Color.WHITE); dAsteroide.getPaint() set.Style(.Style.STROKE); dAsteroide. getPaint () .. set.Style (Style. STROKE) ; dAsteroide.setintrinsicWidth(SO); dAsteroide.setlntrinsicWidth(50); dAsteroide.setintrinsicHeight(50); dAsteroide.setlntrinsicHeight(50); drawableAstero.ide dAsteroide; drawableAsteroide -= dAsteroide; setBackgroundColor(Color.BDACK); setBackgroundColor(Color.BLACK); } else {( drawableAsteroide drawableAsteroide = context.getResources().getDrawable( contex.t. getResources () . getD:r:·awable ( R.drawable.asteroidel); R.drawabie.asteroidel) ;

Lo primero que hace hace este código código es es consultar consultar en en las las preferencias preferencias para para ver ver si el usuario usuario ha ha escogido escogido gráficos gráficos vectoriales. vectoriales. En En caso caso negativo, negativo, se se

151

El gran libro de Android realizará la misma inicialización de drawabieAsteroide drawableAsr.er,:Jide que teníamos antes. afirmativo, comenzaremos creando la variable antes. En caso afirmativo, pathAstex·oide pathAsceroide de la clase Path. En este objeto se introducen todas las órdenes de dibujo necesarias para dibujar un asteroide. asteroide. Luego se crea la variable dAsteroide de la clase ShapeDrawable shapeDrawabie para crear un drawable a partir del path. path. Los últimos dos parámetros (..., (... , 1. i, 1) i) significan el valor de escala aplicado al eje x y al eje y. y. Luego se debe indicar el color y el estilo drawable. Finalmente del pincel y el alto y ancho por defecto del drawable. asignamos el Objeto objeto creado drawableAsteroide. Creado a drawabieAsteroide.

3.

Ejecuta la aplicación y selecciona el tipo de gráficos adecuado en las preferencias. preferencias.

0O

Práctica: Práctica; Representación vectorial de la nave. nave. Como habrás comprobado en el ejercicio anterior, anterior, la nave se representa siempre utilizando un fichero png. png. En esta práctica has de intentar que también pueda representarse vectorialmente. vectorialmente. 1.

Crea un nuevo objeto de la clase Path para representar la nave dentro de la sección if i f introducida en el ejercicio anterior. anterior. Como puedes ver en la ilustración siguiente, triángulo. Como el ángulo de siguiente, debe ser un simple triángulo. rotación inicial es cero, cero, la nave debe mirar a la derecha. derecha.

(O,O¡:>:x (0,0L_^

►

x

(1,0.5) ^>(1,0.5) (0,1 (0.1 )

tr yy

2.

Crea un nuevo shapeDrawabie ShapeDrawabl e a partir de Path Pa t h anterior. anterior. Unas dimensiones adecuadas para que la nave pueden ser 20 de ancho y 15 de alto. alto.

3.

Inicializa la variable drawableNave drawable Nave de forma adecuada.

4.5. Animaciones 4.5. Animaciones El entorno de programación Android incorpora tres mecanismos para crear animaciones en nuestras aplicaciones: aplicaciones: •

La clase Animati.o nDraw·able: Permite crear drawables que reproducen Animar,ionDrawable: una animación fotograma a fotograma. fotograma. Se ha descrito su uso en la sección de Drawables. Drawables.

• Animaciones Tween: Tween: Permiten crear efectos de translación, translación, rotación rotación,, zoom y alfa a cualquiera vista de nuestra aplicación. aplicación. 152

Gráficos en Android • Animaciones de propiedades: Nuevo mecanismo incorporado incorporado en en Android Android 3.0, Permite animar cualquier propiedad de de cualquier objeto, objeto, sea sea una una 3.0. vista o no. no. Además, modifica el objeto en en sí, sí, no no solamente solamente cambia cambia su su representación en pantalla como ocurre en un animación animación Tween. Tween. Las siguientes secciones describen con más detalle estos estos tipos tipos de de animación. animación.

4.5.1. Animaciones Tween Una "animación tween" puede realizar series de de transformaciones transformaciones simples simples {posición, (posición, tamaño, tamaño, rotación y transparencia) en el contenido de de un un objeto objeto View. View, Por Por ejemplo, ejemplo, si si tienes un objeto Textview puedes moverlo, moverlo, rotarlo, rotarlo, aumentarlo, aumentarlo, disminuirlo disminuirlo oo cambiarle la transparencia al texto. La secuencia de órdenes que define la "animación tween" tween" puede puede estar estar escrita escrita mediante xml o código, pero es recomendable recomendable el fichero fichero xml, xml, al al ser ser mas mas legible, legible, reutilizable e intercambiable. Las instrucciones de la animación definen las transformaciones transformaciones que que quieres quieres que que ocurran, cuándo ocurrirán y cuánto tiempo tiempo tardarán tardarán en en completarse. completarse. Las Las ocurran, secuenciales oo simultáneas. simultáneas. Cada Cada tipo tipo de de transformaciones pueden ser secuenciales parámetros específicos, yy también también existen existen unos unos transformación tiene unos parámetros parámetros comunes a todas las transformaciones, como como el el tiempo tiempo que que durarán durarán yy el el tiempo de inicio. inicio.

al directorio directorio res/animl res/anim/ en en El fichero XML que define a la animación debe pertenecer al un único único elemento elemento raíz: raíz: este este debe debe ser ser tu proyecto Android. El archivo debe tener solo un , , , ,, oo elemento elemento uno de los siguientes: , (además de de otro otro ). ). Por Por defecto, defecto, que puede contener grupos de estos elementos (además todas las instrucciones de animación ocurren a partir partir del del instante instante inicial. inicial. Si Si quieres quieres que que una animación comience más tarde debes especificar el el atributo atributo startoffset. startof fset.

Sr

Tween Ejercicio paso a paso: Creación de una animación Tween para animar para animar una una vista. vista.

1.

Crea un nuevo proyecto con con nombre AnimacionTween.

2.

res/anim/tweenanimation.xml yy pega pega el el siguiente siguiente código: código: Crea el fichero res/animltweenanimation.xml /J


153

El gran libro de Android android:f android; f romDegrees= rornDegrees= "0 "0"" android:toDegrees = "360 " android:toDegrees="360" android:pivotX=" 50% " android:pivotX="50%" android:pivot.Y=""50%"/> 50% "/> android:pivotY= tartOffset = "4000" android:startoffset="4000"

android:duration= "2000"

aruir~id: du rat i on=" 2000 "

android:fromXDelta= android ;froitiXDelta= "O" "0" android ta= ""0" O" android:: f:r·omYDel froíTiYDelta= android:toXDelta=" 50"" android:toXDelta= "50 android:toYDelta="100 android:toYDelta= "100 " /> />
android:duration=''2 0(l0 '' android:duration="2000" android: fr orrLZI.lpha= "1 f ronnAlpha= "i "" android:toAlpha="O" android:toAlpha= "0" /> />

3.

Abre el fichero res!Layoutlmain. xml yy añade res/Layout/main.xml añade el el siguiente siguiente atributo atributo aa lala vista vista de tipo TextView:

android:id="@+id/textView" android:id="@+id/textview" 4.

Abre la actividad del del proyecto proyecto yy añade añade las las líneas líneas marcadas marcadas en en negrita negrita alal método OnCreate (). @OverridE: n CreatE: (Bundle savedinst.anceState) ©Override public void oonCreate(Bundle savedlnstanceState) {{ super. onCreate{savedinstanceState); super.onCreate(savedlnstanceState);

setCorlten tView(R.layclut. main); setContentView(R.layout.main); TextView texto = (TextView) (TextView) findViewByid(R.id.textView); findViewByld(R.id.textview) ¡ Animation animacion animación = AnimationUtils.loadAnímation(this, AnimationOtlis.loadAnimation(this, R.anim . anímacion);; R.anim.animación) texto.startAnimation(animacion); texto.startAnimation(animación);

5.

}} Ejecuta la aplicación.

Como podrás ver, el Textview Textview comienza comienza haciéndose haciéndose más más pequeño pequeño (etiqueta ), te >) y, ), después rota rota sobre sobre sí sí mismo mismo (etiqueta (etiqueta ) y, finalmente, se desplaza (etiqueta «transíate?)) aa la la vez vez que que se se hace hace >). Al transparente (etiqueta ). Al finalizar finalizar la la animación, animación, vuelve vuelve aa su su posición y estado inicial, sin importar importar dónde dónde ni ni cómo cómo haya haya acabado. acabado.

lili

Recursos adicionales: Lista Lista de de animaciones tween y sus atributos atributos

etiquetas etiquetas

de de

Los siguientes atributos son aplicables aplicables aa todas todas las las transformaciones: transformaciones: startoffse startof fsett -- Instante inicial inicial de de la la transformación transformación en en milisegundos. milisegundos. duration -- Duración de la transformación transformación en en milisegundos. milisegundos.

154

/as las

Gráficos en Android animación. - Número de repeticiones adicionales de la animación, repea.tcount repeatcount -

interpoiator -- En lugar de realizar una transformación lineal se aplica algún interpolator son: interpolación. Alguno de los valores posibles son; tipo de interpolación. accelerate_interpolator, accelerate_decelerate_interpolator, acce?Lerate_iriterpo.lator, accelerate_decel.erate_i.nterpolator, anticipate_interpolator, anticipate_overshoot_interpolator, antici.pate_interpolator, decelerate__ interpolator,/ bounce interpolator, cycle interpolator, decelerate_intexpolator cycle...interpolator, bounce__inter:polator, oversh oot_ interpolator linear_interpolator, linear_ int.erpolator, overshoot_interpolator

Lista de las transformaciones con sus atributos específicos: específicos: - Desplaza la vista. vista.

X. toXDelta -- Valor inicial y final del desplazamiento en eje X. f romXDeita, toXDeita trornXDelta, Y. - Valor inicial y final del desplazamiento en eje Y. toYDelt.a fromYDelt.a, fromYDeita, toYDeita

- Rota la vista. vista. te>
giro. Este quedará fijo pivotx, - Punto sobre el que se realizará el giro. pi vot.Y vot.x, pivotY pi pantalla. en la pantalla. vista. -Cambia Cambia el tamaño de la vista. toxscale -- Valor inicial y final para la escala del eje X fromxscale fromxscale,, toxscaie

(0.5=50%, 1=100%)

f romYScale, toYScale -Valor - Valor inicial y final para la escala del eje Y. fromYScale, zoom. Este quedará pivotx, pivotY pivotY -- Punto sobre el que se realizará el zoom. fijo en la pantalla. pantalla. vista. - Cambia la opacidad de la vista. -Valor toAlpha fromAlpha f romAipha,, toAipha Valor inicial y final de la opacidad.

Práctica: Introduciendo animaciones en Asteroides En esta práctica has de conseguir que los diferentes elementos del Layout inicial otro, con diferentes efectos. de Asteroides vayan apareciendo, apareciendo, uno tras otro, 1.

Asteroides. Abre el proyecto Asteroides.

2.

Crea una nueva animación con nombre giro_con_zoom.xml. Debe durar 1 dos segundos y de forma simultánea debe hacer un zoom de escala 3 a 1 yy un giro de dos vueltas (720°). El punto de anclaje de la rotación y el vista. zoom ha de ser el centro de la vista.

3.

título. Selecciona el Layout main.xml y pon un id al Textview correspondiente al título.

155

El gran libro de Android 4. 4.

inicial de de Asteroides, Asteroides, crea crea un un objeto objeto correspondiente correspondienteaa este este En la actividad inicial Textview la animación animación anterior. anterior. TextVi ew y aplícale la

5. 5.

Crea una nueva animación animación con con nombre nombre aparecer.xml. aparecer.xml. Debe Debe comenzar comenzaraa los losdos dos segundos, segundos, durar un segundo segundo y modificar modificar el el valor valor de de alpha alpha de de O 0 hasta hasta 1.1.

6. 6.

Aplica esta animación al al primer primer botón. botón.

7.

Crea una nueva animación animación con con nombre nombre desplazamiento_derecha.xml. desplazamientojderecha.xml. Debe Debe segundos, durar durar un un segundo segundo yy modificar modificar elel valor valor de de comenzar a los tres segundos, desplazamiento x de 400 hasta hasta O 0.. Prueba Prueba también también algún algún tipo tipo de de interpolación. interpolación.

8.

Aplica esta animación al al segundo segundo botón. botón.

9.

Si dispones de tiempo, tiempo, crea crea dos dos nuevas nuevas animaciones animaciones aa tu tu gusto gustoyy aplícalas aplícalas al tercer y cuarto botón.

giro_con_zoom.xml al al botón botón "Acerca "Acerca de" de" cuando cuando sea sea 10. Aplica la animación giro_con_zoom.xml pulsado. caDe , la pulsado. Observa cómo al al lanzar lanzar la la nueva nueva actividad actividad Acer AcercaDe, la actividad actividad principal continúa ejecutándose.

4.5.2. Animaciones de de propiedade propiedades de Android Android (nivel (nivel de de API API 11 11), se ha ha incorporado incorporado un un nuevo nuevo A partir de la versión 3.0 de ), se tipo de animaciones. A diferencia de de las las animaciones animaciones Tween Tween que que solo solo es es aplicable aplicable aa vistas, vistas, una animación de de propiedades propiedades puede puede animar animar cualquier cualquier tipo tipo de de objetos. objetos. Además, no está restringido aa las las cuatro cuatro transformaciones transformaciones antes antes vistas, vistas, podemos podemos animar cualquier propiedad del del objeto. objeto. Por Por ejemplo, ejemplo, podemos podemos hacer hacer una una animación animación el color color de de fondo fondo de de una una vista. vista. que cambie progresivamente el respecto aa las las animaciones animaciones Tween, Tween, es es que que estas estas solo solo Otra diferencia, con respecto modifican la forma en que la la vista vista es es representada, representada, pero pero no no sus sus propiedades. propiedades. Por Por ejemplo, si aplicas una animación animación Tween Tween para para que que un un texto texto se se desplace desplace por por lala pantalla, se visualizará correctamente, correctamente, pero pero al al acabar acabar lala animación animación elel texto texto estará estará en el lugar inicial. Lo que te te obligará obligará aa implementar implementar tu tu propia propia lógica lógica para para manejar manejar En una una animación animación de de propiedades propiedades estará estará cambiando cambiando elel este cambio de posición. En cómo se se representa. representa. objeto en sí, no solamente cómo Desventajas de las animaciones Tween: Tween: • Solo podemos animar objetos i ev:. objetos de de la la clase clase vview. • Está limitado a estas estas cuatro cuatro transformaciones transformaciones yy no no puede puede aplicarse aplicarse aa otros otros el color color de de fondo. fondo. aspectos como cambiar el forma en en que que la la vista vista es es representada, representada, pero pero no no sus sus • Solo modifica la forma propiedades en sí. Desventajas de las animaciones de de propiedades: propiedades: • Solo disponible aa partir partir de de la la versión versión 3.0. 3.0. En En la la actualidad actualidad existen existen muy muy pocos dispositivos que la la soporten. soporten para inicializarse inicializarse yy hay hay que que escribir escribir más más código. código. • Requiere más tiempo para Para aprender más sobre sobre este este tipo tipo de de animación animación puedes puedes leer leer lala siguiente siguiente sección de Android Developers: Propertv Propertv Animation. Animation

156

CAPÍTULO CAPÍTULO 5. 5.

Entradas Entradas en en Android: Android: teclado, teclado, pantalla pantalla táctil táctil y y sensores sensores

La forma más habitual para para interactuar interactuar con con un un ordenador ordenador es es elel teclado teclado yy elel ratón. ratón. Por desgracia, estos dispositivos dispositivos de de entrada entrada no no existen, existen, oo están están muy muy limitados, limitados, en en los nuevos nuevos móviles móviles permiten permiten nuevas nuevasformas formasde de un teléfono móvil. Afortunadamente, los interacción con el usuario, usuario, por por lo lo que que el el diseño diseño de de nuestras nuestras aplicaciones aplicaciones ha ha de de adaptarse a estas nuevas nuevas formas formas de de interacción. interacción. AA lolo largo largo de de este este capítulo capítulo se se estudiarán diferentes alternativas alternativas para para recoger recoger las las acciones acciones que que los los usuarios usuarios realizan sobre la aplicación.

del manejo manejo de de eventos eventos en en Android, Android, comenzaremos comenzaremos con con Tras una visión general del tradicional, el el teclado, teclado, luego luego estudiaremos estudiaremos los los eventos eventos de de lala el dispositivo más tradicional, finalizaremos con con los los sensores. sensores. Estos Estos tres tres mecanismos mecanismos de de pantalla táctil, y finalizaremos aplicados al al manejo manejo de de nuestra nuestra nave nave en en lala aplicación aplicación Asteroides. Asteroides. interacción serán aplicados se tocarán tocarán otros otros aspectos aspectos importantes, importantes, como como elel manejo manejo de de hilos hilos De forma adicional se de ejecución (threads) (threads) yy las las gestures. gestares.

i Objetivos: Objetivos; •

alternativas para para manejar manejar los los eventos eventosde deusuario usuarioen en Mostrar las distintas alternativas Android. Android. se manejan manejan los los eventos eventos del del teclado. teclado. • Describir cómo se • Aprender a interaccionar con con la la pantalla pantalla táctil. táctil. son las las Gestures Gestares yy como como pueden pueden ayudarte ayudarteen en eleldiseño diseñodel del • Descubrir qué son interfaz de usuario. disponibles en en muchos muchos terminales terminalesAndroid Android yy • Enumerar los sensores disponibles aprender a utilizarlos. de hilos hilos de de ejecución ejecución (Thread}. (Thread). • Describir el uso de • Seguir mejorando la aplicación aplicación Asteroides. Asteroides.

157

El gran libro de Android

5.1. 5.1. Manejando Manejando eventos eventos de de usuario usuario Android captura los distintos distintos eventos eventos de de usuario usuariode deforma forma homogénea homogéneayyse selos lospasa pasaaalala clase encargada de recogerlos. recogerlos. Por Por lo lo general, general, va va aa ser ser un un objeto objeto tipo tipo view viewelelque que recogerá estos eventos eventos por por medio medio de de dos dos técnicas técnicas alternativas. alternativas. Los Losescuchadores escuchadoresde de Listener) yy los los manejadores manejadores de de eventos eventos(Event {EventHandler). Handler). eventos (Event Listener)

5.1.1. Escuchador de de eventos eventos de eventos eventos oo Event Event Listener Listener es es una una interfaz interfaz de de lala clase clase view viewque que Un Escuchador de callback que que ha ha de de ser ser registrado. legistrado. Cada Cada Escuchador Escuchadorde deEventos Eventos contiene un método callback método cal/back, callback, que que será será llamado llamado por por Android Android cuando cuando se se produzca produzca lala tiene solo un método Tenemos los los siguientes siguientes escuchadores escuchadoresde deeventos: eventos: acción correspondiente. Tenemos onCl ick ( l onClick() Método de la interfaz OnCJ.i.ckListener. Se interfaz View. view.OnClickLlatener. Se llama llama cuando cuando elel usuario usuario selecciona un elemento. Se Se puede puede utilizar utilizar cualquier cualquier medio mediocomo como lalapantalla pantalla táctil, las teclas de de navegación navegación oo el el trackba/1. trackball. onLongClick () onLongClick() Método de la interfaz View. OnLongClicki,istener. Se view.OnLongClickiástener. Se llama llama cuando cuando elel usuario selecciona un un elemento elemento durante durante más más de de un un segundo. segundo. onFocusChange () onFocusChange() Método de la interfaz OnFocusChangeListener. Se interfaz View. view.onFocusChangeListener. Se llama llama cuando cuando elel usuario navega dentro dentro oo fuera fuera de de un un elemento. elemento. onKey() onKey () Método de la interfaz interfaz View.OnKeyLístener. view.onKeyListener. Se Se llama llama cuando cuandose sepulsa pulsaoose se suelta una tecla del del dispositivo. dispositivo. onTouch(l onTouch() interfaz View. view.onTouchListener. Se llama llama cuando cuando se se pulsa pulsaoo Método de la interfaz OnTouchLiBtener. Se se suelta o se desplaza en en la la pantalla pantalla táctil. táctil. onCreateContextJvlenu() onCreateContextMenu()

Método de la interfaz . OnCreateContextMenuLiBtener. Se interfaz View View.OnCreateContextMenuListener. Se llama llama cuando se crea un un menú menú de de contexto. contexto. Existen dos alternativas alternativas para para crear crear un un escuchador escuchador de de evento. evento. La La primera primera es es crear un objeto anónimo por : por ejemplo ejemplo de de lala clase clase onclickListener onciickListener()(): prote c t ed void protected void onCreate(Bundle onCreate(Bundle savedValues) savedValues) {{ Butt.on Button boton boton == (Button)findViewByid(R.id.boton); (Button)findViewByld(R.id.boton); boton.BetOnClickListener( e w OnClickListener() boton.setOnClickListener( nnaw OnciickListener() { public vo i d onClick(View void onClick(View v) v) {

!/ e al.izar // Acciones aa rrealizar J } 158

Entradas en Android: teclado, pantalla táctil y sensores La segunda alternativa consiste en implementar la interfaz onclickListener onciickListener (l. Esta como parte de tu clase y recoger los eventos en el método onclick onciicko. alternativa es la recomendada por Android, Android, al tener menos gasto de memoria. memoria. A continuación, se muestra un ejemplo: ejemplo: publ ic class Ejemplo extends Actívity ementa OnClickListener{ public Activity impl implements OnClickLlstener{ protected voi d onCreate(Bundle savedValues) {{ void Button boton == (Button)findViewByid(R.id.boton); ÍButton)findViewByldíR.id.boton); boton.setOnClickListener( this ); boton.setOnClickListener(this};

} public void onClick (View v) {{ onClickíView /! Acc:ic>nes aa realizar ti Acciones

} }

5.1.2. Manejadores Manejadoras de eventos Si estás creando un descendiente de la clase View, Wew/, podrás utilizar varios métodos (cal/back) (callback) directamente usados como manejadores manejadoras de eventos por defecto (Event {Event Handlers) Handlers).. En esta lista se incluye: incluye: onKeyDovm int keyCode, KeyEvent KeyEven t e) Llamado cuando una tecla es pulsada. onKeyüown 1(int onKeyup onKeyüp (in (intt keyCode, KeyEvent e)

Cuando una tecla deja de ser pulsada.

onTrackball.Event onTrackbailEvent (Notion.Event (MotionEvent me)

Llamado cuando se mueve el trackball. trackball.

onTouchEvent (MotionEvent me)

Cuando se pulsa en la pantalla táctil.

onF'ocusChanged( boolean obtengoFoco, iint nt dirección, direccion, Rect onFocusChanged(boolean prevRectanguloFoco) Llamado cuando cambia el foco. prevRectanguioFoco)

Es la forma más sencilla, dado que no hace falta usar una interfaz, ni registrar el callback. Como en nuestro ejemplo estamos creando JuegoView, Juegoview, que es un método cal/back. descendiente de view, podremos utilizar directamente manejadores de evento. evento.

5.2. 5.2. El El teclado teclado físico, siempre es Aunque cada vez existen menos terminales Android con teclado físico, interesante aprender a gestionar los eventos procedentes del teclado. Su manejo se ilustra en el siguiente ejercicio. ejercicio.

Ejercicio paso a paso: Manejo de la nave con el teclado. teclado. Veamos cómo podemos utilizar un manejador de eventos de teclado para maniobrar la nave de Asteroides: Asteroides:

159

El gran libro de Android Android 1.

Abre el proyecto Asteroides. Asteroides.

2.

Inserta este Inserta este código en en la la clase clase vistaJuego. VistaJuego. ©Override

@Qver~c t de

public boolean onKeyDown(int onKeyDown( int codigoTecla, c odigoT'ecla, KeyEvent KeyEvent evento) evento) super. onKeyDown( codigo'l'ecla , evento); evento); super.onKeyDown(codigoTecla,

{{

// /1 Suponemos que vamos aa procesar procesar la la pulsación pulsación boolean procesada p rocesada = true; true; switch (codigoTecla) (codigoT'ecla) {( case KeyEvent.KEYCODE_DPAD_UP; KeyEvent:. KEYCODE'_DF'AD_UP: ace leracionNave == ++PAS'O_ACELE'RACTON_NA1/E; aceleracionNave PASO_ACELERACION_NAVE; break; case KeyEvent.KEYCODE_DPAD_LEFT: KeyEvent. KEYCODE_DPl\D_LEF'-T: ggiroNave i roNave == -PASO_GIRO_NAVE; - PAS'O_G.IRO_NA VE'; break; case KeyEvent.KEYCODE_DPAD_RIGHT: KeyEvent. KEYCODE_DPAD_RIGH'I': giroNave = + PASO__GIRO_NA Pi1S'O_GllW_NAVE VE;; break; case KeyEvent.KEYCODE_DPAD_CENTER: KeyEvent . KEYCODE... DPAD.... CEN-TER: case KeyEvent. KeyEven t . KEYCODE__ENTEP.: KEYCODE__ ENTER: Actival'-lisil () ; ActivaMisil(); break; default:

í/// Si estamos aquí, no no hay hay pulsación pulsación que qut:, nos nos interese interese procesada = false; break;

} return procesada; p r ocesada;

} 3.

pulse una una tecla tecla se se realizará realizará una una llamada llamada alal método método Cada vez que se pulse onKeyoown () con los siguientes siguientes parámetros; parámetros: El El primero primero es es un un entero entero que que onKeyDown o identifica el código nos identifica código de de la la tecla tecla pulsada. pulsada. El El segundo segundo es es de de lala clase clase KeyEven permite obtener obtener información información adicional adicional sobre sobre elel evento evento KeyEventt y nos permite como, ejemplo, cuándo cuándo se se produjo. produjo. Este Este método método ha ha de de devolver devolver un un como, por ejemplo, valor booleano, booleano, verdadero, verdadero, si si consideramos consideramos que que la la pulsación pulsación ha ha sido sido procesada por nuestro nuestro código, código, yy falso, falso, si si queremos queremos que que otro otro manejador manejadorde de evento, al nuestro, nuestro, reciba reciba la la pulsación. pulsación. evento, siguiente al

4.

Antes de ponerlo ponerlo en en marcha marcha comenta comenta la la llamada llamada aa ActivaMisil(), Ae t i va Misil ( J , dado dado que esta función aún aún no no está está implementada. implementada.

5.

correctamente. Verifica si funciona correctamente.

NOTA: Para poder poder recoger eventos eventos de de teclado teclado desde desde una una vista vista es es necesario necesarioque que esta esta tenga el foco foco y para para que que esto esto sea sea posible posible verifica verifica que que tiene tiene lala propiedad propiedad Focusab.l.!::= " tt rué r·uf.-? ". focusable=

160

sensores táctil yysensores pantalla táctil teclado, pantalla Android: teclado, Entradas en Android; 0 0

teclado. el teclado. con el nave con la nave Práctica: Práctica; Manejo de la

una pulsamos una Cuando pulsamos satisfactoria. Cuando forma satisfactoria. de forma funciona de no funciona anterior no ejercicio anterior El ejercicio pararla. ElEl de pararla. manera de hay manera no hay ya no pero ya girar pero pone aa girar se pone nave se la nave girar la tecla para girar no perono tecla,pero una tecla, pulsa una se pulsa cuando se activa cuando se activa solo se onKeyDown solo eventos onKeyDown de eventos manejador de cuando se suelta. atienda aa nave atienda que lala nave para que o nKeyup para eventos onKeyUp de eventos manejador de el manejador Trata de escribir el código: siguiente código: del siguiente partir del Puedes partir correcta. Puedes forma correcta. las órdenes de forma ®Override ©Override evento) { KeyEvent evento) codigoTecla, KeyEvent onKeyUp(int codigoTecla, public boolean onKeyUp(int evento); super.onKeyUp(codigoTecla, onKeyUp(codigoTecla, evento); super. pulsación la pulsación procesar la vamos aa procesar í! // Suponemos que vamos true; boolean procesada == true;

return procesada; procesada; }

continuación: muestra aa continuación: se muestra ejercicio se al ejercicio solución al posible solución Una posible Solución: Una ®Overri.de ©Override evento) { KeyEvent evento) codigoTecla , KeyEvent onKeyUp(int codigoTecla, public boolean onKeyUp(int evento); onKeyUp(codigoTecla, evento); super. super.onKeyUp(codigoTecla, pulsactón. la pulsación procesar la vamos aa procesar lí // Suponemos que vamos true; procesada == true; boolean procesada (codigoTecla ) {{ switch (codigoTecla) KeyEvent. KEYCODE_DPllD_UP: case KeyEvent.KEYCODE_DPAD_UP: O; aceleracionNave aceleracionNave == 0; break; KeyEvent. KEYCODE_DPliD_LEFT : case KeyEvent.KEYCODE_DFAD_LEFT: KeyEvent. KEYCODE_DPllD_RIGHT : case KeyEvent.KEYCODE_DPAD_RIGHT: O; giroNave == 0; break; default: interese nos interese que nos pulsación que hay pulsación no hay aquí, no estarnos aquí, // Si estamos procesada == false; break;

} procesada; return procesada;

}

161

El gran libro de Android 5.3. La La pantalla pantalla táctil 5.3. táctil Los teléfonos Android suelen incorporar una pantalla táctil, táctil, que es utilizada como dispositivo principal de entrada. entrada. El uso más importante de la pantalla táctil es como sustituto del ratón de un ordenador de sobremesa. sobremesa. De esta forma podemos seleccionar, arrastrar y soltar cualquier elemento de la pantalla de forma sencilla. sencilla. No seleccionar, obstante el uso de este dispositivo no acaba aquí. Suele utilizarse en sustitución del físico. También puede ser teclado en aquellos dispositivos que no disponen de teclado físico. utilizada como entrada de un videojuego, como se verá en este apartado. apartado. Otra alternativa para usar la pantalla táctil consiste en el uso de gestures gestares snportado soportado a partir 1.6. Las gestares gestures serán estudiadas en el siguiente punto. Otro abanico de del SDK 1.6. multi-touch, soportado a partir del SDK 2.0. nuevas posibilidades se abre con el multi-touch, 2.0.

El manejo básico de la pantalla táctil pasa por definir el método onTouchEvent en una clase víew clases). view (o implementar la interfaz onTouchListener onTouchi.ü;tener en otras clases). Este método nos devolverá en un parámetro, t. parámetro, un objeto de la clase t"loti.onEven MotionEvent. Los métodos más interesantes de la clase NotionEvent MotionEvent se indican a continuación:

getAction ({)l getAct.ion

Tipo de acción realizada. realizada. En API level 1 1 puede ser: ser: actiom down, ACTION_ DOl·IN,

ACTION__...f•IOVE, MOVE, ACTION ___UP UPOO ACTION ___CANCEL. CANCEL.

9etx ( l, getY o::;etY () ( l Posición de la pulsación. getx {), pulsación. getDownTime o ( l Tiempo en ms en que el usuario presionó, presionó, por primera vez, en una

cadena de eventos de posición. posición. 9etEventTime () Tiempo en ms del evento actual. getEventTime getPression ( l Estima la presión de la pulsación. getPressioní) pulsación. El valor O 0 es el mínimo, el valor 11 representa una pulsación normal. normal

<;;etsize getsize () Valor escalado en O 0 y 11 que estima el grosor de la pulsación. pulsación.

A partir del API level 5 estos métodos pueden indicar como parámetro un índice de puntero para decirle al sistema sobre cuál de los distintos punteros estamos consultando.

I; Ejercicio paso a paso: paso: Uso de la pantalla táctil. En este ejercicio se mostrará cómo podemos capturar los eventos procedentes de la pantalla táctil. También se aprovechará para repasar otros conceptos como: como: Creación de Layouts y herramientas de revisión de código en Eclipse. Eclipse.

162

1.

Crea un nuevo proyecto con nombre Pantalla Tactil. PantallaTactil.

2.

Modifica el Layout main.xml para que tenga una apariencia similar a la siguiente. siguiente. De esta forma practicarás la creación de Layouts. Layouts. A la derecha se muestra la estructura de vistas que contiene. contiene.

Entradas en Android: teclado, pantalla táctil y sensores

¡e Outline K5 \ O ~i~e~~i~~t,~ Properties: 5 ~~~Android Emulato ] 'g~··o;rtii~~---~<~~ ~?¡~ ~~~~~!~:i íS.JUnearlayout S üneaítayout All TextViewEntrada -- "Pulsa "Pulsa sobre esta vista" ¡;;;;¡ scroiiViewl H scrollViewl Ah Ab TextViewSalida TextViewSalida ··• "Pulsaciones-'· "Puisadooes " 3.

Una posible solución se muestra a continuación: encoding= "u'cf-8"?>
xmlns: e¡.): //.~·;cJJe.mas. xralns : android= "he "htt:p: //schemas. android. android. corn/apk/res/andr:oid" com/apk/res/android"

android:layout_width="fiil_parenc* android: layout_width= "fill_parenc" android:layout_height="fill_parent" android: layout_height= " Lill_par-ent: " android:orientation="ver-l:ical" android:orientarion="vertical" > <'I'ext::View ■cTextView android : id="®+id/TextViewEntrada" android:id="®+ id/TextViewEnt rada" android:layout_width="fill_parent" android:layout__width="fill_parent" android: layout___height="Odp" android:layou^ height="Odp" android: layout___.weight=" 1" android:layout weight="1" android:text="Pulsa sobre esta vista" vista" android:gravity= '1 center'1 android:gravity="canter"

android:background="#OOOOFF" androi d:backg round="SOOOOFF" android android:: layout_margin="2mm" layout_margin= " 2rnm" android:textSize="10pt"/> android:textSize="lOpt" />

> android:text="Pulsaciones:"/>

163

El gran libro de Android ..



4.

siguientes dos dos líneas líneas alal final final del del método métodooncreate oncreate1){): Introduce las siguientes : TextView Text.V. i.ew

entrada - (TextView) (TextView) findViewByid(R.layout. findViewByld(R.layout. TextV.i TextVi ewE.ntr.·ada) ewEn t ra d¿i) ;; entrada.setOnTouchListener( this ); entrada.setOnTouchListener(this); entrada~

5.

Pulsa Shift-Ctr/-0 Shiñ-Ctrl-O para para añadir añadir los los imports. imports.

6.

cómo el el método método setOnTouchListener setOnTouchListener está está marcado marcado como como Observa cómo erróneo. Si pones el el cursor cursor encima, encima, te te indicará indicará que que elel parámetro parámetrode deeste este método {this} (this) es es de de la la clase clase PantallaTactilActivity PantallaTactilActivity yy es es necesario necesario que sea de tipo OnTouchListener. OnTouchListener.

7.

el error error te te mostrará mostrará una una lista lista de de posibles posibles soluciones. soluciones. Para evitar el Selecciona la última última "Lef "Lef 'PantallaTact.ilAct.i.vit.y' 'PantallaTactilActivity' impJ.ement implement 'OnTouchListener' 'OnTouchListener'"" de de esta esta forma forma implementaremos implementaremos este este interfaz interfaz yy podrá ser ser considerada considerada de de este este tipo. tipo. La La declaración declaración de de lala nuestra clase podrá clase cambiará a: a: public class Pantalla'l'actilActivity PantallaTactilActivity extends extends Activity Activity implementa OnTouchListener OnTouchListener

{

8.

Se ha solucionado solucionado el el problema problema anterior, anterior, pero pero ha ha aparecido aparecidootro. otro. Ahora, Ahora, lala PantallaTactilActivity PantallaTactilActivity está está marcada marcada como como errónea. errónea. ElEl problema problema consiste en que estamos estamos diciendo diciendo que que implementamos implementamos elel interfaz interfaz OnTouchListener pero pero no no hemos hemos implementado implementado ninguno ninguno de de los los métodos métodos de este interfaz.

9.

Para evitar el el error error selecciona selecciona en en lala lista lista de de posibles posibles soluciones: soluciones: "Add "Add un .i mpl.emented mpi ernent ed methods" rnethods" de de esta esta forma forma se se añadirán añadirán todos todos los los métodos métodos necesarios de este interfaz. interfaz. La La declaración declaración de de lala clase clasecambiará camoiaráa:a: ®Ove.rride ©Override public public boolean onTouch(View onTouch(View argO, argO, MotionEvent MotionEvent argl) argl) {{ !//í TODO Auto -- generat:ed method Auto-generated inethod st:ub stub return false; false;

}

110. O. Reemplaza el nombre nombre de de los los parámetros parámetros por por otros otros más más expresivos. expresivos. Por Por ejemplo: ejemplo: argO a rgO por por vista vista yy argl argl por por evento. evento.

este método método ha ha de de devolver devolver un un parámetro. parámetro. Actualmente Actualmentees es 11. Observa como este false, que significa significa que que no no nos nos hemos hemos hecho hecho cargo cargo de de lala pulsación, pulsación, elel sistema seguirá pasando pasando este este evento evento aa otras otras vistas. vistas. En En este este caso caso elel LinearLayout que contiene contiene la la vista. vista. Cámbialo Cámbialo aa true, true, para paraque queelelsistema sistema no siga propagando este este evento. evento.

12. Reemplaza la 1 TODO la línea línea "/ "// todo Auto--9enerated Auto-generated method method stub" stub"por: por: TextView salida (R . id. Texi:Vierv8alida) ; salida == (TextView) (TextView} findViewByid findViewBylcUR.id.TextViewSalida); salida.append( e v e nto.toString( ) +"\n" ); salida.append(evento.toString{)+"\n");

164

Entradas en Android: teclado, pantalla pantalla táctil táctil yy sensores sensores 13. Ejecuta el proyecto yy verifica el el resultado. resultado. 14. acction-o acction=O significa que se ha ha pulsado pulsado sobre sobre la la pantalla, pantalla, acction=i acction=l significa que se ha soltado y acction=2 acction=2 que que se se está está desplazando desplazando el el dedo dedo (estos corresponden con las constantes tres valores corresponden con las constantes I•1otionEvent.. ACTION_DO\rlN, MotionEvent . ACTION_UP Mot ionEvent.ACTIONJDOWN, Mot ionEvent.ACTION_UP yy MotionEvent .AC'I'ION_MOVE) . MotionEvent.ACTIONMOVE). 15. Modifica el proyecto para que que cuando cuando el el móvil móvil se se ponga ponga en en apaisado apaisado el el Layout que se visualice sea:

16. Verifica el resultado en un un dispositivo dispositivo real. 17. No todas las pantallas táctiles táctiles soportan soportan los los métodos métodos getPressionOy get.Pression () y getsize o. getsize (l . Prueba si tu terminal lo lo soporta soporta y, y, en en tal tal caso, caso, observa observa el el rango de valores que obtienes. el ejercicio ejercicio que que acabas acabas de de 18. Conéctate a www.androidcurso.com www.androidcurso.com yy localiza localiza el realizar. Comprueba los valores obtenidos obtenidos con otros otros terminales terminales yy comparte comparte realizar. los valores obtenidos por tu terminal. terminal.

5.3.1. Manejo de la pantalla táctil con con multi-touch multi-touch Las pantallas táctiles más modernas modernas tienen tienen la la posibilidad posibilidad de de indicar indicar la la posición posición de de mismo tiempo. tiempo. Para Para averiguar averiguar si si el el dispositivo dispositivo varios punteros sobre la pantalla pantalla a un mismo tiene esta capacidad puedes utilizar utilizar el siguiente siguiente código: código:

boolean multiTouch boolean mul tiTouch == getPackageManager().hasSystemFeature( getPackageManager() .hasSystemFeature( PackageManager.FEATURE_TOUCHSCRESN_MULTITOUCH); Packagef'.lanager. FEA'I'URE_TOUCHSCREEN_I
El gran libro de Android Veamos una lista: lista: ACTION_DOWN - Se pulsa en la pantalla sin haber otro puntero activo. action_down ACTION____uP - Se deja de presionar el último puntero activo. action up ACTION_ r-10VE action move

- Cualquiera de los punteros activos se desplaza. desplaza. -

- Se cancela un gesture. gesture,

ACTION_CJI.NCEL act i on_cancel ACTION_OUTSIDE act i on_out s i de

--

El puntero se sale de la vista.

ACTION_POINTER_nowN action_pot.nter_down ACTION_ POINTER_UP -action_pointer_up

Se pulsa un nuevo puntero distinto al primero. primero.

Se deja de presionar un puntero pero no es el último. último.

Ejercicio paso a paso: Uso de la pantalla táctil multi-touch. multi-touch. 1. 1.

Ejecuta el ejercicio anterior en un dispositivo real con capacidad de multitouch (si no dispones de uno te será imposible realizar este ejercicio). ejercicio).

2. 2.

Pulsa simultáneamente con dos dedos en la pantalla: Si lo haces, sin desplazar los dedos, recibirás 4 eventos. Los dos primeros por las pulsaciones de cada dedo y los dos siguientes cuando se levanten. El resultado puede simular al siguiente: siguiente:

'ulsaciones: MotlonEver:( (-119,0 y-237.0 pressi 1 0.32156864 ^6=0,13333334} VlotionEvent(4050b730 | ,'--91,0 pressure-0.380- 9922 size=Q.20000002} V!otionEvent{4050b730 3Ct.ion=262 | X-2B7.0 p91.0 pressure-0,380: 922 S si?e=-0s,20000002} VlotionEvent|4050b730 action=1 | x=1l9,0y=237.0 3ressure=0.32156864 s i 3.

Como puedes ver, cuando hay más de un puntero en pantalla la acción resulta compleja de interpretar. interpretar. Veremos cómo hacerlo a continuación. continuación.

4.

En primer lugar asegúrate que tu proyecto utiliza las APis APIs 2.0 o superior. superior. Para ello utiliza la opción de menú Project/Properties/Android Project!Properties!Android y selecciona en Project Build Target la opción Android 2.0. 2.0.

5.

o n Touch (): Remplaza la siguiente línea del método onTouch sal ida. append (evento toSt.r.i ng () 4-"\n") + '' \n") ; (evento.. toString

por: por: String acciones[] « = { "ACTIONJDOWN", " ACT I ON__DOWN" ,

"ACTION_UP" , "ACTIONJJP", "ACTION_OUTSIDE 11 , "ACTION_OUTSIDE", "ACTION__POINTER_DOl'IN" "ACTION_ POINTER_ UP " }};; "ACTIOK POINTERJDOWN",, "ACTION__POINTER_UP" accion -■=- evento. evento.getAction( acción getAction ());,* codigoAccion -;';; acción accion & & HotionEvent.ACTION_MASK; Mot ionEvent . .l1CT1"01\j'__M.f':..SK ¡ "ACTION_t-10VE ", "ACTION__MOVE",

iint nt iint nt

166

"ACTION_CANCEL ", "ACTION_CANCEL",

Entradas en Android: teclado, pantalla táctil y sensores salida.append(acciones[codigoAccion]); salida.append(acciones[codigoAccion)); for (int ii =O; = 0; ii < evento.getPointerCount(); i++) {{ salida.append(" puntero-." puntero:" i-+ evento.getPointerld(i) evento.getPointerid(i) + salida.appendC ''" x:'' evento.getX(i) + "'' y:" y:'' +i· evento.getY(i)); x:" + evento.getx(i) } salida . append("\n"); salida.append("\n"); return true true;;

6.

Para visualizar cada posible acción hemos creado un array con sus nombres. A continuación, accion. continuación, averiguamos la acción en la variable acción. Esta nueva acción la ha podido hacer cualquier puntero de los activos o uno nuevo. A partir de la versión 2,0, 2.0, en esta variable se codifica simultáneamente el código de la acción (8 bits menos significativos) e índice de puntero que la ocasiona (siguientes 8 bits). bits). Para obtener esta información por separado puedes utilizar el siguiente código; código: int codigoAccion codi goAccion = acción accion & Mot MotionEvent _NllSK; ionEvent..llCTION ACTJQW_í®SJí; int iPuntero == (acción (accion & 1:<. MotionEvent.ACTION_FO!NTER_ID_í-lASK) MotionEvent .ACTION.... POINTER__ Ip_)1ASK) >> MotionEvent. J·í CTION_POIN'I'EF(_ID_SHIFT; MocionEvenc.ACTION_POINTER_ID_SHIFT;

7.

A partir de la versión 2.2 (API level 8) las dos últimas constantes quedan obsoletas y se definen otras dos equivalentes cuyos nombres son más adecuados: adecuados: int iPuntero iPunte:nl = (acción (accion & . il.C'l'.ION_POINTE'R_INDE'X_l>'diSK) & fvlotionEvent MotionEvent.ACTION__POINTER_INDEX__MASK) >> ACTI01'J___ POINTEF\_Il\TDE..'!{_511IFT; >> MotionEvent. MotionEvent.ACTION_POINTER_INDEX__SHIFT;

8.

Una vez obtenido el código de la acción mostramos su nombre en la vista salida. Luego hacemos un bucle para mostrar información de todos los activos. El método getPointerCount punteros activos. getPointercount () nos permite averiguar su número. Vamos a recorrer los punteros activos con la variable i. Al principio de este apartado vimos una serie de métodos para averiguar () , getsize getsi ze (),...). () , ... ). A partir de la versión información sobre el puntero {getx (getx o, 2.0, 2.0, estos métodos siguen dando información sobre el primer puntero pulsó, ahora también disponemos de los mismos métodos activo que se pulsó, (getx(i), getsize(i),...) pero indicando un índice de puntero {getX(i), getsize(i), ... ) para averiguar información del resto de punteros.

9.

El método getPointeriddnt getPointerid (int índice) indicel nos permite averiguar el identificador del puntero. puntero. No hay que confundir el índice de puntero con su identificador. El índice se asigna en función del orden en que fueron pulsados. El índice cero siempre es el más antiguo. antiguo. El índice de un puntero decrece a medida que los punteros anteriores a él dejan de estar activos. Por el contrario, activos. contrario, el identificador de un puntero es asignado cuando se crea y permanece constante durante toda su vida. Nos será muy útil para seguir la pista de un determinado puntero. El método id) ffindPoínterindex indPointerindex (int (i n t id l nos permite averiguar el índice de un puntero a partir de su identificador. identificador.

110. O. Ejecuta de nuevo el proyecto y vuelve a pulsar con dos dedos. dedos. El resultado ha de ser similar al siguiente: siguiente:

167

Androíd El gran libro de Android p!! +' '1

2c-/)

f,¡

:t)r\

) .2 ",::

.'\(Tll''1\ Dt" ~ }N ¡;

UP '"

lf"tr:

!J);

'.~

:

'~

'J¡

~~~~ t K l<~l;'vÍ',

.j )L' ~~.

..::\C..-Ic.}r\

:~o

~

1 ;:., \: 1

¡ 1r

,(

e \' ~ 1 . e

ur. . t~J_ u-~ p•..rP('ll) o1

1 < L.) •'t ~:rJr .. P¡l, (>-!!1 1 ''(1

c1 \,

se

ttr'iÍ'Y ~~ e)'

.

e ,_ ~ ;L ~}

1~e

r;¡

!_,

v -'~):)o

r

11. Prueba con otras combinaciones de pulsaciones e investiga la relación entre el índice y el id de puntero. puntero. que, además, 12. Modifica el programa para que, además, se muestre en cada evento, evento, el índice de puntero que lo ocasionó. ocasionó.

5.3.2. talla táctil 5.3.2. Manejo de la nave con la pa pantalla

Ejercicio paso a paso: paso: Manejo de la nave con la pantalla táctil. táctil. Veamos cómo podemos utilizar un manejador de eventos de la pantalla táctil para maniobrar la nave de Asteroides. Asteroides. El código que se muestra permite manejar la nave de la siguiente forma; forma: un desplazamiento del dedo horizontal hace girar la nave, nave, un desplazamiento vertical produce una aceleración y, y, si al soltar la pulsación no hay movimiento, movimiento, se provoca un disparo. disparo. 1.

Abre el proyecto Asteroides. Asteroides.

2.

Inserta este código en la clase vistajuego. vis t aJuego.

prívate float mX=0 private mX=O,, raY^O mY=O;; private ean disparo= fa l s e; prívate bool boolean dieparo-false; @Over:cide ©Override

event.)) {{ ppublie ubl i c boolean onTouchEvent (MotionEvent evenr. super,onTouchEvent(event); super .onTouchEvent(event); floa e v e nt.ge tXI); floatt x == event.getx(); float y = = event.getY!); e v e nt.ge tYI); switch (event.getAction()) { case MotionEvent.ACTION_DOWN: MotionEvent. AC7'TON_ DOVIW : disparo~ t rue ; disparo=true;

break; brea k; case I\>fotionEvent . 11C'TTON_l~10 VE : MotionEvent.ACTION_MOVE:

float dx = Math. a l)s(x - m.X); Math.abs(x mX); ffloat loat dy = ~ Math.abs(y Ma th. a h s (y - mYi; mY); if (dy<6 && dx:>6) dx>6){{ g.iroNave f•lath.roun d ( (x - mX) 1 giroNave = Math.round((x / 2); disparo == false; false ; } else iiff (dx<6 && dy>6){ acelerac.ionNave = Math.round((mY t
168

Entradas en Android; Android: teclado, teclado, pantalla pantalla táctil táctil yysensores sensores } break ; break; ccase ase MotionEvent ..l!CTION_UP: ACTJOW_f7P: O; giroNave == 0; aceleracionNave = 0; O; iif f (disparo){ (disparo) { Actival>lisil () ; ActivaMisil{>; } break ; break; } mX=X; mY~y;; mX=xmY=y r eturn true; return true ; } 3.

globales mx Las variables globales mx yy mY mY van van aa ser ser utilizadas utilizadas para para recordar recordar las las último evento. evento. Comparándolas Comparándolas con coordenadas del último con las las coordenadas coordenadas actuales (x, y) y) podremos podremos verificar verificar sisi se se trata trata de de un un desplazamiento desplazamiento horizontal o vertical. vertical. Por Por otra otra parte, parte, la la variable variable disparo disparo es es activada activada cada cada vez que comienza una una pulsación pulsación (action_down). (ACTION_DOWN) . Si Si esta esta pulsación pulsación es es continuada con un un desplazamiento desplazamiento horizontal horizontal oo vertical, vertical , disparo disparo es es desactivado. Si por el el contrario, contrario, se se levanta levanta elel dedo dedo (actionjjp) (ACTION_UP) sin sin haberse producido estos estos desplazamientos, desplazamientos, disparo disparo no no estará estará desactivado desactivado l,cti vaMisil O. y se llamará aa ActivaMisil ().

4.

Antes de ponerlo ponerlo en en marcha marcha comenta comenta la la llamada llamada aa ActivaMisil Activar,lisil (), (l, dado dado que esta función aún no no está está implementada. implementada.

5.

Verifica si funciona funciona correctamente. correctamente.

6.

Modifica los parámetros parámetros de de ajuste ajuste (<6 (<6 ,>6, ,>6, /2, /2 , /25), /25 ), para para que que se se adapten adapten de forma adecuada aa tu tu terminal. terminal.

7.

En el juego original original podíamos podíamos acelerar acelerar pero pero no no desacelerar. desacelerar. Si Si queríamos queríamos detener la nave teníamos dar un giro de 180 grados y teníamos que que dar un giro de 180 grados y acelerar acelerar lolo justo. Modifica el código justo. código anterior anterior para para que que no no sea sea posible posible desacelerar. desacelerar.

5.4. 5.4. Gestures Gestures La pantalla táctil es es uno uno de de los los mecanismos mecanismos más más cómodos cómodos para para interaccionar interaccionarcon con un un teléfono Android. Android . No obstante obstante el el reducido reducido tamaño tamaño de de lala pantalla pantalla en en los los teléfonos teléfonos móviles hace que que el el diseño diseño de de la la interfaz interfaz de de usuario usuario sea sea complejo. complejo. Por Por ejemplo, ejemplo, tratar de introducir introducir las las decenas decenas de de botones botones yy menús menús que que incorporan incorporan lala mayoría mayoría de de aplicaciones de sobremesa sobremesa sería sería imposible imposible en en una una pantalla pantalla de de 33 pulgadas. pulgadas. Para Para tratar de dar nuevas alternativas alternativas en en el el diseño diseño de de interfaz interfaz de de usuario, usuario,aapartir partirdel del SDK SDK 1.6, se incorporan las gestures. gestures. Una gesture es un un movimiento movimiento pregrabado pregrabado sobre sobre lala pantalla pantalla táctil, táctil , que que lala aplicación puede reconocer. reconocer. De De esta esta forma, forma , la la aplicación aplicación podrá podrá realizar realizar acciones acciones

169

El gran libro de Android especiales en función de la gesture introducida por el usuario. Esto permite simplificar mucho una interfaz de usuario al poder reducir el número de botones. Si quieres ver un ejemplo de cómo es utilizado gestares gestures en una aplicación real, te recomendamos que bajes "Google Gesture Search" del Market. Como puedes ver en la siguiente ilustración, ilustración, esta aplicación te permite introducir una secuencia de letras o dígitos escrita directamente en la pantalla. A partir de estos caracteres realiza una búsqueda global en tu teléfono (aplicaciones, música, contactos .. .). contactos...).

11 ik

iSBO'tíf 10:29

5.4.1. Creación y uso de una librería de gestures El primer paso para usar gestures en nuestra aplicación es crear una librería que contenga algunas de ellas. Con este propósito, puedes utilizar la aplicación Gesture Builder, que está pre-instalada en la versión 1.6 del emulador.

f

170

Ejercicio paso a paso: Creación de una librería de gestures. gestures.

1. 1.

Abre un emulador con versión 1.6 y con memoria externa. externa.

2.

En el menú de programas busca el siguiente icono y abre la aplicación.

3.

Para añadir una nueva gesture a tu librería pulsa el botón "Add gesture" y realiza un trazado sobre la pantalla (por ejemplo, un visto bueno), luego "configurar"). introduce un nombre asociado a esta gesture (por ejemplo, "configurar"). El resultado se muestra a continuación: continuación:

Entradas en Android: teclado, teclado, pantalla pantalla táctil táctil yysensores sensores ~!tJ@ 9:46AM 9:46 AM

Ñame

4.

Si no te gusta como ha ha quedado quedado el el trazado, trazado, no no tienes tienes más más que que realizar realizaruno uno nuevo. El anterior anterior será será descartado. descartado.

5.

Pulsa el botón "Done" para para aceptar aceptar la la gesture. gesture. Tras Tras pulsar pulsar este este botón botón cuadro de de texto texto indicándote indicándote donde donde se se acaba acaba de de guardar guardar elel aparecerá un cuadro fichero con la librería librería de de gestures. gestures.

NOTA: Si intentas crear con con el el emulador emulador una una gesture gestureformada formadapor por varios variostrazos trazos (por (por ejemplo el símbolo "X") "X'') es es posible posible que que solo solo quede quede almacenado almacenado el el último último trazo. trazo. Para Para que ambos trazos sean sean reconocidos reconocidos en en la la misma misma gesture, gesture, has has de de introducir introducirel elsegundo segundo continuación del primero. primero. Puede Puede resultar resultar algo algo difícil, dificil, pero pero tras tras un un par par de de justo a continuación intentos lo conseguirás. conseguirás. No No te te preocupes, preocupes, introducir introducir una una gesture gesture de de varios varios trazos trazosen en en el elemulador. emulador. Concretamente, Concretamente, elel un dispositivo real no no resulta resulta tan tan complicado complicado como como en valor FaáeOffset F'adeOfOfse!:: que que indica indica el el tiempo tiempo máximo máximo en en milisegundos milisegundos problema está en el valor entre dos trazos de la misma misma gesture. gesture. Si Si al al introducir introducir dos dos trazos trazos eleltiempo tiempoentre entreellos ellos FadeOffset, se se considerará considerará que que se se han han introducido introducido dos dos gestures gestures es mayor que FaáeOffset, diferentes. Por defecto, este este valor valor es es asignado asignado aa 420 420 milisegundos. milisegundos. El El valor valor resulta resulta adecuado con un dispositivo real, real, pero pero muy muypequeño pequeñopara para el elemulador. emulador. En Enel elejemplo ejemplo descrito más adelante adelante daremos daremos un un valor valor más más alto alto aa FaáeOffset FadeOFfsE·'t: si si queremos queremos el emulador. emulador. trabajar de forma forma más más cómoda con con el

6. 5.

introducir las las gestures gestures mostradas mostradas en en lala siguiente siguiente captura. captura. Para Para Trata de introducir mejorar el porcentaje porcentaje de de reconocimientos reconocimientos correctos, correctos, puede puede ser ser interesante interesante gesture con con trazados trazados alternativos. alternativos. Esto Estose se introducir varias veces veces la la misma misma gesture consigue dándole dándole el el mismo mismo nombre nombre aa dos dos gestures. gestures.

7. I.

que una una nueva nueva gesture gesture es es introducida introducida aparece aparece una una ventana ventana de de Cada vez que texto que indica indica el el fichero fichero donde donde está está almacenando almacenanda nuestra nuestra librería. librería. Seguramente será "/sdcard/gestures". "/sdcard/gestures". Utiliza Utiliza la la vista vista File File Explorer Explorer de de Eclipse para localizar localizar este este fichero. fichero.

171

El gran libro de Android Android Qíli CU 10:36 AM acerca_de ^

acerca_de cancelar

y/

configurar

\y

configurar p|ay

j

8. 8.

liir* 1.

Add

J|

8e wd

'

j

Selecciónalo Selecciónalo yy pulsa pulsa el el botón botón «^para llpara guardarlo guardarlo en en tu tu ordenador. ordenador.

Ejercicio paso aa paso: paso: Añadiendo Añadiendo la la librería librería de de gestares gestures aa nuestra aplicación. aplicación. nuestra Para utilizar la librería librería que que acabas acabas de de guardar, guardar, crea crea un un nuevo nuevo proyecto proyectocon con los siguientes datos: Project Ñame: Name: Gestures Gestures Build Target: Androidl.6 Androidl.6 Application Ñame; Name: Gestures Gestures Package Ñame: Name: org.example.gestures or:g . exampl e . g est ures Create Activity; Activity: Gestures Gestures

2.

El siguiente paso va aa consistir consistir en en crear crear la la carpeta carpeta res/raw res/raw en en elel proyecto proyecto el fichero fichero que que has has guardado guardado (gestures) (ges t ures} en en elel ejercicio ejercicio y copiar en ella el anterior. anterior.

3. 3.

res/ layout / main. xml por por el el siguiente siguiente código: código: Remplaza res/layout/main.xmi <'.?xnll version:::::: 1'.l..O" encoding="utf-S"?> encoding='' utf-F3 "?>
android: layout_height= " Li ll_parent: "> <'l'extView cTextview android : layout_ width= "Lill_pa.r:en.t " android:layout_width="fill_parent" android : layout ___height="wrap_content" h eight= "[v·Lap_content android:layout


11

172

Entradas en Android: teclado, pantalla pantalla táctil táctil yy sensores sensores and:r·oid: gravi ty= ,, cente1:~hori zonta.I androld:gravity="center_horizontal" android: text text== "Lnt.:rod.uc(::~ "Xntrodijce una una g(:~st:ure gesture"" 11

android:textsize="8pt"

andr~ i d:textSize="Bpt"

and roid: layout _mar·gin= " } O android:layout_margin="lOdip"/> <'I'extView «TextView android:id="@-f id/salida"" android: id= "(4+id/salida andro i d: layout_width= "i'ill_pa::-ent:" android:layout_width="fill_parsnt" aandroid:layout_height= ndroi d : layout_he i g h t = "¡.¡_r-ap_conl:ent: > "wrap_content "/ '/> android:fadeOffset= "800 "/> < /' LinsarLayout >

4.

El layout anterior está está formado formado por por un un r..inearLayot LinearLayot que que contiene: contiene: un un Textview con un título, un TextView Textview para para mostrar mostrar la la salida salida del del programa programa yy un Ges t ureoverlayview que GestureOverlayview que será será utilizado utilizado para para introducir introducir los los gestures. gestures. En esta última etiqueta el el parámetro parámetro gestureStrokeType gesturestrokeType indica indica que que permitimos gestures formados formados por por varios varios trazos. trazos. El El parámetro parámetro fadeoffset fadeOffset ha sido explicado en el apartado anterior. anterior.

5.

Reemplaza el código de la la actividad actividad por: por: publ ic class Gestures public Gestures extends extends Activity Activity implementa implements OnGesturePerformedListener { private prívate GestureLibrary librería; libreria,private Textview TextView osalida; osalida; éi~Overri.de ®Override

public ptxblic void onCreate{Bundle onCreate(Bundle savedlnstanceState) savedlnstanceState) { super.onCreate(savedlnstanceState); super. onCreate(savedlnstanceState}; setContentView (R. layout. mai.n) ; setContentView(R.layout.main); librería ( this, libreria ~= GestureLibraries.fromRawl?esource GestureLibraries.fromRa wResowrce(this, R.raw.gestures); if (!libreria.load{)) (!librería.load()) { finish();

} GestureOverlayView GestureOverlayview gesturesView gesturesView == (GestureOverlayView) (GestureOverlayview) ffindViewById(R.id.gestures) indViewByld {R . id. ges!:ures) ;; .:;esturesView . addOnGest urePerformedListener{ this ); gesturesView.addOnGesturePerformedListener(this); salida = = (TextView) (Textview) findViewByld(R.id.salida); findViewByld(R.id.salida);

} public void onGesturePerformed{GestureOverlayView onGesturePerformed(GestureOverlayview ov, ov, Gesture gesture} gesture) {{ ArrayList cPredi.ction > predictions ArrayLlst predictions == libreria.recognize(gesture) libreria.recognize(gesture);;

173

El gran libro de Android sal ida. setTex.t ( '' 11 ) ;; salida.setText("") for {Frediction (Prediction prediction : predictions){ predictionsl{ salida. append (pn::diction. name;-" sal ida. appendípredict ion, ñame+ " "11 +iprediction.score+ 1'\n'1 ) ; prediction.score+"\n");

} } 6.

}) En este código se comienza declarando dos campos de la clase librería librer:ía que contendrá la librería de gestares, gestures, creada en el ejercicio anterior, anterior, y sal ida que corresponde al Textview, Text.View, donde escribiremos los resultados. resultados. salida

7.

En el constructor, tras realizar las operaciones habituales, se carga la librería de gestares gestures desde los recursos y en caso de no ser cargada finaliza la aplicación. aplicación. A continuación, continuación, asocia el GestureoverlayView Gestureoverlayview de main. xrnl al objeto gestureview gestureView y se indicará que nuestra clase será el main.xml escuchador de este elemento. elemento. Finalmente se asocia el Textview donde queremos sacar la salida al objeto salida.

8. 8.

El método onGesturePerformed se introduce para implementar la interfaz OnGesturePerformedLi.st.ener. parámetros, el OnGesturePerformedListener. Este método tiene dos parámetros, GestureoverlayView gesture yy el objeto Gestureoverlayview donde se ha introducido el gestare Gesture Gestare que ha sido introducido. introducido. El El primer paso consiste en reconocer el gesture gestare comparándolo con la lista de nuestra librería. El resultado es una gestures que considere más lista ordenada de Predictions con las gestares parecidas a la introducida. Tras borrar salida, sal ida , se recorrerán todos los elementos de esta lista mostrando el nombre del gestare gesture (prediction. ñame) name} y la puntuación de reconocimiento (prediction. score}. Resulta complicado fijar un umbral, umbral, pero una (prediction.score). puntuación inferior a 1 1 se suele considerar demasiado baja para tenerla en cuenta como predicción. predicción.

9.

obtenidas. Ejecuta la aplicación y estudia las puntuaciones obtenidas.

5.4.2. Añadiendo gestures a Asteroides En el siguiente ejercicio trataremos de aplicar lo aprendido a la aplicación Asteroides. La idea es que como una forma alternativa a usar el menú de cuatro botones que se muestra al arrancar la aplicación, aplicación, se pueda utilizar gestures. gestures.

0

1.

174

Práctica: Aí'iadiendo gestures a Asteroides. Asteroides. Práctica: Añadiendo Si el proyecto Asteroides ha sido con una versión del SDK anterior a la 1.6, tendrás que actualizarlo como mínimo a esta versión. versión. Para ello pulsa sobre el proyecto con el botón derecho y selecciona "properties", selecciona en la lista de la izquierda "Android" "Android" y marca la versión adecuada.

Entradas en Android: teclado, pantalla táctil y sensores 2.

3.

Crea la carpeta res/ raw y copia el fichero gestures res/raw gestures,, que contiene la librería creada anteriormente. Modifica

el

Layout

main.xml

para

que

disponga

de

un

GestureOverlayView.

4.

Cuando el usuario esté utilizando este Layout ha de poder introducir alguna de las cuatro gestures de la librería de forma que se ejecute la acción correspondiente.

r Solución: Los pasos a seguir para realizar el ejercicio anterior se describen a continuación: continuación: 1.

/ layo u t/main. xml el siguiente código. Cierra la Añade al principio de res res/layout/main.xml etiqueta al final del fichero. fichero,
4.

~

Añade el siguiente método:

onGesturePerformed(GestureOverlayView public void onGestur·ePerfor-med (GestureOverlayView ov, Gesture gesture) { predictions=libreria.recognize(gesture); ArrayList predictions=l ibreria .recognize(gesture); if (predictions.size()>0){ (predictions.size()>O) { String comando comando~ predict .i ons.get(O) .name; = predlctions.get(0).ñame; if (comando.equals("play")) (comando.equals("play")){{

175

El gran libro de Android lanzar·,;uego () ; lanzarJuego{); } else if (comando.equals("configurar")l{ {comando.equals("configurar")){ lanzarPreferencias(); } else if (comando.equals("acerca. (comando.equals{"acerca ...de")) de")){{ lanzar·AcercaDe () ; lanzarAcercaDe(); . equals("cancelar")) {{ } else if (comando (comando.equals("cancelar")) finish () ; finishO }

} }

5.5. 5.5. Los Los sensores sensores Bajo la denominación de sensores se se engloba un un conjunto conjunto de de dispositivos dispositivos con con los los que podremos obtener información del mundo mundo exterior exterior (en (en este este conjunto conjunto no no se se incluye la cámara, el micrófono o el GPS). Como Como se se verá verá en en este este apartado, apartado, todos todos los los sensores se manipulan de forma homogénea. homogénea. Son Son los los dispositivos dispositivos de de entrada entrada más más novedosos que incorpora Android y con con ellos ellos podremos podremos implementar implementar formas formas atractivas de interacción con el usuario. usuario. Si no dispones de un terminal físico, físico, puedes puedes instalar instalar un un software software de de emulación emulación que te permitirá realizar las las pruebas pruebas sobre sobre el el emulador, emulador, mientras mientras desde desde una una aplicación de tu PC cambias la orientación de de un un teléfono teléfono ficticio ficticio mediante mediante el el ratón. ratón. Puedes descargarte el software de de http://www.openintents.org/en/node/6, http://www.open¡ntents.orq/en/node/6. no no obstante, obstante, el proceso resulta bastante bastante laborioso. laborioso. Además, Además, tendrás tendrás que que cambiar cambiar el el código de los ejemplos para adaptarlos aa los los requerimientos requerimientos del del emulador. emulador. Por Por lo lo tanto, tanto, tendrás que realizar dos programas programas diferentes: diferentes: uno uno para para sensores sensores reales reales yy otro para el emulador.

Openlntents Sensor Símulator Simulaíor

100

Settíngs Stippofied sefisors (•'> yaw & pitch O Q mil roíl && ptcti O m<>ve mme (jl i:~"!:@:~~ pitdt O Sooket Socket .· js010 Í8010 I so. PossiWe iP adcíresses: üsíening on port 8010...

ossible IP aáóresses: Uste.ning on port 801D...

accelerometer; 0,00, -8,49,-4.90 -8,49, -4,90 accelerometer: 0,00, compass·. 13,40, compass. 13,40, -27,66,-38.45 -27,66, -38,45 orierréation. 340,00, -80,00.. -60,00,0,00 orienla.tion: 340,00, ll,OO

176

.•

El acceíerometer El compa¡ss !R] El orieotation: amntation CJ tl!.erm001eter □ tfrermctfTfeter ,-Enallled senstns·~~~:·~~--~-~ : EnaPtetí sensors ; EJ acceterometer 1 [2] ~~~~tHerometer

¡ !R] compass ! !R] orientanon

Entradas en Android: teclado, pantalla táctil y sensores Android permite acceder a los sensores internos del dispositivo a través de las clases Sensor~1anager y la interfaz SensorEventListener·, Clases Sensor, SensorEvent, SerxsorEvent, SensorManager SensorEventListener, del paquete android.hardware. android. hardware . La clase Sensor acepta ocho tipos de sensores. Aunque, los sensores disponibles varían en función del dispositivo utilizado: TY PE_ACCELER01'1E'I'EI< typeaccelerometer

type_gyroscope 'l'YPE GYROSCOPE TYPE LIGHT type light

TYPE t"íAGNETIC TYPE_MAGNETI C_FFIELD IELD

TYPE ORIENTATION type_orientation TYPE PRESSURE type_pressure

type_proximity TYPE PROXIfviiTY TYPE TEfl.lPERATURE tyfejtsmperature

Acelerómetro Sensor de giro Sensordeluz Sensor de luz Brújula Sensor de orientación Sensor de presión Sensor de proximidad Sensor de temperatura

Ejercicio paso a paso: Listar los sensores del dispositivo. No todos los dispositivos disponen de los mismos sensores. Por lo tanto, tanto, la primera tarea consiste en averiguar los sensores disponibles. disponibles. 1.

Crea un nuevo proyecto con nombre Sensores.

2.

Añade la siguiente propiedad al TextView Textview de res/layoutlmain.xml: res/layout/main.xml\ android:id="@+id/salida" android:id="@+id/sal ida"

3.

Inserta este código en la actividad principal: public class SensoresActivity extends Activity {{ private prívate TextView Textview salida;

SOverride

~'Override

public void onCreate(Bundle savedinstanceState) savedlnstanceState) { super. onCreate(savedinstanceState); super.onCreate(savedlnstanceState); setContentView( R .layout.mainl ; setContentView(R.layout.main); salida= (TextView) findViewByid(R.id.salida); salida = (Textview) findViewByld(R.id.salida); Sensorfl.lanager SensorManager sensorlv!anager sensorManager ~= (SensorManager) getSystemService getSysteraServiceí(SENSOR_SEI<\ILCE); SENSOR_SERVICE) ¡ = ser1sorManager. sensorManager. List listaSensores = getSensorList(Sensor.'I'YPE_!lLL); getSensorList (Sensor. TYPE__ALL) ¡ for (Sensor sensor: listaSensores) { for(Sensor log(sensor.getName()); log(sensor.getName{));

} } prívate void log(String logíString string) {{ + "\n" "\n!l); salida.append(string + ); } }

177

El gran libro de Android 4.

el Layout Layout de de la la actividad actividad yy obteniendo obteniendo el el El método comienza indicando el resultados. AA continuación, continuación, TextView salida, donde mostraremos los resultados. vamos a utilizar el método getsystemservíce getsystemservice para para solicitar solicitar el el sistema sistema servicios específicos. Este método pertenece aa la la clase clase context context (como (como somos Activity también somos cont.ext context)) y será será muy muy utilizado utilizado para para servicios del del sistema. sistema. Al Al indicar indicar como como acceder a gran cantidad de servicios parámetro SENSOR_SERVICE, ssnsor_service, indicamos indicamos que que queremos queremos utilizar utilizar los los sensores. Lo haremos a través del del objeto objeto senso:r·Manager. sensorManager. En En primer primer lugar lugar sensores. llamamos al método getsensorList (()1 del del objeto objeto para para que que nos nos de de J.ístasensores, listaSensores, una lista de objetos sensor. sensor. La La siguiente siguiente línea línea recorre recorre todos los elementos de esta lista para eu.rame () y para llamar llamar aa su su método método 9getNameOy mostrar el nombre de sensor.

5.

una lista lista de de los los valores valores devueltos devueltos por por el el Ejecuta el programa. Esta es una el HTC HTC Magic: Magic; código anterior ejecutándose en el AKH 976A AK8976A AK8976A AK8976A AK8976A

6.

33-axis -axis .Zi,ccelen)meter Accelerometer 3-axis Magnetic field field sensor sensor Oríentatíon sensor Orientation sensor Temperature sensor Temperatura sensor

AK8976A es una combinación de acelerómetro acelerómetro de de tres tres ejes ejes yy El AKS976A magnetómetro de tres ejes. Combinando Combinando la la lectura lectura de de los los campos campos gravitatorio y magnético terrestres proporciona proporciona también también información información de de orientación. orientación. Incluye, además, un sensor sensor interno interno de de temperatura, temperatura, útil útil para para comprobar si el móvil se está calentado demasiado. demasiado.

Como hemos visto la clase sensor sensor nos nos permite permite manipular manipular los los sensores. sensores. AA continuación, se listan los métodos métodos públicos públicos de de la la clase clase sensor: sensor: l oat geU·1aximumRange public ffloat getMaximutnRange () public String getName() getÑame()

Rango máximo en las unidades del sensor.

publíc public float getResolution ()

Nombre del sensor. Potencia (mA) usada por el sensor mientras está en uso. Resolución en las unidades del sensor. sensor.

publíc () public int get'l'ype getTypeO

Tipo genérico del sensor.

Publíc etVendor () Public String ggetVendor()

Fabricante del sensor.

publíc public int int getVersíon() getVersionO

Versión del sensor.

public ffloat l o at ggetPower() e tPower()

t inc:lination, La clase Sensorf"lanager SensorManager tiene además tres tres métodos métodos (ge (getlnclination, getOrientation y getRotat.ioni-1atr:ix), getorientation getRotationMatrix), usados usados para para calcular calcular transformaciones transformaciones de de coordenadas. coordenadas.

Ejercicio paso a paso: Acceso a los datos datos del del sensor. sensor.

178

Entradas en Android: teclado, pantalla táctil yy sensores Veamos ahora cómo obtener la la lectura lectura de cada cada uno uno de de los los sensores. sensores. 1.

Copia el siguiente código al te . al final final de de oncrea oncreate. listaSensores == senso:::·Hanage:::· sensorManager.. getSensorList ge t Sensor List (Sensor (Sensor.. ·TYPE'_OR1EN1'A'I'ION) TYPE^RlEíjTñTlON) ;¡ if (!listaSensores.isErrpty(l (ilistaSensores.isEmpty())) {{ get (O) ; Sensor o.dent.ation.Sensor orientationSensor == listaSensores. listaSensores.get(0); sensorManager. regist.eri,iste.ner (this , orientationSensor, sensorManager.registerListener(this, orientationSensor, Sen:>or14anager DE'L.4 Y_ Ul) ; } SensorManager.. SENSOR_ SENSOR_DELAY_U1);} lista.Sensores listaSensores == sensorManage.r sensoi'Manager .getSenso.rList .getSensorList (Sensor. (Sensor. ~"YPE..._ACCELE'RONE'I'E'R); TYPE,_ACCELEROMETER) ; if (!listaSensores.isEmptyO) ( ilista Senso.res.isEmpty()) {{ Sensor aceleromete.rSensor . get.(O); acelerometerSensor == listaSensores listaSensores.get(0!; sensorManager.registerListener( this , acelerorneterSensor, sensorManager. registerListener- (this, acelerometerSensor, Sensori'tanager. UI);} SensorManager. SE'NSOR_DELAY_ SENSOR_DELAY_UI) ;} l.ist.aSensores == se.nsori'lana.g er. getSenso:t"I,is t (Sensor:. 'I'YPE'_f.1AGNE1'1C_F1Ei..D) listaSensores sensorManager.getSensorList(Sensor. TYPB_MAGNBTIC_FIELD);; if ((ilistaSensores.isEmpty()) UistaSenso.res. isEmpty () i {{ Sensor rnagnet.icSensor .i .staSenso.res. get (O) ; magneticSensor == 1listaSensores.get(0); sensort•lanager. registerListener (this , rnagneticSensor, sensorManager.registerListener(this, magneticSensor, Sensor14anager. DELA Y_ UI) ;;}} SensorManager. SENSOR_ SENSOR_DELAY_UI) 1i staSensores == sensor Hanager. getSensorList. (Sensor . 'l'YPE_ 'l'EMPERAT'URE') ;; listaSensores sensorManager.getSensorList(Sensor.TYPE_TEMPERATURE) iif f ((¡listaSensores.isEmptyO) ! listaSensores. isEmpty ()) {{

Sensor t.emperatureSensor temperatursSensor == :i..ist.aSensores.get(O); listaSensores.get(0); sensorManager.registerListener( this, ternperatureSensor, sensorManager.registerListener(this, teraperatureSensor, Sensorl'lanager. SensorManager. SE'NSOR_DEIAY_UI);} SEN30R_DELAY_UI) ;}

2.

Comenzamos consultando si si disponemos de de un un sensor sensor de de orientación. orientación. Para ello solicitamos al sistema que nos nos brinde brinde todos todos los los sensores sensores de de este este getSensorList (l o.. Si la la lista lista no no está está vacía vacía obtenemos obtenemos el el tipo llamando a getsensorList Es necesario necesario registrar registrar cada cada tipo tipo de de sensor sensor por por primer elemento (el 0). Es separado para poder obtener obtener información información de de él. él. El El método método re9isterListener (()i toma como primer registerListener primer parámetro parámetro un un objeto objeto que que implemente el interface sensorEventLi.stener, sensorEventListener, veremos veremos aa continuación continuación interfaz (se indica indica this this porque porque la la clase clase que que cómo se implementa esta interfaz interfaz para para recoger recoger eventos eventos de de estamos definiendo implementará este interfaz sensores). El segundo parámetro es es el el sensor que que estamos estamos registrando. registrando. YY sensores). qué frecuencia frecuencia nos nos gustaría gustaría recibir recibir el tercero indica al sistema con qué posibles valores, valores, de de menor menor aa actualizaciones del sensor. Acepta cuatro posibles sensor_delay_normal, SENSOR_DEL.AY_UI sensor_delay_üi,, mayor frecuencia tenemos: SENSOR_DELAY_NOR1-'IAL, SENSOR_DELAY_GM1E sensor_belay_game y SENSOR_DELAY_FASTEST. sensor_delay_faste3t. Esta Esta indicación indicación Sirve sirve para para atención necesitan necesitan los los sensores, sensores, pero pero no no que el sistema estime cuánta atención garantiza una frecuencia concreta.

3.

implemente el el interface interface que que hemos hemos comentado comentado Para que nuestra clase implemente añade a la declaración de la la clase: clase: imp l ementa Sensor·EventListener implementa SensorEventListener

4.. 4

los sensores sensores tenemos tenemos que que implementar implementar dos dos Para recibir los datos de los

métOdOS métodos de la interfaz SensorEventListener: SensorEventListener; Cli>Override ©Override public voi d onAccuracyChanged(Sensor void ouAccnracyChanged(Sensor sensor, sensor, int int precision) precisión) {} {}

179

El gran libro de Android @Override OOverride public void onSensorChanged(SensorEvent onSensorChanged(Senso.r:Event evento) {{ 1 /Cada sensor serwo:r puede provocar que un thread pr·i.nc:ipal. //Cada principal pase por / /aqu.í, así a.f::í que síncrcnizamos acces,o (He //aquí, sincronizamos el acceso (se verá. vex-á más adelante) synchronized (this) ( this ) {{ switch (evento.sensor.getType()) { swi tch{evento.sensor.getType()) case Sensor. 'I'YPE ___ORIENTA'I'ION: TYPE__ORIENTATION: for (int ( int i=0 i=O ; i<3 ; i++) {{ l.og("Orientaci.ón "+evento.values[i.) log ("Ox'ientación " ++Í+": 1+"; "-i-evento, valúes fi] ));;

} break break;; case Sensor . TYPE....ACCELEROMETER: Sensor.TYPE_ACCBLEROMETER: for (int ( int i-0 i =O ; ic3 i<3 ; i++) .1++) {{ log("Acelerómetro ": "+evento.values[i] ); logí"Aceleróraetro "+i+ "+i+": "+evento.valúes[i]);

} break; case Sensor.TYPE_MAGNETIC_FIELD: Sensor. TYPE _J'IL,_GNETIC FIELD : for ((int int i=0 i=O ; ic3 i<3 ; i++) i-M-) { lo9("Magnetismo Í + ": "+evento.values log("Magnetismo "+ "+1+": "+evento.valúes [i)); [i] ) ,} break break;; default default:: for ((int int i=0 i=O ; icevento.values.length i
} } 5.

Cuando implementamos un interface interfacfí estamos obligados a implementar todos onl\.ccuracychanged no queremos sus métodos. En este caso son dos. Para onAccuracyChanged ninguna acción específica, específica, pero lo tenemos que incluir. incluir. Cuando un sensor onSensorChanged, aquí comprobaremos qué cambie se llamará al método onsensorchanged, sensor ha causado la llamada y leeremos los datos.

6.

Verifica que el programa funcione correctamente.

Cuando el evento se dispara en el método oonSensorChanged nsensorchanged comprobamos qué sensor lo ha causado y leemos los datos. Los posibles valores devueltos se indican en la documentación de la clase SensorEvent11..

11

180

http://developer.android.com/reference/androíd/hardware/SensorEvent.html http://developer.android.coni/reference/android/hardware/SensorEvent html

Entradas en Android: teclado, teclado, pantalla pantalla táctil táctil yy sensores sensores

5.5.1. Un programa programa que que muestra muestra los los sensores sensores disponibles disponibles y sus valores en en tiempo tiempo real real La aplicación realizada en en el el ejercicio ejercicio anterior anterior resulta resulta algo algo difícil difícil de de utilizar. utilizar. En En primer lugar, lugar, presupone presupone que que se se dispone dispone de de cuatro cuatro sensores, sensores,cosa cosa que que no noserá serácierta cierta en muchos dispositivos. dispositivos. Además, Además, los los datos datos de de los los sensores sensores cambian cambian demasiado demasiado rápido para poder leerlos leerlos en en un un listado. listado. El El ejercicio ejercicio mostrado mostrado aa continuación continuación es es un un resumen de los los ejemplos anteriores, anteriores, pero pero que que permite permite mostrar mostrar en en lala misma misma pantalla pantalla los valores actuales de de todos todos los los sensores sensores de de un un dispositivo. dispositivo. Además, Además, es es un un buen buen ejemplo para ilustrar ilustrar cómo cómo crear crear una una vista vista desde desde código. código.

Ejercicio paso aa paso: paso: Creación Creación de de una una vista vista desde desde código código para mostrar los datos de de los los sensores. sensores. 1.

proyecto con con nombre nombre Sensores2. Sensores2. Crea un nuevo proyecto

2.

de la la actividad actividad por por el el siguiente: siguiente: Remplaza el código de public class Sensores extends extends Activity Activity implements implementa SensorEventListener SensorEventListener { private mLinearLayout; prívate LinearLayout mLinearLayout; private aTextView [] [] [] [] ~ new new TextView TextView[20] [20] [3] [3] ;; ;; prívate TextView aTextView private mSensorManager; prívate SensorManager mSensorManager; private aSensor[] == new new Sensor Sensor[20]; prívate Sensor aSensort] [20]; private listSensors; prívate List listSensors; @Overri.de void onCreate(Bundle onCreat.e (Bundle savedlnstanceState) savedinstanceState) {{ SOverride public void super .onCreate(savedinstanceState); super.onCreate(savedlnstanceState); setContentView (R.layout .main) ; setContentView(R.layout.main); mLinearLayout == (LinearLayout) (LinearLayout) findViewByld(R.id.LinearLayout01); findVie1-1Byid (R . id. LinearLayoutOl); , mSensorManager· == (SensorManager) (Sensor·l·lana9er) getSystemService 9etSystemService{S£W.SOR_í?£'R (SElV.'JOR_SERVICE); mSensorManager /.rCS) ; listSensors == mSensorManager.getSensorList(Sensor.TYPE_ALL); mSensorManager .getSensorList (Sensor .1'YPE_ALL); int n = = 0; O; for (Sensor sensor sensor.· :: listSensors) 1istSensors) {{ aSensor[n] -- sensor; aSensorEnj TextView raTextView m'l'extView == new new TextView(this); TextView ( this ) ; mTextView.setText{sensor.getName()); mTextView.setText(sensor.getName()); mLinea~·Layout. addView (mTextView) ; mLinearLayout,addview(mTextView); nLinearLayout == new new LinearLayout(this); LinearLayout(this ); LinearLayout nLinearLayout mLinearLayout.addView(nLinearLayout); mLinearLayout.addview(nLinearLayout); O; ii << 3; 3; ±++) Í++) {{ for (int ii == 0; aTextView[n] [i] == new new TextViewíthis); TextVie\'i( this ); aTextView(n][i] aTextView[nj [i]3.setText("?"); .setText{"? "); aTextView[n] [i aTextView[n] [i] .setWidt.h(87) . setWidth(B7);; } TextView xTextView -'" new new TextView(this); TextView ( this ) ; xTextView. setText (" X: "); ") ; xTextView.setText{" nLineari.,ayout. addV:i.ew (xTextView) ;; nLinearLayout. .addview(xTextView)

181

El gran libro de Android Androíd nLi.nearLayou t .. addView (aTextView [n] [0]) [O]) ; nl.inearLayout.addview TextVi ew yText View =="~ new Tex tView((this) this );; TextView i'TextView TextView yT'ext \!íevv. setText { '' Y: y : 11"); ) ; yTextView.aetText(" nnLinearLayout,addview(yTextView); ·L inear Layout . addVie.w (y'Text:.Vie"'>~J) ¡ nLin earLayout.addView(a'I'extView[n.] [1]) ; nLinearLayout.addview{aTextView[n][1]); Text View zTextVíew this ); TextView zTextView == new TextView( TextView(this);

zzTextView.aetText{" T'ext\!ievv. setText ( 11 Z: z: "); ") ; nnLinearLayout.addview(zTextView); Linea r Layout . addView ( zTextView) ; nnLinearLayout.addview(aTextView[n][2]); LinearLayout . addView(a'I'extView[n.] [2]) ; mSen sorManager . .r:eg.i s tex: L.i s tener(thi ten er ( this sensor , mSensorManager.registerLis s,, sensor,

SensorManager SE1\fSOJ?.___ DE&1Y__UI} ; SensorManager.. SENSGR_DEL/íY_jJI) U++; n++;

} } \ü
int

accuracy) {{}} @Ove.r:x:.i de public void onSensorChanged(SensorEvent onSensorChanged (SensorEvent. event) event.) {{ SOverride syn chronized ((this) this ) { synchronízed int n n = = O; 0; for (Sensor (Sen sor sensor: iistSensors) l i stSensor s) {{ == sensox :) {{ iiff (event.sensor ( event. sensor == sensor) for (int i=O; Í
} } Tl++ n++;; } } } } 3. 3.

182

Como puedes observar esta actividad utiliza el Layout creado por defecto que, básicamente, es un LinearLayot Linea r Layot (en el código corresponde a la variable mLinearLayout) mLinearLayout ) con un TextView TextVi ew en su interior ("Helio Word ... ') . A mLinearLayout se le va a ir añadiendo una serie de vistas adicionales dispositivo. Por cada sensor se según los sensores encontrados en el dispositivo. añade; un TextView Text.Vi e w con el nombre del sensor, sensor, un LinearLayot de tipo añade: TextView con " X: ", un Textview TextView con horizontal para contener a su vez un Textview X:", el valor del sensor en el eje X, X, un TextView con"" Y ", un Textview TextView con el Textview con valor del sensor en el eje Y, TextView con el Y, un Textvie"' Textview con " Z: Z: " y un Textview valor del sensor en el eje Z. Z. Las referencias a los Textview donde se visualizarán los valores de los sensores se almacenan en el array aTextVie\..r [J [] [ J donde el primer índice identifica el número de sensor y el aTextview [] segundo la dimensión X, Z. Por otra parte, X, Y o Z. parte, los sensores encontrados J. son almacenados en el array asensor [[].

Entradas en Android: teclado, pantalla pantalla táctil táctil yy sensores sensores 4.

En el método onsensorchanged onsensorchanged ()() se se hace hace un un bucle bucle para para localizar localizar elel índice del sensor que ha ha cambiado cambiado yy se se modifican modifican los los Textview Textview correspondientes al sensor sensor con con los los valores valores leídos. leídos.

NOTA: No todos los sensores tienen tienen tres tres dimensiones. dimensiones. Por Por ejemplo, ejemplo, en en elel caso caso del del sensor de temperatura solo se se cambiará cambiará en en el el valor valorde deXX. 5.

Verifica sobre un un dispositivo dispositivo real real que que el el programa programa funciona funcionacorrectamente. correctamente.

5.5.2. Utilización de de los los sensores sensores en en Asteroides Asteroides A continuación, proponemos una una serie serie de de ejercicios ejercicios yy prácticas prácticas para para manejar manejar lala nave de Asteroides utilizando utilizando sensores. sensores.

Ejercicio paso paso aa paso: paso: Manejo Manejo de de la la nave nave con con el el sensor sensor de de orientación.

t

1.

En primer lugar, implementa implementa la la interfaz interfaz senso:cEventListener. sensorEventListener. public class VistaJue9o VistaJuego extends extends View View implementa implements SensorEventListener SensorEventListener

2.

{

En el constructor registra registra el el sensor sensor ee indica indica que que nuestro nuestro objeto objeto recogerá recogerá lala llamada callback:

SensorManager mSensorManager mSensorManager =-= (SensorManager) (SensorManager) Senso:crvranage:c context.getSystemService(Context.SENSOR_SERVICE); context. getSystemService (Context. SE!.VSOR_SERVICE); List listSensors listSensors == mSensorManager.getSensorLi mSensorManager.getSensorList( ListcSensor> st( Sensor. TYFE.._ORIE.lVTllTION) ;; Sensor.TYPE_ORIENTATION) if (!lis tSensors.isEmpty()) {{ (! listSensors.isEmpty()) Sensor orientationSensor orientationSensor

=- llistSensors.get(0); istSensors.get(O);

mSensor!Vlanager. r·egisterListener ( this, orientationSensor mSensorManager.registerListeneríthis, orientationSensor,, SensorManager. SENSOR_DEI..llY_GAME) ;; SensorManager.SENSOR_DELAY_GAME)

} 3.

siguientes dos dos métodos métodos que que implementan implementan lala interfaz interfaz Añade los siguientes SensorEventListener SensorEventListener:: ®Overr.ide onAccuracyChanged(Sensor sensor, sensor, int int accuracyl{} accuracy){} public void onAccuracyChanged(Sensor private l orinicial prívate boolean hayVa hayValorInicial private float val orinicial ; prívate valorlnicial;

== false; false;

t!{i0verride OSOverride

public void onSensorChanged(SensorEvent onSensorChanged(SensorEvent event) event) {{ valor = event. event.valúes[l]; float valor= values [l]; if (!hayValorinicial) (IhayValorlnicial){{ va l orini cial = l or; valorlnicial = va valor; hayValorinicial hayValorlnicial = true; true;

183

El gran libro de Android giroNave= (int) giroNave=(int)

(valor-valor i nicial) /3 (valor-valorlnicial)/3

;

} 4.

Prueba la aplicación. Has de tener cuidado de que el terminal esté en en una una posición cómoda al entrar en la actividad ,Juego, Juego, dado que que el movimiento de la nave se obtiene con la diferencia de la posición posición del terminal terminal con con respecto a la posición inicial.

.\Ei

a

yv « • M TSJ

Práctica; Manejo de la nave con sensor de aceleración. Práctica:

Modifica el ejemplo anterior para utilizar el sensor de aceleración en lugar lugar del del de de orientación. orientación. Gracias a la fuerza de gravedad que la (a Tierra ejerce ejerce sobre sobre el el terminal terminal podremos saber si este está horizontal. En caso de que que la la nave nave esté esté horizontal horizontal (o (o casi) no ha de girar, pero cuando el terminal se incline, incline, la la nave nave debe debe girar girar proporcionalmente a esta inclinación. Utiliza los los programas a[lteriores anteriores para para descubrir descubrir qué eje (x, y o z) es el que te interesa y el rango de valores que proporciona. que proporciona.

ª

\Ei

- v;

♦y •

¿Te cuidado cuando también

Práctica: Aceleración de la nave con sensores. animarías a controlar la aceleración de la nave con con los los sensores? sensores? Ten Ten de que no acelere con mucha facilidad, este juego resulta resulta muy muy difícil difícil la nave está en movimiento. movimiento. Puede ser una buena buena idea idea que que permitas permitas desacelerar la nave.

$

a

Práctica: Configuración de tipo de entrada en preferencias.

Todos los controles de la nave (teclado, pantalla táctil táctil yy sensores) sensores) están están activados simultáneamente. El teclado y la pantalla táctil no no interfieren interfieren cuando cuando el el usuario no quiere utilizarlos. utilizarlos. Sin embargo, la activación de de los los sensores sensores sí sí que que molestará a los usuarios que no quieran utilizar este método de de entrada. entrada. 1. 1.

Crea nuevas entradas en la configuración para activar activar oo desactivar cada cada tipo de entrada (o al menos la de los sensores).

2. 2.

Modifica el código anterior para que se desactiven las las entradas que que el el usuario no haya seleccionado. seleccionado.

5.6. 5.6. Uso Uso de de hilos hilos de de ejecució ejecución (Threads) (Threads) Cuando se lanza una nueva aplicación el sistema crea un un nuevo hilo hilo de de ejecución ejecución (thread) para esta aplicación conocida como hilo principal. Este Este hilo hilo es es muy muy importante dado que se encarga de atender los eventos eventos de de los los distintos distintos

184 184

Entradas en Android: teclado, pantalla táctil yy sensores componentes. (), onDraw (), ( l, componentes. Es decir, decir, este hilo ejecuta los métodos oncreate {), onKeyDown () . Por esta razón al hilo principal también se lo conoce como hilo del interfaz de usuario. usuario. El sistema no crea un hilo independiente cada vez que se crea un nuevo componente. decir, todas las actividades y servicios de una aplicación son componente. Es decir, ejecutados por el hilo principal. Cuando tu aplicación ha de realizar trabajo intensivo como respuesta a una interacción de usuario, hay que tener cuidado porque es posible que la aplicación no responda de forma adecuada. Por ejemplo, ejemplo, imagina que has de esperar para descargar unos datos de Internet, Internet, si lo haces en el hilo de ejecución principal este tanto, no se quedará bloqueado a la espera de que termine la descarga. Por lo tanto, podrá redibujar la vista (onDraw 0)0 () ) o atender eventos del usuario (onKeyDown ()). () ). Desde el punto de vista del usuario, usuario, se tendrá la impresión de que la aplicación se ha colgado. Mas todavía, todavía, si el hilo principal es bloqueado más de 5 segundos, segundos, el sistema mostrará un cuadro de diálogo al usuario "La aplicación no responde" para que el usuario decida si quieres esperar o detener la aplicación. aplicación. La solución en estos casos es crear un nuevo hilo de ejecución, ejecución, para que realice principal, que puede este trabajo intensivo. De esta forma no bloqueamos el hilo principal, usuario. Es decir, decir, cuando estés implementando un seguir atendiendo los eventos de usuario. método del hilo principal (empieza por on...) on...) nunca realices una acción que pueda bloquear este hilo, hilo, como cálculos largos o que requieran esperar mucho tiempo. tiempo. En estos casos hay que crear un nuevo hilo de ejecución y encomendarle esta tarea. tarea. En el siguiente apartado describiremos cómo hacerlo. hacerlo. Las herramientas del interfaz de usuario de Android han sido diseñadas para ser tanto, no se ejecutadas desde un único hilo de ejecución, el hilo principal. Por lo tanto, permite manipular el interfaz de usuario desde otros hilos de ejecución. ejecución.

5.6.1. Introduciendo movimiento en Asteroides Para que el juego cobre vida será necesario animar todos los gráficos introducidos. introducidos. En el siguiente ejercicio veremos cómo hacerlo. hacerlo.

Ejercicio paso a paso; paso: Introduciendo movimiento en Asteroides. 1.

Comienza declarando las siguientes variables en la clase vistajuego: vistaJuego: ////THREAD TIEMPO////// // lili THREAD Y TIEMPO lililí II encargado de procesar el juego /1 Thread encarGado pri vate ThreadJuego Th readJu e go thread thread= prívate = new ThreadJuego(); // /1 Cada cuanto queremos procesar cambios (ms) prívate priva te static int i n t FERrODO...PROCESO PERIODO.... PROCESO = = 50; // /1 Cuando se realizó el último proceso priv ate long ultiraoProceso ultimoProceso == 0; O; prívate

185

El gran libro de Androíd Android 2.

La animación del juego juego la la llevará llevará aa cabo cabo el el método método actualizaFisicaO actualizaFisica í) que que será ejecutado aa intervalos intervalos regulares, regulares, definidos definidos por por lala constante constante PERIODO PROCEso. Esta Esta constante constante ha ha sido sido inicializada inicializada aa 50 50 ms. ms. En En periodo proceso. ultimoProceso almacena el el instante instante en en que que se se llamó, llamó, por por última última vez, vez, aa ultimo Proceso se almacena actualizaFisica() actualizaFisica{)..

3.

método dentro dentro de de la la clase clase vistajuego: VistaJuego: Copia el siguiente método protected actualizaFisica() {{ protacted void actualizaFisicaO long ahora ahora~ Sy;>tem.currentTimeJVlillis(); = System,currentTimeMillisO;

í//1 No hagas nada nadzt si el el período perio do de de proceso proceso no no se se ha ha cumplido, cumplido. if (ultimoProceso ( ul t. imoProceso ++ PERIODO_PROCESO PERIODO PROCESO >> ahora) ahora) { return;

} // Para una ejecución ejecuc.ión en en tiempo tiempo real real. calculamos calculamos retardo rer:arclo double retardo =~ (ahora (ahora -- ultimoProceso) ultimoProceso) // PERIODO__PROCESO; PERIODO_PROCESO;

ultimoProceso == ahora; ahora; // // Para Pa ra la J.a próxima próxj_ma vez vez // Actualizamos Acr.uaJ. izamos velocidad velocida.d y y dirección dirección de de la J.a nave nave aa. partir part.j_r de de // giroNave gi.roNave y aceIeracionNave acel.eracionNav e (según (según la J.a entrada entrada del del jugador) jugador) nave. setAngulo ( ( int ) (nave.getAngulo() (nave. getAngulo () ++ giroNave giroNave ** retardo!); retardo)) ; nave.eetAngulo{(int! double nlncX nincX -~ nave.getlncXO nave.getincX() ++ aceleracionNave aceleracionNave ** Math. cos (r"lath. toRadians (nave.getAngulo())) ** retardo; retardo; Math.coa(Math.toRadians(nave.getAngulo())) double nlncY nincY == nave.getIncY() nave.getincY() ++ aceleracionNave aceleracionNave ** JVlath. sin (r"lath. toRadians (nave. getAngui.o ())) ** retardo; retar·do; Math.sin(Math.toRadians(nave.getAnguloí))) /! Actualizarnos Act:ualizamon si el el módulo módulo de de la l.a velocidad velocidad no no excede excede el el máximo máximo // if (Math.hypot (nlncX, (nincX,nincY) "''" Gx"af Grafico.getHaxVelocidad()) nlncY) <-■ ico .getMaxVelocidad () ) {{

nave.setlncX(nlncX); rtave.setinc~X(nincX); rlave.setinc=Y(nincY); nave.setlncY(nlncY); } /í Actualizamos posiciones posiciones XX ee YY // nave.incrementaPos(retardo); nave.incrementaPos(retardo) ; for (Gráfico (Grafico asteroide asteroide :: Asteroides) Asteroides) { asteroide.incrementaPos(retardo); asteroide.incrementaPos(retardo) ; } }

186

4.

continuación, este este método método será será llamado llamado de de forma forma Como veremos aa continuación, PERIODC_PROCESO continua. queremos desplazar desplazar los los gráficos gráficos cada cada periodo continua. Como queremos proceso milisegundos, verificamos si si ya ya ha ha pasado pasado este este tiempo tiempo desde desde la la última última vez vez que se ejecutó (ultimoProceso). (ultimoProceso}.

5.

posible que que el el sistema sistema esté esté ocupado ocupado yy no no nos nos haya haya Como también es posible un tiempo tiempo superior superior aa periodo_proceso, PERrono_ PRocEso, vamos vamos aa podido llamar llamar hasta hasta un calcular el factor de de retardo retardo en en función función del del tiempo tiempo adicional adicional que que haya haya pasado. Si por ejemplo, ejemplo, desde desde la la última última llamada llamada ha ha pasado pasado dos dos veces veces PErnono.PROCESO, la variable variable retardo retardo ha ha de de valer valer 2. 2. Lo Lo que que significará significará periodo proceso, la en circunstancias circunstancias que los gráficos han han de de desplazarse desplazarse el el doble doble que que en normales. De esta forma conseguiremos conseg iremos un un desplazamiento desplazamiento continuo continuo en en tiempo real.

Entradas en Android: teclado, pantalla táctil y sensores 6.

A continuación, continuación, se actualizan las variables que controlan la aceleración y cambios de dirección de la nave. Se consiguen por medio de las variables aceleracíonNave aceleradonNave y giroNave. En el siguiente capítulo, modificaremos estas variables para que el jugador pueda pilotear la nave. nave, A partir de estas variables se obtiene una nueva velocidad de la nave, descompuesta en sus componentes X e Y Y.. Si el módulo de estos componentes es mayor que la velocidad máxima permitida, no se actualizará la velocidad.

7.

Finalmente, se actualizan las posiciones de todos los gráficos (nave y asteroides) a partir de sus velocidades. Esto se consigue llamando al método incrementaPos () definido en la clase Grafico. Gráfico.

8.

Ahora necesitamos que esta función sea llamada continuamente, continuamente, para lo que utilizaremos un Thread. Thread. Crea la siguiente clase dentro de la clase VistaJuego: VistaJuego! clasa class ThreadJuego extenda extends Thread {{

©Ove rr i de

@Ovei.~r.i de

public void run() {{ true ) {{ while (!true) actuali zaFisica () ; actuallzaFisica();

} } }

9.

Introducir esta línea al final del método onsizechanged (): thread . start(}; thread.start();

run() ejecución. Este 10. Esto ocasionará que se llame al método run ( l del hilo de ejecución. método es un bucle infinito que, continuamente, llama al actualizaFisica ¡. actuaiizaFisica (().

11. Ejecuta la aplicación y observa cómo el juego cobra vida. El trabajo con hilos de ejecución es especialmente delicado. delicado. Como veremos en próximos capítulos, este código nos va a ocasionar varios quebraderos de cabeza. Un problema es que seguirá ejecutándose aunque nuestra aplicación esté en segundo plano. Veremos cómo detener el hilo de ejecución, cuando estudiemos el ciclo de vida de una actividad (NOTA: Si ejecutas el programa en el terminal real yy detectas que este funciona más lentamente, puede ser buena idea detener la aplicación) aplicación).. Un segundo problema, aparecerá cuando dos hilos de ejecución traten de acceder a la misma variable a la vez. También se resolverá más adelante. adelante.

5.7. 5. 7. Introduciendo un misil en Asteroides Para poder disparar a los asteroides va a ser necesario introducir un misil en el juego. En el siguiente ejercicio aprenderemos a hacerlo:

t Ejercicio paso a paso: Introduciendo un misil en Asteroides. Asteroides.

187

El gran libro de Android 1. 1.

vistaJuego: En primer lugar, lugar, añade las siguientes variables a la clase VistaJuego: // //// MISIL lilll/ ////// pprívate r ívate Gráfico Grafi co misil; priva te static int PASO_VELGCIDAD._MISIL P_4SO_ VE.LOC.TDAD 1"1TSIL prívate

= 12 ¡;

pprívate rivate boolean boole an nü si.lActivo == false; misilActivo prívate int ínt tiempoMisil; tiempo~1isil ;

2.

Para trabajar con gráficos vectoriales, vectoriales, puedes crear en el constructor la drav:ablet"lisil de la siguiente forma: variable drawableMisil forma: ShapeDrawable dt•lisil ShapeDr·awabl.e (new RectShape()); Rect:.-lhape ()) ; dMisil = new ShapeDrawable(new dMisi l. 9etPaint () . setColor (Color. h'HITE) ; dMisil.getPaint().setColor(Color.WHITE) dMisil.9etPaint() . setStyle(Style . STROKE) ; dMisil.getPaint().setStyle{Style.STROKE) ddMisil.setlntrinsicWidth(15); Misil . setintrinsicWidth(l5); dMisil.setlntrinsicHeight(3); dMisi l.setintrinsicHeight(3); drawab l e!Vlisil = ~ dMisil; drJiisil; drawableMisil

3.

Crea la variable drawabl.e~1isil drawableMisil para el caso en que se deseen gráficos en bitmap, utilizando el fichero misiii.png. misill . png.

4.

Inicializa el objeto misil, misi l. de forma similar a como se ha hecho en nave.

5.

En el método oonDrawf) nDraw () dibuja misil, misil , solo si lo indica la variable misillictivo. misilActivo.

6. 6.

Quita los comentarios de las llamadas a activaMlsil activaf'1isil ()

7.

En el método actuaiizaFislca actualizaFisica () (5 añade las siguientes líneas: líneas: !/Actualizamos // Actualizamos posición de misil íf (misi lActivo) {{ if (misilActivo) misi l .in cremen taPos(retardo);; misil.incrementaPos(retardo) tiempoMisil--; iif f (tiempoMisil ( tiempot"'isil < 0) O) { misilActivo = = false;

} else {{ for (int (ínt ii = = 0; O; ii < Asteroides.size(); Asteroides .size(); i++) íf (nlisil.verificaColisi o n( Asteroides . e l e mentAt(i) )) { if (misil.verificaColision(Asteroides.elementAt(i))) destruyeAsteroide( i ); destruyeAsteroide(i); break break;; } } } 8.

Añade los siguientes dos métodos: métodos: prívate void destruyeAsteroide(int i) i} Astero ides.remove(i); Asteroides.remove(i); misi.lActivo misilActivo == false;

} prívate void voíd ActivaMisil(} ActivaMisil() {{

188

{{

Entradas en Android: teclado, teclado, pantalla táctil yy sensores mi s il . setPosX (nave .getPosX () + nave.getAncho()/2-misil.getAncho()/2); nave . getAncho () /2 - misi l. getAncho () / 2 ); misil.setPosX(nave.getPosX()+ mi sil. setPosY (nave . getPosY () + nave.getAlto()/2-misil.getAlto()/2); nave . getAlto () /2 - misil .getAlto () /2) ; misil.setPosY(nave.getPosY()+ misil . setAngulo (nave .getAngulo ()) ; misil.setAngulo(nave.getAngulo()); misil. setincX(Math. cos (Math. toRadians (misi l.getAngulo() ) ) ** misil.setlncX(Math.eos(Math.toRadians(misil.getAngulo())) PASO_ VELOC.IDAD_NISIL ); PASO_VELOCIDAD_MISIL); misil. setincY (Math. sin (Math .toRadians (misil. g e tAngulo() ) ) ** misil.setlncY(Math.sin(Math.toRadians(misil.getAngulo())) PASO_VELOCIDAD_MISIL); ti e mp oMisil = (int) Math.min(this.getWidth() Math .min (this . getWid th () /1 Math.ajbst Mat h. abs ( misil. misil. tiempoMisil ge t i n cX()), thís.getHeight() this.getHe i ght() // Math.ahs(misil.getlncY())) Math. abs (misi l.getincY()) ) - 2; 2; getlncXO), rnis i lAct i vo = = true; raisilActivo

} 9.

Este último método requiere alguna explicación. explicación. Cuando se quiere quiere activar activar un nuevo misil este debe partir del centro de de la la nave. nave. Como Como las las coordenadas X, X, Y de Gráfico, Graf ico, corresponden a a la la esquina esquina superior superior del misil ha ha de de ser ser el el izquierda hay que hacer algunos ajustes. ajustes. El ángulo del módulo de de la velocidad velocidad de de la la mismo que actualmente tiene la nave. nave. El módulo PASO_VELOCIDAD_r"'ISIL. Para Para nave nos lo indica la constante constante paso_velocidad__misil. descomponerlo en sus componentes X e Y utilizamos utilizamos el coseno yy el seno. seno. que sale por un lado lado aparece aparece Dada la naturaleza del espacio del juego (lo que acabar chocando chocando contra contra la la por el otro) si disparáramos un misil este podría acabar nave. Para solucionarlo, nave. solucionarlo, vamos a dar dar un tiempo de de vida al misil misil para para la nave (tiempoMisil). impedir que pueda llegar de nuevo a la ( tiempof'-t isil ) . Para Para obtener obtener la el ancho dividido dividido la este tiempo nos quedamos con el mínimo entre el velocidad en X y el alto dividido entre entre la la velocidad en en Y. Y. Luego Luego le le restamos constante. Terminamos activando el misil. una constante.

10. Verifica que todo funciona correctamente. correctamente.

NOTA: Este código es posible posible que de algún problema problema de de acceso concurrente aa los los capítulo. datos desde dos threads diferentes. Se resolverá en el siguiente capitulo. . O

Práctica: vez. Práctica; Disparando varios misiles aa la vez. Tal y como se ha planteado en el código solo es posible posible lanzar lanzar un un misil misil cada cada vez. Si disparamos un segundo misil el primero primero desaparece. desaparece. ¿Podrías ¿Podrías modificar modificar el vez. código para que se pudieran lanzar tantos misiles misiles cómo cómo quisieras? quisieras? Consejo: Consejo: Observa como se ha resuelto para el caso de de los asteroides, asteroides, la la solución solución para para los los misiles puede ser muy similar. similar.

189

,

CAPITULO 6. CAPÍTULO 6.

Multimedia y ciclo ciclo de de vida vida Multimedia y de una actividad actividad de una

Una de las funciones más más habituales habituales de de los los modernos modernos teléfonos teléfonos móviles móviles es es su su utilización como reproductores reproductores multimedia. multimedia. Su Su uso uso más más frecuente frecuente es es como como la reproducción reproducción de de vídeos vídeos yy televisión televisión aatravés través de de Internet. Internet. reproductores MP3, para la El API de Android viene preparado preparado con con excelentes excelentes características características de de reproducción reproducción multimedia, permite la reproducción reproducción de de gran gran variedad variedad de de formatos, formatos, tanto tanto de de audio audio origen de de los los datos datos puede puede ser ser tanto tanto un un fichero fichero local local como como un un como de vídeo. El origen stream obtenido desde desde Internet. Internet. Todo Todo este este trabajo trabajo lo lo realiza realiza principalmente principalmente una una t·1ediaPlaye:r. clase MediaPlayer. Antes de comenzar la la descripción descripción de de estos estos contenidos, contenidos, comenzaremos comenzaremos elel capítulo con un aspecto aspecto de de vital vital importancia importancia en en el el desarrollo desarrollo de de aplicaciones aplicaciones en en Android, el ciclo ciclo de vida de de una una actividad. actividad. Es Es decir, decir, cómo cómo las las aplicaciones aplicaciones son son creadas, puestas en espera espera yy finalmente finalmente destruidas. destruidas.

Objetivos: •

Comprender el ciclo de de vida vida de de una una actividad actividad Android. Android.

•

eventos relacionados Utilizar de forma correcta los los diferentes diferentes eventos relacionados con con elel ciclo ciclo de vida. vida.

• •

Aprender cuándo yy cómo guardar guardar el el estado estado de de una una actividad. actividad. Repasar las facilidades multimedia multimedia disponibles disponibles en en Android, Android, qué qué formatos formatos soporta y las clases que que hemos hemos de de utilizar. utilizar. Describir la clase MediaPlayer, MediaPiayer, utilizada utilizada para para la la reproducción reproducción de de audio audio yy video. video.

• •

Dotar a la aplicación aplicación Asteroides Asteroides de de un un control control adecuado adecuado de de su su ciclo ciclo de de vida y de varios efectos efectos de de audio. audio.

191

El gran libro de Android

6.1. Ciclo de vida vida de de una una actividad actividad 6.1. Ciclo de El ciclo de vida de una aplicación Android Androides es bastante diferente del ciclo de vida de una aplicación en otros S.O., como Windows. Windows. La mayor diferencia es que, que, en Android el ciclo de vida es controlado principalmente por el sistema, sistema, en lugar de ser controlado directamente por el usuario. usuario. Una aplicación en Android va a estar formada por un conjunto de elementos básicos de visualización, conocidos como actividades. actividades. Además de varias actividades una aplicación también puede contener servicios. El ciclo de vida de los servicios será estudiado en el capítulo 8. Son las actividades las que realmente controlan el ciclo de vida de las aplicaciones, dado que el usuario no cambia de aplicación, sino de actividad. El sistema va a mantener una pila con las actividades previamente visualizadas, de forma que el usuario va a poder regresar a la actividad "atrás". anterior pulsando la tecla "atrás". Una aplicación Android corre dentro de su propio proceso Linux. Este proceso es creado para la aplicación y continuará vivo hasta que ya no sea requerido y el sistema reclame su memoria para asignársela a otra aplicación. aplicación. Una característica importante, importante, y poco usual, de Android es que la destrucción de un proceso no es controlado directamente por la aplicación. En lugar de esto, es el sistema quien determina cuando destruir el proceso, basándose en el conocimiento que tiene el sistema de las partes de la aplicación que están corriendo (actividades y servicios), acerca de qué tan importantes son para el usuario y cuánta memoria disponible hay en un determinado momento.

aplicación, el usuario vuelve a ella, Si tras eliminar el proceso de una aplicación, ella, se creará de nuevo el proceso, pero se habrá perdido el estado que tenía esta aplicación. aplicación. En estos casos, va a ser responsabilidad del programador almacenar el estado de las actividades, si queremos que cuando sea reiniciada conserve su estado. Como vemos, Android Androides es sensible al ciclo de vida de una actividad, por lo tanto necesitas comprender y manejar los eventos relacionados con el ciclo de vida si quieres crear aplicaciones estables. Una actividad en Android puede estar en uno de estos cuatro estados: estados:

Activa (Running): (Running). La actividad está encima de la pila, lo que quiere decir que es visible y tiene el foco. foco. Visible (Paused): (Paused): La actividad es visible pero no tiene el foco. Se alcanza este estado cuando pasa a activa otra actividad con alguna parte transparente o que no ocupa toda la pantalla. Cuando una actividad está tapada por completo, completo, pasa a estar parada. parada. Parada (Stopped) visible, se recomienda guardar (Stopped).: Cuando la actividad no es visible, el estado de la interfaz de usuario, usuario, preferencias, preferencias, etc.

{Destroyed). Cuando la actividad termina al invocarse el método Destruida (Destroyed): finishQ,, o es matada por el sistema Android, finish() Android, sale de la pila de actividades.

192

Multimedia y ciclo de vida de una actividad Cada vez que una actividad cambia de estado se van a producir eventos que actividad. A continuación, se podrán ser capturados por ciertos métodos de la actividad. muestra un esquema que ilustra los métodos que capturan estos eventos. Se crea la actividad

I 1 onCreate {) onCreate() l1

onStart {) () - - - - - - ,

i onResume (} onResume()

1

Activa onPause{)

Visible cmS t op() onStopO

onRest.art (> () onRestart

Parada onDest.roy() onDestroyO

Destruida

actividad. Figura 1: Ciclo de vida de una actividad. onCreate(Bundle): onCreate(Bundle): Se llama en la creación de la actividad. Se utiliza para realizar todo tipo de inicializaciones, como la creación de la interfaz de datos. Puede recibir información usuario o la inicialización de estructuras de datos. Bundie), por si se de estado de instancia (en una instancia de la clase Bundle), reanuda desde una actividad que ha sido destruida y vuelta a crear. onStart(): Nos indica que la actividad está a punto de ser mostrada al usuario.

onResume(): Se llama cuando la actividad va a comenzar a interactuar con el onResume(): usuario. usuario. Es un buen lugar para lanzar las animaciones y la música. onPause(): onPause(): Indica que la actividad está a punto de ser lanzada a segundo plano, normalmente porque otra aplicación es lanzada. Es el lugar adecuado para detener animaciones, animaciones, música o almacenar los datos que estaban en edición. edición. 193

El gran libro de Android onStop(): La actividad ya no va a ser visible para el usuario. onStop(): usuario. Ojo si hay muy poca memoria, memoria, es posible que la actividad se destruya sin llamar a este método. método. onRestart(): onRestart(): Indica que la actividad va a volver a ser representada después de haber pasado por onStop(). onStop(). onDestroy(): onDestroy(): Se llama antes de que la actividad sea totalmente destruida. destruida. Por ejemplo, ejemplo, cuando el usuario pulsa el botón o cuando se llama al método finish() finishQ.. Ojo si hay muy poca memoria, memoria, es posible que la actividad se destruya sin llamar a este método. método.

Ejercicio paso a paso: ¿Cuándo se llama a los eventos del ciclo de vida en una actividad?

ai

En este ejercicio vamos a implementar todos los métodos del ciclo de vida de la actividad principal de Asteroides y añadiremos un Toast para mostrar cuando son ejecutados. ejecutados. De esta forma comprenderemos mejor cuándo se llama a cada método. método. 1.

Abre la actividad Aste roi des del proyecto Asteroides. Asteroides. Asteroides

2.

Añade en el método oncreate oncrea te (()l el siguiente código: código: Toas t.. makeTc:.xt ( this , Toast.makeText(this,

3.

11 onCreate 11 , Toas t. . LEIVGTI-I.._.SI·fORT). show (); "onCreate", Toast.LBNGTH__SHORT).show();

Añade los siguientes métodos: métodos: @Override onStart(} ©Override protected void onStart() super.onStart(}; super.onStart();

{

Toast .mateText .makeText (this, "onStart", "onStart ", Toast. LBNGTH.,.SHORT) LENGTH....SHORT) .show(); . show();

} @Override onResume(} {{ ©Override protected void onResume() super.onResume(}; super.onResume(); Toast.makeText (this, "onResume", Toast.LENGTH_SHORT).show(); Toast .LElvGTH_E;HORT) .show(); Toast.makeText(this,

} @Override onPause(} {{ ©Override protected void onPause() Toast.makeText(this, LENG'IH_SHOR1') .show() .show(};; Toast ./naiceText (this, "onPause", Toast. LBNGTH_SHORT) super.onPause(}; super.onPause() ;

} @Override ©Override protected void onStop() {{ Toast . makeText (this, "onStop", Toast.LENGTH_SHORT).show() Toast. LEi'VG'I'H_SilOR'T) .show(};; Toast.maíceText(this, super.onStop();

} (q;Qver:üde onRestart (} ©Override protected void onRestart()

{{ super.onRestart(}; super.onRestart(); Toas t .makeText "onRestart. '', Toast. LENGT¡l_SHORT) LENGTH_ SfiOR'l')..showO show(} ; Toast. makeText (this, "onRestart",

}

194

- - - - - - -- - - - - - - - - - - - - - - - - -- -

-----------

Multimedia y y ciclo de vida de una actividad ®Override ©Override protected void onDestroy() onDestroyO { Toast.makeText(this, .show(); Toast.makeText( this, "onDestroy", TToast.LENGTH_SHORT) o ast .LENGTH_SHORT) .show(); super.onDestroy (); super.onDestroy();

} 4.

Ejecuta la aplicación y observa la secuencia de Toas t. Toast.

5.

Pulsa el botón Acerca de y luego regresa a la la actividad. actividad. Observa Observa la la secuencia de Toas t. Toast.

6.

Pulsa el botón Jugar y luego regresa a la actividad. Observa Observa la la secuencia secuencia de Toast. Toa st.

7.

Sal de la actividad y observa la secuencia de Toas t. Toast.

Ejercicio paso a paso: Aplicando eventos del ciclo de vida vida en la actividad Juego de Asteroides. Asteroides gestiona el movimiento de los objetos gráficos por medio medio de un un aplicación pasa pasa aa segundo segundo plano, plano, thread que se ejecuta continuamente. Cuando la aplicación este thread continúa ejecutándose, por lo que puede hacer que nuestro nuestro teléfono teléfono funcione más lentamente. Este problema aparece por una gestión incorrecta incorrecta del del ciclo de vida. vida. En el siguiente ejercicio veremos cómo solucionarlo: 1.

Abre el proyecto Asteroides y ejecútalo en un terminal con una una versión versión 2.3.x. 2.3.x.

2.

pulsa con con el el Pulsa el botón "Jugar" y cuando esté en mitad de la partida pulsa Las actividades actividades botón de inicio para dejar a la actividad en estado parada. Las recursos. Sin en este estado no tendrían que consumir demasiados recursos. embargo, Asteroides sí que lo hace, para verificarlos utiliza la la aplicación aplicación "Administrador de tareas" (disponible en las últimas versiones de de Android). El resultado puede ser similar al que se muestra a continuación:

195

El gran libro de Android Como puedes ver la aplicación Asteroides está consumiendo casi el 50% del uso de CPU. CPU. Evidentemente algo hemos hecho mal. No es lógico que cuando la actividad Juego esté en segundo plano se siga llamando a act.uaJizaFisj ca () actual.!saFisica o.. En este ejercicio aprenderemos a solucionarlo. solucionarlo. 3.

Juego. Incluye la siguiente variable en en la actividad juego. prívate VistaJuego Vi s t aJuego vistaJuego;

4. 4.

onc:r·eat:e añade: añade: Al final de onCreate vistaJuego

5.

indViewByid(R.id. FistaJuego); == (VistaJuego) ffindViewById(R.id.VistaJuego);

Incorpora los siguientes métodos a la actividad: actividad: @Over:ci.de pro tected void onPause() onPa use () SOverride protected super . o nPause(); super.onPause(); vistaJuego.getThread() vistaJuego.getThreadO .pausar();

{

} @()ver·:d. de protected void onResume() onResume () ®Override super.onResume(); vistaJuego.getThread() .reanu dar(); vistaJuego.getThreadO.reanudar();

{

} @Override pro tected void onDestroy() ©Override protected vistaJuego . getThread() . deten er(); vistaJuego.getThreadO.detener(); super.onDestroy();

{

} Lo que intentamos hacer con este código es poner en pausa el thread secundario, cuando la actividad deje de estar activa, activa, y reanudarlo, reanudarlo, cuando la actividad recupere el foco. foco. Además, Además, detener el thread cuando la actividad vaya a ser destruida. destruida. NOTA: realmente el thread será destruido al destruirse la actividad que lo ha posible. lanzado. lanzado. No obstante, puede resultar interesante hacerlo lo antes posible.

Observa cómo los eventos del ciclo de vida solo pueden ser escritos en un Activity, Vista,"Tuego. Activity, por lo que no sería válido hacerlo en vistaJuego.

6. 6.

vistaJu ego y busca la definición de la clase ThreadJuego y Abre la clase vistaJuego remplázala por la siguiente: siguiente: class ThreadJuego extends Thread Thread }{ prívate boolean boo lea n pausa,corriendo; pausa,corri e ndo ; public synchronized void pausar() pausa == true; true ;

}

196

{

Multimedia y ciclo de vida de una actividad public synchronized void reanudar() {{ pausa == false false;; notify (); notify(); } public void detener() {{ corriendo = = false false,-; if (pausa) reanudarí); reanudar();

} SOverride public void run() {{ corriendo =~ true; while (corriendo) { actualizaFisica(); actualizaFisica() ; synchronized (this (this)) { whi l e (pausa) { while try {{ wait () ();; } catch (Exception e) {{ } } } } } } Comenzamos declarando las variables pausa, corriendo. Estas pueden ser l. modificadas mediante los métodos pausar (} (),, reanudar (} () y detener ((). 7.

La palabra reservada synchronized impide el acceso concurrente a una sección del código. En el siguiente capítulo explicaremos su utilización. El ol se ha modificado de manera que en lugar de ser un bucle método run 1 infinito, permitimos que termine poniendo la variable corriendo a false. Luego, tras llamar a actualizaFisica (), () , se comprueba si se ha activado pausa. En tal caso, se entra en un bucle donde ponemos en espera el wait (). thread llamando al método wa i t 1 l . Este quedará bloqueado hasta que se o. Esta acción se realizará desde el método reanudar (). o. llame a notify (). () puede lanzar excepciones por lo que es obligatorio La llamada a wait wai t () ... } ca tch {{...}. ... } . escribirla dentro de un bloque try {{...} catch

8.

prívate, Dado que la variable thread es de tipo pri vate, no puede ser manipulada VistaJuego. Para poder llamar a los métodos de este desde fuera de vistajuego. objeto (pausar, reanudar) vamos a incluir un método getter. Para ello, sitúa vistajuego. Pulsa con el botón el cursor justo antes de la última llave de vist.aJuego. derecho en el código y selecciona la opción Source 1/ Generate Getters and Setters ... Marca solo el método getThread (} tal y como se muestra a Setters... getThreadO continuación: continuación:

197

El gran libro de Android

r^ ¡E ¡rr¡ "o puntuación puntuacion

"' BJ hread Üj . ?:' t thread Á

h/| o getlhteadO ~f~ 9~trhreadO j | <•" setThfead{Thtead)uego) I~H setThre.ad(ThreadJuego) i> ultimoProceso 0 U =• ultimo Proceso

Se insertará el siguiente código: código: public ThreadJuego Thread,Juego getThreadO getThread () return thread;

{

} 9. 9.

Ejecuta de nuevo la aplicación y repite repite el el segundo punto punto de de este este ejercicio. ejercicio. En este caso el resultado ha de ser similar al al siguiente:

LJL

f Descarga

F aBEiga

Aplicar :iones acti lililí Salir de 1 todo 1 3 a WhatsApp ^ RAM: 21,61MB, CPU:

" > ■' I Salir 1

jm Asteroides * RAM: 3,31MB, CPU: 0

' 1 Salir 1

ji| Música " RAM: 17,45MB, CPU;

1 Salir 1

bH

6.1.1. ¿Qué proceso se elimina? Como hemos comentado Android mantiene en memoria todos todos los los procesos procesos que que quepan aunque estos no se estén ejecutando. ejecutando. Una Una vez vez que que la la memoria memoria está está llena llena yy el usuario decide ejecutar una nueva aplicación, aplicación, el el sistema sistema ha ha de de determinar determinar qué qué ha de de ser eliminado. eliminado. Android Android ordena ordena los los proceso de los que están en ejecución ha jerárquica, asignándole asignándole aa cada cada uno uno una una determinada determinada procesos en una lista jerárquica, "importancia". basándose en los los componentes componentes de de la la "importancia". Esta lista se confecciona basándose aplicación que están corriendo (actividades (actividades yy servicios) servicios) yy el el estado estado de de estos estos componentes. componentes. Para establecer esta jerarquía de importancia importancia se se distinguen distinguen los los siguientes siguientes tipos tipos de procesos: procesos: Proceso de primer plano (Foreground process): process): Hospeda Hospeda una una actividad actividad en en la superficie de la pantalla, con la cual el el usuario usuario está interactuando interactuando (su (su método onResume () ha sido llamado). llamado). Debería haber solo solo uno uno oo unos unos pocos procesos de este tipo. Sólo serán eliminados cómo cómo último último recurso,

198

Multimedia y ciclo de vida de una actividad si es que la memoria está tan baja que ni siquiera estos procesos pueden continuar corriendo. puedencontinuarcorriendo. Proceso visible (Visible process): Hospeda una actividad que está visible en la pantalla, pero no en el primer plano (su método onPause () < J ha sido llamado). Considerado importante, no será eliminado a menos que sea necesario para mantener los procesos de primer plano. Proceso de servicio (Service process): Hospeda un servicio que ha sido inicializado con el método startserviceO. startservice
0

.0 0 _

Práctica: Aplicando eventos del ciclo de vida en la actividad inicial de Asteroides. Asteroides.

Los conceptos referentes al ciclo de vida de una actividad son imprescindibles para el desarrollo de aplicaciones estables en Android. Para reforzar estos conceptos te proponemos el siguiente ejercicio en el que vamos a reproducir una música de fondo. 1.

Abre el proyecto Asteroides. Asteroides.

2.

Busca un fichero de audio (los formatos soportados por Android se listan capítulo). Renombra este fichero a audio.xxx y cópialo a la carpeta en este capítulo). reslraw. res/raw.

NOTA: Cada vez que ejecutes el proyecto este fichero será añadido al paquete .apk. .apk Si este fichero es muy grande la aplicación también lo será, lo que ralentizará su instalación. Para agilizar la ejecución te recomendamos un fichero muy pequeño, por instalación. ejemplo un .mp3 de corta duración o un fichero MIDI (mid). (mid). Si no encuentras ninguno puedes descargar uno de la Web del curso.

199

El gran libro de Android

3.

Abre la actividad Asteroides Asr.eroides yy añade añade las las siguientes siguientes líneas líneas en en elel método método oonCreate(): nCreate () : t4ediaPlayer MediaPla.yer . c.reate·{ this, R.raw.audio); R.raw .audio) ; MedlaPlayer mp -= MediaPlayer,create(this, mp.sta:r:t(); mp.start();

4. 4.

Ejecuta el proyecto yy verifica verifica que que cuando cuando sales sales de de lala actividad actividad lala música música tiempo. sigue sonando un cierto tiempo.

5.

Utilizando Utilizando los los eventos eventos del del ciclo ciclo de de vida vida queremos queremos que que cuando cuando lala actividad actividad el audio audio deje deje de de escucharse. escucharse. Puedes Puedes utilizar utilizar los los deje de estar estar activa el métodos: métodos: mp.pause( ); mp.pause(); mp. s tart () ; mp.start{);

6. 6.

Verifica que que funciona correctamente. correctamente.

O"

Práctica: Aplicando eventos del ciclo ciclo de de vida vida en en la la actividad actividad inicial de Asteroides (II). (//).

0

1.

realizar el el ejercicio ejercicio anterior, anterior, ejecuta ejecuta la la aplicación aplicación yy pulsa pulsa en en elel botón botón Tras realizar Acerca de... de .. . La música ha ha de de detenerse. detenerse.

2.

mientras parte parte de de esta esta actividad actividad esté esté visible visible (como (como ha ha Nos interesa interesa que, mientras Es decir, decir, utilizando utilizando anterior), la la música música se se escuche. escuche. Es ocurrido en el punto anterior), los eventos del ciclo de de vida, vida, queremos queremos que que cuando cuando la la actividad actividad deje deje de de estar visible el audio deje deje de de escucharse. escucharse.

3. 3.

que funciona correctamente. correctamente. Verifica que

6.1.2. Guardando el el estado estado de de una una actividad actividad 6.1.2. Guardando Cuando el usuario usuario ha ha estado estado utilizando utilizando una una actividad, actividad, yy tras tras cambiar cambiar aa otras, otras, en memoria memoria yy continúe continúesu su primera, lo lo habitual habitual es es que que esta esta permanezca permanezca en regresa a la primera, ejecución sin alteraciones. alteraciones. Como Como hemos hemos explicado, explicado, en en situaciones situaciones de de escasez escasez de de posible que el memoria, es posible el sistema sistema haya haya eliminado eliminado el el proceso proceso que que ejecutaba ejecutaba lala actividad. caso, el el proceso proceso será será ejecutado ejecutado de de nuevo, nuevo, pero pero se se habrá habrá perdido perdido actividad. En este caso, su estado, es decir, decir, se se habrá habrá perdido perdido el el valor valor de de sus sus variables variables yy elel puntero puntero de de programa. Como consecuencia, si si el el usuario usuario estaba estaba rellenando rellenando un un cuadro cuadro de detexto textooo estaba reproduciendo un audio audio en en un un punto punto determinado determinado perderá perderá esta esta información. información . En este apartado estudiaremos estudiaremos un un mecanismo mecanismo sencillo sencillo que que nos nos proporciona proporciona Android Android para resolver este este problema. problema. actividad sensible sensible aa la la inclinación inclinación del del teléfono, teléfono, es es NOTA: Cuando se ejecuta una actividad horizontal oo en en vertical, vertical, se se presenta presenta un unproblema problemasimilar similaral al decir que puede verse en horizontal anterior. La actividad es destruida destruidayy vuelta vuelta aa construir construircon con las las nuevas nuevasdimensiones dimensionesde de llama de de nuevo nuevo al al método método onCreate onCreate{). (). Antes Antes de de que que lala pantalla y, por lo tanto, se llama resultafundamental fundamentalguardar guardarsu suestado. estado. actividad sea destruida también resulta

200

Multimedia yy ciclo de vida de una una actividad actividad Dependiendo de lo sensible sensible que que sea sea la la pérdida pérdida de de la la información información de de estado estado se se podrá actuar de de diferentes diferentes maneras. maneras. Una Una posibilidad posibilidad es, es, por por ejemplo, ejemplo, no no hacer hacer nada. el ejemplo ejemplo anterior, anterior, el el usuario usuario tendría tendría que que volver volver aa rellenar rellenar elel nada. Siguiendo con el cuadro de texto o el audio audio volvería volvería aa reproducirse reproducirse desde desde el el principio. principio. En caso de tratarse de de información información extremadamente extremadamente sensible, sensible, se se recomienda recomienda elel uso del método onPauseO en Pause () para para guardar guardar el el estado estado yy onResumeí) onResume () para para recuperarlo. recuperarlo. en un un medio medía permanente, permanente, Por supuesto, la información información sensible sensible ha ha de de almacenarse almacenarse en base de de datos. datos. Se Se trata trata del del método método más más fiable, fiable, como como vimos vimos como un fichero o una base en el ciclo de vida de una una actividad, actividad, los los métodos métodos onstop onstop()() yy onDestroy onDestroy{)() no notienen tienen la garantía de ser llamados. llamados. También tenemos una una tercera tercera posibilidad posibilidad que, que, aunque aunque no no tenga tenga una una fiabilidad fiabilidad en utilizar utilizar los los siguientes siguientes dos dos sencilla. Consiste Consiste en tan grande, resulta mucho mucho más más sencilla. métodos: métodos: onSavelnstanceState(Bundle): Se invoca invoca para para permitir permitir aa lala actividad actividad onSavelnstanceState(Bundle): Se guardar su estado. estado. Ojo, si si hay hay muy muy poca poca memoria, memoria, es es posible posible que que lala actividad se destruya destruya sin llamar llamar aa este este método. método. onRestorelnstanceState(Bundle): Se invoca invoca para para recuperar recuperar elel estado estado onRestorelnstanceState(Bundle): Se onSaveinstanceState {{). i. guardado por onSavelnstanceScate

Veamos un ejemplo de de lo lo sencillo sencillo que que resulta resulta guardar guardar la la información información de de una una variable tipo cadena de de caracteres caracteres yy entero. entero. String cadena; cadena ; int pos; pos ;

©Override

í?JOverl~ide

protected void onSavelnstanceState(Bundle onSaveinstanceState(Bundle guardarEstado) guardarEstado) { super.onSaveinstanceState(guardarEstado); super.onSavelnstanceState(guardarEstado); guardarEstado .putString (" variable", var); var ) ; guardarEstado.putString("variable", guardarEstado. putint ( "posicion", pos); pos) ; guardarEstado.putlnt("posición",

} @Ove rrtde: ©Override protected void onRestorelnstanceState(Bundle onRestoreinstanceState(Bundle recEstado) recEstado) {{ super.onRestoreinstanceState(recEstado); super.onRestorelnstanceState(recEstado); var = recEstado.getString("variable"); recEstado.getString(•variable" ); pos = recEstado.getlnt("posición"); recEstado.getint(''posici.on");

} La ventaja de usar estos estos métodos métodos es es que que el el programador programador no no debe debe buscar buscar un un método de almacenamiento almacenamiento permanente, permanente, es es el el sistema sistema quien quien hará hará este este trabajo. trabajo. El El inconveniente es que el sistema sistema no no nos nos garantiza garantiza que que sean sean llamados. llamados. En En casos casos de de extrema necesidad de memoria memoria se se podría podría destruir destruir nuestro nuestro proceso proceso sin sin llamarlos. llamarlos.

0 Vf

Práctica: estado en en Asteroides. Asteroides. Práctica: Guardando el estado 201

El gran libro de Android Androíd 1.

Ejecuta el proyecto Asteroides. Asteroides.

2. 2.

Cambia de orientación el teléfono. teléfono. Observarás como la música se reinicia cada vez que lo haces. haces.

3. 3.

Utilizando los métodos para guardar el estado de una actividad, actividad, trata de teléfono, el audio continúe en el mismo punto de que cuando se voltea el teléfono, reproducción reproducción.. Puedes utilizar los siguientes métodos: métodos; iint n t pos == mp.getCurrentPosition() mp . getCurrentPos i tion();; mp . seekTo (pos ) ; mp.seekTo(pos);

4. 4.

Verifica el resultado. resultado.

f Solución: — Solución: Una posible solución al ejercicio anterior se muestra a continuación: continuación: @Over:r:·ide ®Override

protect e d void onSaveinstanceState(Bundle protected onSavelnstanceState(Bundle estadoGuardado) estadoGuardado){{ super.onSavei nstanceStat e (estado Guardado) ; super.onSavelnstanceState(estadoGuardado) if (mp != null) nuil) {{ nt pos pos= mp.getCurrentPosition() ; iint = mp.getCurrentPosition(); estad oGuardado.put i nt ( "posicion" , pos); estadoGuardado.putlnt("posición",

} } ©Override pprotected rotected void onRestorelnstanceState(Bundle onRestoreinsta nceState(Bundle estadoGuardado){ estadoGuardado) { super.onRe s toreinstanceState(estadoGu ardad o) ; super.onRestorelnstanceState(estadoGuardado); if (estadoGuardado != null nuil && mp != null) nuil) {{ int pos = estadoGuardado.getlnt("posición"); estadoGuardado . getint("posicion" ); mp. seekTo (pos); mp.seekTo(pos);

} } Para reforzar el uso de estos métodos te recomendamos el ejercicio planteado en el apartado 6.4.1 donde se pide recordar el punto de reproducción de un vídeo. vídeo.

6.2. en Android 6.2. Utilizando Utilizando multimedia multimedia en Androíd La integración de contenido multimedia en nuestras aplicaciones resulta muy sencilla gracias a la gran variedad de facilidades que nos proporciona el API. Concretamente podemos reproducir audio y vídeo desde orígenes distintos: distintos: •

202

Desde un fichero almacenado en el dispositivo. dispositivo.

Multimedia yy ciclo de vida de una actividad •

Desde un recurso que está incrustado en el paquete de la aplicación (fichero ..apk). apk) .

•

Desde un stream que es leído desde una conexión de red. red. En este punto admite dos posibles protocolos (http: 11 y rstp: 1! ) (http:// rstp://)

También resulta sencilla la grabación de audio y vídeo, vídeo, siempre que el hardware del dispositivo lo permita. permita.

En la siguiente lista se muestran las clases de Android que nos permitirán acceder a los servicios Multimedia: Multimedia: MediaPayer: MediaPayer: Reproducción de audio/vídeo desde ficheros o streams. streams. MediaControler: MediaControler: Visualiza controles estándar para mediaPiayer mediaPlayer (pausa, (pausa, stop).

VideoView: Vista que permite la reproducción de vídeo. VideoView: vídeo. SoundPool: Maneja y reproduce una colección de recursos de audio. audio. AsyncPiayer: AsyncPlayer: Reproduce listas de audios desde un thread distinto al nuestro. nuestro. MediaRecorder: MediaRecorder; Permite grabar audio y vídeo. vídeo. AudioManager: AudioManager: Gestiona varias propiedades del sistema (volumen, tonos, etc.). (volumen, tonos, AudioTrack: AudioTrack: Reproduce un búfer de audio PCM directamente por hardware. hardware. JetPiayer: JetCreator. JetPIayer: Reproduce audio y video interactivo creado con JetCreator. Camera: Cómo utilizar la cámara para tomar fotos y video. video.

FaceDetector: Identifica la cara de la gente en un bitmap. FaceDetector: La plataforma Android soporta una gran variedad de formatos, muchos de los cuales pueden ser tanto decodificados como codificados. codificados. A continuación, continuación, mostramos una tabla con los formatos multimedia soportados. soportados. No obstante, obstante, algunos modelos de móviles pueden soportar formatos adicionales que no se incluyen en la tabla, tabla, como por ejemplo DivX. DivX. Cada desarrollador es libre de usar los formatos incluidos en el núcleo del sistema o aquellos que solo se incluyen en algunos dispositivos. Tipo

Audio

Formato

Codifica

Decodific a

AAC LC/LTP

X

X

HE-AACv1 (AAC+)

X

HE-AACv2 (enhanced AAC+)

X

AMR-NB

X

X

Detalles

Fichero soportado

Mono/estéreo con cualquier combinación estándar de frecuencias por encima de 160 Kbps y ratios de muestreo de 8 a 48kHz

3GPP ((,. 3gp) MPEG-4 ((.mp4) . mp4 ) No soporta raw AAC ((..aac) aac)

4.75 a 12.2 12,2 Kbps muestreada a @ 8kHz

3GPP ((.. 3gp)

203

El gran libro de Android Tipo

Formato

Codifica

Detalles

Fichero soportado

X

9 ratios de 6.60 Kbps Kbps aa 23.85 Kbps 3GPP ((.. 3gp) muestreada maestreada a @ @ 16kHz

X

Mono/estéreo de 88 aa frecuencia 320 Kbps, frecuencia MP3 ((.. mp3 mp3)) de muestreo constante (CBR) o variable (VBR) (VBR)

MIDI MI DI

X

MIDI 0 y 1. 1. DLS DLS v1 v1 MI DI tipo O y v2. XMF y XMF móvil. Soporte para para tonos de llamada RTTTL 1/ RTX, OT A yy OTA iMelody. ¡Melody.

Ogg Vorbis

X

FLAG FLAC

a partir 3.1 3.1

PCMIWAVE PCM/WAVE

AMR-WB

X

MP3

X

JPEG GIF

Imagen

Decodífic Decodific a

X

PNG BMP WEBP

Tipo O . mid, 0 y 11 ((.mid, ,xmf, .mxmf .rnxmf). .xmf, ). RTTTL/RTX RTTTL 1 RTX ((.rtttl, .rtttl, .. rtx}, rtx), OTA ((.ota) . ota) iMelody ((.. imy) Ogg ((.. ogg) Matroska ((.. mkv mkv a partir 44.0) .0)

mono/estereo (no (no multicanal) multícanal)

FLAC ( .flac) FLAC(.flac)

X

8 y 16 bits PCM lineal lineal (frecuencias limitadas limitadas por el hardware)

WAVE ( .wav) WAVE(.wav)

X

Base + progresivo

JPEG ( . jpg) JPEG(.jpg)

X

GIF ((.gif) .gH )

X

PNG ( . png) PNG(.png)

X

BMP ((,bmp) . bmp)

a partir 4.0 a partir 4.0

H.263

X

X

H.264 AVC H.264AVC

a partir 3.0

X

WebP ((.. webp) 3GPP ((.3gp) . 3gp ) MPEG-4 ((.mp4) . rnp4 ) Baseline Profile (BP) (BP)

3GPP ((.. 3gp) 3gp) MPEG-4 ((.mp4) . mp4 )

Video MPEG-4 SP WP8 WPS

3GPP ((.. 3gp)

X a partir 2.3.3

Streaming a partir 4.0 4.0

Tabla 1: Formatos multimedia multimedia soportados soportados en enAndroid. Android.

204

WebM ((.. webm) Matroska ((.. rnkv mkv a partir 4.0)

-

- - - - - · - - - -- -- - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - -- - - - - - -

Multimedia yy ciclo de vida de una actividad

6.3. vista VideoVíew VideoView 6.3. La La vista La forma más fácil de incluir un vídeo en tu aplicación es incluir incluir una una vista vista de de tipo tipo Videovie-.;. siguiente ejercicio. videoview. Veamos cómo hacerlo en el siguiente

Ejercicio paso a paso: Reproducir un vídeo con VideoView. 1.

siguientes datos: datos: Crea una nueva aplicación con los siguientes Project ñame: name: videoView Build Target: Android 1.5 1.5 Application ñame; name: videoView Package ñame: name: org.example.videoview org. example. videoviev,r Create Activity: videoView

2.

Remplaza el fichero ref/layout/main.xmi ref/layout/main.xml por: por:

> > 3.

Remplaza el siguiente código en la clase videoview: videoview: public class videoView extends Activity { prívate VideoView mVideoView; private

©Override public void onCreate(Bundle savedlnstanceState) savedinstanceState) {

super .onCreat.e(savedinstanceState) ; super.onCreate(savedlnstanceState); setContentView (R . layout .main) ; setContentView(R.layout.main); mVideoView =(VideoView)findViewByldíR.id.surface_view); = (VideoView) findViewByld (H.. id. surface_ v·iew) ; //de forma altemative 1 /de for:ma alternative si queremos cruer·emos un streaming usar usar 1 /mVideoView . setVideoú"RI (Uri. parse (URLstring) ) ; //mVideoView.setVideoüRI(Uri.pareeÍDRLstring))¡ mVideoView.setVideoPath("/data/video.mp4"); mVideoView . setVideoPath( " /data/video.mp4 "); mVideoView.start() mVideoView.start();¡ mVideoView.request.Focus(); mVideoView.reouestFocus{);

} } 4.

( l estamos indicando indicando un un fichero fichero local. local. En el método setvideoPath ()

205

El gran libro de Android 5. 5.

Busca un fichero de vídeo en codificación mp4. mp4. Renombra Renombra este este fichero fichero aa video.mp4. video. mp4.

6.

vídeo en en el el simulador. simulador. Para Para ello, ello, Es necesario almacenar un fichero de vídeo utiliza la opción del menú Window > Show Show View >Others... >Others ... >> Android Android >> File Explorer. Te mostrará el sistema de ficheros del del emulador. emulador.

íl Probt [ §3 Cora [ a LogC 1 p Emul D Prope | Q FHeE ¡Z 1 i Mame íM? data ^ sdcard system

B Devic ^ □ ü € 1 -Z l

í.-MSsSí

y¡

7. 7.

el botón botón donde donde aparece aparece un un teléfono teléfono con con Selecciona la carpeta data y utiliza el una flecha para almacenar un un nuevo fichero. Indica Indica el el fichero fichero vldeo.mp4. video.mp4.

8. 8.

Ejecuta la aplicación yy observa el resultado. resultado. Recuerda Recuerda que que con con Ctrl-F11 Ctri-F11 puedes cambiar la orientación. orientación. Si no no funciona, funciona, trata de de usar usar otro otro tipo tipo de de emulador. emulador.

7.14 AM

i ' IPT i. < ¡té

9. 9.

el vídeo vídeo aparezca aparezca centrado centrado yy ocupe ocupe toda toda Modifica el fichero xml para que el la pantalla del teléfono, tal y como se muestra muestra en en la la imagen imagen de de arriba. arriba.

al método método start start (>: ( ¡: 10. de la llamada llamada al 10. Añade la siguiente línea antes de mV.ideoV. i ew . setMediaController set r<:~ediaCon.t.rol J er (new MediaController Me di aContro ll er (this) (thi s)); ttiVideoView. );

De esta forma permitimos que el usuario usuario pueda pueda controlar la la reproducción reproducción del vídeo mediante el objeto MediaController. t.f;edi.aCont.roJ.le r . 11. Observa el resultado.

206

Multimedia y ciclo de vida de una una actividad actividad

6.4. 6.4. La La clase clase MediaPiayer MediaPlayer La reproducción multimedia en Android Android se se lleva lleva aa cabo cabo principalmente principalmente por por medio medio de de la clase MediaPlayer. Veremos, a continuación, continuación, las las características características más más importantes importantes de esta clase y cómo podemos sacarle provecho. provecho. Un objeto MediaPlayer va aa poder poder pasar pasar por por gran gran variedad variedad de de estados: estados; inicializados sus recursos (initialized), (initialized), preparando preparando la la reproducción reproducción (preparing), (preparing), preparado para reproducir (prepared), (preparad), reproduciendo reproduciendo (started), (started), en en pausa pausa (paused), (paused), parado (stoped), reproducción completada completada (playback (playback completed), completed), finalizado finalizado (end) (end) yy con error (error) (error).. Resulta importante importante conocer conocer en en qué qué estado estado se se encuentra encuentra dado dado que que muchos de los métodos solo pueden pueden ser ser llamados llamados desde desde ciertos ciertos estados. estados. Por Por ejemplo, no podremos ponerlo ponerlo en reproducción reproducción (método (método start starto) sino está está en en ( l ) sino estado preparado. O no no podremos podremos ponerlo ponerlo en en pausa pausa (pause (pause ()()), si está está parado. parado. Si Si ), si llamamos a un método no admitido admitido para para un un determinado determinado estado estado se se producirá producirá un un error de ejecución. La siguiente tabla permite conocer los los métodos métodos que que podemos podemos invocar invocar desde desde cada uno de los estados y cuál es es el el nuevo nuevo estado estado al al que que iremos iremos tras tras invocarlo. invocarlo. Existen dos tipos de métodos, los los que que no no están están subrayados subrayados representan representan métodos métodos llamados de forma síncrona desde nuestro nuestro código, código, mientras mientras que que los los que que están están subrayados representan métodos métodos llamados llamados de de forma forma asíncrona asincrona por por el el sistema. sistema.

Estado salida

Id le

lnitialized Initialized

setDataSource setDataSource

Estado entrada lnitialized Initialized

Preparing

prepareAsinc prepare Asme

Prepared

prepare

Preparing

Prepared Prepared

Started

Paused

Stoped

prepareAsinc prepareAsmc onPregared onPrepared

Started

seekTo seekTo start

Paused Stoped

stop

Playback Completed

prepare seekTo start

start

pause

seekTo pause

stop

stop

start

stop

onComgletion onComoletion

End Error

Playback Completed

stop seekTo

Release

release

release

release

release

release

release

release

onError

onError

onError

onError

onError

onError

onError

onError

de la la clase clase MediaPiayer. MediaPlayer. Tabla 2: Transiciones entre estados de

6.4.1. Reproducción de audio audío con con MediaPiayer MediaPlayer se va aa reproducir reproducir siempre siempre en en nuestra nuestra aplicación aplicación resulta resulta Si el audio o vídeo se interesante incluirlo en el paquete paquete .. apk apk yy tratarlo tratarlo como como un un recurso. recurso. Este Este uso uso ya ya ha ha sido ilustrado al comienzo del capítulo. capítulo. Recordemos Recordemos como como se se hacía: hacía: 1.

Crea una nueva carpeta con con nombre nombre raw raw dentro dentro de de la la carpeta carpeta res. res.

207

El gran libro de Android 2.

audio. Por ejemplo audio.mp3. audio.mp3. Arrastra a su interior el fichero de audio.

3.

Añade las siguientes líneas de código: código: MediaPlayer mp rnp = 1-'lediaPlayer. c.reat:e( this , R.raw,audio); R.r-aw.audio ) ; MediaPlayer.crea te(this, mp . s tart ( ) ; mp.start();

Si deseas parar la reproducción tendrás que utilizar el método stop{). stop (). Si, Si, a luego, start (). continuación, quieres volver a reproducirlo utiliza el método prepare () y, y, luego, \). reanudarlo. También puedes usar pause () y start {; () para ponerlo en pausa y reanudarlo. Si en lugar de un recurso prefieres reproducirlo desde un fichero utiliza el siguiente ( l . En el caso código. código. Observa cómo en este caso es necesario llamar al método prepare {). reate (). () . anterior no ha sido necesario dado que esta llamada se hace desde ecreate MeciiaPlayer rnp == new MediaPlayer{); fV1edi aPlayer () ; MediaPlayer mp rnp. setDataSource (C.ll,MINO AL FICHERO); mp.setDataSource(CAMINO mp.prepare(i;

mp.start.(); mp.start{) ;

6.5. Un Un reproductor reproductor multimedia multimedia paso paso a paso 6.5. a paso En el siguiente ejercicio vamos a profundizar en el objeto MediaP/ayer MediaPlayer por medio de ejemplo, donde trataremos de realizar un reproductor de vídeos personalizado. un ejemplo, personalizado.

Ejerc icio paso a paso: Un reproductor multimedia paso a paso. Ejercicio paso. 1. 1.

Crea una nueva aplicación con los siguientes datos: datos: Project ñame: name: VideoPlayer Build Target: Google APIs APis 1.5 BulId Target; Appli ca tion name Application ñame:: VideoPlayer Package name : org.example.videoplayer org .example.v ideopl ayer Package ñame: Create Activity: Ac tivity: VideoPlayer Min SDK Versión: Version: 3

2.

En la carpeta res/drawable res/drm.;able arrastra los cuatro ficheros de iconos: iconos: play . jpe9, pause, pause . jpeg, reset jpeg y stop.jpeg. stop_ jpeg. Los puedes encontrar play.jpeg, reset.. jpegy en www.androidcurso.com. www androidcurso.com.

3.

Remplaza el fichero resllayoutlmain. xml por: res/layout/maín.xml por:

"1.O" encoding="utf-8"?> android:orientation="horizontal"> 11

1

208

Multimedia y y ciclo de vida de una actividad <

android:layout_alignFarentTop="true"> android:src="@drawable/play"/> android: src= ~~ t~dravlable/pause /> android:src="@drawahle/log"/> android: text= "/d.ata/vj_d.eo . 3Qp "1 > <"'\.T.ideoVi.ew android: id= @+.id/surfaceVi.ehr '' android:layout_below="@h id/ButonsLayout"/> android:layout_alignParentBottom= ""true"> android:text="Log:"/> 11

u

11

1

continuación: La apariencia del Layout anterior se muestra a continuación:

209

El gran libro de Android Androld m 10:00 AM

I

s

I /data/video.mp4

>r.

4.

Remplaza el código de la clase Vi d eoPlayer por: por: videoPlayer ppublic u b l ic class VideoPlayer extends e xte nds Activity implements imple men ta OnBufferingUpdateListener, OnCompletionListener, Med i aPlayer.OnPreparedListener, SurfaceHolder.Callback MediaPlayer.OnPreparedListener, pri vate MediaPlayer mediaPlayer; me d iaPlaye r ; prívate pprívate rivate SurfaceView surfaceView; surfaceView ; private sur f a c e Holder ; prívate SurfaceHolder surfaceHolder; private e d itText ; prívate EditText editText; private Irnage Button bPlay, bPlay , bbPause, Pa u se , bstop, bStop , bLog; bLog ; prívate ImageButton pprívate r i va t e TextView llogTextView; o gTe x t View ; a us e ; pprívate r ivate boolean ppause; pprívate rivate String path; p at h; pprívate rivate int i nt savePos = = 0; O; public void vo i d oonCreate(Bundle nCreate(Bundle bbundle) undle ) { ssuper.onCreate(bundle); u per .onCre ate(bundle ); setContentView (R .layout. n
2100 21

{

Multimedia yy ciclo de de vida vida de de una una actividad actividad if (mediaPlayer != != nuil) null) {{ iif f (pause) {{ mediaPlayer.start(); } else {{ playVideo(); playVideoO ;

} } }} }}); ) ; bPause = (ImageButton) findViewByld(R.id.pause); findViewByid(R.id. pause); bPause.setOnClickListener( new OnClickListener() OnClickListener() { bPause.setOnClickListener(new public void onClick(View onClick(View view) view) { iif f (mediaPlayer != ! = nuil) null) { pause == true; mediaPlayer.pause(); mediaPlayer.pause();

} }}

}}); ) ; bStop = (ImageButton) findViewById(R.id.stop); findViewByid(R.id. scop); bStop.setOnClickListener(new OnClickListener() { bStop.setOnClickListener(new OnClickListener() public void onClick(View onClick(View view) view) {{ iif f (mediaPlayer != != nuil) nuJ.l) { pause = false; mediaPlayer.stop(); mediaPlayer.stop();

} }} ) ; }}); findViewByid (R. id. logEutton ); bLog == (ImageButton) findViewById(R.id.locrButton); bLog.setOnClickListener(new OnClickListener() {{ bLog.setOnClickListener(new OnClickListener() pu.blic onClick(View view) view) {{ public void onClick(View iiff (logTextView.getVisibility()==TextView. ( logTextView. getVisibili ty () ==TextView. V'XSJñLE) VISIBLE) { logTextView. setVisibility (TextView. _INVT8IBLE) ; logTextView.setVisibility(TextView.INVISIBLE); e lse {{ } else logTextView.setVisibility(TextView. VISIBLE); logTextView.setvisibility(TextView. VISIBLE); } }} }})) i; log( log("") ; 11 " ) ;

} 5.

puedes ver, ver, la la aplicación aplicación extiende extiende lala clase clase Activity. Act ivi ty. Además, Además, Como puedes implementamos cuatro interfaces interfaces que que corresponden corresponden aa varios varios escuchadores escuchadoresde de eventos. Luego continúa continúa la la declaración declaración de de variables. variables. Las Las primeras primeras corresponden a diferentes diferentes elementos elementos de de la la aplicación aplicación yy su su significado significado resulta resulta obvio. pause nos nos indica indica sisi el el usuario usuario ha ha pulsado pulsado elel botón botón obvio. La variable pause correspondiente, la variable variable path path nos nos indica indica dónde dónde está está elel vídeo vídeo en en reproducción yy la variable variable savePos savePos almacena almacena la la posición posición de dereproducción. reproducción.

211

El gran libro de Android 6.

Añade: Añade: pprívate riva t e void playVideo playVideo í) () ttry ry {{ pause -~ false; f a lse ;

{

path == editText.getText{),toString(); editText.getText ( ) .toString(); mediaPlayer MediaPlayer(); medíaPlayer == new MediaPlayer{); mediaPl ayer.setDataSource(path); mediaPlayer.setDataSource ípath); mediaPl ayer.setDisplay(surfaceHolder); medíaPlayer.setDisplay(surfaceHolder); mediaPl ayer.prepare() ; mediaPlayer.prepare();

!/// mMediaPlayer.prepareAsync{); mMediaPlayer. prepareJ\ sync () ; Para Para atrsaming str.::aming mediaPlayer.setOnBufferingUpdateListener( thi s ); mediaPlayer.setOnBufferingUpdateListener(this); mediaPlayer. setoncompletionLü;tener ( this ); mediaPlayer.setOriCompletionListeneríthis); mediaPlayer.setOnPreparedListenerl t his ); mediaPlayer.setOnPreparedListener(this);

}

mediaPlayer.seCAudioStreamType(AudioManager.STREAM,JÍUSIC); mediaPlayer . setAudioSt.reamType (AudioManager. S'I'REAM...HUSIC) ; mediaPlayer . seekTo(savePos); mediaPlayer.seekTo(savePos); ccatch atc h (Sxception (Exception e) e) {{ log(''ERR.OR: e.get.Message(i); logC'ERROR: "" + e.getMessage {) ) ;

} } 7.

continúa con con la la definición definición del del método métodoplayvideo playvideo(). () . Este Este método método El código continúa un nuevo nuevo objeto objeto se encarga de obtener obtener la la ruta ruta de de reproducción, reproducción , crear crear un r>lediaPlayer, se le le asigna asigna la la ruta ruta yy la la superficie superficie de de visualización, visualización,aa MediaPlayer, luego se continuación, se prepara En caso caso de de querer querer continuación, prepara la la reproducción reproducción del del vídeo. vídeo. En reproducir un stream desde desde la la red, red, esta esta función función puede puede tardar tardar bastante bastante tiempo, en tal caso es tiempo, es recomendable recomendable utilizar utilizar en en su su lugar lugar elel método método prepareAsync () ( l que que permite permite continuar continuar con con la la ejecución ejecución del del programa, programa, aunque sin esperar esperar aa que que el el vídeo vídeo esté esté preparado. preparado. Las Las siguientes siguientes tres tres de eventos eventos que que serán serán líneas asignan a nuestro nuestro objeto objeto varios varios escuchadores escuchadores de descritos más adelante. adelante. Tras Tras preparar preparar el el tipo tipo de de audio, audio, se se sitúa sitúa lala posición posición de reproducción a los milisegundos milisegundos indicados indicados en en la la variable variable savePos. savePos. Si Si se se trata de una nueva reproducción, reproducción, esta esta variable variable será será cero. cero.

8.

código: Añade el código: ppublic ublic void vo i d onBufferingüpdate(MediaPlayer onBufferingUpdat. e (MediaPlayer argO, argO, int i nt percent) percent)

{{ log ( " onBufferingUpdat.e percent:" percent:" ++ percent); percent) ; log("onBufferingüpdate

} public void onCompletion(MediaPlayer onCompl.etion (!'1edi.aPi.aye r argO) argO) log ( "onCompl.et.ion called"); c all.ed " ) ; loq("onCorapletion

{

} 9.

métodos anteriores anteriores implementan implementan los los interfaces interfaces onBufferingüpdate onBufferingupdate Los métodos Listener y Oncompletionhistener. oncompletionListener. El El primero primero irá irá mostrando mostrandoelel porcentaje porcentajede de el segundo segundo será será invocado invocado obtención de búfer de reproducción reproducción, mientras mientras que que el cuando el vídeo en reproducción reproducción llegue llegue al al final. final.

212

Multimedia yy ciclo de vida de una actividad 1 O. Añade el código: 10. código: _

public void onPrepax onPrepared ed (J:.1ediaPlayer (MediaPlayer mediaplaye:r) mediaplayer) { log("onPrepared called"); int mVideoVíidth mVideovlidth == mediaPXayer. mediaPlayer. getVideoWidth í) () ;,int mVideoHeight = = mediaPlayer.getVideoHeight(}; mediaPlayer.getVideoHeight( ) ; iif f (mVideoWidth != &.& mVideoHeight !" O) {{ !■- 0o && != 0) surfaceHolder.setFixedSize(mVideoWidth, mVideoHeight); mVideoHeight ); surfaceHolder.setFixedSize(raVideoWidth, mediaPlayer.start(); mediaPlayer.start{);

} } 11. El método anterior implementa la interfaz onPreperedListener. OnPreperedListener. Es invocado una vez que el vídeo ya está preparado para su reproducción reproducción.. En este momento podemos conocer el alto y el ancho del vídeo y ponerlo en reproducción. 12. Añade el código: código: public void surfaceCreated(SurfaceHolder sux-faceCreated{SurfaceHolder holder) log("surfaceCreated called"l; called"); pplayVideo{i; layVideo();

{{

} public void surfaceChanged(SurfaceHolder surfaceholder, int i, int j, int k) log("surfaceChanged called");

{{

} public void surfaceDestroyed(SurfaceHolder surfaceholder) log("surfaceDestroyed log{"surfaceDestroyed called");

{{

} 13. Los métodos anteriores implementan la interfaz surfaceHolder.Caiiback. surfaceHolder. Callback. Se invocarán cuando nuestra superficie de cree, cambie o se destruya. Los métodos que siguen visualización se cree, actividad: corresponden a acciones del ciclo de vida de una actividad: 14. Añade el código: ®Override SOverx'ide protected void onDestroy() onDestroyO super.onDestroy(); if (mediaPlayer !!== null) nuil) {{ mediaPlayer.release(); mediaPlayer.release() ; mediaPlayer = = nuil; null;

{

} }

15. Este método se invoca cuando la actividad va a ser destruida. destruida. Dado que recursos, resulta un objeto de la clase MediaPlayer consume muchos recursos, interesante liberarlos lo antes posible. posible.

213

El gran libro de Android 16. Añade el código: código: @Override p ublic void onPauseO o n Pause() {{ ®Override public ssuper.onPause(); uper . onPau se(); if (mediaPlayer != nuil n ull & & !pause) ¡pause) mediaPlayer. pause(); mediaPlayer.pause();

{

} } @Override p ublic void onResu me() {{ SOverride public onResume() super . onResume(); super.onResume(); if (mediaPlayer != nnuil u ll & & !pause ¡pause)) { mediaPlayer.start();

} } 17. 17. Los dos métodos anteriores se invocan cuando la actividad pasa a un segundo plano y cuando vuelve a primer plano. plano. Dado que queremos que el vídeo deje de reproducirse y continúe reproduciéndose en cada uno de estos casos, se invocan a los métodos pause {) () y start (), í) , respectivamente. respectivamente. No hay que confundir esta acción con la variable pause que lo que indica es que correspondiente. el usuario ha pulsado el botón correspondiente. 18. Añade el código: código: @Ove:n:·ide ©Override

pprotected rotected void v o id onSaveinstanceState(Bundle onSavelnstanceState(Bundle guardarEstado) super.onSaveinstanceState(guardarEstado) super.onSavelnstanceState(guardarEstado);; if (mediaPlayer !!== null) nuil) {{ iint nt pos = mediaPlayer.getCurrentPosition() mediaPlayer .getCu rrentPos ition();; gguardarEstado.putString("ruta", u a rdarEst ado.pu tStri n g (" ruta" , path); path) ; guardarEstado. putlnt ( •posicion H, pos); pos) ; guardarEstado.putlnt("posición",

{

} } ©Override protected void onRestoreinstanceState(Bundle onRestorelnstanceState(Bundle recEstado) sup er.on RestoreinstanceState (recEstado); super.onRestorelnstanceState(recEstado); iiff (recEstado != nuil) null) {{ path = recEstado.getString("ruta"); recEstado. getStrin g ( " rut.a" ) ; savePos = recEstado.getlnt("posición"); recEstado.getint("posicion" );

{{

} } 19. Cuando este sistema necesita memoria, memoria, puede decidir eliminar nuestra actividad. onsaveinstancestate para actividad. Antes de hacerlo llamará al método onSavelnstanceState darnos la oportunidad de guardar información nformación sensible. sensible. Si, Si, más adelante, adelante, el usuario vuelve a la aplicación, aplicación, esta se volverá a cargar, cargar, invocándose el método onRestorelnstanceState, onRestoreinstanceState, donde podremos restaurar el estado perdido. perdido. En nuestro caso la información a guardar son las variables path y

214

Multimedia y ciclo de vida de una actividad savePos savePos,, que representan reproduciendo. reproduciendo.

el

vídeo y

la posición que estamos

20. Ocurre el mismo proceso cuando el usuario cambia la posición del teléfono. Es decir, cuando el teléfono se voltea las actividades son destruidas y vueltas a crear, por lo que también se invocan estos métodos. 21 21.. Añade el código: private t ri n g s) {{ prívate void log(S logíStríng lXogTextView.appendis ogTe x tV i ew.append(s + "\n " ); "\n");

22. El último método es utilizado por varios escuchadores de eventos para mostrar información sobre lo que está pasando. Esta información puede visualizarse o no, utilizando el botón correspondiente. correspondiente.

6.6. 6.6. Introduciendo Introduciendo efectos efectos de de audio audio con con SoundPool SoundPool Hemos aprendido a utilizar la clase rvlediaPlayer MediaPlayer para reproducir audio y vídeo. En un primer ejercicio vamos a aprender como introducir efectos de audio en Asteroides. Como veremos esta clase no resulta adecuada para este uso. A SoundPool y se mostrará, mediante un continuación, se introducirá la clase soundPooJ. ejercicio, cómo esta sí que resulta eficiente para nuestro juego.

i gjP

Ejercicio paso a paso: Introduciendo efectos de audio con MediaPlayer en Asteroides. Asteroides. MediaP/ayer

1.

Abre el proyecto Asteroides.

2.

Copia los siguientes ficheros a la carpeta reslraw. res/raw. disparo.mp3 disparo.moS y explosion.mp3. explosión.mp3.

3.

Abre la clase vistaJuego y añade las siguientes variables: MediaPlayer mpDisparo, n1pExplosion; mpExplosion;

4.

En el constructor de la clase inicialízalas de la siguiente forma:

R.raw.disparo! mpDisparo == MediaPlayer.create(context, t-lediaPlayer.create(context, R . raw.disparo);; R.raw.explosión); mpExplosion = = MediaPlayer.createícontext, MediaPlayer . create(context, R.raw.explosion); 6. 5.

ActivaMis.il vistaJuego! Añade en el método Act ivar4:i.si1 () de Vist.aJuego: mpD i sparo.start ();; mpDisparo.start()

6.

Añade en el método dest.ruyeAst.eroide destruyeAsteroide () () de Vista,Juego: VistaJuego!

mpExplos ion .start(};; mpExplosion.start() 7.

Ejecuta el programa y verifica el resultado. ¿Qué pasa cuando disparamos o destruimos un asteroide? ¿El sonido se oye de forma inmediata?

215

El gran libro de Android La clase soundPooi soundPool maneja y reproduce de de forma forma rápida rápida recursos recursos de de audio audio en en las aplicaciones. aplicaciones. Un soundPool sound Pool es una colección de de pistas de de audio audio que que se se pueden pueden cargar cargar en en la la memoria desde un recurso (dentro de de la APK) APK) oo desde desde el el sistema sistema de de archivos. archivos. soundPool ~1ediaPlayer para para decodificar decodificar el el audio audio en en SoundPool utiliza el servicio de la clase MediaPlayer un formato crudo (PCM de16 bits), bits), lo que después después permite reproducirlo reproducirlo rápidamente rápidamente decodificarlas cada cada vez. vez. por el hardware sin tener que decodificarlas Los sonidos pueden repetirse en un bucle b ele una una cantidad establecida establecida de de veces, veces, definiendo el valor al reproducirlo, reproducirlo, o dejarse dejarse reproduciendo en en un un bucle bucle infinito infinito con con -caso, será necesario detenerlo con con el método método stop stop {). (). 1. 1. En este caso, La velocidad de reproducción también se puede puede cambiar. cambiar. El El rango rango de de velocidad velocidad 1.0 hace hace que que el el de reproducción reproducción va de 0.5 a 2.0. 2.0. Una Una tasa de de reproducción reproducción de de 1,0 original. Una Una tasa tasa de de reproducción reproducción de de 2.0 2.0 sonido se reproduzca en su frecuencia original. hace que el sonido se reproduzca al doble de de su su frecuencia frecuencia original, original, yy una una tasa tasa de de la mitad mitad de de su su frecuencia frecuencia original. original. reproducción de 0.5 hace que se reproduzca a la sound Pool hay que establecer establecer en en un un parámetro parámetro el el máximo máximo Cuando se crea un SoundPool de pistas que se pueden reproducir simultáneamente. simultáneamente. Este Este parámetro parámetro no no tiene tiene por por qué coincidir con el número de pistas pistas cargadas. cargadas. Cuando Cuando se se pone pone una una pista pista en en play (; ) hay que indicar indicar una una prioridad. prioridad. Esta Esta prioridad prioridad se se reproducción (método playO) número de de reproducciones reproducciones activas activas exceda exceda utiliza para decidir qué se hará cuando el número En este este caso, caso, se se detendrá detendrá el el flujo flujo con con el valor máximo establecido en el constructor. En la prioridad más baja, y en caso de que que haya varios, varios, se se detendrá detendrá el el más más antiguo. antiguo. En En caso de que el nuevo flujo sea el de de menor prioridad, prioridad , este este no no se se reproducirá. reproducirá.

Una lista de todos los métodos métodos de esta esta clase clase la la puedes puedes encontrar encontrar en: en: http://developer.android.com/reference/android/media/SoundPool.html http :1/developer. and ro id.com/reference/and raid/m edia/Sou nd Pool.htm 1

Ejercicio paso a paso; paso: Introduciendo efectos efectos de audio audio con con SoundPool en Asteroides. SoundPoo/ Asteroides. 1.

El proyecto Asteroides elimina todo el el código código introducido introducido aa partir partir del del punto punto 3, anterior. 3, del ejercicio anterior.

2.

vistaJuego y añade las las siguientes variables: variables: Abre la clase vistajuego

// lili /1// MULTIMEDIA lililí //!/// SoundPool soundPool; SoundPool soundPool ; int idDisparo idExplosion ; idDisparo,, idExplosion;

3.

En el constructor de la clase inicialízalas inicialízalas de de la la siguiente siguiente forma: forma: ssoundPool oundPoo l =~ nnew e w SoundPool SoundPool. ( 5, AnáioHanaíger. Aud.iol>1anager . STREAM,._MUSIC STRE.iiN....MUS.T.C ,, 0) 0);; iidDisparo d Disparo == soundPool.load{context, soundPool.load(co ntext, R.raw.disparo, 0); O); iidExplosion d Explosion == soundPool.load(context, soundPool.load(context, R.raw.explosión, R.raw.explosion, 0); O);

4.

216

En el constructor de SoundPool hay que que indicar indicar tres tres parámetros. parámetros. El El primero primero simultáneas. El El segundo segundo es es el el tipo tipo corresponde al máximo de reproducciones simultáneas.

Multimedia y ciclo de vida de una una actividad actividad de stream de audio (normalmente STREJI.l'·1_Musrc) stream musio).. El El tercero tercero es es la la calidad calidad de de reproducción, aunque actualmente no se implementa. implementa, 5. 6.

Cada una de las pistas ha ( ¡. ha de de ser ser cargada cargada mediante mediante el el método método load ioad(). Existen muchas sobrecargas para este método. método. La La versión versión utilizada utilizada en en el el ejemplo permite cargar las pistas pistas desde desde los los recursos. recursos. El El último último parámetro parámetro corresponde a la prioridad, aunque aunque actualmente actualmente no no tiene tiene ninguna ninguna utilidad. utilidad.

6.

Añade en el método l;ctivaMisil ActivaMisii () () de de VistaJuego: vis ta Juego: soundPool.play(idDisparo, l, 1, l, 1, 11,, O, 0, l); 1);

7.

El método play ( l permite playO permite reproducir reproducir una una pista. pista. Hay Hay que que indicarle indicarle elel identificador de pista; el volumen volumen para para el el canal canal izquierdo izquierdo yy derecho derecho (0.0 (0.0 aa 1.0); La prioridad; El número de repeticiones =siempre, O=solo repeticiones (-1 (-1=siempre, 0=solo una una vez, vez, ...)) y el el ratio ratio de de reproducción, reproducción, con con el el que que podremos podremos 11=repetir =repetir una vez, ... (1.0 reproducción normal, normal, rango: rango: 0.5 0.5 aa 2.0). 2.0). modificar la velocidad o pitch (1 .0 reproducción

8.

Añade en el método destruyeAsteroide destruyeAsteroide (()i de de VistaJuego: VistaJuego; soundPool.play(idExplosion, 1, 1, l, 1, O, 0, O, 0, 1); 1) ;

9.

Los parámetros utilizados para para la la explosión explosión son son similares, similares, solo solo hemos hemos menor. La La consecuencia consecuencia será será que que sisi ya ya hay hay un un introducido una prioridad menor. constructor) reproduciéndose reproduciéndose yy se se pide pide lala total de 5 pistas (ver constructor) reproducción de un nuevo disparo, el el sistema sistema detendrá detendrá la la reproducción reproducción de de la explosión más antigua, por por tener tener esta esta menos menos prioridad. prioridad.

el resultado. resultado. ¿Qué ¿Qué pasa pasa cuando cuando disparamos disparamos 10. Ejecuta el programa y verifica el ¿El sonido sonido se se oye oye de de forma forma inmediata? inmediata? o destruimos un asteroide? ¿El los parámetros parámetros del del método método play playO verifica elel ( l yy verifica 11. Modifica algunos de los resultado.

6.7. 6. 7. Grabación de audio APIs de Android disponen de de facilidades facilidades para para capturar capturar audio audio yy video, video, Las APis diferentes formatos. formatos. La La clase clase MediaReco:nier MediaRecorder te te permitiendo su codificación en diferentes esta funcionalidad funcionalidad en en tu tu aplicación. aplicación. permitirá de forma sencilla integrar esta disponen de de micrófono micrófono para para capturar capturar audio, audio, sin sin La mayoría de los dispositivos disponen sido integrada integrada en en el el emulador. emulador. Por Por lolo tanto, tanto, deberás deberás embargo esta facilidad no ha sido probar los ejercicios de este apartado apartado en en un un dispositivo dispositivo real. real. MediaRecorder dispone de de una una serie serie de de métodos métodos que que podrás podrás utilizar utilizar La clase t
constantes como como DEFuur, defult, CAI'•ICORDER, camcorder, También se pueden utilizar otras constantes VOICE .._CALL, VOICE_COMUNICATION, . .. VOICE__CALL, VOICE_COMlXNI CATION,...

setoutputFile (String (string fichero) fichero) -Nombre - Nombre del del fichero fichero de de salida. salida.

217

El gran libro de Android setOutputFormat (in (intt output output ___torma) forma) -- Formato del del fichero fichero de de salida. salida. Se Se pueden utilizar constantes de la clase MediaRecorder-. MediaRecorder. outputFormat: outputFormat; DEFl•ULT, DSFAÜLT, .1\.MRNB, AMR KB, liJ
setAudioCharmels setAudioChanneia (int (iat

((int int bbitRate) i tRate) (desde nivel nivel de de API API 8) 8) — Especificamos los bits por segundo (bps) a utilizar en en la codificación.

setAudioEncodingBitRate

setAudioSamplingRar.e {int setAudioSamplingRate (int samplj.ngRate) samplingRate) (desde nivel nivel de de API API 8) 8) — Especificamos el número de muestras por segundo segundo aa utilizar utilizar en en la la codificación. codificación. (int max_duration_ms) maxdurationms) (desde nivel nivel de de API API 3) 3) — Indicamos una duración máxima para la grabación. Tras Tras este tiempo tiempo se se detendrá.

set.MaxDurat:ion setMaxDuracion

setMaxFileSize (long max __filesize. filesize ___bytes) bytes) (desde (desde nivel nivel de de API API 3) 3) -Indicamos un tamaño máximo para el fichero. Al alcanzar alcanzar el el tamaño tamaño se se detendrá. prepar·e prepare () -- Prepara la grabación para la captura de de datos. datos. Antes de de llamarlo llamarlo

hay que configurar la grabación y después ya podemos podemos invocar invocar al al método start (l. o. st.art start () -- Comienza la captura. stop (()l -- Finaliza la captura. stop re se t. (Ol -- Reinicia el objeto como si lo reset lo acabáramos de de crear. Hay Hay que que volver volver a configurarlo. configurarlo. release () reiease O -- Libera todos los recursos utilizados utilizados de de forma forma inmediata. inmediata. Si Si no no llamas al método se liberarán cuando el objeto sea destruido. destruido. ~1ediaRecorder también dispone de métodos La clase MediaRecorder métodos que que podrás podrás utilizar utilizar para para configurar la grabación de video. Más información en: http://developer.android.com/ http://deveioper.android.com/ reference/android/media/MediaRecorder. reference/android/med ia/Med iaRecorder. html. htm I.

La siguiente tabla muestra los diferentes métodos que pueden pueden ser ser ejecutados ejecutados en en cada estado y el estado que alcanzaremos tras la llamada:

Estado salida lnitial Initial

218

l nitial

1Initiahzed nitia lized Reset

Estado Estaco entrada DataSource Prepared Confieured

Kecording

Lrror

Multimedia y ciclo de vida de una actividad

Estado salida lnitialized

lnitial initial

lnitialized Initialized

setAudioSource set setVVideoSource ideoSource

setAudioSource set V ideoSource setV ideoSource

DataSource OataSource Configured Confígured

setüutputF orrnat setOutputFormat

Prepared Prepared

Estado entrada DataSource Prepared on fi1gured eConfígured

prepare start releas llamada incorrecta Incorrecta

Error

Error

setAudioEncoder setAudioEncoder setVideoEncoder set VideoEncoder setüutputFile setOutputFile setVideoSize set ideoFrameRate setVVideoF rameRate setPreviewDisplay

Recording Recording Released

Recording

llamada incorrecta

llamada incorrecta

llamada incorrecta

llamada incorrecta

Tabla 3: Transiciones entre estados de la la clase MediaRecorder MediaRecorder

de audio audio utilizando utilizando Ejercicio paso a paso: Grabación de MediaRecorder. MediaRecorder. 1.

nombre Grabadora. Grabadora. El El nombre nombre del del paquete paquete ha ha Crea un nuevo proyecto con nombre de ser oorg rg.. example. exatnple. grabadora.

2.

código: Remplaza el Layout main.xml por el siguiente código: utf-S'"?> 0" encod encoding=

/> ndro id :on Click=" detenerGrabacion "/> 1

11

11


219

El gran libro de Android androicl: layout_widt~h= "h'ra_p_co.nten t:: " android:1ayout_width="wrap_conteat"

and roid: layou t _heigh t = "vn-ap_con t:ent:" android: 1 ayout_height "wrap_cont:ent" and roid: text = "Rf..-:~p roduc.ir l' android:text="Reproducir" android: onCl ick = "re¡)r oduc.i :r "/ > android:onClick="reproducir"/>

3.

por: Remplaza el el código de la actividad por: pub lic class cl.ass GrabadoraActivity extends Activity {{ public príva t e static final String LGGJTAG LOG_'J'ilG = "Grabadora"; "Grabadora" ; prívate prívate MediaRecorder mediaRecorder; mediaRecorder ; prívate MediaPlayer mediaPlayer; med iaPlayer ; prívat prívatee static String Licher-o fichero = Environment. getExtern alStorageDi rectory () . getAbsolutePath ()+ " /audio . 3gp" ; getExternalStorageDirectory {).getAbsolutePath()+"/audio.3gp"; voi d onCreate(Bundle savedlnstanceState) savedi nstanceState) { :!<:Override pub l ic void SOverride public super . onCreate(savedinsta nceState);; super.onCreate(savedlnstanceState) setContentView (R. layout. main ) ; setContentView(R.layout.main);

} public void ggrabar(View r a bar (Vie w view) { mediaRecorder = new MediaRecorder(); Media Rec o r der (); media Recorde r . setOutputFi le( fichero ); mediaRecorder.setOutputFile(fichero); media Recorder. setAudioSou rce(MediaRecorder .AudioSource .N.TC); mediaRecorder.setAudioSource(MediaRecorder.AudioSource. MIC); mediaRecorder. setOutputFo rmat(MediaRecorder. mediaRecorder.setOutputFormat(MediaRecorder. Ou tputFormat . 'T'JiREE_G.PP) ; OutputFormat.THREE_GPP) mediaRecorder. set AudioEnc oder(MediaRecorder.AudioEnc oder . mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder. l>J.1R_ NB ); AMR_NB);

try {{ mediaRecorder .prepare ( ); mediaRecorder.prepare(); cat ch (IOException } catch (lOException e) {{ Log. ( LOG.... TAG, "Fallo en grabación"); grabación''); Log. ee(LOG__TAG,

} mediaRecorder .start(); mediaRecorder.start();

} public void detenerGrabacion(View view) view) {{ medi aRecorder .stop(); mediaRecorder.stop(); mediaRecorder.rele ase (); mediaRecorder.release();

} publ :i e void rep roduci r (Vi ew vview) i e w) {{ public reproducir(View mediaPlayer = new ne w MediaPlayer(); Me diaPl a y e r(); try {{ mediaPlayer . setDataSou rce ( f.ichero ) ; mediaPlayer.setDataSource(fichero); mediaPlayer .prep are () ; mediaPlayer.prepare(); mediaPlayer . star t (); mediaPlayer.start(); (IOExcept i on e) e ) {{ } catch (lOException

220

Multimedia yy ciclo de de vida de de una una actividad actividad Log.e( LOG___)'AG Log.e(LOG TAG,,

"Fallo en reproducción"); reproducción"); "Fallo

} } } 4.

declarando dos dos objetos objetos de de las las clases clases MediaRecorder !'
5.

continuación, se se han han introducido introducido tres tres métodos métodos que que serán serán ejecutados ejecutados alal A continuación, pulsar los botones botones de de nuestro nuestro Layout. Layout El El significado significado de de cada cada uno uno de de los los métodos que se invocan invocan acaba acaba de de ser ser explicado. explicado.

6.

en la la pestaña pestaña Permissions Permissions pulsa pulsa elel botón botón AndroidManifestxml yy en Abre AndroidManifest.xml Add ... selecciona selecciona Uses Uses Permissions. Permissions. En En el el desplegable desplegable Ñame Name indica indica Add... RECORD AUDIO. Repite este este proceso proceso para para usar usar elel permiso permiso recordaud io. Repite í-l"RITE STOP~Z\.GE. WRITE ....EXTERNAL ....STORAGE.

7.

de nuevo nuevo la la aplicación aplicación yy verifica verifica el el resultado. resultado. Ejecuta de

Ejercicio paso aa paso: paso: Grabación Grabación de de audio audio utilizando utilizando MedíaRecorder (I/) MediaRecorder (II) La aplicación anterior anterior resulta resulta algo algo confusa confusa de de utilizar. utilizar. Sería Sería más más sencillo sencillo sisi los los pudiéramos utilizar utilizar en en un un determinado determinado momento momento estuvieran estuvieran botones que no pudiéramos deshabilitados. Para conseguirlo vamos utilizar método deshabilitados. Para conseguirlo vamos aa utilizar elel método setEnabled(boolean). Veamos Veamos cómo cómo conseguirlo: conseguirlo: Button. setEnabled(boolean). 1.

Declara las siguientes siguientes tres tres variables variables al al principio principio de de lalaActividad: Actividad: private Button Button bGrabar, bGrabar , bDetener, bDetener, bReproducir; bReproducir; prívate

2.

En el método método onCreateO onCreate () inicializa inicializa estos estos tres tres botones. botones. Además, Además, comenzaremos deshabilitando deshabilitando dos dos de de los los botones botones que, que, al al principio principio de de lala aplicación, deben ser ser pulsados: pulsados: aplicación, no deben bGrabar == (Button) (Button) findViewByld(R.id.bGrabar); findViewByid(R. id.l:)Grabar); bDetener = (Button) findViewByld(R.id.-bDetener); findViewByid(R.id. bDe t: ener); bReproducir = (Button) (Button) findViewByld(R.id. findViewByid(R.id .bReproducir); bRepr·oduc.ir); bDetener.setEnabled( false);; bDetener.setEnabled(false) bReproducir.setEnabled(false); bReproducir.setEnabled(false) ;

3.

el método grabar grabar {) () añade añade el el siguiente siguiente código: código: En el bGrabar .setEnabled( false ); bGrabar.setEnabled(false); bDetener bDetener..setEnabled(true setEnabled (tr-ue));;

221

El gran libro de Android bbReproducir.setEnabled(false); Reproduc i r .setEnabled( false } ;

4.. 4

código: En el método detenerGrabacion (()i añade el siguiente código: bGr abar. setEnabled( true }; bGrabar.setEnabled(true); bbDetener.setEnabled(false); Deten er .setEnabled( false }; bReprod ucir .se tEnabled( tnle } ; bReproducir.setEnabled(true);

5.

222

resultado. Ejecuta de nuevo la aplicación y verifica el resultado.

CAPÍTULO 7. CAPÍTULO 7.

Seguridad y posicionamiento posicionamiento Seguridad y

En este capítulo abordaremos abordaremos dos dos de de los los aspectos aspectos más más novedosos novedosos de de Android: Android: lala seguridad y el API de posicionamiento. posicionamiento. El capítulo comienza estudiando estudiando los los fundamentos fundamentos del del sistema sistema de de seguridad seguridad que que incorpora Android. Android. Sin embargo, embargo, aa pesar pesar de de lo lo que que cabría cabría esperar, esperar, elel sistema sistema de de las aplicaciones aplicaciones puedan puedan realizar realizar cualquier cualquier tipo tipo de de seguridad no va a impedir impedir que que las acción con el dispositivo. dispositivo. En la segunda parte del del capítulo, capítulo, se se describe describe el el API API que que incorpora incorporaAndroid Android para para posición geográfica geográfica del del dispositivo. dispositivo. Estos Estos servicios servicios se se basan basan permitir conocer la posición GPS, pero pero también también disponemos disponemos de de novedosos novedosos servicios servicios de de principalmente en el GPS, redes Wi-Fi. Wi-Fi. AA lolo largo largo de de este este capítulo capítulo localización basados basados en en telefonía telefonía móvil móvil yy redes mostraremos una serie de de ejemplos ejemplos que que te te permitirán permitirán aprender aprender aa utilizar utilizar estas estas funciones. funciones. capítulo describiendo describiendo cómo cómo podemos podemos incorporar incorporar aa nuestra nuestra Terminaremos el capítulo aplicación servicios realizados realizados por por terceros. terceros. En En concreto concreto instalaremos instalaremos una unavista vistaque que mapa de de Google Google Maps. Maps. permite representar un mapa

~Objetivos: Objetivos:

• • • •

•

Mostrar los pilares de de la la seguridad seguridad en en Android. Android. Describir cómo Android crea un un usuario usuario Linux Linux asociado asociado aa cada cada aplicación. aplicación. esquema de de permisos permisos en en Android Android yy enumerar enumerar los los permisos permisos Describir el esquema más importantes. importantes. Mostrar cómo los permisos permisos de de Android Android pueden pueden ser ser ampliados ampliados con con usuario yy enumerar enumerar los los pasos pasos aa seguir seguirpara paracrear crear permisos definidos por por el usuario un nuevo permiso. permiso. los diferentes diferentestipos tipos Describir (as las APIs APis de de Android para para la la geolocalización geolocalización yy los de sistemas de posicionamiento posicionamiento disponibles. disponibles.

223

El gran libro de Android Android • Ver lo sencillo que que resulta resulta incorporar incorporar en en nuestra nuestra aplicación aplicación un un servicio serviciode de un tercero. En concreto, concreto, Google Google Maps. Maps. •

Seguir mejorando Asteroides Asteroides al al introducir introducir elel problema problema del del acceso acceso concurrente a datos yy cómo cómo se se puede puede solucionar solucionar elel Java Java mediante mediante lala palabra reservada synchronized. synchronized.

7.1. 7 .1. Los Los tres tres pilares pilares de de la la seguridad seguridad en en Android Android

_......

.,-,,.JII'~

lili

111 WzZ

Poli[MedÍa]: Seguridad Poli[Media]: Seguridad en en Android. Android.

La seguridad es un un aspecto aspecto clave clave de de todo todo sistema. sistema. Si Si nos nos descargáramos descargáramos una una maliciosa de de Internet Internet oo del del Play Play Store, Store, esta esta podría podría leer leer nuestra nuestra lista lista de de aplicación maliciosa contactos, averiguar nuestra nuestra posición posición GPS, GPS, mandar mandar toda toda esta esta información información por por contactos, averiguar Internet y terminar enviando enviando 50 50 mensajes mensajes SMS. SMS. En algunas plataformas, plataformas, como como Windows Windows Mobile, Mobile, estamos estamos prácticamente prácticamente tanto, los los usuarios usuarios han han de de ser ser desprotegidos ante ante este este tipo tipo de de aplicaciones. aplicaciones. Por Por lolo tanto, muy cautos antes de de instalar instalar una una aplicación. aplicación. En otras plataformas, plataformas, como como en en /OS iOS del del iPhone, iPhone, toda toda aplicación aplicación ha ha de de ser ser validada por Apple antes antes de de poder poder ser ser instalada instalada en en un un teléfono. teléfono. Esto Esto limita limita aa los los pequeños programadores programadores yy da da un un poder poder excesivo excesivo aa Apple. Apple. Se Se trata trata de de un un planteamiento totalmente totalmente contrario contrario al al software software libre. libre. esquema de de seguridad seguridad que que protege protege aa los los usuarios, usuarios, sin sin lala Android propone un esquema necesidad de imponer imponer un un sistema sistema centralizado centralizado yy controlado controlado por por una una única única empresa. empresa. La seguridad en Android se se fundamenta fundamenta en en los los siguientes siguientes tres tres pilares: pilares: primer capítulo capítulo Android Android está está basado basado en en Linux, Linux, por por lolo Como se comentó en el primer tanto, poder aprovechar aprovechar la la seguridad seguridad que que incorpora incorpora este esteSO. SO.De Deesta estaforma forma tanto, vamos a poder Android puede impedir impedir que que las las aplicaciones aplicaciones tengan tengan acceso acceso directo directo alal hardware hardware oo interfieran con recursos recursos de de otras otras aplicaciones. aplicaciones. con un un certificado certificado digital digital que que identifique identifique aa su su Toda aplicación ha ha de de ser ser firmada firmada con autor. La firma digital autor. digital también también nos nos garantiza garantiza que que elel fichero fichero de de lala aplicación aplicación no no ha ha sido modificado. modificado. Si Si se se desea desea modificar modificar la la aplicación aplicación está está tendrá tendrá que que ser serfirmada firmada de de nuevo, hacerlo el el propietario propietario de de la la clave clave privada. privada. No Noes es preciso preciso(ni (ni nuevo, y esto solo podrá hacerlo certificado digital digital sea sea firmado firmado por por una unaautoridad autoridad de decertificación. certificación. frecuente) que el certificado Si queremos que una una aplicación aplicación tenga tenga acceso acceso aa partes partes del del sistema sistema que que pueden pueden hemos de de utilizar utilizar un un modelo modelo de de permisos, permisos,de de comprometer la seguridad del del sistema sistema hemos antes de de instalar instalar lala aplicación. aplicación. forma que el usuario usuario conozca conozca los los riesgos riesgos antes más detalle detalle elel primer primeryytercer tercerpunto. punto. En los siguientes apartados apartados se se describe describe con con más El proceso de firmar una una aplicación aplicación será será descrito descrito en en el el último últimocapítulo. capítulo.

224

Seguridad yy posicionamíento posicionamiento

7 .1.1. Usuario Usuario Linux Linux yy acceso acceso aa ficheros ficheros 7.1.1. Para proteger el acceso aa recursos recursos utilizados utilizados por por otras otras aplicaciones, aplicaciones, Android Android crea crea ID) nueva nueva por por cada cada paquete paquete ((.apk) instaladoen enelel una cuenta de usuario usuario Linux Linux (user (user ID) apk) instalado sistema. usuario es es creado creado cuando cuando se se instala instala lala aplicación aplicación yy permanece permanece sistema. Este usuario constante durante toda toda su su vida vida en en el el dispositivo. dispositivo.

Cualquier dato almacenado almacenado por por la la aplicación aplicación será será asignado asignado aa su su usuario usuario Linux, Linux, por lo que normalmente normalmente no no tendrán tendrán acceso acceso otras otras aplicaciones. aplicaciones. No No obstante, obstante,cuando cuando crees un fichero puedes puedes usar usar los los modos modos modeworldreadable MODE_ WORLD_READABLE y/o y/o MODE_WORLD_WRITEABI..E para para permitir permitir que que otras otras aplicaciones aplicaciones puedan puedan leer leer oo escribir escribir mode_world_writeable en el fichero. fichero. Aunque otras otras aplicaciones aplicaciones puedan puedan escribir escribir el el fichero, fichero, elel propietario propietario siempre será el usuario usuario asignado asignado aa la la aplicación aplicación que que lo lo creó. creó. Dado que las restricciones restricciones de de seguridad seguridad se se garantizan garantizan aa nivel nivel de de proceso, proceso, elel código de dos paquetes paquetes no no puede, puede, normalmente, normalmente, ejecutarse ejecutarse en en elel mismo mismo proceso. proceso. Para ello sería necesario necesario usar usar el el mismo mismo usuario. usuario. Puedes Puedes utilizar utilizar elel atributo atributo shareduserid Android!"'anifest .xml . x ml para para asignar asignar un un mismo mismo usuario usuario Linux Linux aa sharedüserid en AndroitiManifest dos aplicaciones. Con esto esto conseguimos conseguimos que que aa efectos efectos de de seguridad seguridad ambas ambas aplicaciones sean tratadas tratadas como como una una sola. sola. Por Por razones razones de de seguridad, seguridad, ambas ambas aplicaciones han de de estar estar firmadas firmadas con con el el mismo mismo certificado certificado digital. digital.

7 .1.2. El esquema esquema de de permisos permisos en en Android Android 7.1.2. Para proteger ciertos ciertos recursos recursos yy características características especiales especiales del del hardware, hardware, Android Android define un esquema de permisos. permisos. Toda Toda aplicación aplicación que que acceda acceda aa estos estos recursos recursos está está obligada a declarar su intención intención de de usarlos. usarlos. En En caso caso de de que que una una aplicación aplicación intente intente acceder a un recurso del del que que no no ha ha solicitado solicitado permiso, permiso, se se generará generará una una excepción excepción de permiso y la aplicación aplicación será será interrumpida interrumpida inmediatamente. inmediatamente. Cuando el usuario usuario instala instala una una aplicación, aplicación, este este podrá podrá examinar examinar lala lista lista de de permisos que que solicita la la aplicación aplicación yy decidir decidir sisi considera considera oportuno oportuno instalar instalar dicha dicha aplicación. Veamos la de algunos algunos permisos. permisos. Abajo Abajo se se describe describe elel aplicación. la descripción descripción de esquema utilizado: utilizado:

A

NOMBRE_DEL_PERMISO Grupo al a! que que pertenece perteneceDescripción del del permiso permiso nombre_del_permiso A Grupo - Descripción que se mostrará a! al usuario usuario antes antes de de instalar instalar la la aplicación aplicación (grado (grado de de relevancia relevancia de seguridad ajuicio a juicio del del autor). autor). Descripción Descripción yy comentarios. comentarios.

A continuación, continuación, se muestra muestra una una lista lista con con algunos algunos de de los los permisos permisos más más utilizados utilizados en Android: Android: ••

A

CALL_ PHONE A Servicios Servicios por por los los que que tienes tienes que que pagar pagar -- Llamar Llamar call_phone directamente a números de de teléfono teléfono (muy (muy alta). alta). Permite Permite realizar realizar llamadas llamadas sin sin la intervención del usuario. usuario.

A Servicios ~ Envío • SEND_SMS SEND_SMsA servlcíos por por ios !os que que tienes tienes que que pagar pagarEnvío SMS/MMS SMS/MMS (muy alta). alta). Permite aa la la aplicación aplicación mandar mandar SMS. SMS.

225

El gran libro de Android •

WRITE_EXTERNAL_STORAGE A» A Almacenamiento -- Modificar/borrar Modifíc::u!borrar archivos write_external_storage en SD (alta). Permite la lectura de archivos y su modificación, modificación, típico en aplicaciones de backup. backup.

•

READ__OWNEH__DATA Aiy Tu lnform.ación read_owner_.data información personal -- Leer datos de contacto (alta). (alta). Permite leer información sobre scbre el propietario del teléfono (nombre, (nombre, correo electrónico, número de teléfono). teléfono). Muy peligroso, peligroso, algunas aplicaciones lícita. podrían utilizar esta información de forma no licita.

•

READ__calendar CALENDAR A ru -· Leer datos de calendario read Tu información personal (moderada). Solo otorga este permiso si consideras que la aplicación realmente lo necesita. necesita.

•

write_calendar A A ru Tu información personal ····· Escribir datos de calendario WRITE_CALENDAR calendano (moderada). Este permiso no permite leer el calendario. (moderada). calendario. Por las mismas razones que el anterior permiso, permiso, hay que plantearse si una aplicación nos pide este permiso con sentido o no. no.

•

READ_PHONE_STATE de! teléfono e read_phone_state A Llamadas de teléfono - Leer estado del identidad (alta). Muchas aplicaciones piden este permiso para ponerse en pausa mientras hablas por teléfono. teléfono Sin embargo, embargo, también permite el acceso al IMEI, IMSI y al identificador único de 64 bits que Google asigna a cada terminal. En las primeras versiones de SDK este permiso no era necesario.

•

ACCESS_.FINE_LOCATION Atu A ru ubicación ubicac ión - Precisar PrecH:>ar !a access_fine_location la ubicación (GPS) (moderada). Localización basada en GPS. GPS.

•

ACCESS_COARSE_LOCATION - Ubicacíón (l;asac!a en access_coarse_l.ocation ,j\ A Tu ubicación Ubicación común (basada red) (moderada). (moderada). Localización basada en telefonía móvil (Cei-ID) (Cel-ID) y Wi-Fi.

•

BLUETOOTH A A Comunicación de red ~- Crear conexión Biuetooth Bluetooth (baja). (baja). bluetooth Conexión con otro dispositivo Bluetooth. 8/uetooth.

•

INTERNET ····· Acceso /\cceso íntegro a Internet internet A Comunicación de md red internet (muy alta). Permite establecer conexiones a través de Internet. Este es posiblemente el permiso más importante, importante, en el que hay que fijarse más a quién se le otorga. Muchas aplicaciones lo piden, piden, pero no todas lo necesitan. Cualquier malware necesita una conexión para poder enviar datos de nuestro dispositivo. dispositivo.

A

A

»

A

A Comunícación Comunicación de red - Ver estado de conexión, • access_wifi_state ACCESS_INIFLSTATEA red···· conex:ón. ver estado de Wi+i Wi-Fi (baja). (baja). Información sobre redes WiFi disponibles. A Herramientas del sistema -- lmpedír impedir que ei ele •• A el teléfono entre en modo rnodo de suspensión (baja). (baja). Algunas aplicaciones aplicacones pueden necesitar este permiso, permiso, y realmente a lo único que puede afectar es a nuestra batería, batería.

•

226

A

CHANGE_CONFiGURATiON A Herramientas del sistema CHANGE_CONFIGURATION - Modificar la conflguracíón global de! configuración globaí del sistema (moderada). Permite cambiar la configuración (como loca/e). común, así por lócale). Pese a que es importante en sí, es muy común, ejemplo los widgets lo necesitan. necesitan.

Seguridad y posicionamiento

A

••

READ_SYNC_SETIINGS read_sync_settings A Herramientas

de! del sistema sistema -- Leer Leer ajustes ajustes de de sincronización (baja). Tan solo permite permite saber saber si si tienes tienes sincronización sincronización en en segundo plano con alguna aplicación aplicación (como (como con con un un cliente cliente de de Twitter Twitter oo Gmail).

••

WRITE_APN_SETTINGS Herramientas del WRiTE_APN_SETTiNGS«b del sistema sistema -- Escribir Escribir configuración configuración d<~l del Punto de Acceso (moderada). Permite Permite la la configuración configuración del del punto punto de de acceso a la red. Por ejemplo, encender encender yy apagar apagar tu tu conexión conexión de de red red oo Wi-Fi. Wi-Fi.

••

MANAGE_APP _TOKENS » Herramientas del manage_app_tokens del sistema sistema -- Recuperar Recuperar aplicaciones aplicaciones en ejecución e;ecución {moderada). (moderada). Permite Permite saber qué qué aplicaciones aplicaciones están están corriendo corriendo en en segundo plano y cambiar el orden.

••

SET_PREFERRED_APPLICATIONS set_preferred_appücations A Herramientas Herramientas del del sistema sistema -- Establecer Establecer aplicac;ones aplicaciones preferidas (moderada). (moderada). Permite Permite la la asignación asignación aa una una aplicación aplicación para que haga determinada tarea. Por Por ejemplo, ejemplo, la la reproducción reproducción de de vídeos. vídeos.

••

VIBRATEÁControles víbrate A Controles de hardwarehardware - Control Control de de la la vibración vibración (baja). (baja). Permite Permite hacer vibrar al teléfono. Los juegos lo lo suelen suelen utilizar utilizar bastante. bastante.

••

camera A Controles de hardware hardware -~ Realizar Realizar fotografías fotografías (baja). (baja). Permite Permite CAMERA acceso al control de la cámara yy aa la la toma toma de de imágenes. imágenes.

••

RECORD_AUDIO record_audio A Controles Controles

A

A

A

A

A

de de hardware hardware - Grabar Grabar audio audio (moderada). (moderada). Permite grabar sonido desde el el micrófono micrófono del del teléfono. teléfono.

Para solicitar un determinado permiso permiso en en tu tu aplicación, aplicación, no no tienes tienes más más que que incluir incluir Una etiqueta xml de en en el el fichero fichero l~ndroidManifest. AndroidManifest.xml de tU tu aplicación. En el siguiente ejemplo ejemplo se se solicitan solicitan dos dos permisos: permisos:
>

>

android:name="android.permissioa.RECEIVE_SMS"/> >

7 .1.3. Permisos definidos por 7.1.3. por el el usuario usuario en en Android Android por el el sistema, sistema, los los desarrolladores desarrolladores vamos vamos aa Además de los permisos definidos por para restringir restringir el el acceso acceso aa elementos elementos de de nuestro nuestro poder crear nuevos permisos para software.

ü Poli [Media]:|: Permisos definidos Pol¡|Med¡a def nidos por por el el usuario usuario en en Android. Android.

227

El gran libro de Android Android Abordaremos el estudio estudio de de la la creación creación de de nuevos nuevos permisos permisos utilizando utilizando elel Somos la la empresa empresa PayPerView PayPerView especializada especializada en en ofrecer ofrecer siguiente ejemplo. Somos servicios de reproducción reproducción de de vídeos vídeos bajo bajo demanda. demanda. Queremos Queremos crear crear un un software software que permita a cualquier cualquier desarrollador desarrollador reproducir reproducir nuestros nuestros vídeos vídeos desde desde sus sus aplicaciones. No No obstante, este este servicio servicio no no es es gratuito, gratuito, por porloloque quenos nosinteresa interesaque que el usuario sea advertido advertido cuando cuando se se instale instale lala aplicación aplicación del deltercero, tercero, indicándole indicándoleque que esta aplicación va hacer hacer uso uso de de un un servicio servicio no no gratuito. gratuito. Para definir el nuevo nuevo permiso permiso utilizaremos utilizaremos elel tag tag en en elel fichero fichero Andro idNanifest..xmi xml de AndroídManifest de nuestro nuestro software. software. AA continuación, continuación, se semuestra muestraun unejemplo: ejemplo: craanifest package="com.payperview.servicios"» 11

11

,!

> android:proteotionLevel-"danaerous"

El atributo android: name indica android;ñame indica el el nombre nombre del del permiso. permiso. Como Como ves ves ha hade deestar estar dentro del mismo mismo dominio dominio que que nuestra nuestra aplicación. aplicación. ElEl atributo atributo android:permissionGroup android: permiss ionGroup es es opcional opcional yy permite permite incluir incluir nuestro nuestro permiso permiso en en un un grupo. po de grupo. En el ejemplo se se ha ha incluido incluido en en elel gr grupo de permisos permisosque quepueden puedensuponer suponerun un coste económico al usuario. usuario. El El atributo atributo androi.d:protectionLevel androidrprotectionLevel informa informa alal sistema cómo el usuario ha ha de de ser ser informado informado yy qué qué aplicaciones aplicaciones tienen tienen acceso accesoalal permiso. Los valores posibles posibles se se indican indican aa continuación: continuación: nnormal o rmal

El El usuario usuario no no es es advertido advertido de de que que se se va va utilizar utilizar elel permiso. permiso.

dangerous

El El usuario usuario es es advertido. advertido.

signature signatura

Solo Solo aplicaciones aplicaciones firmadas firmadascon con lalamisma mismafirma firmadigital digitalque que la aplicación que declara declara el el permiso. permiso.

signatureOrSystem

Igual Igual que que signature signatura pero pero además además puede puede ser serusado usadopor por el sistema. Caso Caso poco poco frecuente, frecuente, donde donde varios varios fabricantes necesitan compartir compartir características características aa través través de la imagen del sistema. sistema.

nciroid::iabei label yy android: descript ion son Los atributos aandroid android idescription son opcionales opcionalesyyhan hande de través de de un un recurso recurso de de cadena. cadena. En En estas estas cadenas cadenas hay hay que que ser introducidos a través de forma forma abreviada abreviada yy extensa, extensa, respectivamente. respectivamente. Veamos Veamoscómo cómo describir el permiso de podría ser en el ejemplo: reproducc i ón de videos bajo reproducci6n de videos bajo demanda demandac/string> Permi te aa la
android:permission= android:permission= servícios VER_ VIDEOS "">> "com. paypei-vi ew.servi cios.. VER_VIDEOS cintent-f ilter> < ac t iion on andró i d:nams="andróid.intent.action. MAIN" /> "andToid . inte.nt. c.·ategol:y~ . LAfJlVCHER "í > "co1n . ~payperview.

11

4.

Copia detrás de de la la etiqueta etiqueta ... /> del del ejemplo anterior. anterior.

5. 5.

Recuerda definir etiqueta yy descripción. descripcion. definir los los recursos recursos de de cadena cadena etiqueta

6.

Ejecuta el proyecto. proyecto. Es Es imprescindible imprescindible para para registrar registrar en en elel teléfono teléfono elel nuevo permiso yy la la nueva nueva actividad actividad que que queremos queremos lanzar lanzar desde desde otras otras aplicaciones. aplicaciones.

7. 7.

Para usar este este servicio servicio crea crea un un nuevo nuevo proyecto proyecto con con los los siguientes siguientesdatos: datos: Project ñame: name: UsarPermiso UsarPermiso Build Target: Androidl.5 Androidl.5 ¡,pplication name: UsarPermiso UsarPermiso Application ñame:

229

El gran libro de Android Package ñame: name: ora.example.usarpermiso org.exampJ.e.usarpermiso Create Activity: Ac tivity: UsarPermiso IJsarPermiso Min SDK Versión: Version: 3

8.

Abre el fichero main.xmi main . xml e inserta el siguiente botón dentro del : >: andró i d:iid= d="0+i d/Bu 11on01"/>

9.

Abre el fichero usarPermisos. java y añade el siguiente código al final de {):: la función onCreate ()

Button = B u tton b b =

(Button)findViewByldÍR.id.ButtonOl); (Button) findViewByid(R.id.BuUon01);

b.setOnClickListener(new OnClickListener(}{{ b.setOnCli ckListener( new OnClickListener() @Override ©Overrida

public void onClick(View view){ v iew ){ Intent ii == new IntentO Intent();; i. setClassNarne ( "com.paypervie\AJ. servicios 11 i.setClassName("com,payperview.servicios", 11 corn.payperview.servicios.VerVideo 11 ) ; "com.payperview.servicios,VerVideo"); 1

startActivity(i); startActivlty í i )• ;

})

;

.~t

<;,-:;::;;. Nota sobre Java: En este código no se han incluido los import, impon, pulsa CtrlShift-0 Shift-O para añadirlos de forma automática. 10. Ejecuta la aplicación. aplicación. Cuando pulses el botón la aplicación provocará un error. error.

permiso. 11. Visualiza la ventana LogCat para verificar que se trata de un error de permiso. 12. Para solucionar el problema tendrás que incluir el siguiente código al final del fichero AndroidManifest.xmi; Jl.ndroid.Manitest .xn'll: ...>
android:name="com . payperview.servicios.VER.VIDEOS"Í android:name="com.payperview.servicios.VER VIDEOS"/>> <ímanite st >

13. Comprueba cómo ahora se accede al servicio sin problemas. problemas.

Preguntas de repaso y reflexión: Los permisos en Androíd. Android.

230

Seguridad yy posicionamiento posicionamiento 7.2. Localización 7 .2. Localización La plataforma Android Android dispone dispone de de un un interesante interesante sistema sistema de de posicionamiento posicionamiento que que combina varias tecnologías: tecnologías: Sistema de localización localización global global basado basado en en GPS. GPS. Este Este sistema sistema solo solo funciona funciona sisi disponemos de visibilidad visibilidad directa directa de de los los satélites. satélites. Sistema de localización basado basado en en la la información información recibida recibida de de las las torres torres de de telefonía telefonía celular y de puntos de acceso acceso Wi-Fi. Wi-Fi. Funciona Funciona en en el el interior interiorde de los losedificios. edificios. Estos servicios se encuentran encuentran totalmente totalmente integrados integrados en en el el sistema sistema yy son son usados usados por gran variedad de aplicaciones. aplicaciones. Por Por ejemplo, ejemplo, la la aplicación aplicación Loca/e Locale1 1 de de Android Android puede adaptar la la configuración configuración del del teléfono teléfono según según donde donde se se encuentre. encuentre. Podría Podría por por en elel trabajo. trabajo. ejemplo poner poner el el modo de de llamada llamada en en vibración vibración cuando cuando estemos estemos en El sistema de posicionamiento posicionamiento global, global, GPS, GPS, fue fue diseñado diseñado inicialmente inicialmente con con fines fines militares pero hoy hoy en en día día es es ampliamente ampliamente utilizado utilizado para para uso uso civil. civil. Gracias Graciasalaldesfase desfase 31 satélites satélites desplegados, desplegados, este este temporal de las las señales señales recibidas recibidas por por varios varios de de los los 31 sistema es capaz de posicionarnos posicionarnos en en cualquier cualquier parte parte del del planeta planeta con con una una precisión precisión de 15 metros. metros. El GPS presenta un un inconveniente; inconveniente; solo solo funciona funciona cuando cuando tenemos tenemos visión visión directa directa de los satélites. satélites. Para Para solventar solventar este este problema, problema, Android Android combina combina esta esta información información con la recibida de las las torres torres de de telefonía telefonía celular celular yy de de puntos puntos de deacceso accesoWi-Fi. Wi-Fi.

Ejercicio paso aa paso: paso: El API API de de localización localización de de Android. Android. En este ejercicio crearemos crearemos una una aplicación aplicación que que es es capaz capaz de de leer leer información informaciónde de un cambio. cambio. localización del del dispositivo dispositivo yy actualizarla actualizarla cada cada vez vez que que se se produce produce un 1.

Crea un un nuevo nuevo proyecto proyecto con con los los siguientes siguientes datos: datos: Pruject ñame: name: Localización Localizacion Project Bui.ld 1. 6 Euild Target: Android 1.6 Application ñame: name: Localización Localizacion Package ñame: name : org.example.localización oz·g. example .localizacion Create Activity: Localización Localizacion Min SDK Versión: Version: 4

2.

11

Por razones de de seguridad seguridad acceder acceder aa la la información información de de localización localizaciónestá, está,en en principio, prohibido aa las las aplicaciones. aplicaciones. Si Si estas estas desean desean hacer hacer uso uso de dedicho dicho servicio han de de solicitar solicitar permisos permisos especiales. especiales. Estos Estos permisos permisos hay hay que que AndroidManiest.,xmi. xml. En En concreto, concreto, esta esta aplicación aplicación indicarlos en el fichero fichero AndroidManiest necesita los permisos permisos de de localización localización precisa precisa yy localización localización imprecisa: imprecisa:

http://www.androidlocale.com http://www.androidlocale.com

231

El gran libro de Android ACCESS FINE LOCATION ACCESS_FIKEJLOCATION ACCESS COA!
Puedes hacerlo a través de los cuadros de diálogos, como se muestra a continuación: continuación: g; ^ Android Manifest Manifost Permissions Pefmíssioivs ÍF| (P) A: A; 0 (Q) @ fF| 0 ®

(Ü) Uses P«rniss»or>

Attrlbutes fot Uses Permiswoft @ The jses~:St'1.-pt:rmis>:ion tag requests requ5ts aa (í¿) The p-etmisiion tag '"penni.ssion that the package mast mu-rt "permaskm".. that the containing package be 9 r-.tnte:d in ín otder for It it to to opérate operate ccrrectly. be grántcd order for N.tme .android.perm.~'iion.ACCESS_COARSI_lO Ñame 3ndrotd.pefmKsion,ACC£SS_C0ARS£_L0 ▼... :

' Atttlbut.. for Oses P
contain/~"' 9

~crrectly.

Manifejt \ Applicatior: i Permissions i ÍRítrumentotior» AodroisJManrfest.xml i Añadiendo las siguientes líneas en el fichero XML. FINE....LOC?\.TION" 1 >
3.

En este ejemplo de posicionamiento vamos a utilizar tanto la localización fina, fina, que nos proporciona el GPS, GPS, como una menos precisa, precisa, proporcionada por las torres de telefonía celular y WiFi. En este ejemplo nos limitaremos a mostrar en modo de texto la API de localización, información obtenida desde el API localización, tal y como se muestra en la siguiente pantalla: pantalla:

hisa

232

ame© ti

Seguridad yy posicionamiento Como puede observarse nos nos limitaremos limitaremos aa mostrar mostrar un un Textview Textview con con scroll. Sustituye el scro/1. el fichero fichero res/layout/main.xral res/layout/mai n . xml por: por:

arent" " f i l l ....Parent" aandroid: n droid : layout_height= layout_height= ""fi l l _.parent "> parent "> < /Se rol IV ielA'> 4.

Ve ahora al fichero fichero LocationTest Locat ionTest..java java yy copia copia el el siguiente siguiente código: código: public clasa class Localización Localizacion extends extends Activity Activity implements implementa LocationListener LocationListener { priva te static ata tic final StringH String[] AA == { "n/d", prívate "preciso", "impreciso" n/cl preciso "impreciso }; p = { "n/d", priva te static final Stringt] String[] P= prívate "bajo", n/d "bajo'', "medio","alto" tnedi.o" , alto }; priva te static final String[] String[] E¡;; == { "fuera prívate " fuera de de servicio", servicio", "tempo:r-almente disponible ", " , "disponible" "disponible" }; }; "temporalmente no disponible priva te LocationManager manejador; mane j ado:r·; prívate priva te Textview TextView salida; salida ; prívate priva te String proveedor; proveedor ; prívate 11

11 ,

'1

11 ,

11

11 ,

11

11

11

}

11

} ;

;

~:YC-·verride ■SOverride public void onCreate(Bundle onCreate(Bundle savedlnstanceState) savedlnstanceState) { super.onCreate(savedlnstanceState); super .onCreate(savedlnsta nceState); ssetContentView(R.layout.main); e t ContentView(R . l ayou t.main); salida == (Textview) (TextView) findViewById(R.id.salida); findViewByld (R. id . sa.Iúla );

manejador == (LocationManager) (LocationManager) getSystemService getSystemService (LOCATiOALSiíR'/XCBj (L.OC.'A'TlON_SERVICE) ,• ; log ("Proveedores ( 11 Proveedores de localización: localización: \n \n "); ") ; muestraProveedores(); Criteri c riteria == new new Gritería(); Criteria(); Griteríaa criteria proveedor == manejador.getBestProvider(criteria, manejador . getBestProvider (criter ia, true); true); log( 11 Hejor proveedor: "" ++ proveedor proveedor ++ "\n"); "\n"); log("Mejor log("Comenzamos con la la última última localización l ocalizaci ón conocida:"); conocida:" ); Location localización l ocalizac i on == manejador.getLastKnownLocation(proveedor); manejador .ge tLastKnownLocation(proveedor); muestraLocaliz(localización); mues t raLocaliz (localizacion);

} La primera línea línea que que nos nos interesa interesa es es lala llamada llamada aa getsystemservice getSystemse :rvic e { locat i on_servi ce ) que que crea crea el el objeto objeto manejador manejador de de tipo tipo (LOCATION_SEEVICE) LocationManager. Loca t i onManage r. La siguiente línea línea hace hace una una llamada llamada al al método método log log ()<) que que será será definido definidomás más el Textview TextView el el texto texto indicado. indicado. adelante. Simplemente saca por por el adelante. Simplemente

233

El gran libro de Android Androíd La siguiente llamada aa muestra Proveedores ()O también muestraProveedores también es es un un método método que listará listará todos todos los los proveedores proveedores de de localización localización definido por nosotros, que disponibles. En las tres siguientes siguientes líneas líneas vamos vamos aa seleccionar seleccionar uno uno de de estos estos proveedores de de localización. localización. Para Para ello ello usaremos usaremos elel método método getBest.Provider (). En getBestProvider(). En este este método método hay hay que que indicar indicar un un criterio criterio de de se podría podría indicar indicar restricciones restricciones de de coste, coste, potencia, potencia, selección. Aquí se En este este ejemplo ejemplo no no indicamos indicamos ninguna ninguna restricción. restricción. precisión, etc. En Dependiendo del proveedor proveedor puede puede tardar tardar un un cierto cierto tiempo tiempoen endarnos darnosuna una primera posición. No No obstante, obstante, Android Android recuerda recuerda lala última última posición posición que que fue devuelta por este este proveedor. proveedor. Es Es lo lo que que se se hace hace en en las las últimas últimaslíneas líneas del programa. El El método método muestraLocaliz muestraLocaiiz ()t) será será definido definido más más tarde tarde yy muestra en pantalla una una determinada determinada localización. localización. 5. 6.

Copia, a continuación, continuación, el el resto resto del del código: código:

!! // Métodos del del ciclo ciclo de de vida vida de de la la actividad actividad &Override () {{ ©Override protected void void onResume onResumeí) super .onResume();; super.onResume{! // r\ctivarnos o c alización Activamos notificaciones notificaciones de de llocalización manejador. request.Locat.ionUpdat.es ); ; requestLocationlTpdat.es (proveedor, (proveedor, 1.0000, 10000, 1,1, this this)

} &Override () {{ ©Override protected void void onPause onPause() super. onPause(); super.onPause(); // Desactivarnos es para Desactivamos notificacion notificaciones para ahorrar ahorrar baLería batería manejador . removeUpdates( this) ; manej ador.removeUpdates(this);

}

!i i! 1>1ét:odos Métodos de J.a la int.erfaz interfaz Locati.onList.enet· LocationListener public public void onLocationChanged(Location onLocationChanged ■(Location locat:.ion) location) log( "Nueva localización log("Nueva localización:: "); "); muestraLocaliz (locat.ion); inuestraLocaliz(locationi;

{

} public void onProviderDisabl ed(String proveedor) onProvlderDisabled(String proveedor) { log("Proveedor o: "" +proveedor+ loq("Proveedor deshabilitad deshabilitado: + proveedor + "\n"); "\n");

} public public void onProvid.er·Enabled onProviderSnabled(St:.ring
} public void onStatusChanged(String , onStatusChanged(String proveedor, proveedor, int int estado estado,

Bundle extras) extras! {{ log ( 11 Cam.bía e(·Jtado n log("Cambia estado proveedor proveedor:: ti" ·-+-+ proveedor proveedor ++ 11 estado:.:: estado=" 11 E[Jv1ath.rnax{0 1 estado) J ++ "",, extras= ++ eextras xtra s ++ ""\n"); \ n 11 ) ; + £[Math.max(0,estado)) extras=" 1

234

Seguridad y posicionamiento 11 ,// t•lét.odos Métodos para para mostrar mostrar info:nna,ción información prívate void log(String log(String cadena) cadena) {{ salida.append(cadena ++ "\n"); "\n");

} void muestraLocaliz(Location rcuestraLocaliz(Location localízacion) localización) prívate voíd íf localizacion == if ((localización == null nuil)) log("Localización desconocida\n"); desconocida\n"); el se else log(localizacíon.toString() log(localización. toString() ++ "\n"); "\n");

{

} prívate voíd void muestraProveedores() itvuestraProveedores {) {{ List proveedores proveedores == manejador.getAllProviders(); manejador.getAUProviders(); for (Strlng (String proveedor proveedor :: proveedores) proveedores) {{ muestraProveedor(proveedor); muestraProveedor(proveedor);

} } prívate voíd void muestraProveedor(String muestraProveedor(String proveedor proveedor)) {{ Locat.ionProvider LocationProvider info info == manejador.getProvider(proveedor); manejador.getProvider(proveedor); log("Locat.ionProvider[ log ("LocationProvider [ "+"getName=" "•t-"getName=" ++ info.getName{)+ info. getName ()+ isProviderEnabled=" ++ manejador.isProviderEnabled(proveedor)+ manejador.isProviderEnabled(proveedor)+ A[Math.max(0, info.getAccuracy())] info.getAccuracy!))]+ getAccuracy=" ++ A[Math.max(O, + " , getPo1r1erRequirement=" getPov/erRequirement=" ++ P[Math.max(0, info.getPowerRequirement{))]+ P [l'lath. max (O, info. getPowerRequi:r·ement () ) ] + hasMonetaryCost-"'' ++ info. info.hasMonetaryCost()+ hasl'lonetaryCost= hasr"'onetaryCost. () + requiresCell=" ++ info.requiresCell()+ info.requiresCell()+ requ i resNetwork=" + info. requiresNetvmrk () + requiresNetwork=" info.requiresNetwork()+ requiresSatellite=" requires3atellite=" ++ info.requiresSatellite()+ info.requiresSatellite()+ " , supports.Zütitude=" supportsAltitude=" +-i- info.supportsAltitude()+ info. supportsAltitude () + supportsBearing=" ++ info.supportsBearing()+ info.supportsBearing()+ ", supportsSpeed=" suoportsSpeed^" ++ info.supportsSpeed()+" info.supportsSpeed()+" ]\n"); ]\n");

} notifiquen cambios cambios de de posición posición hay hay que que llamar llamaralal Para conseguir que se notifiquen requestLocationüpdates (()Jyy para para indicar indicar que que se se dejen dejen de de método requestLocationUpdat.es hacer las notificaciones hay hay que que llamar llamar aa removeUpdates removeupdates(). (). Dado Dado que que batería, nos nos interesa interesa que que se se reporten reporten notificaciones notificaciones queremos ahorrar batería, aplicación esté esté activa. activa. Por Por lolo tanto, tanto, tenemos tenemos que que solo cuando la aplicación lOS métodos oonResume () yy onPause onPause {(). reescribir los nResume () l. El método requestLocationUpdates requestLocationüpdates ()(¡dispone de 44 parámetros: parámetros: elel dispone de nombre del proveedor, el el tiempo tiempo entre entre actualizaciones actualizaciones en en ms ms (se (se recomiendan valores mayores mayores de de 60.000 60.000 ms), ms), lala distancia distancia mínima mínima (de (de manera que si es menor, menor, no no se se notifica) notifica) yy un un objeto objeto LocationListener. LocationListener.

235

El gran libro de Android A continuación, implementamos implementamos los los métodos métodos de de un un Locationiástener: r.ocationListener: onLocationChanged cada vez vez que que cambie cambie la la posición. posición. Los Los onLocationchanged se activará cada en otros tres métodos pueden ser usados usados para para cambiar cambiar de de proveedor proveedor en caso de que se active uno uno mejor mejor o deje deje de de funcionar funcionar el el actual. actual. Sería Sería buena idea llamar de nuevo nuevo aquí al al método método getBestProvider getBest.Provider o. () . El resto del código resulta fácil de de interpretar. interpretar.

6, 6.

Verifica el funcionamiento del del programa, programa, si si es es posible posible con con un un dispositivo dispositivo real. real.

7.2.1. Emulación del GPS GPS con con Eclipse Ecli se Muy probablemente el ordenador ordenador donde donde estés estés trabajando trabajando no no disponga disponga de de GPS, GPS, por por lo que sería muy difícil difícil que que este este programa programa funcione funcione en en el el emulador. emulador. No No hay hay un sistema sistema de de emulación emulación problema, el plug-in de de Android Eclipse proporciona proporciona un Android para para Eclipse al menú menú Window Window >> Show Show GPS. Para activarlo sigue sigue los los siguientes siguientes pasos. pasos. Accede Accede al del GPS. View >Others ... Control. .. > Android > Emulator Control.

f íM ShrfcwVtf»»/

t'

^

^ TI

j type flfcer t&xt General ~General @} Andro~d igj» Android 1lll DEl/ice< Q Devices 1 (p Emulator JI Eqmlator Controi <2'¡~¡c¡l ; $Y File Explorer E~plore 0 File til Heap § Heap ,g L<>gC•t 0i LogCat ■0 Resource .gi Resaurce Explorer Explorer Threads ~Threads . g; §?. Ant ~~~ Use F2 to to display display the the descfipt description for aa selected selededview. view. Use F2 on for

Aparecerá una ventana como la la siguiente: siguiente:

lf_ Prcblems O Consolé Q LogCat Q Emolí torCootrol I : i Location Controls I Manml | KML 1 i # Decimal i 0 Sexagesimal i i Longrtude -122.084095 | Latitude i 37422006 j

236

H

„

r

,

" d" *1 § h iJ

Seguridad y posicionamiento NOTA: Es posible que el GPS GPS no no reciba reciba ninguna ninguna señal. señal. El El problema problema está está relacionado relacionado con el formato formato de las coordenadas coordenadas enviadas enviadas al al emulador. emulador. Por Por algún algún motivo motivo (probablemente relacionado con el el carácter carácter usado usado para para separar separar los los decimales, decimales, la lacoma coma en español y y punto en inglés) el el emulador emulador solo solo recibe recibe correctamente correctamente las las actualizaciones actualizaciones si la configuración regional está está establecida establecida en en el el idioma idioma inglés. inglés. Para Para solucionar solucionar este este problema basta cambiar el loca/e lócale del del runtime runlime de de java. java. Si Si utilizas utilizas el el plug-in plug-in para para Eclipse, añade '-Duser.fanguage '-Duser. language=en' =en' al al archivo archivo ec/ipse.ini. eclipse, ¡ni. Más Más información informaciónen en2.2.

7 .3. Google Maps 7.3. Google Maps nos proporciona un servicio servicio de de cartografía cartografía online online que que podremos podremos utilizar utilizaren en nuestras aplicaciones Android. Veamos Veamos las las claves claves necesarias necesarias para para utilizarlo. utilizarlo.

hacer uso uso de de este este servicio servicio necesitas necesitas una una clave clave de de Google Google En primer lugar, para hacer Maps. Puedes encontrar información información en en http://code.google.com/intl/es/apís/maps/ http://code.qooale.com/intl/es/apis/maps/ sianup.html. Siempre es una una buena buena idea idea revisar revisar los los términos términos yy condiciones. condiciones. He He aquí aquí signup.html. algunos ejemplos: •

número de de solicitudes solicitudes de de codificación codificación geográfica geográfica por pordía, día, Hay un límite en el número 15.000. 15.000.

•

AdWords) no no está está incluida incluida en en lala API API de de Google Google Publicidad (AdSense 1/ AdWords) Maps.

•

mapas de de Google Google como como un un servicio servicio gratuito gratuito para para Estás obligado a ofrecer mapas tus usuarios.

Google Maps Maps 7.3.1. Obtención de una clave Google servicio de de Google, Google, igual igual que que como como ocurre ocurre cuando cuando se se utiliza utiliza Para poder utilizar este servicio desde una página web, va aa ser necesario necesario registrar registrar la la aplicación aplicación que que lolo utilizará. utilizará. se nos nos entregará entregará una una clave clave que que tendremos tendremos que que indicar indicar Tras registrar la aplicación, se en la aplicación. dos claves claves diferentes, diferentes, una una durante durante el el proceso proceso de de Realmente vamos a necesitar dos desarrollo y otra para para la la aplicación aplicación final. final. La La razón razón es es que que se se genera genera una una clave clave certificado digital digital con con la la que que se se firma firma la la aplicación. aplicación. En En lala diferente en función del certificado aplicaciones también también han han de de ser ser firmadas firmadas digitalmente, digitalmente, pero pero fase de desarrollo las aplicaciones utiliza un un certificado certificado especial especial utilizado utilizado solo solo en en lala fase fase de de en este caso el SDK utiliza desarrollo. clave Google Google Maps Maps para para el el certificado certificado de de depuración. depuración. Veamos cómo obtener la clave En caso de querer distribuir tu aplicación, aplicación, una una vez vez terminada terminada tendrás tendrás que que firmarla firmarla con un certificado digital propio. propio. Este Este proceso proceso se se explica explica en en elel último último capítulo. capítulo. remplazar la la clave clave Google Google Maps Maps por por otra, otra, esta esta última última Recuerda que será necesario remplazar digital. asociada a tu certificado digital.

2

http://code.goog le.com/p/androídlissues/detail?id=9155 http://code.google.com/p/android/issues/detai^id^QI

237

El gran libro de Android

Ejercicio paso a paso: Obtención de una clave Google Maps. Maps. 1.

El primer paso va a consistir en descubrir donde está almacenado el certificado digital de depuración. depuración. Utilizando el entorno Eclipse accede al menú Windows > Preferences > Android > Build. Build. Aparecerá el siguiente cuadro de diálogo; diálogo: ::~r~L~~~~~~::::~:::

>:;. General General * Android .. Android íBuMj (~j¡~j DÍ)MS DDMS Launch Laun.ch LogCat LogCat üsdge Stats Us:a.g:eStats }í> Ant Ant ;-p Data Management Management í> Help > Hdp p. lmtaJVUpdate Instaftdjpdate & lava Java E£ l!MH Oat~

2. 2.

..J

Buíld iht>Jd Mttíng~ 3aifd Settingíu &iAutcmati:c.ally ref~em Picurees P..e;ourc.s and and Assets A..\lets fotder folde:r on on build buíld j m Automatically refresh Build output Build output f; Silent tS Silent

:§) Nofmal

{f} \l~rtcse

<> ú\Usets\jtom~s\.androtd\debug,keyst:ore Defauit ciebug feeystore C:\üsef5 jtomas\.android\dBbug.key5£ofe Custom debug keystore : 8 ........ ··········-·

Oefa.uh rl,e.bug keyst:ore

En el cuadro informativo Default debug keystore: aparece la ruta del fichero donde se almacena el certificado digital de depuración. depuración. ruta. Copia en el portapapeles esta ruta.

3.

Ahora necesitamos extraer la huella digital MD5 de este fichero. fichero. Para k e ytool. En Windows extraer la huella digital puedes utilizar el programa keytooi. este programa se encuentra e : \ P r og:r·am en la carpeta C:\Program Files\Java\jre6\bin\ Fiies\Java\jre6\bin\ o en una similar. similar. Abre un intérprete de comandos y sitúate en la carpeta anterior. anterior.

4.

Ejecuta el siguiente comando remplazando el nombre del del fichero por el que acabas de copiar en el portapapeles. portapapeles. kkeytool e yt ool -v ·· v -list ·· list ··keystore ['I'u debug.keystore d ehug . keyst ore path] path.l -keystore [Tu

En nuestro ejemplo: ejemplo: kkeytool eytool -v - v -list - li s t -keystore - k e ysto re C: \ Users \ jtornas\ . android\ debu9 .key sto re C:\Users\jtonias\.android\debug.keystore

gn Sín-.bcic ce! í;iten-a C:\Pro¡Jram files (x86)\Java\jre6\bin>keytool (•86)\Java\jre6\bin>keytool C:\Program Files droidNdebug.keystore dro i d\debug . keys tore Escriba la Escriba la contraseña contrase'a del del almacún almacún de de claves: claves:

.- lli st -keystore keys tore C:\Users\jtoMas\.an C \Users\jtomas \ an list

1 ipo de almacún al macún de claves: el aves . JKS Tipo Proveedor de de almacún almacún de de claves: claves : SUN SUN Proveedor Su almacún almacún de de claves claves contiene contiene entrada entrada 1 Su andro i ddebugkey. 02-feb-2010, 0/- f eb -201 O. PrivateJeyEntry. Pr i val eKeyFnt ry. androiddebugkey. Huella digital de certificado (MD5): (HD5l: FD :RF: 7R :5F: 52: RE: 51:62:84:18:60: lF : Dl: OO :F Huella digital de certificado fD:flF:7fi:5F:52:flE:51:62:84:18:60:lF:Dl:00:F E:79 C:\Program Files Fil es (x86)\Java\jre6\bin> (•86)\Java\jre6\bin> C:\Program

238

Seguridad y posicionamiento posicionamiento

5.

El programa te solicitará una una contraseña contraseña para para proteger proteger el el almacén almacén de de claves. es android android oo no no introduzcas introduzcas nada. nada. AA claves. La contraseña es continuación, la huella huella digital digital del del certificado certificado DM5. DM5. Como Como continuación, te indicará la puedes ver en la captura anterior anterior está está formado formado por por los los siguientes siguientes 16 16 FD:AF:7A:5F:52:AE:Sl:62:B4:18: bytes expresados en hexadecimal: hexadecimal: FD:AF:7A:5F:52:AE:51:62:84:18: 60:1F:Dl:OO:FE:79 60:1F:D1:00:FE:79 Copia en el portapapeles esta secuencia secuencia de de dígitos. dígitos.

6.

Para obtener la clave Google Maps Maps entra entra en en la la siguiente siguiente página página Web: Web: http://code.gooqle.com/android/maps-apí-signup.html http://code.aooaie.com/android/maDs-api-sianup.html

7.

Tendrás que introducir introducir tu huella huella digital digital yy el el usuario usuario de de Google Google Mail Mail que que realiza la solicitud. solicitud. Si Si no dispones dispones de de un un usuario usuario en en Google Google puedes puedes crear crear de minutos. minutos. El El resultado resultado final final se se muestra muestra aa uno nuevo en un par de continuación. continuación,

ala

Graaas clave del del API API de de Android Android Maps. Maps. Gracias Por por suscribirte a la clave Tu clave es:

f HcRHUdAOASRI35:r.llqst6U2'PM5ATMJ !ikl';g [ O}fhSa 0!fiiSa£Hc:RHlMÁOÁSEI86:ri!qst6n?PMSATMjnkKg

Esta clave es válida pata todas las apítcaciones firmadas con el certificada cuya huella dactilar sea;

Esta cirlificado cuya huella dactilar sea:

FD :AF ?A:5F:52:AE:SI:62:84;18:60:1F:DI:00:FE:79 7A : SF:52 :AE:51:&2.84:18.60:1F:D1.00 :FE : 79 FD;¿F

8.

Recuerda copiar en en el el portapapeles portapapeles la la clave clave obtenida, obtenida, la la necesitaremos necesitaremos en en el siguiente ejercicio.

Ejercicio paso aa paso paso:: Un programa de ejemplo con Google Goog/e fí Maps. Maps. Veamos un sencillo ejemplo que que nos nos permite permite visualizar visualizar un un mapa mapa centrado centrado en en las coordenadas geográficas detectadas detectadas por por el el sistema sistema de de posicionamiento. posicionamiento. 1.

Crea un nuevo proyecto proyecto con con los los siguientes siguientes datos: datos: name: EjemploGoogleMaps EjemploGoogle!Vlaps Project ñame; Build Target: Google Apis APis 1,6 1.6 Application ñame: name: Ejemplo Google Google Maps Maps Packagename: org.example.ej org.exarnple.ejemplogooglemaps emplogooglemaps Create EjemploGoogleMaps Cx-eate Activity: EjemploGoogleMaps Min SDK Versión: Version: 44

2.

Añade los siguientes siguientes permisos permisos aa tu tu aplicación aplicación en en Android,xml: Android.xml: INTERNET ACCESS FINE LOCJI.TION ACCESS_F1NE_L0CATI0N COAI-I.SE LOCATION LOCA'I'ION ACCESS COARSE

239

El gran libro de Android Android 3.

Indica que necesitamos la la librería librería de de Google Google Maps Maps en en tu tu aplicación. aplicación. Entra Entra en AndroidManifest. Android1'1anifest. xmi xml yy selecciona selecciona la la lengüeta lengüeta Application. Application. Utilizando Utilizando "Add ..." añade añade un un "Uses library" library'' con con la la librería: librería: com.google, com. google. el botón "Add..." android. ma.ps android.maps

.9a< Android Android Mamtest Manifost Application Application ~ 'APPii~~ú~~-i~l~--

g> tag csscrrbes riescrib6: application-lrvef ap.plicatíon- levrl components componenti cc-ntairted cc.ntainrd¡f> the th-epactcage. pa..: :lcage.as aswetí wellsi ¡ugeneral ger-,era!applicaticn attributes attribut es, W Thr app;catión tag [#}, Define an < 3ppiicstton> tag tn the AndroidManif est jrml -~:-- AWi~~-Attrarute* Attt~t~ Otfines tht atributes .rttribotu specífic sptc:fic lo to the the appücation applic:atlon. Defines the t:Wru:i ...... [i~~~ AUow tiD rre¡Hrentmg Rttow tasfc eparentmg . ..... ............................................. t-f-!s code rias code la.be1 Glstringi:s.pp_name ........................... t~f~~ PErsistent ©slrrng/ 3pp_oame 8r,®*íS«.,.j Persisten» kon :8re»5e«« rnabled hm-,~,~J E:1abled ■árcc^ss.,, ¡ -lefcuqgabk [,~t\m!,I\\~,J Debuggah~ ············r;~J •▼ . Managespace ...lanage spa.'e activitv .. .. . . ,. . . . . .._. . . SíQaíifcu? Allow A llow dear ust f dat• dear use? data ;sppik~tion

:~

applic:at~n

@j Define an < apphc-B'ti·tm> tag m the AndroidManifest.)U'lll

Th~me

[~~Mm]

@dfawahlt~hccn

~

Procr~s

~--~~ ---~----·--

~

~

~d1v.ty

Li"i1i~;;J

[Jiiiti,!~d

Task affinit';

Applw.af¿ao Wod<»

(A| [KJ (S| $4 [Pj (0) (Ñkz Attrlhirtes fot<«r»jí|o©gfo.^Mwfr{«d.tnaf«{usesiitwsry} @ The s~illes s
~~--

En el fichero AndroidManif AndroidMani fest. xml se se añadirá añadirá la la siguiente siguiente línea: línea: est. xmi android:name,"com . google . android.maps" />
4. 4.

Remplaza el contenido contenido del del layout layout main. main. xml xml por por el el siguiente siguiente código: código:
xmlns: a.nd.roid= ' http: //schemas . a.ndro.i cl. com/ap.k:/res/androi.d!! xmlns:android»"http://sch.emas.android.com/apk/res/andró id" android: orient.ation= orientaticn= "vertical !!ve.rt .i.ca.l''" 1

and.ro:id: l ayout w:idth= "f'iil_parent" " fi: l __pa1·ent" android; layout_widthandroid: layout__height= layout_height = ""fil l ____oa.r ent" >> fill_jparent"

<<<"/> android:apiKey»">>>

5. 6.

240

" »> Tu clave clave de de Google Gocgle Maps r'laps <<<" «<" por por la la clave clave de de Google Google Sustituye ">>> Maps obtenida en el apartado apartado anterior. anterior.

Seguridad yy posicionamiento 6.

código de de tjempioGoogieMaps Ej emploGou,JleMaps .java . java por: por: Remplaza el código

public publ ic class c l a s s EjemploGoogleMaps EjemploGoogleMaps extends extends MapActivity MapActivity implements LocationListener LocationListener { pprívate r i vat e MapController mapController; mapCon t r o lle r ; pri vat e MapView mapView; prívate pri vat e LocationManager manejador; mane j ador; prívate ®Override pub lic void onCreate(Bundle onCreate( Bundle bundle) bundle) { public s upe r ..onCreate onCreate(bundle); ssuper (bundle) setContentView (R. (R . layout.inain) layout. ma .i.n ) ;; mapView id.jriapa) mapVi ew == (MapView) findViewById(R. findViewByid(R.id .mapa );; mapView.setBuiltinZoomControls( true ); mapView.setBuíltlnZoomControls(true); //Activa //Activa controles controles toom zoom m a pView. setSatelli te ( t rue) ; mapView.setSatellite(true); //Activa i /Acti,Ja vista vista satélite satélite mapView.setStreetView(false ); //Desactiva StreetView Street.View mapView.setStreetView(false); //Desactiva mapView.setTraffic(false); //Desactiva información información de de tráfico tráfico mapView.setTraffie(false); //Desactiva m a pController == mapView.getControllerO; mapView . getController(); mapController mapController. setZoom ( 14) ; ! / Zoom Zoom 11 ver ve~· todo todo el el mundo mundo mapController.setZoom(14); // inane mane j ador == (LocationManager) (LocationManager) getSystemService (Context. LOCA'T'ION___SERVICE); SERiliCE) ; getSystemService(Context.LGCATION_ manejador requestLocationUpdates (LocationManager. (LocationManager.GPS__PROVIDER, GP$...PROVIDER , manejador.. requestLocationUpdates 110000, 0 0 00 , 1, l, this);

} :;.'Ovel-ride p rot ect ed boolean boolean isRouteDisplayedf) isRouteDisplayed () {{ ©Override protected fal se ; r e t urn false; return

} ©Override onLocationChanged(Location location) location) {{ public void onLocationChanged(Location int lat == (int) (int ) (location.getLatitude() (location.getLatitude() ** 1E6); 1E6); int Ing int lng == (Int) (int ) (location.getLongitudeO (location.getLongitude() ** 1E6); 1E6); GeoPoint point = new ne w GeoPoint(lat, GeoPoint (lat, Ing); lng); mapControl ler. setCenter(point); mapController.setCenter(point); } ©Override public publ ic void onProviderDisabled(String onProviderDisabled(String provider) provider) {} {} @ Overr.i de ©Override publicc void onProviderEnabled(String publi onProviderEnabled(String provider) provide r) {} {}

©Override public void onStatusChanged(String onStatusChanged(String provider, provider, int int status, status, Bundle extras){}

} Si estás utilizando el el emulador, emulador, en en lugar lugar de de un un teléfono teléfono real, real, utiliza utiliza lala vista vista "Emulator Control" para para indicar indicar las las coordenadas coordenadas geográficas geográficas aa visualizar. visualizar. 241

El gran libro de Android Por ejemplo, la Universidad Politécnica de Valencia se se encuentra encuentra en Latitud: Latitud: 39.47987 y Longitud: -0.33874. El resultado se muestra muestra a continuación:

*"* SSM (jiiiufc" API ülSfflQ 11:07 PM

mw

Práctica: Un programa de ejemplo con Google Maps. Maps. 1.

En el ejemplo anterior, modifica algunos parámetros parámetros de de configuración, configuración, como como inicial de de zoom. Verifica Verifica los los resultados. resultados. visualizar recorrido StreetView o nivel inicial

2.

Si estás utilizando un teléfono real real reemplaza reemplaza en en el el código código anterior anterior LocationManager .NETWORK_ PROpor LocationManager.NHTWORK_PROVIDER. las dos dos posiciones posiciones vider. Ejecuta de nuevo el programa y compara las geográficas obtenidas. obtenidas. Locati o nl'lanager . GPS_PROVIDER LocationManager.GPS_PROVIDER

7 .4. Fragmentando Fragmentando los los asteroides asteroides 7.4. Siguiendo con el juego Asteroides, queremos queremos que que cuando cuando el el misil misil alcance alcance un un asteroide, este se divida en varios fragmentos. fragmentos. Para Para conseguirlo conseguirlo puedes puedes seguir seguir las las instrucciones del siguiente ejercicio:

242

Seguridad y y posicionamiento posícionamiento

Ejercicio paso a paso: Fragmentando los asteroides. asteroides. 1.

Convierte la variable local drawable.l\steroide drawabieAsteroide declarada en el constructor de la clase vista VistaJuego, global, que será un array de tres Juego, en una variable global, elementos: elementos: prívate Drawable drawabieAsteroide[]= drawableAsteroide[J= new Drawable[3]; Drawable[3);

2.

En el constructor cuando se quiera trabajar con bitmaps inicializaremos esta variable de la siguiente forma: forma: drawableAsteroide[O] drawabieAsteroide[0]

= context.getResources(). getDrawable (R. drawable. asteroú1e1) ; getDrawable(R.drawable.asteroide!); drawableAsteroide[l] drawabieAsteroide[1] == context.getResources(). context.getResourcesO. getDra•,..able (R. drawable. ast,;oroidt22) ; getDrawable(R.drawable.asteroides); drawableAsteroide[2] drawabieAsteroide[2] = context.getResources(). getDrawable(R.drawable.asteroide3 ); getDrawable(R.drawable.asteroide!); 3.

Y en caso de querer trabajar con gráficos vectoriales: vectoriales: for (int i=O; .i<3; i++) {{ i=0; i<3; ShapeDrawable n ew ShapeDrawable(new ShapeDrawable (new PathShape( Pa.thShape ( ShapsDrawable dAsteroide = new pathAsteroide, 1, 1)); dAsteroide.getPaint() .setColor(Color.WHlTE); dAsteroide.getPaint().setColor(Color.WHITE); dAsteroide. getPaint. () . setStyle (Style. ST'ROKE) ; dAsteroide.getPaint().setStyle(Style.STROKE); d1\steroide.setintrinsicWidth(50 ); dAsteroide.setIntrinsicWidth(50 - ii ..* 14 14); dAsteroide.setintrinsicHeiq-ht(SOdAsteroide.setlntrinsicHeight{50 - ii * 14); 14); drawableAs teroide [ i] == dAsteroide; cU\s teroide; drawableAsteroide[i]

} 4.

Añade al principio del método destruyeAsteroide código: dest.ruyeAstero.i.de (int i) el código: int t a m; int tam; if(Asteroides . get(i) . ge t Drawable() !=drawableAsteroide [2]) { if(Asteroides.get(i).getDrawable()!=drawableAsteroide[2]){ iif(Asteroides.get(i).getDrawable{)==drawableAsteroide[1]){ f {Asteroides .get (i) . getor·awable () ==drawableAsteroide [1]) { tara=2; tam=2; } else {{ tam=l;

} for (int n=0;n
Corrige algún error adicional ocasionado por este cambio. cambio.

243

El gran libro de Android 6. 6.

Prueba los cambios propuestos anteriormente y verifica que cuando se destruye un asteroide no siempre aparece el mismo número de fragmentos. También es posible que el programa se interrumpa. interrumpa. ¿A qué puede deberse este problema? El siguiente ejercicio trata de explicar este extraño comportamiento. comportamiento.

«Ejercicio Ejercicio paso a paso: Introduciendo secciones críticas en Java (synchronized) . Cuando se realiza una aplicación que ejecuta varios hilos de ejecución hay que prestar un especial cuidado a que ambos hilos pueden acceder de forma simultánea a los datos. Cuando se limitan a leer las variables, no suele haber problemas. El problema aparece cuando un hilo está modificando algún dato y justo en este instante se pasa a ejecutar un segundo hilo que ha de leer estos datos. Este segundo hilo va a encontrar unos datos a mitad de modificar, lo que posiblemente cause errores en su interpretación. El método más común para evitar que dos hilos Java, se accedan al mismo tiempo a un recurso es el de la exclusión mutua. mutua. En Java, consigue utilizando la palabra reservada synchronized. synchronized,

1. 1.

Prueba a introducir la palabra reservada synchronized delante del método onDraw() onDraw () y actualizaFisica{). actualizaFisica ().

2. 2.

problema. Verifica si se ha corregido el problema.

~)

Nota sobre Java: La palabra clave synchronized permite definir una sección ""~Nota crítica en Java. Expliquemos en qué consiste: Cada vez que un hilo de ejecución (thread) entra en un método o bloque de instrucciones marcado con synchronized se pregunta al objeto si ya hay algún otro thread que haya entrado en la sección crítica de ese objeto. La sección crítica está formada por todos los bloques de instrucciones marcados con synchronized Si nadie ha entrado en la sección crítica, se entrará normalmente. Si ya hay otro thread dentro, entonces el thread actual es suspendido y ha de esperar hasta que la sección crítica quede libera. libera. Esto ocurrirá cuando el thread, que está dentro de la sección crítica, salga. Dos matizaciones importantes: La primera es que la sección crítica se define a nivel de objeto no de clase. clase. Es decir, cada objeto instanciado no influye en las secciones críticas de otros objetos. objetos. En segundo lugar, solo se define una sección crítica por clase. clase. Aunque métodos, realmente solo hay una sección se haya utilizado synchronized en varios métodos, crítica. crítica.

a

~

244

Práctica: Práctica: Mejorando preferencias en Asteroides 1.

Modifica el programa para que el número de fragmentos generados corresponda con el valor introducido en las preferencias.

2.

Puedes aprovechar para que la reproducción de música de fondo y los efectos de audio sean también configurables por el usuario. usuario.

CAPÍTULO CAPÍTULO 8. 8.

Servicios, Servicios, notificaciones notificaciones y y receptores de anuncios receptores de anuncios

Las aplicaciones que hemos creado hasta el momento estaban formadas por una serie de actividades, cada una de las cuales permitía construir un elemento de usuario. Una aplicación en Android va a disponer de otros tipos de interacción con el usuario. componentes; estos serán estudiados en este capítulo. Cuando sea necesario que parte de una aplicación se ejecute en segundo plano, debajo de otras actividades y, además, además, no precise de ningún tipo de interacción con el usuario, la opción más adecuada es crear un servicio. Un servicio puede estar en ejecución indefinidamente o puede ser controlado desde una actividad. A lo largo de este capítulo aprenderemos las facilidades proporcionadas actividad. por Android para la creación de servicios. servicios. Por otra parte, las notificaciones de la barra de estado constituyen un mecanismo de comunicación vital en Android. Permiten a las aplicaciones que corren en un segundo plano advertir al usuario sobre alertas, avisos o cualquier tipo de información. Las notificaciones se representan como pequeños iconos en la barra superior de la pantalla y se utilizan, utilizan, habitualmente, para indicar al usuario la llegada de un mensaje, una cita de calendario, una llamada perdida o cualquier otra interés. Se trata de una comunicación que no requiere una interacción incidencia de interés. inmediata del usuario; este puede estar utilizando otra aplicación sin ser interrumpido o puede no estar utilizando el teléfono en ese momento. Este hecho hace de las notificaciones un mecanismo de comunicación ideal para un servicio o anuncios. Por lo tanto, este capítulo parece el sitio ideal para para receptores de anuncios. describir cómo podemos crear nuestras propias notificaciones y utilizarlas desde nuestras aplicaciones. aplicaciones. Terminaremos el capítulo estudiando otro componente de una aplicación Android, anuncios. Un receptor de anuncios (BroadcastReceiver en inglés) los receptores de anuncios. permite realizar acciones cuando se producen anuncios globales de tipo broadcast. Existen muchos anuncios originados por el sistema; como por ejemplo Batería baja, llamada entrante,... aunque, aunque, las aplicaciones también pueden lanzar un anuncio

245

El gran libro de Android crear nuevos nuevos tipos. tipos. Los Los receptores receptores de de anuncios anunciostetepermitirán permitiráncrear crear broadcast o incluso crear aplicaciones mucho más integradas integradas en en el el entorno entornodonde dondese seejecutan. ejecutan.

1 Objetivos: •

de servicios servicios en en Android Android.. Describir el uso de

•

Enumerar los pasos pasos aa seguir seguir cuando cuando queramos queramos crear crear un un servicio servicio para para que una tarea se se ejecute ejecute en en segundo segundo plano. plano.

•

las notificaciones notificaciones de de lala barra barra de de estado estado pueden pueden ser ser Mostrar cómo las utilizadas como mecanismo mecanismo de de comunicación comunicación eficaz eficaz con con elel usuario. usuario.

•

de avisos avisos que que pueden pueden utilizar utilizarlas lasnotificaciones. notificaciones. Repasar los tipos de

•

Describir el uso de de un un servicio servicio como como mecanismo mecanismo de de comunicación comunicaciónentre entre aplicaciones.

•

pasos aa seguir seguir para para crear crear un un receptor receptorde deanuncios. anuncios. Enumerar los pasos

•

receptores de de anuncios anuncios más más importantes importantes disponibles disponibles en en Enumerar los receptores Android

8.1. 8.1. Introducción Introducción a a los los servicios servicios en en Android Android

--·

't~"''"

•

,..-·

Poli[Media]: Pol¡[Media |: Los Los servicios servicios en en Android. Android.

't~"''" PoU[MedÍa]: Un Un servicio servicio para para ejecución ejecución en en segundo segundoplano. plano. - - - Poii[Media]: En muchos casos, será necesario necesario añadir añadir un un nuevo nuevo componente componente aa tutu aplicación aplicación para ejecutar algún tipo tipo de de acción acción que que se se ejecute ejecute en en segundo segundo plano, plano, es esdecir, decir,que que no requiera una interacción interacción directa directa con con elel usuario, usuario, pero pero que que queramos queramos que que permanezca activo aunque aunque el el usuario usuario cambie cambie de de actividad. actividad. Este Este es eselel momento momentode de crear un servicio. En Android los servicios servicios tienen tienen una una doble doble función función:: La primera función permite permite indicar indicar al al sistema sistema que que elel elemento elemento que que estamos estamos creando ha de ejecutarse ejecutarse en en segundo segundo plano, plano, normalmente normalmente durante durante un un largo largo Este tipo tipo de de servicios servicios son son iniciados iniciados mediante mediante elel método método período de tiempo. Este startservice () , que startservice(), que indica indica al al sistema sistema que que lolo ejecute ejecute de de forma forma indefinida indefinidahasta hasta que alguien le le indique indique lo lo contrario. contrario.

246

-------------

---··

----

Servicios, notificaciones y receptores de de anuncios anuncios La segunda función permite que nuestra nuestra aplicación aplicación se se comunique comunique con con otras otras aplicaciones, aplicaciones, para lo cual ofreceremos ciertas ciertas funciones funciones que que podrán podrán ser ser llamadas llamadas desde otras aplicaciones. Este tipo tipo de de servicios servicios son son iniciados iniciados mediante mediante elel método método bindservice (), que permite establecer una una conexión conexión con con el el servicio servicio ee invocar invocar alguno de los métodos que son ofrecidos. Cada vez que un servicio es es creado creado por por alguna alguna de de las las razones razones anteriores, anteriores, elel sistema instancia el servicio y llama llama al al método método oncreate oncreate (l. (). Corresponde Corresponde alal servicio servicio adecuado; habitualmente habitualmente creará creará un un hilo hilo de de implementar el comportamiento adecuado; ejecución (thread) secundario donde se se realizará realizará el el trabajo. trabajo. Un servicio en sí es algo muy simple; simple; en en este este capítulo capítulo se se verán verán ejemplos ejemplos de de servicios locales escritos en en muy muy pocas pocas líneas. líneas. No No obstante, obstante, también también pueden pueden complicarse, como veremos al final final del del capítulo capítulo cuando cuando tratemos tratemos de de invocar invocar servicios remotos por medio de una interfaz interfaz AIDL. AIDL. Un servicio, servicio, como el resto de componentes componentes de de una una aplicación, aplicación, se se ejecuta ejecuta en en elel hilo principal del proceso de la aplicación. Por Por lo lo tanto, tanto, sisi el el servicio servicio necesita necesita un un uso uso intensivo de la CPU o puede quedar bloqueado bloqueado en en ciertas ciertas operaciones, operaciones, como como uso uso de redes, debes crear un un hilo diferente diferente para para ejecutar ejecutar estas estas acciones. acciones. También También puedes utilizar la clase rntentservice mtentservice para para lanzar lanzar un un servicio servicio en en su su propio propio hilo. hilo.

8.1.1. Ciclo de vida de un servicio. servicio. Es importante que recuerdes que un un servicio servicio tiene tiene un un ciclo ciclo de de vida vida diferente diferente aa una una actividad. A continuación, podemos podemos ver ver un un gráfico gráfico que que ilustra ilustra el el ciclo ciclo de de vida vida de de los los actividad. servicios: servicios:

startServiceQ Servicio creado por startService() 1

bindServiceQ Servicio creado por bindService() 1

onCreat.e () onCreate()

onCreate () onCreate()

onSt art () / onSta rt.Command () onStart()/onStartCommand()

onBind() onBind(}

Corriendo

Conectado onUnbind() onUnbind{)

onRebind() onRebí.nd ()

Desconectado onDestroy () onDestroyO

anDes t ro y ( ) onDestroyO

Destruido

Destruido Figura 1: Ciclo de vida de /os los servicios. servicios.

247

El gran libro de Android Como acabamos de explicar existen dos tipos de servicios según según como hayan hayan lo tanto, tanto, sido creados. creados. Las funciones de estos servicios son diferentes diferentes y, y, por lo también su ciclo de vida. Si el servicio es iniciado mediante startservice () el sistema sistema comenzará comenzará creándolo yy llamando a su método oncreate (), () . A continuación llamará a a su método método 1 oonStartCommand nStartCommand (Intent intent, int flags, int startld) 1 con con los los argumentos argumentos ejecución hasta hasta que que sea sea proporcionados por el cliente. El servicio continuará en ejecución invocado el método stopService o () O o stopSelf (). NOTA: Si se producen varias llamadas a starcService start:Service () ( j esto est:o no no supondrá supondrá ¡a la creación de varios servicios, aunque sí que se realizarán múltiples múltiples llamadas aa onStartCommancl (). r ). No inqjorta importa cuántas veces el servicio haya sido creado, creatlo,parará onStartCommand parará con la primera invocación de stopService() stopSE.· rv.ice () o stopSelf stopSe.Lf (). í i . Sin embargo, podemos potlemos utilizar el método stopSelf st:opSeli: (int (int: startld) scart:ld) para asegurarnos de que que el servicio no no parará hasta que todas las llamadas hayan sido procesadas.

Cuando se inicia un servicio para realizar alguna alguna tarea en en segundo plano, plano, el proceso donde se ejecuta podría ser eliminado ante una una situación situación de de baja memoria. memoria. ante esta esta circunstancia circunstancia Podemos configurar la forma en que el sistema reaccionará ante ons tartcommand (). Existen Existen dos modos modos según el valor que devolvamos en onstartcommandO. principales: STi\RT...sTICKY queremos que que el sistema sistema trate de de crear crear principales: devolveremos start sticky si queremos memoria suficiente. suficiente. Devolveremos Devolveremos de nuevo el servicio cuando disponga de memoria START_NOT_STICKY nuevo sólo cuando cuando start_not_sticky si queremos que el servicio sea creado de nuevo llegue una nueva solicitud de creación. creación. Teniendo en cuenta que los servicios pueden estar largo largo tiempo en en ejecución, ejecución, el el un asunto de de gran gran es un ciclo de vida del proceso que contiene nuestro servicio es situaciones donde donde el sistema necesite necesite importancia. Conviene aclarar que en situaciones memoria para conservar un servicio, este será siempre menos prioritario que que la la otras actividades actividades en en actividad visible en pantalla, aunque más prioritario que otras segundo plano. Dado que el número de actividades visibles es siempre siempre reducido, reducido, un un servicio sólo será eliminado en situaciones de extrema necesidad de de memoria. memoria. Por Por otra parte, si un cliente visible está está conectado aa un servicio, servicio, éste éste también también será será considerado como visible, visible, siendo tan prioritario como el cliente. cliente. En En el el caso caso de de un un proceso que contenga varios componentes, componentes, por ejemplo una actividad actividad yy un servicio, servicio, su prioridad se obtiene como el máximo de sus componentes. componentes. bindService (Intent servicio, servicio, ServiceConnection ServiceConnection Podemos también utilizar bindServiceíIntent conexion, int flags) para obtener una conexión persistente con con un un servicio. servicio. Si Si conexión, dicho servicio no está en ejecución, ejecución, será creado (siempre que que el el flag flag BU.lD_.l\tJTO_CRE.l\TE activo), llamándose al al método onCreate oncreate (), (), p6r0 pero DO no S6 se I{3rn3r3 llamará bind_auto_create esté activo), a onStartCosTimand onStartCommand (>. (). En SU su lugar se llamará al método onBindíIntent onBind ( Intent intención) intencion) que ha de devolver al cliente un objeto iBinder IBinder a través del cual se se podrá establecer establecer servicio. Esta comunicación se establece establece por medio de de una comunicación entre cliente y servicio.

11

el método llamado llamado será onstartí). onstart () . En En En versiones del API inferiores a 2.0 el versiones recientes se mantiene por razones de compatibilidad. compatibilidad.

248

Servicios, notificaciones notificaciones yy receptores de de anuncios anuncios una interfaz escrita en AIDL, AIDL, que que permite permite ei el intercambio intercambio de de objetos objetos entre entre aplicaciones aplicaciones El servicio servicio permanecerá permanecerá en en ejecución ejecución tanto tanto tiempo tiempo que corren en procesos separados. separados. El como la conexión esté establecida, establecida, independientemente independientemente de de que que se se mantenga mantenga oo no no lala referencia al objeto iBinder. IBinder. También es posible diseñar diseñar un un servicio servicio que que pueda pueda ser ser arrancado arrancado de de ambas ambas (star-tservice () () yy bindservice bindService ()). () ). Este Este servicio servicio permanecerá permanecerá activo activo se se formas (startservice desde la la aplicación aplicación que que lo lo contiene contiene oo sisí recibe recibe conexiones conexiones desde desde ha sido creado desde otras aplicaciones. Todo servicio terminará terminará llamando llamando al al método método ancestro ancestro () ( J cuando cuando vaya vaya aa terminar terminar de forma efectiva. efectiva.

8.1.2. Permisos Podemos conseguir que que el el acceso acceso global global aa un un servicio servicio declarándolo declarándolo en en lala etiqueta etiqueta de AndroidManifest An droidManifest..xmi. x ml. También También podemos podemos definir definir un un permiso permiso para para restringir su acceso. acceso. En este este caso, caso, las las aplicaciones aplicaciones han han de de declarar declarar este este permiso, permiso, en en su su propio propio manifiesto. manifiesto. con el correspondiente un servicio. servicio. De De Podemos definir un permiso permiso para arrancar, arrancar, parar parar oo conectarse conectarse aa un forma adicional, podemos pociemos restringir restringir el el acceso acceso aa funciones funciones específicas específicas de de las las ofertadas por un servicio. servicio. Para Para este este propósito, propósito, podemos podemos llamar llamar al al principio principio de de checkCallingPermission (String) para para verificar verificar sisi elel cliente cliente nuestra función a checkcaiilngpermission(string) en concreto. concreto. dispone de un permiso en Para más información sobre sobre permisos permisos se se recomienda recomienda la la lectura lectura del del capítulo capítulo 7.7.

8.2. Un servicio servicio para para ejecución ejecución en en segundo segundo plano plano Dentro de los los dos usos usos de de un un servicio, servicio, el el más más frecuente frecuente es es permitirnos permitirnos ejecutar ejecutar parte de nuestra aplicación aplicación en en segundo segundo plano. plano.

Ejercicio paso a paso: paso: Un servicio servicio para para ejecución ejecución en en segunsegundo plano de reproducción de música. música. Veamos un ejemplo de servicio servicio que que corre corre en en el el mismo mismo proceso proceso de de la la aplicación aplicación que lo utiliza. El servicio servicio será será creado creado con con la la finalidad finalidad de de reproducir reproducir una una música música de de la actividad actividad principal. principal. fondo y podrá ser arrancado arrancado yy detenido detenido desde desde la 1.

un nuevo proyecto proyecto con con los los siguientes siguientes datos: datos: Crea un Project ñame: name: ServicioMusica ServicioMusica Bui.ld Target : Android 2.0 2. O Build Target; Appl i.cation ñame: name: Servicio Servicio de de Música t"lúsica Application

Package ñame; name: org.example.serviciorausica org.example.serviciomusica Create Activity; Activity: ActividadPrincipal ActividadPrincipal Min SDK Versión: Version: 5

249

El gran libro de Android Android 2.

Remplaza el código código del del layout layout main. main. xmi xml por: por: -

sion= "i "?>
x1nlns: android= ''11 t tp: //sclJernas . android. coln/a:pk/Les / and.r:oid '' xmlns;android»"hctp://schemas.android.com/apk/res/android"

android:orientatio n=" vertical" android:orientation="vertical" android: layout_width= " fill t i l l ___parent" parent" android:layout_width= android: Iayout_height= layo ut height= "fill_„parent fill. 1:•are:.1t "> "> música"/>

irap_cont:ent:" android: layout_height= andr·oid: text= text = "Arrancar' u.Ar:rancar- servicio seLvicio "/> "1 > android: E;ervicio 11 / > android:text="Detener <ÍLinearLayout> 11

11

11

3. 3.

11

ver se se trata trata de de un un layout layout muy muy sencillo, sencillo, con con un un texto texto yy dos dos Como puedes ver botones: botones:

8:31 PM

Arrancar servicio Detener servicio

4. 4.

de la la actividad actividad por: por: Remplaza el código de public clasa class ActividadPrincipal ActividadPrincipal extends extends Activity Acti vit y

{

@()v·er:c:Lde Sí-Ove rride

public void onCreate(Bundle o n Create (Bundl e savedlnstanceState) savedinstanceState) super.onCreate(savedinstanceState); super.onCreate(savedlnstanceState);

{

setContentView (R .layout . ma.in ) ;; setContentView(R.layout.main) Button arrancar == (Button) (Button) findViewById(R.id.óocori__arx-ar.¡car) findViewByid(R.id . .bocon_ a .rrancar) ,• ; arrancar.setOnClickListener(new OnClickListe n er () {{ arrancar. setOnClickListener (new OnClickListener() public void onClick(View onClick( Vi e w view) view) {

250

,-----------------------------

~

---

-----

Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios startService (new Intent(ActividadPrincipal.this, Intent(ActividadPrinc ipal . this, startService(new ServicioMusic a . class ) ); ServicioMusica.class));

}} ) ; }});

Button detener == (Button) (Butto n) findViewById(R.id.i»ton_detener); findViewByid (R . id. lx)!:on_detener); detener.setOnClickListener(new det e ne r . setOnClickLi s t e ner (new OnClickListener() OnCli c k Liste n e r( ) {{ public vold void onClick(View o n Cli c k(Vi e w view) v iew) {{ stopService(new Intent(ActividadPrincipal.this, Intent(ActividadPrincipal.this, ServicioMusic a.class)); ServicioMusica.class));

}} }}); ) ;

} } 5. 6,

nueva clase, clase, ServicioMusica, serviciol>1usica, con con el el siguiente siguiente código: código: Crea la nueva public class ServicioMusica ServicioMusica extends extends Service Service {{ r"lediaPlayer reproductor; MediaPlayer

@Override ©Override public void onCreateí) onCreate() {{ Toast ..make·re:xt ( this ~ 'Servicio creado". creado'~, Toast.makeText(this,"Servicio Toast. LENGTH_SHORT) LENGTH_~SHORT).-ShowO show ();; MediaPlayer . c.~:eat:e ( this , R.raw.audio); R . raw.audio); reproductor == MediaPlayer,create(this, 1

} @Overri.de ■SOverride public int onStai-tCommand(Intent or$tartCommand(Intent intención, intencion, int i nt flags, flags, int int idArranque) id~ranque) Toast.make'l'ext:( this ,"Servicio arrancado arrancado"+ idll.rranque, Toast.makeText(this,"Servicio "+ idArranque, Toast. LE'.NG'TH_SJ-IbRT) .show(); . show {) ¡ Toast.LENGTH_SHGRT) rep roductor.start(); reproductor.start(); return START_STICKY; START__STICKY;

} ©Override public void onDestroyO onDestroy() { Toast. make:T'ext ( this , "Serv.i cio detenido", detenido", Toast.makeText(this,"Servicio

Toast. LENGTH__SHORT) ..show(); show () ;

Toast.LENGT~ _SHORT)

reproductor.stop();

} @Qverride ■SOverride public IBinder onBind(Intent onBind(lntent intención) intencion) return nuil; null ;

{

} }

251

{

El gran libro de Android Android 6. 6.

Android~1anifest. xmi xml yy añade añade lala siguiente siguiente línea línea dentro dentrode de Edita el fichero AndroidManifest. la etiqueta . .

/>
7.

Crea una nueva nueva carpeta carpeta con con nombre nombre raw raw dentro dentro de de lala carpeta carpeta res. res. Arrastra a su su interior interior el el fichero fichero audio.mps. audi o. mp3 .

NOTA: puedes utilizar cualquier fichero fichero de de música música compatible compatible con con Android Androidsiempre siempre

audio. que el nombre de fichero fichero sea sea de de audio.

8.

la aplicación aplicación yy comprueba comprueba su su funcionamiento. funcionamiento. Puedes Puedes terminar terminar lala Ejecuta la actividad pulsando el botón botón para para retroceder retroceder yy verificar verificar que que elel servicio servicio continúa en marcha. marcha.

9.

Verifica que que aunque aunque pulses pulses varias varias veces veces el el botón botón "Arrancar "Arrancar servicio", servicio", este este no no vuelve a crearse, pero pero sí sí que que vuelve vuelve aa llamarse llamarse alal método método oonstartcommand n startcommand (). () . Además, Además, con con solo solo una una vez vez que que pulses pulses en en "Detener "Detener servicio" este parará. parará servicio" este

10. Arranca la la aplicación aplicación Ajustes/Aplicaciones/Servicios Ajustes/Aplicaciones/Servicios en en ejecución/Servicio ejecución/Servicio servicio. de Música. Música. Desde aquí aquí puedes puedes obtener obtener información información yy detener detenerelel servicio. NOTA : Esta aplicación no está disponible disponible en en todas todas las las versiones. versiones. NOTA:

Servicios 1 ServidoMusic I Iniciado por aplica Servicio iniciado por detención del servici errores en la aplicac ■Hil Procesos

1

I Servicio de M I org.example.servi! Proceso principal en

8.2.1.. Los métodos 8.2.1 métodos onStartCommcid() onStartCommad() yy onStart() onStart() Cuando se crea un un servicio servicio hay hay que que tener tener en en cuenta cuenta una una cuestión cuestión de de compatibilidad. compatibilidad. El método onstartcommand o n startcommand {) () aparece aparece aa partir partir del del nivel nivel de de API API 5,5, en en sustitución sustitución de de

252

Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios trabajas con con una una versión versión inferior inferior aa la la 2.0, 2.0, remplaza remplaza este este método método por por onstart (). Si trabajas siguiente: el código siguiente:

Ejercicio paso aa paso: Los Los métodos métodos onStartCommandQ onStartCommand() yy onStart(). 1.

ejercicio anterior anterior el el método método onstartcommand onstart.command{)( l Comenta en el ejercicio

2.

siguiente método: método: Añade el siguiente ©Override public void onStart(Intent onStart(Intent intent, intent, int int startld) startld) {{ Toast.maJceText(this, Toast.makeText (this, "Servicio "Servicio arrancado arrancado "" ++ startld, startld, Toast. LENGTH_ SHORT) . show(); Toast.LENGTH_SHORT).show(); reproductor.start();

3. 3. 4.

} programa funciona funciona exactamente exactamente igual. igual. Verifica que el programa método onstart onstart í) () yy quita quita el el comentario comentario alal método método Comenta el método onStartCommand (). onStartCommand(). Si lo comparamos con onstartcommand onstartcommand (), () , este este último último tiene tiene un un parámetro parámetro más y permite devolver devolver un un resultado. resultado. Veamos Veamos con con más más detalle detalle como como sus sus parámetros pueden ser ser utilizados utilizados para para obtener obtener información información valiosa: valiosa: public int onStartCommand (Intent (Intent intención, intencion, int int flags, flags, int int idArranque)

Llamado cada vez que que un cliente cliente inicializa inicializa un un servicio servicio mediante mediante el el método método startservic () . Los Los parámetros parámetros se se detallan detallan aa continuación: continuación: startservicee (). intencion intención flags

objeto mtent I n tent. que que Un objeto startService(Intent) startService{Intent)..

se se

indicó en en indicó

llamada lala llamada

sobre cómo cómo comienza comienza la la solicitud. solicitud. Puede Puede ser ser 0,O, Información sobre ST.Z\RT_ FLAG_ REDELIVERY O O START_FLAG_RETRY. START_FLAG_ RETRY. Un Un Valor valor distinto distinto de de START_FLAG_REDELIVERY O un servicio servicio tras tras detectar detectaralgún algún problema. problema. 0 se utiliza para reiniciar un

idArranque

único representando representando la la solicitud solicitud de de arranque arranque Un entero único el método método específica. Usar este este mismo mismo estero estero en en el específica. Usar stopSelfResult (int idArranque) . stopSelfResult{int idArranque).

En el retorno, describe describe cómo cómo ha ha de de comportarse comportarse el el sistema sistema cuando cuando elel proceso del servicio servicio "sea matado" matado" una una vez vez que que el el servicio servicio ya ya se se ha ha inicializado. Esto puede ocurrir inicializado. ocurrir en en situaciones situaciones de de baja baja memoria. memoria. Los Los siguientes valores están están permitidos: permitidos:

start_sticky: STAH.T_STICKY: Cuando Cuando sea sea posible posible el el sistema sistema tratará tratará de de recrear recrear el el servicio, servicio, se realizará una llamada llamada aa onstartcommand onstartcommand o () pero pero con con el el parámetro parámetro intencion null. Esto Esto tiene tiene sentido sentido cuando cuando el el servicio servicio puede puede intención igual aa nuil. arrancar sin información información adicional, adicional, como como por por ejemplo, ejemplo, el el servicio servicio mostrado para la la reproducción reproducción de de música música de de fondo. fondo.

253

El gran libro de Android El El sistema sistema no no tratará tratará de de volver volveraacrear crearelelservicio, servicio,por porlolo tanto el parámetro parámetro intencion intención nunca nunca podrá podrá ser ser igual igual aa null. nuil. Esto Esto tiene sentido cuando el el servicio servicio no no puede puede reanudarse reanudarse una una vez vez interrumpido.

START_NOT_STICKY: start_not_sticky:

START start_redeliver_intent: El sistema sistema tratará tratará de de volver volver aa crear crearelel servicio. servicio. - REDEI. IVER- INTENT.: El El parámetro intencion intención será será el el que que se se utilizó utilizó en en lala última última llamada llamada startService[Intent) startService(Intent).. START_STTCKY_COHPATIBILITY: start_sticky_compat.ibili.ty: Versión Versión compatible compatible de de S'I'ART_STICKY, start_sticky,que queno no

() Sea garantiza que onStartCommand onStartCommand() Sea llamado llamado despuéS después de de que que elel proceso "sea matado". matado".

de la la barra de estado estado 8.3. Las notificaciones de arra de

__..,.

..~~~ ~'"" IsÍÍMÍÉ lililí lili;

Poii[Media]: Poli[Media |: Notificaciones Notificaciones en en Android. Android.

La barra de estado de de Android Android se se encuentra encuentra situada situada en en lala parte parte superior superiorde delala pantalla. La parte parte izquierda izquierda de de esta esta barra barra está está reservada reservada para para visualizar visualizar notificaciones. Cuando Cuando se se crea crea una una nueva nueva notificación, notificación, aparece aparece un un texto texto desplazándose en la la barra barra y, y, aa continuación, continuación, un un pequeño pequeño icono ¡cono permanecerá permaneceráen enlala barra para recordar al al usuario usuario la la notificación. notificación

8:44 PM El usuario puede arrastrar arrastrar la la barra barra de de notificaciones notificaciones hacia haciaabajo, abajo, para paramostrar mostrarelel listado de las notificaciones notificaciones por por leer. leer. Un Un posible pos bleejemplo ejemplose semuestra muestraaacontinuación: continuación:

November 10, 2010

USffi ® 8:45 PM

(No service} Notifkations !""""" . do mussca • ' Reproduciendo música •^ •·R epro duc1en información adicional Información

8:38 PM

Una notificación puede puede ser ser creada creada por por un un servicio servicio oo por por una una actividad. actividad.Aunque Aunque dado que la actividad actividad dispone dispone de de su su propio propio interfaz interfaz de de usuario, usuario, parece parece que que las las notificaciones son son el el mecanismo mecanismo de de interacción interacción más más interesante interesante del del que quedisponen disponen

254

- - - - - - -

- - -

Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios los servicios. serv1c1os. Las notificaciones notificaciones pueden pueden crearse crearse desde desde un un segundo segundo plano, plano, sin sin interferir con la la actividad actividad que que en en ese ese momento momento esté esté utilizando utilizando el el usuario. usuario.

Ejercicio paso a paso: Las Las notificaciones notificaciones de de la la barra barra de de estado. estado. 1.

Abre el proyecto ServicioMusica. ServicioMusica.

2.

siguientes variables variables al al comienzo comienzo de de la la clase: clase: Declara las siguientes private NotificationManager Not.ificati.ont-1:anager nm; nm; pri vate static stat ic final fina l int int ID_NOTIFlCACION_CREAR .ID_NO'l'l FICACION_CRE"'flR == 1; 1; private

3.

una referencia referencia al al NotificationManager Noti.fica tíoni'1anager del del sistema. sistema. Vamos a obtener una las siguientes siguientes variables variables yy añade añade al Para ello, declara las al método método oncreate o ncreate()( J la siguiente línea: línea: nm (Notifi.cationi"lanager) getSystem.Service (NOTIFICATION__8ERiliCE) ; nm -~ (NotificationManager)getSystemService(NOTIFICATION^SERVICE);

4.

una nueva nueva notificación. notificación. Añade Añade la la siguiente siguiente línea línea en en elel Vamos a crear una método onStartCommand {); ():

notificación ="' new Notification( notificacíon Notificatíon( R.drawable.icon, R.drawable.i con, MGsica", "Creando Servicio de Música", Systern. currentTiineMi cur.rent.:'Ti.Jnc:.-:l·.J.i llís .7..7. i.t; {) () )) ;; System,

Como puedes ver, ver, en el constructor constructor de de una una notificación notificación hay hay que que indicar indicar 33 parámetros: el icono aa visualizar visualizar (en (en el el ejemplo ejemplo usamos usamos el el mismo mismo que que elel de la aplicación. aplicación. En MOTODEV se llama llama íc^iaucher), ic _laucher ), el el texto texto aa mostrar mostrar yy visualice (en (en el el ejemplo ejemplo indicamos indicamos que que ahora ahora cuándo queremos que se visualice mismo). mismo). 5.

Define información adicional adicional que que será será utilizada utilizada en en la la ventana ventana de de la actividad actividad notificaciones. información incluye incluye el el mensaje mensaje expandido expandido yy la notificaciones. Esta información sobre la la notificación: notificación: a ejecutar cuando se pulse sobre Pendinglntent intencionPendiente i ntencionPendiente == Pendinglntent.getActivity( Pendinglntent.getAct ivity( this O, new Intentíthis, Intent( this , ActividadPrincipal.class), Act.ividadPrincipal. class ), 0); 0); this,, 0, not.ificacion.setLat.est.Eventinfo( this , "Reproduciendo "Reproduciendo música", música", notificación.setLatestEventlnfo(this, "información adicional", intencionPendiente); intencionPendiente};

Cuando el usuario abra la ventana ventana de de notificaciones, notificaciones, podrá podrá ver ver información información adicional formada por por un título título yy un un texto texto explicativo. explicativo. Además Además se se podrá podrá asociar una actividad para que que se se ejecute ejecute cuando cuando el el usuario usuario pulse pulse sobre sobre lala notificación. En el ejemplo se notificación. se crea crea un un Pendinglntent Pendinglntent asociado asociado aa lala actividad actividad ActívidadPr incipal. Por supuesto, supuesto, también también puedes puedes crear crear una una nueva nueva ActividadPrincipal. con este este fin. fin. En En un un ejemplo ejemplo más más actividad para usarla exclusivamente exclusivamente con complejo, puedes pasar los los parámetros parámetros adecuados adecuados aa través través del del intent, rntent, para para que la actividad conozca conozca los los detalles detalles específicos específicos que que provocaron provocaron lala notificación (por ejemplo, ejemplo, el número número de de teléfono teléfono que que provocó provocó la la llamada llamada perdida). perdida).

255

El gran libro de Android Androíd Una notificación puede puede tener tener otros otros parámetros, parámetros, por por ejemplo, ejemplo, puede puede sonido, puede puede hacer hacer vibrar vibrar elel teléfono teléfono oo puede puede hacer hacer reproducir un sonido, parpadear un LEO LED del del teléfono. teléfono. Puedes Puedes consultar consultar elel siguiente siguiente punto punto sisi estás interesado en en alguno alguno de de estos estos aspectos. aspectos. 6.

Vamos a pasar pasar la la notificación notificación creada creada alal Notifi.cationtvlanager. Notif icationManager. Para Paraello ello añade: añade: nm. notify ( l"D_lVO(TLFICACl"OIV_CRE'l lR, notificacion) nm.notiiy(ID_NOTIFICACION_CREAR, notificación);¡ ... // resto () resto de de código código de de onCreate onCreateO

7.

Queremos que si si el el servicio servicio deja deja de de estar estar activo, activo, se seelimine eliminelalanotificación. notificación. Para ello añade en en onDestroy onDestroy{)():: nm. cancel {ID_NO~'lPICACLON_ CREi'l.R ) ;; nm.cancel{ID_NOTIFJCACION_CREAR)

Este paso es opcional. opcional. Muchas Muchas notificaciones notificaciones han han de de permanecer permanecervisibles visibles aunque el servicio que las las creó creó sea sea destruido. destruido. En En nuestro nuestro caso, caso, dado dadoque que estamos anunciando que que un un servicio servicio de de reproducción reproducción de de música música está está activado, la notificación deja deja de de tener tener sentido sentido alal desaparecer desaparecerelelservicio. servicio.

Práctica: Uso del del servicio servicio de de música música en en Asteroides. Asteroides. 1.

Copia la clase clase servicior
2.

Corrige los errores errores que que hayan hayan aparecido apaiecido para para adaptarla adaptarlaalalnuevo nuevoproyecto. proyecto.

NOTA: Mantén Mcrntén la versión versión del del SDK SDK de de Asteroides Asteroides en en 1.6. 1.6.

3.

4.

En el ejercicio anterior, anterior, cuando cuando se se visualizan visualizan los los detalles detallesde delalanotificación notificación dadPrincipal. Modifica se podía lanzar la la actividad actividad Activi ActividadPrincipai. Modificaelelcódigo códigopara para que se lance la actividad actividad Asteroides. Asteroides. Si

realizas el el punto punto anterior anterior simplemente simplemente lanzando lanzando lala actividad actividad

Asteroides Asteroides,, cuando el el usuario usuario pulse pulse sobre sobre lala notificación notificación elel sistema sistema

lanzará una nueva tarea, tarea, aunque aunque ya ya exista exista una una previa. previa. Si Si tete interesa interesaque que no se lance una nueva nueva tarea tarea cuando cuando ya ya exista exista una una previa, previa, añade añadelalalínea línea en negrita en AndroidManifest.xml.
android :na me= " .Asteroides " andróid:name=".Asteroides" andro id: label = ""@string/app_name" @string/app .. na.rne " android:label= android:launchMode="singl eTask" > android:launchMode="singleTask">

5.

256

Lanza el servicio en n create ( 1 de en el el método método oonCreateO de lala actividad actividad Aster.·oides. Asteroides. Para el servicio en en el el método método onDestroy onDestroy (). ().

Servicios, notificaciones notificaciones yy receptores de de anuncios anuncios

8.3.1. Configurando Configurando tipos tipos de de avisos avisos en en las las notificaciones notificaciones Como hemos comentado, una una notificación notificación puede puede utilizar utilizar diferentes diferentes métodos métodos para para alertar al usuario de de que se se ha ha producido. producido. Veamos Veamos algunas algunas opciones. opciones.

8.3.1.1. Asociar un sonido sonido Si consideras que una una notificación notificación es es muy muy urgente urgente yy deseas deseas que que el el usuario usuario pueda pueda conocerla de de forma inmediata, inmediata, puedes puedes asociarle asociarle un un sonido sonido que que será será reproducido reproducido cuando aquélla se produzca. produzca. Si quieres asociar un un sonido sonido de de notificaciones notificaciones por por defecto, defecto, utiliza utiliza lala siguiente siguiente sentencia: sentencia: notificacion.defaults notificación.defaults

!~ Notification.DEFAULT_SOUND; Notification . DEFP..ULT_SOUND;

Si prefieres reproducir un un sonido sonido personalizado personalizado para para la la notificación, notificación, puedes puedes almacenarlo en una carpeta yy usar: usar: notificacion# sound -:.:.:. Uri.parse{"file:///sdcard/carpet.a/tono.mp3"); Uri · l')arse {~~file:/ ;'/sdcard/carpet.a/tono. mp3") ; notificación.sound

Si el fichero de audio audio se se encuentra encuentra almacenado almacenado en en el el ContentProvider ContentProvider utilizar la la siguiente siguiente sentencia: sentencia: MediaStore, puedes utilizar notificacion. sound == notificacion.sound Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, Uri. withAppendedPath (Audio .Media. INTERNAI.,_CONTENT_URI, "6"); "6''};

Tendrás que sustituir el el parámetro parámetro "6" "6" por por el el ID ID del del elemento elemento que que quieras quieras reproducir. Si desconoces reproducir. desconoces este este ID, ID, puedes puedes realizar realizar una una consulta consulta al al ContentProvider. ContentProvider. Para más información consulta consulta el el apartado apartado 9.7. 9.7.

8.3.1.2. Añadiendo vibración También es posible alertar alertar al al usuario usuario haciendo haciendo vibrar vibrar el el teléfono. teléfono. Puedes utilizar la vibración vibración por defecto: defecto: notificacion.defaults J= Not Notification.DEFAULT_VIBR.l\TE; notificación.defaults j= i f icat i on.DEFAULT_VTBRATE;

O, por el contrario, tu propio O, propio patrón patrón de de de de vibración: vibración: long[] vibrate == {0,100,200,300}; {0,100,200,300}; notification.vibrate == víbrate; vibrate; notification.víbrate

El array define un patrón patrón de de longitudes longitudes expresadas expresadas en en milisegundos, milisegundos, donde donde elel primer valor es el tiempo sin vibrar, vibrar, el el segundo segundo es es el el tiempo tiempo vibrado, vibrado, el el tercero tercero sin sin vibrar y así sucesivamente. sucesivamente. Este Este array array puede puede ser ser tan tan largo largo como como queramos, queramos, pero pero solo será activado una vez, vez, no no se se repetirá repetirá de de forma forma cíclica. cíclica.

8.3.1.3. Añadiendo parpadeo parpadeo de de LED LEO Algunos móviles disponen disponen de de diodos diodos LED LEO que que pueden pueden ser ser utilizados utilizados para para avisar avisar alal usuario que se ha producido producido una una notificación. notificación. Este Este método método es es muy muy interesante interesante sisi elel grado de urgencia del aviso aviso no no es es lo lo suficientemente suficientemente alto alto para para usar usar uno uno de de los los métodos anteriores. anteriores.

257

El gran libro de Android Podemos utilizar el aviso de LEO LED configurado configurado por por defecto: defecto: notificacion.defaults notificación.defaults i~ j- Notification.DEF'AULT_LIGH'I'S; NotifÍGation.DEFAüLT_LIGHTS;

O podemos definir una cadencia de tiempo tiempo yy color color específica específica para para nuestra nuestra notificación: notificación:

= OxffOOffOO; notificacion.ledARGB = notificacion.ledOnMS = = 300; notificacion.XedOffMS = - lODO; 1000;

not i ficacion .ledOfft~S

not i ficacion. flags ¡|= .~ Notification. FLAG_SHO\'i_LIGHT'S; notificación.flags Notification.FLAG__SHOW_LlGH'rS;

En el ejemplo anterior se empieza empieza indicando indicando que que queremos queremos que que el el LEO LED se se ilumine en color verde durante 300 ms ms yy luego luego esté esté apagado apagado durante durante 11 segundo. segundo. Esta secuencia se repetirá de de forma forma cíclica cíclica hasta hasta que que el el usuario usuario atienda atienda lala notificación. Conviene destacar que no todos los móviles móviles disponen disponen de de un un LEO LED para para este este propósito. Además, no todos los los colores colores pueden pueden ser ser utilizados, utilizados, siendo siendo el el color color verde verde el más habitual para indicar una una notificación. notificación.

#- •# i m m Práctica: Una notificación de socorro. socorro.

1.

En el proyecto anterior, crea un un nuevo nuevo botón. botón.

2.

Al pulsar este botón se lanzará lanzará una una nueva nueva notificación notificación que que será será mostrada mostrada 5 segundos más tarde.

3.

Esta notificación mostrará el texto texto "¡SOCORRO!" "¡SOCORRO!"

4.

El audio de la notificación notificación será será una una grabación grabación de de voz voz que que diga diga "¡SOCORRO!"

5.

La notificación hará vibrar el teléfono telefono con con el el mensaje mensaje internacional internacional de de socorro SOS codificado en Morse. Para Para conseguir conseguir esto esto haz haz vibrar vibrar el el teléfono con una sucesión de tres tres pulsos pulsos cortos, cortos, tres tres largos largos yy otros otros tres tres cortos( ). cortos (.... . . --— ... . . .).

8.4. 8.4. Receptores Receptores de de anuncios anuncios Un receptor de anuncios (BroadcastReceiver) (BroadcastReceiver) recibe recibe yy reacciona reacciona ante ante anuncios anuncios globales de tipo broadcast, aunque aunque las las aplicaciones aplicaciones también también pueden pueden lanzar lanzar un un anuncio broadcast broadcast.... Existen muchos muchos originados por por el el sistema; sistema; como como por por ejemplo ejemplo Batería baja, ... (se baja, llamada entrante, entrante,... (se muestra muestra una una tabla tabla más más adelante). adelante). Los Los receptores de anuncios no tienen interfaz interfaz de de usuario, usuario, aunque aunque pueden pueden iniciar iniciar una una actividad o crear una notificación para informar informar al al usuario. usuario. El ciclo de vida de un BroadcastReceiver BroadcastReceiver es es muy muy sencillo sencillo pues pues solo solo dispone dispone del del ve (). método onRecei onReceíve o. De hecho un un objeto objeto BroadcastReceiver BroadcastReceiver sólo sólo existe existe durante durante lala llamada a onReceive (). El sistema crea el onReceiveO. el BroadcastReceiver, BroadcastReceiver, llama llama aa este este método método yy cuando termina destruye el objeto. Un Un detalle importante importante es es que que no no hace hace falta falta tener tener en en marcha la aplicación donde se define el BroadcastReceiver BroadcastReceiverpara para que que este este se se active. active. 258

Servicios, notificaciones yy receptores de anuncios El método onRece.i ve () es ejecutado por el hilo principal de onReceiveO de la aplicación; aplicación; por por lo lo tanto no puede bloquear al sistema (ver ciclo de vida de de una actividad). actividad). Si Si tienes tienes que realizar una acción que puede bloquear el sistema tendrás que lanzar lanzar un un hilo hilo secundario. secundario. Si queremos una acción persistente en el tiempo resulta resulta muy muy frecuente frecuente lanzar un servicio. Desde un BroadcastReceiver no no puedes mostrar mostrar un un cuadro cuadro de de diálogo o unirte a un servicio (bindService ). Para lo primero, en su (bindservi.ee () {)). su lugar lugar puedes puedes startService (()l para para lanzar una notificación. Para lo segundo, puedes utilizar star·tservice arrancar un servicio. Una aplicación puede registrar un receptor de anuncios de dos dos maneras: maneras: en en AndroidManifest. xml y en tiempo de ejecución mediante mediante el el método método AndroidManifest.xml registerReceiver{) . registerReceiver().

8.4.1. Receptor de anuncios registrado en AndroidManifest.xml es muy muy sencillo. sencillo. No No Registrar un receptor de anuncios desde AndroidManifest.xml es tienes más que introducir las siguientes líneas en AndroidManifest.xml AndroidManifest.xml dentro dentro de de la la etiqueta : : > < intent- f i l ter·> <.action android: name= l'and.:co.i d~ i.ntt..-:nt.: . n.t-:..T:CEF > creceiver android: android:name="ReceptorL1amsda"> < intentr- f .i. J. ter·> > action.PHONE_STATE" <Í int:ent-filter>

<ít:eceiver>

De esta forma registramos registramos un un receptor receptor de de anuncios anuncios que que se se activará activará cuando se produzca una una llamada llamada 3.

Tenemos que pedir pedir permiso permiso para para leer leer elel estado estado del del teléfono. teléfono. Añade Añade lala dentro de de .. siguiente línea dentro <..uses-permi.ssion name= "anclro.id .J.)el.7ni ss.i.on. > READ_ 1

4.

/

clase Receptor-Llamadas ReceptorLiamadas yy elel siguiente siguientecódigo: código: Crea una nueva clase ppublic ublic cla ss Receptor·Llamadas ver class ReceptorLlamadas extends extends BroadcastRecei BroadcastReceiver

{

SOverride

@Over~cide

ppublic ublic vvoid o i d onReceive(Context onReceive(Context context, context, Intent Intent intent) intent)

{ /! Sacamos información // información del del intent intent String estado == nurnero numero == Bundle extras =- intent.getExtras(); intent.getBxtras()j if (extras {extras != i= null nuil)) { estad o == extras. getString ('l'elephonyManager. EX'l'i?A_S'1~11"'E') ; ; estado extras.getString(TelephonyManager.EXTR%_STATE) iiff (estado.equals(TelephonyManager.EXTRA_STATE_RINGING)) (estado. equal s (Tel ephonyi'1anager. &YTRA.... ST:ll. TE_RINGING) ) { numero = = extras.getString('I'elephonyManager. extras.getString(TelephonyManager. EX'T'PJ.\_Il'VCQ!..Jl"NG_lVU1'1Bb7.) ¡; BXTKA_INCQMmG_NUMBER) } } String info = estado estado ++ " " ++ numero¡ numero; Log.d( ReceptorAnuncio info = ++ intent); Log.d("ReceptorAnuncio", info ++ " intent intent=" intent); íl // Creamos Notificación Notificación Notificationl\'lanager nm NotificationManager nm == (Not.ificationManager) (NotificationManager) context. get.SystemServ.i ce ( Conte.xt. NOT.IF.TC.~4T.TOl'{___ SERVICE) ¡ ; context.getSystemService(Context.NOTIFICATION_SERVICE) Notificat.ion (R . dra\·lable. ic_ l auncller, Notificación notificacion notificación == new new Notification Notification(R.drawable.ic_Iauncher, 11 11 IJ1 amada entrante System .. c u..?:·r en t·T.i mt}f\1i. .I.l. .i. .s ()) ¡ "Llamada entrante", System.currentTimoMi11is()i; Pend.i.ngi.ntent .nt.encionPendiente == Pendingintent.. ge t Act i v.i. ty (context, Pendinglntent .iintencionPendiente Pendinglntent.getAccivíty(context, O, ), O); 0, new Intent{cont.ext, Intent(context, LlamadaEntranteActivity.class LlamadaEntranteActivity.class), 0); notificacion.setLatestSventInfo(context, "Llamada entrante", entrante", not.ificacion. set.Latest.Event.Info (context, "J.,lamada info, intencionPendiente); intencionPendiente) ,nm.notify(l, notificac.i.on); nm.notify(.1, notificación) ; } } 1111 ,

1111 ;

11

11

"

11 ,

11

1

260

11

Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios 5.

aplicación ee introduce introduce una una llamada. llamada. Si Si utilizas utilizas elel emulador emulador Ejecuta la aplicación EmulatorContro/. puedes utilizar la vista vista EmulatorControl. Telephony Actions Incoming 5555555555 Incommg number: number 5555555555 ~) # Voíce Voice

f) © SMS

Cali: i Harsg Up 6.

crea la la notificación. notificación. Verifica que se crea

7.

notificación yy verifica verifica la la información información mostrada mostrada: Abre la notificación

7 de febrero de 2012 Android

Llamada entrante RINGING 5555555555 8.

Con el administrador receptor administrador de de tareas tareas detén detén la la aplicación. aplicación. Verifica Verifica que queelel receptor igual aunque aunque la la aplicación aplicación no no esté de anuncios funciona igual esté en en marcha. marcha.

Recursos adicionales: adicionales: Algunos Algunos anuncios anuncios broadcast broadcast Lista de los anuncios broadcast broadcast más más importantes importantes organizados organizados por por temas. temas. (No (No Manifest): no no se se puede declarar declarar el el receptor receptor de de anuncios anuncios en en AndroidManifest AndroidManifest.xml. xml. Solo se puede utilizar utilizar registerReceiver registerRecei ver (). (l. (Solo (Solo sistema): sistema): intención intención protegida protegidaque que solo puede ser lanzada lanzada por por el el sistema. sistema. l'lorn.brt:~ de la .la acción acc.ión Nombre /(CONSTANTE) /
Descripción/Permiso ( IN.FORNACIÓN extra EXTRA Descripción/Permiso (ihformrcióh EN INTENT) I NTENT)

Batería a.ndro.id .intt:)nt . action. act i.on. BATTER'i EATTERr _L android.. intent. ON BATTERY BAT'I'ERY LOW.) LOi'/ J OW (ACTI (ACTION

o¡~r

Batería baja (Solo sistema). sistema).

261

El gran libro de Android android..in intent. action..BATTERY BATTERY OO Batería correcta android tent.action correcta después después de de haber haber estado estado KAY (ACTION battery BATTERY OKAYj OY-AY} hay ¡'action baja (Solo sistema). sistema).

r t ·· h t d (S 1 Laataalimentación 1m)en ac10n se se haa conectado conec a o (Solo oo sistema). S/S ema ·

android.intent.action.ACTIOK_POW android. int ent . action.I-~.CTION PO)'I L

ER CONNECTED ERJCONNECTED

-

{['CTION CONNECTED) (ACTION POi'iER POWER CONMECTED)

android.. intent. android int.ent . action. act.ion. ACTION ACTION POW POW L . t "ó se ha h d d (S 1 11men Laa aalimentación ER DISCONNECTED ac1 n se a desconectado esconecta o (Solo oo ER_DISCONNECTED sistema). (AC~'I'ION POí~ER DISCONNEC'l'ED) SIStema). (ACTION POWER DISCONNECTED) android. intent. in tent.action.BATTERY action, BATTERY_CC Cambia el estado estado de de la la batería batería (A/o (No Manifest) Manifest) sistema). HANGED (ACTION BATTERY CHANGED) (Solo Sistema).

Sistema anciro.icl i.nLent . ac!: .í.on . BOOT_COMP DOOT COMP Sistema operativo operativo cargado. cargado. Permiso Permiso android.. .intent.action. LETED (ACTION BOOT COMPLETED) REC'BXVE RECEIVE BOOT COMPLETED CO!
android. intent.. intent. action act ion.ACTION_SHU va aa ser ser desconectado desconectado (Solo (Solo .action__shü El dispositivo va tdown (action SHUTDOWNi sistema). TDO'NN ( ~S:.T~S!t.U~!~!!l?.S2~~~~ sistema).

andr·o.id i.ntent:. act act: ion. :i.on . AIRPLA.NE_ .ALH.PLA1\iE_ android...intent. 110DE MODE

Modo vuelo activo (Solo sistema). sistema).

(ACTION AIRPLANE MODE !•JODE CHANGEDj CHANGED) aandroid. n droid . intent. action.tims_tick act ion . Tll\1E TICK Se envía envía cada cada minuto. minuto. (A/o (No Manifest) (Solo (action time tick) sistema). (!.'.~:.!.~.S2.I~_T:~~l];.;_T:.~.~:.J:<:) sistema). android . intent. act ion.TIME_SET ion. TI!VlE SET android.intent.act

(ACTION TIME CHANGED)

La fecha/hora es modificada (Solo sistema). sistema).

androi d. intent .action.CONFIGURAT . act ion. CONFIGURAT Cambia la configuración configuración del del dispositivo dispositivo android. ion_changed (orientación, ION_ CHANGED (orientación, idioma,..) idioma, .. ) (A/o (No Manifest) Manifesl) (ACTION CONFIGDRA'TIOM CHANGED) (Solo (!.'.S:.!}g~~-s:g~y~sj~!.F.0!.~g~r_<::t.r.~iS'.J!:J?.) (Solo Sistema). sistema).

Entradas y pantalla androicl act ion . SCREEN..GF SCREE!'~ OF android.. intent. action.

F (ACTION SCREEN OFF)

La pantalla se apaga (Solo sistema). sistema).

...

···r1r::J ·r ·Í i r: t · -• r• t· -í·-t n f 'i\] android.intent.action.SCPEEN_ON ~~~-~;~¿~· S~l~~~~ ·q~:;·'- · · · u . ..u ,_,.J La pantalla se enciende (Solo sistema). sistema). (ACTION SCREEN ON,i :J

;;.,-, .S·

c: ····r~¡;·r~-' 1\j

andro id. intent. action. camera_but CAMERA_BUT Se pulsa pulsa el el botón botón de de la la cámara cámara android. TON (ACTION (l,CTION CAMERA CAív!ERi\ BDTTON) BUT'I'ON) (EXTHJ.\ KBY KEY EVENT) EVEN'r) (EXTRA

android t . action. HEADSET_PL HElillSET__PL Se conectan conectan los los auriculares auriculares (extras: (extras: state, state, android.. inten intent. UG í ~.s:.::r:.;g~r-~~~~PE.'..f!:.:I.'_I.'.I.:~~!S1) uG nam e, microphone) microphone) (action headset pltjg) ñame,

262

Servicios, notificaciones y receptores receptores de de anuncios anuncios android. intent. action. INPl!"'T_f•lET android.intent.action.INPUT_MET HOD_CHANGED HOD CHANGED Cambia método de entrada. entrada. (ACTION INPUT l'-1ETHOD METHQD CHANGED) CHANCEO) android. intent. action. USER_PRES El usuario está presente android.intent.action.USER_PRES presente después después de de que que se se SNT (ACTION USER USER PRESEN'l') PRESENT) ENT (AC'l'ION active el dispositivo (Solo (Solo sistema). sistema).

Memoria y Escáner Multimedia Multimedia

android.intent.action.DEVICE STO Queda poca memoria (Solo Sistema) (Solo android. intent .acti on.DEVICE___.STO Queda poca memoria (Solo Sistema) (Solo RAGE_LOW RA.GE_LOW sistema). sistema). (ACTION DEVICE STORAGE STORAGE LOW) LOW) android.intent.action.DEVICE_STO an~~o;: · intent · action · DEVICE_STO Salimos Salimos de de la la condición condición de de poca poca memoria memoria RAGE_OK RAC,E_,),< (Solo (Solo Sistema) Sistema) (Solo (Solo sistema). sistema). (ACTI ON DEVICE SSTORAGE T OPJ
android. intent. ac t. ion. MEDLZ\._Eejec JEC El intent .action.media El usuario usuario pide pideextraer extraeralmacenamiento almacenamiento t (:f.:g_T_~g_~~~f.P::f!I-_];;_~T.f..S:.T.l (action media eject) exterior. T exterior.

android.intent.act ion.MEDIA MOUM android. intent . act ion. 1'-lEDIA MOUN . . · "bl Almacenamiento extertor exterior dtspont disponible. TED Almacenamiento e. TED (ACTION (ACTION MEDIA MEDIA MOUJ:-JTED) MOÜNTED) -··· android.intent,action.MEDIA_REM and roid. int.ent · action.MEDIA_REf\1 Almacenamiento Almacenamiento exterior exterior no no disponible. disponible. OVED (ACTION l'1EDIA MEDIA REr-IOVED) REMOVED) android.intent.action.MEDIA_SCA android · int.ent · act.ion · NEDIA SCA El El escáner escáner de de medios medios termina termina un un directorio directorio NNER_FINISHED NNER FINISHED (se indica en lntent.mData). Intent.mData). (ACTION MEDIA SCAl'lNER SCANNES FINISHED) FINISHED) androi d . intent. action. fv!EDIA SCA android.intent.action.MEDIA_SCA medios encuentra encuentra un un fichero fichero El escáner de medios NNER SCi\J.'\1 FILE NNER_SCAN

(t.>.<::.XI.Q~U:l.~.!:"J..I..!.>_~-~~~¡>.'-:?..<::~-~:.L~.fi:) (ACTION MEDIA SCANNER SCAN FILE)

(se indica indica en en lntent.mData). Intent.mData). (se

android. intent . action .t,lEDIA SCA android.intent.act ion.MEDIA SCA medios comienza comienza un un El escáner de medios NNER STARTED NNER_STARTED en Intent.mData). directorio (se indica en lntent.mData). (ACTION fJlEDIA HEDIA SCANNER STARTED) STARTEP)

Aplicaciones android. intent. action. NY PACY.J\G android.intent.act ion.MY_PACKAG versión de de tu aplicación aplicación ha ha sido sido Una nueva version E REPLACED E_REPLACED instalada (Solo sistema). sistema). (ACTION NY PACI
263

El gran libro de Androíd Android android action .PACKAGE androld.. intent inCent.. action. PACKAGE R

EMOVED (ACTION package removed) ~

_

Se Se

. . . . .. ^ , desinstala una una apl.cac.on aplicación (Solo (Solo sistema). ^sinstala sistema).

Comunicaciones y redes

ancü-oid . intent . act·ion . PHOl'JE_ST/1 androíd.inCent.acción.PHONE STA T.R

android. inten t. action. action .NE\' 1 OUTGO anciroid. intent. NEW_OüTGO

ING CALL ING_CALL

Llamada de teléfono. Permiso: Permiso:

READ PHONE STATE (EXTRA _E'.E.~_Y.~~Q.t.!J;:-"~_:l?~~ ~XTRA STATS, STATE, RI.NGI NG) . EXTRA. STATE RINGING). EXTRA Se va a hacer una llamada. Permiso PROCESS OUTGOI NG CRLLS CALLS PROCESE OUTGOING

(ACTION NEW OUTGOING CALL)l (!'-ºT!9!,~-t~~.\'i_Q.9.:!.'.9.9!:~0!-~~:!'-!~I~.

(EX'I'Ri\ PHONE NUMBE!i) (Solo sistema). sistema). (BXTRA_PHOí]EjNmBER)

andró.i d.provider.Telephony.SMS_ SMS recibido. Permiso: receive RECEIVE sms. SMS. recibido. Permiso: RECE'.TVED RECBIVED and.Loid. hluet:ooth. intent.: . action androíd.bluetooth.intent.action ..DISCOVERY DISCOVERY STARTED STAR:TED

androicl . bluet ooth. intent . a c tic'n androíd.bluetooth.intent.action ..ENABLED E!·lABLED

Comienza escáner Bluetooth Bluetooth.. Bluetooth habilitado. habilitado .

a ndLoid. net . ~~lif"i .I·!E'T~·VOF·(K_l"DS_CH android.net.wifi.NETWORK_IDS_CH AIVGED Cambia la red WiFi. WiFi. ANGED (NETWORK IDS CHANGED ACTION.)

and.roid . net . ~\rif"i .. STJ1Tl::."'___CHJ1l'JGE android.net.wifi.STATE_CHANGE

TATE CHANGED ACTION) J~CTION J (NETWORK SSTATS

(NETí~ORK

andro i d . net..wifi wif i .RSSI . RSSI CHANGED CHAJ'JGED android.net ( RSS I CHANGED CH.r..."JGED ACTION.) ACT ION ) (RSSI

.m***

Cambia la conectividad WiFi (EXTRA NETWORK INFO, -~;-~Tl3:,!l,_~~ª!:P· EXTRA BSSID, (~~T~!'--~
Cambia el nivel de señal WiFi (EXTRA (EXTPJ', NEW NEí'i RSSI). RSS I ).

Práctica: Práctica: Arranque de una actividad desde un receptor de anuncio. anuncio.

Modifica el proyecto Asteroides para que arranque automáticamente automáticamente la actividad actividad Ace r caDe al llegar un SMS cualquiera. cualqu iera. AcercaDe

, 0 •» *♦ Práctica: receptor de de anuncio. anuncio. Práctica; Arranque de una tarea desde un receptor Modifica el proyecto Asteroides para que arranque arranque automáticamente automáticamente la la actividad actividad principal Asteroides al llegar un SMS cualquiera. cualquiera.

264

Servicios, notificaciones y receptores de anuncios NOTA:

De. c.l.ass Si utilizas ulilizas el código anterior modificando Acerca AcercaDe. class por por AsteLoides . class comprobarás que no funciona. funciona. Para realizar Asteroides. realizar esta esta práctica práctica has has de de tener en cuenta que Android trata de forma forma diforente diferente aa las las actividades actividades principales principales de de una una tarea (marcada en como MA.TN). MAIN). Si intentas arrancar una una actividad actividad de de este este tipo, Android considera que estás tratando de arrancar una una nueva nueva tarea. tarea. El El problema problema surge porque para lanzar una tarea desde una intención resulta imprescindible imprescindible activar activar el el FLriG_,',CTIVITY_NEf-i_TASK Para hacer esto, siendo ii de fa flag FLAG_ACTIVITY_NEW_TASK la clase Intenr::, intent, utiliza utiliza el siguiente código: ii.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); .addFlags(Intent .FLAG_ACTIVITY_NEW_TASK);

Cuando se utiliza este flag, si una tarea ya se está está ejecutando ejecutando no no se se lanza lanza una una nueva actividad; actividad; el flag se pondrá al frente de la tarea, mostrándose mostrándose la la última última vista vista activa de ésta. ésta. Si no nos interesa este comportamiento podemos podemos utilizar, utilizar, además, además, el el flag flag_activity_multiple_task FLAG_ACTIVITY_llmLTIPLE_TASK para permitir permitir lanzar lanzar varias tareas tareas

8.4.2. Arrancar un servicio tras cargar el sistema operativo En muchas ocasiones puede ser interesante que un servicio servicio de de nuestra nuestra aplicación aplicación esté siempre activo, incluso aunque el usuario usuario no no haya haya arrancado arrancado nuestra nuestra aplicación. Imagina, por ejemplo, un servicio de mensajería instantánea instantánea que que ha ha de de aplicación. estar siempre atento a la llegada de mensajes. Conseguirlo Conseguirlo es es muy muy fácil, fácil, no no tenemos más que crear un receptor de anuncios que que se se active active ante ante el el anuncio anuncio a.ndro.id . i.ntent . act i on. BOOT_ cor"'PLETED. Desde android. intent.action.boot_completed. Desde este este receptor receptor podremos podremos crear crear el el servicio. Para poder registrar el receptor receptor es obligatorio solicitar solicitar el el permiso permiso RECEI VE_BOOT_Cm•IPLE'I'ED.. Veamos los tres pasos aa seguir: rece i ve__boot_completed 1.

recetor de anuncios: Creamos un recetar public clasa class ReceptorArranque extends Broadca.stReceiver BroadcastReceiver { ®Over-ride ©Override

public void onReceive(Cont.ext onReceive(Context context, Intent Intent intent) intent) { context.startService(new Intent(context, Intent(context. Ser,ricio.class)); Servicio.class));

i\ 2.

}

Creamos el servicio public clase class Servicio extenda extends Ser~ice Service ({ @{),.rer:cide ©Override

public void onCreate () {{...} ... } onCreateO

©Override onStartCommand(Intent intención, int fflags, public int onStartCotrunand ( Intent intencion, l ags, int idArranque) idl'..rranque) {{...} ... } Gi:Over1·ide SOverride

public void onDestroy{) ... } onDestroyO {{...}

265

El gran libro de Android @Overri.d @Overridee public IBinder onBind( Intent intención) intencion) {{ onBindíIntent return nuil; null ;

} } 3. 3.

En AndroidManifest.xml registramos el receptor de anuncios y pedimos el permiso adecuado. adecuado. < api i car. ion > android: name= ''a "android. > <írecei·ver> RECEIVE_BOOT_COMPLETED"/>

Práctica: Arranque automático del SetVicio Sen/icio de Música. Música. Modifica el proyecto ServicioMusica para que el servicio se active desde el arranque del sistema operativo. operativo.

8.5. Un servicio como mecanismo de comunicación comunicación entre aplicaciones Como hemos comentado, funcionalidad : permitir la comentado, un servicio tiene una doble funcionalidad: ejecución de código en segundo plano y poder ser utilizado como un mecanismo de comunicación entre aplicaciones22.. Cuando una aplicación quiere compartir algún tipo de información con otra se presenta un problema. problema. En Android las aplicaciones se ejecutan en procesos separados y, por tanto, impide, por tanto, tienen espacios de memorias distintos. Esto nos impide, ejemplo, que ambas aplicaciones compartan un mismo objeto.

2

266

http://developer.androíd .com/guide/topícs/fundamentals. htm l#rpc http.7/developer.android.com/guide/topics/fundamentais.

Servicios, notificaciones yy receptores de anuncios Como respuesta a este problema Android Android nos nos propone propone un un mecanismo mecanismo de de en un lenguaje lenguaje de de especificación especificación de de comunicación entre procesos, procesos, que se basa en AIDL, que son publicados por medio medio de servicios. servicios. interfaces, AIDL, un lenguaje lenguaje de de especificación especificación AIDL (Android Interface Definition Language) es un de interfaces que permite que un proceso en en Android pueda pueda llamar llamar aa un un método método de de un objeto situado en un proceso proceso diferente diferente al al suyo. suyo. Se Se trata trata de de un un mecanismo mecanismo de de comunicación entre procesos similar a COM o Corba, Corba, aunque aunque algo algo más más ligero. ligero. Si queremos comunicar dos aplicaciones aplicaciones aa través través de de este este mecanismo mecanismo seguiremos los siguientes pasos: pasos: 1) Escribiremos un fichero AIDL: Al DL: en él se se define define la la interfaz, interfaz, es es decir decir los los métodos y los parámetros que luego podremos utilizar. utilizar. 2) Implementaremos los métodos de la interfaz: interfaz: para para ello, ello, habrá habrá que que crear crear estos métodos. métodos. una clase en Java que implemente estos 3) Publicar la interfaz a los los clientes: clientes: para ello, ello, se se extenderá extenderá la la clase clase Service service y sobrescribiremos el método onBind(intent) onBind(Intent) de de forma que que devuelva devuelva una instancia de la clase que implementa implementa la la interfaz. interfaz.

m

Pol¡[Media]: Un servicio como mecanismo de comunicación Poli[Media]: comunicación entre aplicaciones. aplicaciones.

Veamos estos tres pasos más detenidamente detenidamente por medio medio de de un un ejemplo. ejemplo. Para Para ello, crea la siguiente aplicación: aplicación: Project ñame: name: ServicioRemoto Servi.ci.oRemoto Bu.i ld Target: Android Andro.id 2.0 2. O Build Applicati.on name: Servicio Remoto Application ñame: Package ñame: name: org.example,serviciocliente org.example.serviciocliente Create Activity: ActividadPrincipal Acti.vi.dadPr.incipal Mi.n Version: 5 Min SDK Versión:

Reemplaza el código del Layout main.xmi main. xml por el el mismo mismo utilizado utilizado en en servicioMusica. serv.ici.oMusica. Remplaza los textos de los los botones botones "Arrancar ''Arrancar servicio" servicio" por por "Conectar "Conectar servicio" y "Detener servicio" por "Desconectar servicio". servicio". Crea Crea dos dos botones botones más. más. Uno Uno con texto "Reproducir" e id "@+id/boton_reproducir" yy otro con con texto texto "Avanzar" "Avanzar" ee id id "@+idlboton_avanzar". "@+id/boton_avanzai".

res/raw/audio. Copia el fichero res/ raw! audio. mp3 aa la la nueva nueva aplicación. aplicación.

8.5.1. Crear la interfaz inteñaz en AIDL El lenguaje de especificación de interfaces interfaces AIDL, AIDL, tiene tiene una una sintaxis sintaxis similar similar aa Java, Java, aunque permite únicamente identificar la interfaz interfaz de de un un objeto, objeto, no no su su implementación. implementación. Una interfaz estará formada por una secuencia de métodos métodos cada cada uno uno con con una una serie de parámetros y un valor devuelto. devuelto. Tanto los los parámetros parámetros como como el el valor valor devuelto han de tener un tipo. tipo. Los tipos permitidos permitidos se indican indican aa continuación: continuación:

267

El gran libro de Android Androíd int,, short short,, byte byte,, char, char, float float,, double, doubTe, long, long,BooJ.ean. Boolean. • Tipos primitivos: int •

Uno de los siguientes tipos: tipos: String, String, CharSequence CharSequence,, List, List,Tvlap. Map.

•

Una interfaz escrita en en AIDL. AIDL.

•

Un objeto Parcelabl.e Parcelable..

Para

seguir

con con

el el

ejemplo, ejemplo,

crea crea

un un

nuevo fichero fichero con con nombre nombre nuevo

IServicioMusica. aidl. dentro org . example . servicioaidl/ IServicioMusica.aidl dentro de de src/ src/org.example. servicioaidl/ con conelelsiguiente Siguiente

código: package org.exampJ.e.servicioremoto; org.example,serviaioremoto; interface IIServicioMusica Servi ciot~u si ca {{ String reproduce(in ng mensaje reproduce íin Stri String mensaje)); void setPos icion( int ms ); setPosicioníint ms); int getPosicion(); getPosicion(>;

} la sintaxis sintaxis es es similar similar aa Java Java aunque aunque existen existen diferencias. diferencias. Como puedes observar la La más destacable consiste consiste en en que que los los parámetros parámetros de de los los métodos métodos cuyos cuyostipos tiposno no han de de indicar indicar la la etiqueta etiqueta in, in, out out oo inout inout,, según según sean sean parámetros parámetros sean primitivos, han de entrada, salida oo de de las las dos dos cosas cosas aa lala vez. vez. Para Para los los tipos tipos primitivos primitivos sólo sólo se se permite que actúen actúen como como entrada, entrada, por por lolo tanto tanto se se procesan procesan de de forma forma predeterminada como in. in. con las las clases clases en en Java Java los los interfaces interfacesen enA1DL AIDLhan hande deescribirse escribirse NOTA: Igual que ocurre con en fichero con igual nombre nombre que que la la interfaz. interfaz.

8.5.2. Implementar la la interfaz interfaz Una vez escrita esta esta interfaz interfaz yy almacenada almacenada en en elel fichero fichero . aidl aidi,, elelp/ug-in plug-inde deEclipse Eclipse generará de forma automática example. servicioremoto/ automática el el fichero fichero gen/orq. gen/org.exampie.servicioremoto/ IServiciol•lu sica . java. IServicioMusica.j ava. Este fichero implementa implementa la la interfaz interfaz Java Java rservicioJvlmd.ca IServicioMusica como como descendiente descendiente de IInterface. En En IServiciot·1usica IServicioMusica se se define define internamente internamente lala clase clase abstracta abstracta stub que implementa la la interfaz interfaz escrita escrita en en AIDL. AIDL. Es Es decir, decir, lala clase clase stub stub contiene contiene tantos métodos abstractos como como métodos métodos declaramos declaramos en en lala interfaz interfazAIDL. AIDL. La Laclase clase stub también define una una serie serie de de métodos métodos que que lele permiten permiten elel intercambio intercambio de de invoquen estos estos métodos métodos entre entre procesos procesos remotos. remotos. información cuando se invoquen Ahora tenemos que darle darle funcionalidad funcionalidad aa lala interfaz interfaz y,y, para para ello, ello, tendremos tendremos que que rvicioMus i c a.Stub yy que crear una clase que extienda extienda rse IServicioMusica.stub que implemente implemente todos todos los los métodos abstractos de esta esta clase, clase, oo lolo que que es es lolo mismo, mismo, los losmétodos métodosdeclarados declaradosen enlala interfaz AIDL. A continuación continuación se se muestra muestra un un ejemplo ejemplo de de cómo cómo podríamos podríamos implementar implementar estos métodos. Más Más tarde tarde se se indica indica dónde dónde hay hay que que introducir introducireste estecódigo: código:

prívate final final IServicioMusica.Stub IServicioMusica.Stub binder binder private

= new new IServicioMusica.Stub() IServicioMusica.Stub() { {

=

publ ic String reproduce(String public reproduce(String mensaje) mensaje) {{

268

Servicios, notificaciones yy receptores de de anuncios anuncios reproductor.start(); rreturn eturn mensaje; mens aje;

} publ i c void v oid setPosicion(int s etPosic i on( int ms) ms) public reproductor.seekTo(ms);

{{

} public int getPosicion() getPo sicio n () {{ return reproductor.getCurrentPosition(); reproductor. getCu r r e n t Po si tion( );

} } La variable reproductor será declarada declarada posteriormente posteriormente de de tipo tipo MediaPlayer. J'vlediaPlayer. Como puedes ver, en el método método reproduce, reproduce , tanto tanto el el parámetro parámetro de de entrada entrada como como elel valor devuelto no tienen ninguna ninguna utilidad. utilidad. Se Se han han introducido introducido para para ilustrar ilustrar elel paso paso de de una variable no primitiva. Cuando implementes los los métodos de de una una interfaz interfaz AIDL AIDL has has de de tener tener en en cuenta cuenta lo siguiente: siguiente: Si generas una una excepción desde desde uno uno de de estos estos métodos, métodos, ésta ésta no no pasará pasará aa lala aplicación que hizo la llamada. llamada. Las llamadas son síncronas. síncronas. Por Por lo lo tanto, tanto, has has de de tener tener cuidado cuidado de de que que cuando cuando se se haga una llamada que tarde cierto tiempo tiempo en en responder, responder, nunca nunca se se realice realice desde desde elel hilo principal de la aplicación. aplicación. Si Si este este hilo hilo queda queda bloqueado bloqueado demasiado demasiado tiempo, tiempo, aplicación no no responde". responde". En En estos estos cuadro de diálogo diálogo "La "La aplicación aparecerá el incómodo cuadro secundario desde desde donde donde se se haga haga la la llamada. llamada. casos, casos, crea un hilo secundario declarar métodos; métodos; no no puedes puedes declarar declarar campos campos estáticos estáticos en en una una Solo es posible declarar interfaz AIDL

8.5.3. Publicar la interfaz interfaz en en un un servicio servicio Otras aplicaciones han de de tener tener visible visible esta esta interfaz interfaz para para poder poder comunicarse comunicarse con con nosotros. se consigue creando un un servicio servicio que que contenga contenga nuestra nuestra interfaz. interfaz. nosotros. Esto se Para ello, ello, has de crear una una clase que que herede herede de de Service service yy que que reescriba reescriba elel método onBínd onBind (). ( l . Este método método será será utilizado utilizado para para devolver devolver un un objeto objeto que que implementa nuestra interfaz. interfaz. Veamos cómo cómo se se escribiría escribiría este este servicio: servicio: public class cla ss ServicioRemoto extends e x t e nds Service{ Service{ M ediaPlayer reproductor; MediaPlayer

•SOverride ®Override ppublic ublic void void onCreateO onCreate() {{ ssuper.onCreate(); u per.onCreate(); reproductor = MediaPlayer.create(ServicioRemoto.this, MediaPlayer. create (ServicioRemoto.this, R.raw.audio); R.raw. audio);

269

El gran libro de Android } private I ServicioMusica.Stub binder binder prívate final IServicioMusica.Stub

new IServicioMusica.Stub(){ IServicioMusica.Stub () { = new

/1 aqui el código código anterior anterior // Copia aquí

}};; @O,ler:r-ide ©Override public IBinder onBind(Intent onBind (Intent intent) int ent) return this.binder; this .binder ;

{{

} } Crea una nueva clase en en el el proyecto proyecto ee introduce introduce este este código. código. Para Para que que elel servicio sea visible visible aa otras otras aplicaciones aplicaciones hay hay que que publicarlo publicarlo declarándolo declarándolo en en AndroidManifest .xmi. Android1'1anifest. xml. Para Para ello, ello, copia copia el el siguiente siguiente código código dentro dentro de de lala etiqueta etiqueta . android:: nattie= na me= ". Servid Sert...i.c:.ioRemoto android :procesa= : process=": ":.remoto''> < <.in ten t ... f ixter> i.J. t.er> I8erv.i c.ioMus:i.ca '' /> 1'

11

.

11

El atributo ñame name ha ha de coincidir coincidir con con la la clase clase que que implementa implementa elel servicio. serv1c1o. ElEl atributo procese process permite que que el el servicio servicio se se ejecute ejecute en en un un proceso proceso propio, propio, diferente diferente al resto de los componentes de de la la aplicación. aplicación. A A continuación, continuación, indicaremos indicaremosdentro dentrode de la etiqueta por por cada cada interfaz interfaz que que Un servicio servicio podría podría publicar publicar más más de de una una interfaz, interfaz, para para lolo que que queremos publicar. publicar. Un habría que escribir un un fichero fichero AIDL AIDL por por cada cada interfaz. interfaz. Puedes Puedes encontrar encontrar un un ejemplo ejemplo en la aplicación ApiDemos. ApiDemos.

8.5.4. Llamar aa una una interfaz interfaz remota remota Para llamar a la interfaz interfaz creada creada anteriormente, anteriormente, sigue sigue los los siguientes siguientes pasos; pasos: 1) Declara un objeto de tipo tipo IServicioMusica. IServiciol'lusica. Es Es el el que que podrás podrás utilizar utilizarpara para

hacer las llamadas al al objeto objeto remoto. remoto. la clase serviceConnection. serviceconnection. Nos Nos permitirá permitirá controlar controlar cuándo cuándo 2) Implementa la {onserviceconnected í)) () ) yy cuándo cuándo se se produce produce se produce una conexión (onserviceconnected {onServiceDisconnected () ).). servicio (onServiceDisconnectedO una desconexión del servicio 3) Para conectarte al al servicio servicio llama llama al al método método bindservice bindservice()() pasándole pasándole un un objeto de la clase ServiceConnection servi.ceconnection que que acabas acabas de de implementar. implementar. realizar lala conexión conexión se se llamará llamará alal método método 4) Si se puede realizar Servi.ceConnect.i.on. onServiceConnected () yy recibirás recibirás en en uno uno de de SUS SUS ServiceConnection.onServlceConnected() parámetros instancia de IBinder. Utiliza elel método método una instancia de IBinder. Utiliza IServicioMusica. Stub. as Interface () () pasándole pasándole como como parámetro parámetro esta esta IServicioMusica.stub.asinterface inicializar el el objeto objeto declarado declaradoen en elel primer primerpunto. punto. instancia de IBinder para inicializar

270

Servicios, notificaciones notificaciones yy receptores receptores de de anuncios anuncios 5) Ya puedes llamar llamar aa los los métodos métodos del del objeto objeto remoto remoto declarados declarados en en elel punto punto 1). En nuestro caso 1). caso reproducir repr·oducir (), () ' setPosicion setPosicion()() yygetPosicion getPosicion(). (). 6) Puedes desconectarte desconectarte del del servicio servicio utilizando utilizando el el método método unbindservice unbindservice(). (). Realizaremos este trabajo trabajo en en la la clase clase ActividadPrincipai. ActividadP:r:incipal. Remplaza Remplaza su su código por el siguiente: siguiente: public class ActividadPrincipal public Acti vidadPrincipal extends extenda Activity Acti vity {{ prívate IServicioMusíca ISer·vicioMusica servicio; servicio;

(1) (1)

prívate ServiceCormection Servi ceConnection conexión con exi on =; new new ServiceConnection() ServiceConnection(} {{

(2) (2) (4) (4) IBinder iservicio) iser•icio) {{ serv i c i o "' IServicioMusica.Stub.aslnterface(iservicio); IServi cioMusica. Stub. a:.-; Int(:~rface ( i servicio) ; servicio Toa st.makeText(Act. i v i dadPrincipal .this , Toast.makeText (ActividadPrincipal.this, "Con ectado a Servicio", Servicio" , Toast.LENGTH_SHORT).show(); Toast. LENG'I'H_8HOR'1') . show (); "Conectado

public void onServiceComiected(ComponentNatne onServiceConnected(ComponentName className, className,

} public void onServiceDlsconnected{ComponentName onServiceDisconnected(ComponentName className) className} ser vicio =; nuil; null ; servicio

{{

Toast.make'I'ext(ActividadPrincipal. this, Toast.makeTexL(ActividadPrincipal.this, ''Se la conexión conexión con con el el Setvicio", Setvicio", "Se ha perdido la Toas t. . LENG'TH___ SHORT) . s hcw ( ) ; Toast.LENGTH_SHGRT).show();

}; :;.,Qver:ride ■SOverride

public void onCreate(Bundle onCrea.te (Bundl.e savedlnstanceState) savedinstanceSt.at.e)

{

super . onCreate(savedTnstanceState) ; super.onCreate(savedlnstanceState); setContentView (R . layout . main) ; setContentView(R.layout.main);

Button botonConectar boton Conectar =; (Button) (Button) findViewByldíR.id.Í30ton_arrancar); f indVie wByid(R.id.boton_arrancar); bot.onConectar. setOnC:L i ckLi.stener (new OnClickListener() On ClickList.ene:r: () { botonConectar.setOnCIickListener(new public void onClick(View onClick (View v) v} {{ ActividadPrincipal. thi s.bindService( (3) ActividadPrincipal.this.bindService( (3) new Intent(ActividadPrincipal,this, new Intent (ActividadPrincipal. this , ServicioRemoto.class) ServicioRemot.o. clas s ),, conexion, Context . BJt;¡lJ_AU'fO_ CRE'.A/l'.~,~;) ;; conexión, Context.BIND_AUTG_CREATE) } ) i

indViewByld(R. Button botonReproducir= bot onReproducir= (Button) (But ton) ffindVie•.,Byld (R .id. id .boton...reproducir) boton....reproducir) ; botonReproducir.setOnClickLístener( new OnClickListener() OnClickListener() {{ botonReproducir.setOnCIickListener(new public void onClick(View onClick(Víew v) v} {{ try {{

servicio.reproduce("titulo " };,(5) servicio.reproduce ("titulo") (5) e} {{ } catch (Exception e) Toast.wakeText Toast .makeText (ActividadPrincipal.this, {Act..i.vidadPr.i ncipa1 . this , e.toString(), e. to.String (), Toas t . LENGTH_SHORT) LENG1'H._SHOR'l') .show() . show ( };; Toast.

}l; Button botonAvanzar bot.onAvanzar = (Button) (Bu t .ton} findViewByld(R,id. findVie.,,Byld (R. id J.boton_ avanzar) ; ; boton_avanzar)

271

El gran libro de Android botonAvanzar.setOnClickListener( new OnClickListener() botonAvanzar.setOnClickListenex-(new OnClickListener(S voi d onClick(View public void onClick{View v) { try {{

{

servicio. setPosicion í servicio. qetPos icion ()+lO 00) ; ((5) 5) servicio.setPosición(servicio.getPosición()+1000); catc h (Exception e) { } catch Toast. s , e.toString{), Toast. makeText(ActividadPrincipal. raa.keTe.xt vActividadPrincipal. thi this, e. toString () , Toa.st .. LENGTH_SHORT) LF.:.NG'l'H_SHORT) .. show () ; Toast.

} ) i

Button botonDetener = (But.ton) (R. id. boton_detener); (Button) .f.indViewByid findViewByld(R.id.botoi7_detener); botonDetener . set.OnClickListener( new OnClickListener() botonDetener.setOnClickListener(new OnClickListener() {{ v oid onClick(View public void onClick (Viev/ v) {{

try{{ try ActividadPrincipal .unbindService(conexion); ((6) 6) ActividadPrincipal..this this,unbindSer'/ice (conexión) ; } catch (Exception e) { Toast . make'J'ext (ActividadPrincipa:i.. thi s , e. to.Str.i.ng í) Toast.makeText(ActividadPrincipal.this, e.toString í),, Toast Toast.. LE'NG'PH_Sl-!O.H'P} LENGTH_SHORT) .. shov; show (); () ; } servicio - nnuil ull ;; l \ . J''

La actividad está formada por 4 botones botones para para realizar realizar las las acciones acciones de: de: conectarse al servicio, desconectarse, reproducir reproducir música música yy avanzar avanzar 11 segundo segundo (1.000 ms). ms). Si los botones no se activan por por el orden orden adecuado adecuado podemos podemos provocar provocar excepciones. Estas son capturadas y visualizadas t , por visualizadas mediante mediante un un toas toast, por lo lo que que la la aplicación continuará funcionando aunque se se produzcan. produzcan. Prueba Prueba aa llamar llamar aa un un método antes de establecer la conexión oo trata trata de de desconectarte desconectarte dos dos veces veces para para observar las excepciones generadas.

272

CAPÍTULO 9. CAPÍTULO 9. Almacenamiento de datos datos Almacenamiento de

Las aplicaciones descritas descritas hasta hasta este este capítulo capítulo representaban representaban lala información información aa procesar en forma de variables. variables. El El problema problema de de estas estas variables variables es es que que dejan dejan de de existir en el momento en en que que la la aplicación aplicación es es destruida. destruida. En En muchas muchas ocasiones ocasiones vamos a necesitar almacenar almacenar información información de de manera manera permanente. permanente. Las Las alternativas alternativas habituales para conservar son los los ficheros, ficheros, las las bases basesde dedatos datos más habituales conservar esta esta información información son red. Estas Estas técnicas técnicas no no solo solo permiten permiten mantener mantener aa buen buen o servicios aa través de de la la red. recaudo los datos de de la la aplicación, aplicación, sino sino también también compartir compartir estos estos datos datos con con otras otras aplicaciones yy usuarios. usuarios. De De forma forma adicional, adicional, el el sistema sistema Android Android pone pone aa nuestra nuestra disposición dos nuevos nuevos mecanismos mecanismos para para almacenar almacenar datos: datos: las las preferencias preferencias yy ContentProvider ContentProvider. A lo largo de de este este capítulo capítulo estudiaremos estudiaremos cómo cómo utilizar utilizar estas estas técnicas. técnicas. Comenzaremos describiendo describiendo el el uso uso de de las las preferencias preferencias como como un un mecanismo mecanismo sencillo para guardar guardar de de forma forma permanente permanente algunas algunas variables. variables. Seguiremos Seguiremos describiendo las las características características del del sistema sistema de de ficheros ficheros que que incorpora incorpora Android. Android. Se Se puede acceder acceder aa los los ficheros aa través través de de las las clases clases estándar estándar incluidas incluidas en en Java; Java;de de incluyen nuevas nuevas clases clases para para cubrir cubrir las las peculiaridades peculiaridadesde deAndroid. Android. forma adicional se incluyen

Como tercera alternativa alternativa se se estudiará estudiará el el uso uso de de XML XML para para almacenar almacenar lala información de manera manera estructurada. estructurada. Se Se describirán describirán dos dos herramientas herramientas alternativas, alternativas, las librerías SAX yy DOM. DOM. Como Como cuarta cuarta alternativa alternativa al al almacenamiento almacenamiento de de datos datos se se estudiarán las bases bases de de datos. datos. Android Android incorpora incorpora lala librería librería SQLite, SQLite, que que nos nos permitirá crear yy manipular manipular nuestras nuestras propias propias bases bases de de datos datos de de forma forma muy muy sencilla. sencilla. Para finalizar, se se describirá describirá la la clase clase contentProvider; contentProvider; consiste consiste en en un un mecanismo mecanismo introducido en Android para para poder poder compartir compartir datos datos entre entre aplicaciones. aplicaciones. En el capítulo siguiente siguiente se se describe describe otra otra alternativa, alternativa, elel uso uso de de Internet Internet como como recurso para almacenar almacenar yy compartir compartir información. información. Concretamente, Concretamente, se se describirá describirá elel uso de sockets TCP, HTML HTML yy los los servicios servicios web. web. Todas estas alternativas alternativas serán serán ilustradas ilustradas aa través través del del mismo mismo ejemplo. ejemplo. Trataremos de almacenar almacenar la la lista lista con con las las mejores mejores puntuaciones puntuaciones obtenidas obtenidas en en Asteroides descrita en el capítulo capítulo 3. 3.

273

El gran libro de Android

~Objetivos:

* Objetivos: • • • • • •

Repasar las alternativas para el almacenamiento de datos en Android. Android. Describir el uso de ficheros. XML, las Ilustrar la utilización de dos herramientas para manipular ficheros XML, librerías SAX y DOM. DOM. Mostrar cómo desde Android podemos utilizar SQLite para trabajar con bases de datos. datos. Describir qué es un ContentProvider y cómo podemos utilizar algunos ContentProvider disponibles en Android. Aprender a crear nuestros propios ContentProvider.

9.1. Alternativas para datos permanentemente 9.1. Alternativas para guardar guardar datos permanentemente en en Android Android Existen muchas alternativas para almacenar información de forma permanente en un sistema informático. informático. A continuación mostramos una lista de las más habituales utilizadas en Android: Android: Preferencias: es un mecanismo liviano que permite almacenar y recuperar datos primitivos en la forma de pares clave/valor. Este mecanismo es típicamente usado para almacenar los parámetros de configuración de una aplicación. aplicación. • Ficheros: puedes almacenar los ficheros en la memoria interna del dispositivo SD. También o en un medio de almacenamiento removible como una tarjeta SD. puedes utilizar ficheros añadidos a tu aplicación como recursos. estándar. • XML: se trata de un tipo de archivo que sigue un determinado estándar. Ampliamente utilizado en Internet y en muchos otros sitios (como en el Android SDK). Disponemos de las librerías SAX y DOM para manipular estos ficheros desde Android. Android. • Base de datos: las APis APIs de Android contienen soporte para SQLite. SQLite. Tu aplicación puede crear y usar base de datos SQLite de forma muy sencilla y con toda la potencia que nos da el lenguaje SQL. • Proveedores de contenidos: un proveedor de contenidos es un componente opcional de una aplicación que expone el acceso de lectura/escritura de sus datos a otras aplicaciones. aplicaciones. Está sujeto a las restricciones de seguridad que quieras imponer. imponer. Los proveedores de contenidos implementan una sintaxis estándar para solicitar datos (URIs) (URis) y un mecanismo de acceso para devolver los datos (similar a SQL). SQL). Android provee algunos suministradores de contenidos para tipos de datos estándar, personales, estándar, tales como contactos personales, ficheros multimedia, multimedia, etc. etc. • Internet: no te olvides que también puedes usar la nube para almacenar y capítulo. recuperar datos. datos. Se estudia en el siguiente capítulo. •

274

Almacenamiento de de datos

Poli[Media]: Almacenamiento de de datos datos en en Android. Android. PolilMedia |: Almacenamiento 9.2. Añadiendo Añadiendo puntuaciones puntuaciones en en Asteroides Asteroides A modo de ejemplo, se se va va aa implementar implementar la la posibilidad posibilidad de de guardar guardar las las mejores mejores puntuaciones obtenidas en en Asteroides. Asteroides. Se Se utilizarán utilizarán mecanismos mecanismos alternativos alternativos que que el siguiente: siguiente: serán desarrollados a lo largo largo de de este este capítulo capítulo yy el

Array (implementado en capítulo 3). 3). en el capítulo Preferencias. Ficheros en memoria memoria interna. interna. Fichero en memoria memoria externa. externa. Fichero en recursos. recursos. XML con SAX. XMLconSAX. XML con DOM. SQLite. Base de datos SQLite. Content Provider. Contení Provider. Sockets. Sockets. Servicios Web. Servicios

• • • • • • • • • • •

Para facilitar la sustitución del del método método de de almacenamiento, almacenamiento, en en el el capítulo capítulo 33 se se creó el siguiente interface: public interface AlmacenPuntuaciones AlmacenPun tuaciones {{ public void guardarPuntuacion(int guardarPunt u acion( int puntos, p un t os, String String nombre, nombre, long fecha); fecha) ; public Vector listaPuntuaciones(int listaPuntuaciones( int cantidad); cantidad);

} También se declaró la la variable almacén almacen de de tipo tipo AlmacenPuntuaciones AlmacenPuntuaciones yy se se creó creó la actividad Puntuaciones que que visualizaba visualizaba un un Listview ListView con con las las puntuaciones. puntuaciones. Dado Dado que en el capítulo 3 todavía todavía no no teníamos teníamos la la opción opción de de jugar, jugar, no no se se podían podían añadir añadir almacen. En En el el siguiente siguiente ejercicio ejercicio trataremos trataremos de de calcular calcular una una nuevas puntuaciones a almacén. almacen. puntuación en el juego y almacenarla almacenarla en en almacén.

Ejercicio paso aa paso: Calculando Calculando la la puntuación puntuación en en Asteroides. Asteroides. 1.

Crea una variable global global en en la la clase clase vistajuego VistaJuego con con nombre nombre puntuación puntuacion e inícialízala inicialízala a cero: cero: pprivats rivat e int puntuación puntuacion == 0; O;

275

El gran libro de Androíd Android 2.

Cada vez que se destruya un asteroide hay que incrementar esta variable. variable. Añade dentro de dest~.:uyeAstero i de () la siguiente línea: destruyeAsteroide puntuacion puntuación += 1000;

3.

Cuando desde la actividad inicial Astewides Asteroides,, se llame a la actividad ,Juego Juego obtenida. Recuerda cómo nos interesa que ésta nos devuelva la puntuación obtenida. en el capítulo 3 estudiamos la comunicación entre actividades. actividades. Para pasar la información entre las actividades añade en siguiente código en Asteroides. public void lanzaJuego(View lanzaJuego (Vie1v view) v i ew) {{ Intent ii = = naew ew Intent( this , Juego.clasa); Juego. class ); Intentíthis, st:artActivityForResult.(i, startActivityForResult í i, 1234}; 1234!;

} ®Ovt::'rride onActivityResul t (int ( int requestCode, ©Override protected void onActivityResult int resultCode, Intent data) data){{ super .onActivit.yResult (requestCode, resultCode, result:Code, data); super.onActivityResult(requestCode, if {requestCode=-12.34 (request.Code==1234 & resu l t.Code== RESULT.... OK & &. data!=null; data ! =nul l) reBultCoáe--RBSUL,T_OK

{

iint nt puntuación puntuacion = data. dat.a.getExtt:as() getExtras (!..getlnt("puntuacion"); getlnt ( "puntuación") ,Strinc; " Yo'' ; String nombre = "Yo"; /! Mejor leerlo leer l o desde un Bialog Dialog o una nueva actividad // // AlertDialog.Builder almacen . guardarPuntuacion(puntuacion, nombre, nombre , almacén.guardarPuntuación(puntuación, Systern. curren'cTimeMillis cu rrt.-)nt::r.imel~1.ii.7..is {)); System. ()) ;

lanza rPuntuaciones();; lanzarPuntuacionesO

4.

} ) Para realizar la respuesta de la actividad va a ser más sencillo hacerlo desde vistaJuego en lugar que desde Juego. Juec;o. El problema es que esta clase es una vista, no una actividad. actividad. Para solucionar el problema puedes vi sta.Juego el siguiente código: usar el siguiente truco. truco. Introduce en vistaJuego prí vat e Activity padre; private public void setPadre(Activity setPadre (Activity padre) padr·e) this. padre this.padre

{{

= = padre;

} 5.

Cuando se detecte una condición de victoria o derrota es un buen momento para almacenar la puntuación y salir de la actividad. actividad. Para ello, crea el siguiente método dentro de Juego: Juego: rívate void vo i d salir() ¡( pprívate Bundle bundle bundl e ~ new Bundle(); bundle. put.Int ( ''puntuac ion", puntuación); puntuaci.on) ; bundle.putlnt("puntuación", Intent intent i ntent = ~ new Intent{); Intent(); intent.rnltExtras(lnindle); intent.putExtras(bundle); ppadre. a dre. setResult. setResu l.t. (Activity. (AcU.vity . RESULT,_OK, RE8ULT ..OK , intent) in t.ent ) ;

276

Almacenamiento de datos pad:r·e.finish(); padre.f inish() ;

} 6.

Al final del método destruyeAsteroide () introduce: iif f (Asteroides.isEmpty(i) (Asteroides.isEmpty()) salir();

(

} 7.

Al final del método actualizaFisica () introduce: introduce: for (Gráfico (Grafico asteroide : Asteroides) {{ if (asteroide.verificaColision(nave)) (asteroide . verificaColision(nave)) { salir();

} } 8.

introduce: En el método oncreate de Juego introduce: vistaJuego.setPadre( this );; vistaJuego.setPadre(this)

9.3. 9.3. Preferencias Preferencias Las preferencias (clase sharedPreferences) SharedPreferences) pueden ser usadas como un mecanismo para que los usuarios modifiquen algunos parámetos de configuración de la aplicación. Este uso fue estudiado en el capítulo 3, donde se describe cómo podíamos crear una actividad dependiente de PreferenceActivity para que el usuario consultara y modificara estas preferencias. preferencias. Las preferencias también pueden ser utilizadas como un mecanismo liviano para almacenar ciertos datos que tu aplicación quiera conservar de forma permanente. Es un mecanismo sencillo que te permite almacenar una serie de variables con su booleano, real, entero yy nombre yy su valor. Puedes almacenar variables de tipo booleano, stríng. En este apartado describimos su utilización. string. utilización. Las preferencias son almacenadas en ficheros XML dentro de la carpeta shared_prefs en los datos de la aplicación. aplicación. Recuerda que en el capítulo 3 vimos cómo las preferencias de usuario siempre se almacenaban en el fichero paguete_preferencas paquet:e_preferences , donde el paquete ha de ser reemplazado por el paquete de la aplicación (en Asteroides el fichero es org.example.asteroides org. example . asteroides___preferences). Cuando utilices las preferencias para almacenar otros valores podrás utilizar otros ficheros. Tienes dos alternativas según utilices uno de los siguientes métodos: ficheros. ••

••

getsharedPreferences o getSharedPreferences () Te permite indicar de forma explícita el nombre preferencias. Puedes utilizarlo cuando necesites varios de un fichero de preferencias. ficheros de preferencias o acceder al mismo fichero desde varias actividades. ()l No tienes que indicar ningún nombre. nombre. Puedes utilizarlo getPreferences 1 cuando solo necesites un fichero de preferencias en la actividad donde se usa. usa.

277

El gran libro de Android Estos dos métodos necesitan como parámetro el tipo de permiso que queramos dar preferencias. Los valores posibles son mode_private, al fichero de preferencias. MODE PRIVATE, l'10DE_WORLD_WRI'I'EABLE según queramOS t•10DE_í'iORLD_READABLE O mode_world_readable o mode_wqrld_writeable queramos tener aCCeSO acceso exclusive, exclusive, permitir la lectura o permitir lectura y escritura. escritura. Una llamada a uno de estos dos métodos te devolverá un objeto de la clase SharedPreferences. SharedPreferences.

código: Para escribir las preferencias puedes utilizar el siguiente código: SharedPreferences preferencias^ preferencias= g gePreferences (HODE.. P-R PR.TVATE) e P r e f e r e nc e s (MOD£. J VA Ti?) ;¡ Sh aredPreferences.Editor editor= edit(); SharedPreferences . Editor editor = preferencias . ed.it () ; ed.i.tor.putString( "nombre ", "Juan"); ",Juan"); editor.putStrlng("nombre", ed.itor.putint( " edad", 35); editor.putlnt("edad", editor.comm.it(); editor.commit{);

Para leer las preferencias puedes utilizar el siguiente código: código: Sl1aredPreferenc:es preferenc:ia.s -= gePreferences (ArOi3E_.PHXV7iT£) (JYIODE___ PRI1/ATE) ; SharedPreferences preferencias St.ring preferencias. getString í "nombre", String nombre = preferencias.getString("nombre", "valo "valorr por defecto"); int edad edad= preferencias.getint( " edad", -1); -11 ¡ = preferencias.getlnt{"edad",

El ejemplo anterior puede ser modificado reemplazando getPreferences 1) () por getSharedPref erences (). () . En este caso, caso, tendrás que indicar el fichero donde se getsharedPreferences almacenarán las preferencias. preferencias.

i Jp*

Ejercicio paso a paso: Almacenando la última puntuación en un fichero de preferencias. preferencias.

Veamos un ejemplo de cómo podemos crear un fichero de preferencias (MiFicheroDePreferencias.xml) para almacenar la última puntuación obtenida en Asteroides. Asteroides.

1. Abre el proyecto Asteroides. Asteroides. 2. Crea una nueva clase AlraacenPuntuacionesPreferencias. AlmacenPuntuacionesPreferenc .ian. 3.

Remplaza el código por el siguiente: siguiente: public class AlmacenPuncuacionesPreferencias AlmacenPuntuacionesPreferencias implementa implements AlmacenPuntuaciones {{ private static String PREFERENCIAS PREFERENCIAS=- "puntuaciones"; private prívate Context context; public AlmacenPuntuacionesPreferencias(Context AlmacenPuntuac.ionesPreferencias (Context. context) this .context = = context; context. ; this.context

} publ i c void guardarPunt.uac: .i on (int puntos, String St.r.i.ng nombre, public guardarPuntuación(int long fecha) {{

278

{{

Almacenamiento de datos SharedPreferences preferencias =context.get.SharedPreferences( =context.getSharedPreferences( PI?.EFERENClllS, Context.MODE_PRIVATE); Con text . NODE,'_PR IVil.'l'E) ; PREFERENCIAS, SharedPreferences.Editor editor= editor = preferencias.edit();

editor.putString("puntuacion", puntos +t "" "+nombre); editor.putString("puntuación", " + nombre); editor·. comrni t(>; t () ; edi tor,comrai

} public Vector Vector listaPuntuaciones( int cantidad) { XistaPuntuaciones(int VectorcString> Vector result == new VectorcString>(); Vectorí); Shar edPreferences ppreferencias referencias =-context.getSharedPreferences( SharedPreferences =context.getSharedPreferences{ PREFE.J.?ElVCDlS, Context. Context .110DE_PRTV~'1TE); PREFERENCIAS, MODE__PRIVATE) ; String s s == preferencias.getString("puntuación", preferencias.getString("puntuacion", ""); if (s (S !!= = "") { res u lt.add(s) ; result.add(s>; } return result; } 11 " )

{

} 4. 4.

Asteroides.java y en el método oncreat.e onCreateO Abre el fichero Asteroídes.java () reemplaza la línea adecuada por: por: a.J.macen AlmacenPunt.uacionesPrefenencias ( this ) ; almacén = new AlmacenPuntuacionesPreferencias(this);

5. 5.

Ejecuta el proyecto y verifica que la última puntuación se guarda correctamente.

6.

Abre la vista File Explorer: Explorer: utilizando el menú Wíndow/Show Window/Show View/Other...../Androíd/Fíle ./Android/File Exp/orer Explorer y verifica que se ha creado el fichero: Víew!Other /data/data/org. example. asteroides/shared_prefs/puntuaciones. xml ldataldatalorg.examp/e.asteroídes/shared_prefs/puntuacíones.xm/

7.

^) y observa su contenido. Descarga este fichero a tu ordenador (botón ~~)y O

0

Práctica: Almacenando las 10 Práctica: /as últimas 1 O puntuación en un fichero de preferencias. preferencias.

En el ejercicio anterior solo guardamos la última puntuación, lo cual no coincide con la idea que habíamos plantado en un principio -nos interesaba guardar una lista puntuaciones-. En esta práctica tratarás de solucionar este con las últimas puntuaciones-. inconveniente. NOTA: Básicamente es una práctica de programación en Java. Si no estás interesado puedes consultar directamente la solución.

1. 1.

Las preferencias solo están preparadas para almacenar variables de tipo vector. Para solucionar este simple, por lo que no permiten almacenar un vector. inconveniente, te recomendamos que crees 110 O preferencias con nombres puntuacionO, puntuacionl, puntuacionl , ... , puntuacion9.

279

El gran libro de Android 2.

guardarPuntuacionO almacena la la nueva nueva puntuación puntuación Cuando se llame a guardarPuntuacion \ l almacena la precaución precaución de de copiar copiar el el valor valor de de esta esta en puntuaciono. Pero, antes, ten la puntuacionl; y puntuacionl preferencia a puntuacioni; puntuacioni aa puntuacion2 puntuacion2 yy así así hasta hasta la la penúltima. penúltima. La última se perderá perderá. Esta Esta operación operación puede puede realizarse realizarse por por entero, nn,, de de forma forma que que el el nombre nombre de de la la medio de un bucle con un índice entero, preferencia a mover puedes expresarlo como como "puntuacion" "puntuación" +n. +n.

3.

para implementar el el método método ListaPuntuaciones ListaPuntuaciones (). (). Utiliza el mismo truco para

-V*' ,/ ~

4.

las últimas últimas 10 10 puntuación puntuación en en un un fichero fichero Solución: Almacenando las de preferencias. preferencias. guardarPuntuacion (): (): Remplaza en guardarPuntuacion editor. putString ( 11 puntuacion 11 puntos editor.putString("puntuación", puntos ++ 1

" "" ++ nombre) nombre);;

n

por: por:

= 9; S; nn >= >= 1; 1; n--) n--) {{ for (int n = editor.putString("puntuacion" editor.putString("puntuación" ++ n, n, preferenc .i.as.get.String("ptmtuacion" ++ (n preferencias.getString("puntuación" (n -- 1.), 1),

"'' ));

} 11 , editor.putSt:ring("puntuaci.on0 puntos+ editor.putString{"puntuacionO", puntos +

5.

" " +nombre}; + nombre);

11

11

Remplaza en ListaPuntuaciones ListaPuntuaciones () ():: 11 puntuacion':, String s:::: ''''); s = preferencias.getString( preferencias.getString<"puntuación", "");

(s 1= ( if (S ! = "") { result.add(s); } por:

= O; 0; nn e= <- 9; !1++) n++) {{ for (int nn = String ss :::: prefe: c encias.get.Str.i.ng( = preferencias .getString { ''punt.uac.i.on "puntuación"11 +-i- n, n, if

(s (s

!= !=

"") "")

11 ' 1 ) ;

{{

result..add(s); result.add(s);

} }

9.4. Accediendo aa ficheros 9.4. Accediendo ficheros Existen tres tipos de ficheros donde donde podemos podemos almacenar almacenar información información en en Android: Android: ficheros almacenados en la memoria memoria interna interna del del teléfono, teléfono, ficheros ficheros almacenados almacenados en en la memoria externa (normalmente una una tarjeta tarjeta SO) SD) yy ficheros ficheros almacenados almacenados en en los los recursos. Estos últimos son de solo solo lectura lectura por por lo lo que que no no son son útiles útiles para para almacenar almacenar información desde la aplicación.

280

Almacenamiento de datos

Poli[Media]: ficheros en en Android. Android. Poli[Med¡a]: Gestión de ficheros 9.4.1. Sistema interno interno de de ficheros ficheros Android permite almacenar ficheros ficheros en en la la memoria memoria interna interna del del teléfono. teléfono. Por Por defecto defecto los ficheros almacenados almacenados solo solo son son accesibles accesibles por por la la aplicación aplicación que que los los creó, creó, no no el usuario usuario del del teléfono. teléfono. otras aplicaciones, aplicaciones, ni ni siquiera siquiera por por el pueden ser leídos por otras Cada aplicación dispone dispone de de una una carpeta carpeta especial especial para para almacenar almacenar ficheros ficheros (ldataldatalnombre_del_paquetelfiles). La ventaja ventaja de de utilizar utilizar esta esta carpeta carpeta es es que que (/data/data/nombre_det_paquete/files). La cuando se desinstala la la aplicación aplicación los los ficheros ficheros que que has has creado creado se se eliminarán. eliminarán. en Android, Android, ten ten siempre siempre en en cuenta cuenta que que lala memoria memoria Cuando trabajes con ficheros ficheros en disponible de de los teléfonos teléfonos móviles móviles es es limitada. limitada. Recuerda que el sistema sistema de de ficheros ficheros se se sustenta sustenta en en la la capa capa Linux, Linux, por por lolo que que Android hereda su estructura. estructura. Cuando Cuando se se instala instala una una nueva nueva aplicación, aplicación, Android Android crea crea un nuevo usuario Linux Lir.ux asociado asociado aa la la aplicación aplicación yy es es este este usuario usuario el el que que podrá, podrá, oo no, acceder a los ficheros. Puedes utilizar cualquier cualquier rutina del del paquete paquete java.io java. io para para trabajar trabajar con con ficheros. ficheros. creado métodos métodos adicionales adicionales asociados asociados aa lala clase clase contex contex para para Adicionalmente, se han creado facilitarte el trabajo con ficheros ficheros almacenados almacenados en en la la memoria memoria interna. interna. En En particular particular los los métodos openFiieinput openFileinput () yy openFiieOutput open FUeOutput {) () te te permiten permiten abrir abrir un un fichero fichero para para lectura o escritura respectivamente. respectivamente. Si Si utilizas utilizas estos estos métodos métodos el el nombre nombre del del archivo archivo no no puede contener subdirectorios. subdirectorios. De De hecho, hecho, el el fichero fichero siempre siempre es es almacenado almacenado en en lala carpeta reservada para tu tu aplicación aplicación {/data/data/nombrejde!_paquete/files). (ldata/data/nombre_de/_paquetelfiles). Recuerda Recuerda con el el método método cióse el ose (). () . El El siguiente siguiente ejemplo ejemplo muestra muestracómo cómo siempre cerrar los ficheros con crear un fichero yy escribir escribir en en él él un un texto: texto: String fichero fichero= "fichero.txt"; = "fichero,txt"; String texto texto= •texto almacenado"; almacenado"; = "texto FileOutputStream FileOutputStream fos; try {{ fos = openFiieOutput openFileOutput (fichero, (fichero, Context Context .MOI'fLRRI'VAT'E') .MODE"'_PRlVJl'l'E' ); ; fos . write(texto . getBytes());; fos.write(texto.getBytes()5 fos . close(); fos.cióse(); } catch (FileNotFoundException (FileNotFound Exception e) e) { Log.e("Mi Aplicación",e.getMessage(),e); Log.e("Mi Aplicación ",e.getMessage() ,e) ; } catch (lOSxception (IOException e) {{ Lo g .e (" Mi Aplicación",e.getMessage() Aplicación ", e . getMe ssage() ,, e); e); Log.e("Mi

} Es muy importante hacer hacer un un manejo manejo cuidadoso cuidadoso de de los los errores. errores. De De hecho, hecho, elel acceso a ficheros ha de de realizarse realizarse de de forma forma obligatoria obligatoria dentro dentro de de una una sección sección try/cat:ch. try/catch. Además de los dos dos métodos métodos indicados indicados pueden pueden serte serte útiles útiles algunos algunos de de los los siguientes: getFilesDir o ( l devuelve devuelve la la ruta ruta absoluta absoluta donde donde se se están están guardando guardando los los siguientes: getFi.iesD.ir

281

El gran libro de Android getoirO crea un un directorio directorio en en tu tu almacenamiento almacenamiento interno interno (o(o lolo abre abre sisi ficheros; getDi r ( J crea existe; () devuelve existe; deleteFile deieteFile (oJ borra borra un un fichero; fichero; fileList fiieListO devuelve un un array array con con los los ficheros almacenados por por tu tu aplicación. aplicación.

Ejercicio paso aa paso: paso: Almacenando Almacenando puntuaciones puntuacionesen en un un fichero de la memoria memoria interna. interna. El

siguiente

ejerc1c1o ejercicio muestra muestra una una clase clase que que implementa implementa lala interfaz interfaz

lümacenPuntuaciones AimacenPuntuaciones utilizando utilizando los los métodos métodos antes antesdescritos. descritos.

1.

Abre el proyecto Asteroides. Asteroides.

2.

clase Al AlmacenPuntuacionesPicheroInterno. Crea una nueva clase macenPuntuacione sFiche:r·ointerno .

3.

Remplaza el código por por el el siguiente: siguiente: public cla ss lümacenPuntuacionesFi c herointe:nlO impl ementa class AlmacenPuntuacionesFicheroInterno implements AlmacenPuntuaciones AlmacenPuntuaciones {{ private tic Strin9 puntuaciones.txt"; prívate sta static String FICHERO= FICHERO = 11"puntuaciones.txt"; private prívate Context context; context; public Alma cenPuntuaciones F i cherointerno(Context context) AlmaceuPuntuacionesFicheroInterno(Context context.) tthis his .contex . context.t ~= context; context;

{

} guardarPuntuacion(int puntos, String String nombre, nombre, l long fecha){ public void guardarPuntuacion( int puntos, ong fecha) { try { FileOutputStream ff == context.openFileOutput(FIC'HERO, context.openFileOutput{FICHERO, Conte xt. MODE ....APPEND) ;; Context. MODE,_APFEND) St ri ng texto= \n"; String texto = puntos puntos ++ " " ++ nombre nombre ++ ""\n"; writ e(texto.getBytes()); f . write (texto. getByt.es () ) ; f.close(); f.cióse(); } catch (Exception (Exception el e) {{ I ;og. e: ( HAsteroi d es e.get fl-1essag e{), e)¡ Log.e("Asteroides", e.getMessage(), e); } } 11

11

11

1

public Vector: int cantidad) Vector listaPuntuaciones( listaPuntuacionesíint cantidad) { VectorcString> result (); Vector result = new new Vect.or Vector(); try {{ Fi le lnputStre am ff ~- context . ope nFilelnput(FLCHE'RO); FilelnputStream context.openFilelnput(FXCHKFO); BufferedReader ent rada = e w BufferedReader( entrada = nnew BufferedReader( new InputStreamReader(f)); InputStreamReader(f)); int = O; 0; in t nn = String linea; do { linea a .readLine (); linea ~= entrad entrada. readLineO;

282

Almacenamiento de datos if (linea !~ ll ) { != nu nuil) result . add(linea result.add(linea); n++;

} ); } while (n << cantidad && linea != 1= null nuil); f. e lose () ; f.cióse(); } catch (Exception e) { Log.ei"Asteroides", ) , ee>; ); Log.e("Asteroides", e.getMessage( e.getMessage(), } return result; } } 4.

oncreate () () reemplaza reemplaza la la Abre el fichero Asteroides.java y en el método oncreate línea adecuada por: a.l.macen i cherointerno( this ); almacén =~ new AlmacenPuntu.acionesF AlmacenPuntuacionesFicheroInterno(this);

5.

Ejecuta el proyecto y verifica que la última puntuación puntuación se se guarda guarda correctamente. correctamente.

6.

el fichero: fichero: Abre la vista File Explorer y verifica que se ha creado el /data/data/org. example. example. asteroides/files/puntuaciones. asteroides/flles/puntuaciones. txt /data/data/org.

7.

Descarga este fichero a tu ordenador (botón 11 ^ )) y observa su su contenido. contenido.

.0 0

Practica: Configurar almacenamiento de puntuaciones desde desde

preferencias. preferencias.

Modifica las preferencias de la aplicación Asteroides para que el el usuario usuario pueda pueda momento incluye incluye tres tres seleccionar donde se guardarán las puntuaciones. De momento memoria interna" interna" opciones: "Constante", "Preferencias" y "Fichero en memoria

1.

Abre el fichero Asteroides.java y en el método oncrea oncreate () remplaza: remplaza: te 1) almacen e w AlmacenPuntuacionesFicherointerno( this ); almacén =- nnew AlmacenPuntuacionesFicheroInternoíthis);

2. 3.

la variable almacen almacén de de por el código necesario para que se inicialice la forma adecuada según el valor introducido en preferencias. Verifica el resultado. incluyelo en en Cada vez que añadas un nuevo método de almacenamiento inclúyelo la lista de preferencias.

9.4.2. Sistema de almacenamiento externo Los teléfonos Android suelen disponer de memoria adicional de almacenamiento, almacenamiento, conocido como almacenamiento externo. Éste suele ser de mayor mayor capacidad capacidad por por lo lo que que resulta ideal para almacenar ficheros de música o vídeo. Suele ser ser una una memoria memoria extraíble, como una tarjeta SO, SD, o una memoria interna no extraíble extraíble (algunos (algunos modelos modelos incorporan los dos tipos de memoria, es decir almacenamiento externo externo extraíble extraíble yy no no

283

El gran libro de Android extraíble). Cuando conectamos el dispositivo Android a través del cable USB permitimos el acceso a esta memoria externa, de forma que los ficheros aquí escritos podrán ser leídos, leídos, modificados o borrados por cualquier usuario. Para acceder a la memoria externa lo habitual es utilizar la ruta /sdcard/... /sdcard/ ...

SD. No obstante, obstante, resulta En esta carpeta es donde el sistema suele montar la tarjeta SO. más Conveniente Env.iromnent:. getExte:mal:.-ltorageD.irectory () conveniente Utilizar utilizar el método Environment.getExtemalStorageDirectoryO para que el sistema nos indique la ruta exacta. A

partir

de

la

versión

1.6

resulta

necesario

declarar

el

permiso

WRITE_EXTERNAL_STOR.liGE t.xm1 write_external_storage en A.ndroidrvlanifes AndroídManlfest. xrni para poder escribir en la memoria

externa.

,..-·

tr7.~,~

~ Poli[Media]: Android. PolifMedia]: Almacenamiento externo en Andmid.

11

Ejercicio paso a paso: Almacenando puntuaciones en la memoria externa. externa.

1. 1.

Abre el proyecto del ejercicio anterior.

2. 2.

AlmacenPuntuacionesFicherolnterno.java, y cópialo Selecciona el fichero AlmacenPuntuacionesFicheroInterno.java, en el portapapeles (Ctri-C). (Ctrl-C).

3. 3.

Pega el fichero sobre el proyecto (Ctri-V) (Ctrl-V) y renómbralo con el nombre AlmacenPuntuacionesFicheroExterno.java.

4. 4.

Abre la nueva clase creada y remplaza la inicialización de la variable FICHERO por: fichero por: private F.ICJ!ERO = Environment.. prívate static String FICHERO = Environment. getExterna1St:orageDi rectory() + "/puntuaciones.txt"; " /puntuaciones.txt"; getExternalScorageDirectory{)

Normalmente esta variable valdrá: "/sdcard/puntuaciones.txt". "/ sdcard/puntuaciones. txt" . 5.

En el método guardarPuntuacionO g u ardar Puntuac.ion () remplaza la inicialización de la variable ffos os por: FileOut.putSt.ream FileOutputStream fos

6.

En el método listaPuntuacionO l.istaPuntuacion() remplaza la inicialización de la variable fis por: por: Fil einputStream f.is FilelnputStream fis

284

.i leOutputStream ( FTCHERO, true ); == new FFileOutputStreaxn(FICHERO, true);

Fi lei nputStream ( FICHEIW) ; == new Fi1eInpu131ream{FICHERO);

7.

Abre el fichero AndroidManifest.xml y solicita el permiso write_external_ l·iRI TE_EXTERNAL_ STORAGE. STORAG.E.

8.

Ejecuta la aplicación y crea nuevas puntuaciones. puntuaciones,

9.

Verifica con la vista File Explorer que dentro de la carpeta sdcard aparece el fichero. fichero.

Almacenamiento de datos

9.4.2.1. Verificando acceso a la memoria externa escritura. La memoria externa puede haber sido extraída o estar protegida contra escritura.

getExternalStorageState () para verificar Puedes utilizar el método Environment. getExternaistorageState el estado de la memoria. utiliza: memoria. Veamos como se utiliza: String stadoSD

Envi ronmen t. getExternalStorageState O (); =~ Environment.

if í(stadoSD . equals (Envi ronment. MEDIA_MOUNTED )) stadoSD.equals(Environment.MEDIA_MOUNTED)) /1 Podemos leer y y escribir //

{

(stadoSD . equals (Environment. (Environment . MED MEDIA_MOUNTED_READ_ONLY)) } else iiff (stadoSD.eguals IA_MOUISlTED_READ_ONLy)) { /1 Podemos leer //

} else {{ /1 No podemos leer y ni escribir escrib ir //

Práctica: Verificando acceso a la memoria externa. externa. 1.

Modifica la clase AimacenPuntuacionesFicheroSxterno AJ.macenPunt.uac ionesFicheroExterno para que, antes posible. En de acceder a la memoria externa, verifique que la operación es posible. caso contrario mostrará un Toas Toastt y saldrá del método.

2.

Ejecuta el programa en un dispositivo real con memoria externa y verifica que se almacena correctamente.

3.

Para que la aplicación Asteroides ya no tenga acceso a esta memoria la solución más sencilla consiste en conectar el dispositivo con el cable USB y activar el almacenamiento por USB. USB.

4.

Regresa a Asteroides y comprueba el resultado. resultado.

W

Solución; Verificando acceso a la memoria externa. externa. Solución:

guardarPuntuacion () añade: 1. En guardarPuntuacionO añade:

eraaiSírorageStatev) String stadoSD = Environment. getExc g·etExternalStorageState () ; if (!stadoSD.equals(Environment.MEDIA_MOUNTED) (! stadoSD. ecrúaJ.s (Environment. MEDLA_MOUNTED))) {

Toa.st..ma.ke'I'ext(context, Toast.makeText(context, "No puedo escribir en la memoria LONG) .show(); externa", Toast.L.ENG'l'H_ Toast.LBNGTH_LONG) return return;;

285

El gran libro de Android 2.

En listaPuntuacion() listaPuntuacion () añade:

= Environment Hnvironment.getExcemaiStorageStateí) String stadoSD ::::: . ~-¡etExterna18toraqe8tate{) ¡; if (! stadoSD . equaJ.s (Environment . MEDTA__NOUNTED) && (i stadoSD.equals(Environment.MEDIA„MOUNTED) && !i stadoSD.equals(Environment.MEDIA_MGUNTED_READ_ONLY)) s tadoSD . equals (Environrnent .MEDil!_l"!OUN·TED_READ_ONLY)) { Toast.makeText(cont ext, "No puedo leer en la memoria Toast.makeText(context, externa externa"11

Toas t. LENGTH__LiONG) L~ENGTI-I._~DO.NG) . shov-1 , Toast. show () {) ; ,

return :r·esult; result;

}

9.4.2.2. Almacenando ficheros específicos especí ficos de tu aplicación en el almacenamiento externo A partir de la versión 2.2 (nivel de API 8) las aplicaciones pueden almacenar los ficheros en una carpeta específica del sistema de almacenamiento externo, de forma que cuando la aplicación sea desinstalada se borren automáticamente estos ficheros. ficheros. En concreto esta carpeta ha de seguir esta estructura: /And:r·oid/ dataí // files/ f i 1 es /

donde el paquete ha de cambiarse por el nombre del paquete de la aplicación, por ejemplo org. example. exampie. asteroides. A partir del nivel de API 8 puedes utilizar el método getExternalFilesDü getExternaiFiiesDir (null) (nuil) para obtener esta ruta. ruta. Si en lugar de null nuil indicas alguna de las constantes que se indican más abajo, se devolverá la ruta a una carpeta específica según el tipo de contenido que nos interese. Este método crea la carpeta en caso de no existir previamente. Indicando la carpeta garantizamos que el escáner de medios de Android previamente. adecuada. Por ejemplo, un tono de llamada será categoriza los ficheros de forma adecuada. identificado como tal y no como un fichero de música. De esta forma, no aparecerá en la lista de música que puede reproducir el reproductor multimedia. Estas carpetas también son eliminadas cuando se desinstala la aplicación. Constante

carpeta

descripción

DIREC'l'ORY DIRECTORY IvlUSIC MUSIO

t-íusic

Ficheros de música.

DIRECTOR Y- PODCASTS DIRECTORY_PODGA3TS

Podcasts

Descargas desde podcast.

DIRECTOR Y RINGTONES DIRECTORY

Ringtones

Tono de llamada de teléfono.

DIRECTOR Y ALARMS ALAR!'
Alarms

Sonidos de alarma. alarma.

DIRECTORYY NOTIFICA'l'IONS NOTIFICATIONS DIRECTOR

Notificati ons Notifications

Sonidos para notificaciones.

DIRECTOR PIC'I'URES DIRECTORYY PICTURES

Pictures

Ficheros con fotografías. fotografías.

DIRECTOR DOWNLOADS DIRE CTORY Y_DOV?NLO AD S -

Download

Descargas de cualquier tipo. tipo.

DIRECTORY DCIM DIRECTORY__DCIM

DCIN DCIM

Carpeta que tradicionalmente crean las cámaras.

NOTA. Si tu aplicación es creada para el nivel de APJ API inforior inferior a 8 no tendrás acceso al método getExternaiFiiesDir g e tE.xt e rnal Fil esDi r(null). (nuil). No obstante, puedes almacenar a mano los ficheros en una carpeta con la estructura:

286

Almacenamiento de datos getExternalStorageDirectory() getExternalStorageDirectory() ++ " /Android/ data <:nom.b·ce_del_¡..vit:.Tuete>/ files /" /Andró i d/ da t a / /files/"

Cuando se desinstale desinstale tu tu aplicación aplicación esta esta carpeta carpeta será será eliminada eliminada sisi se se ha ha instalado en dispositivos dispositivos con con una una versión versión 2.2 2.2 oo superior. superior.

Práctica: Almacenando Almacenando puntuaciones puntuaciones en en una una carpeta carpeta de de la la Práctica: aplicación de de la la memoria memoria externa. externa. aplicación

0

1.

fichero AlmacenPuntuacionesFicheroExterno.java, AlmacenPuntuacionesFicheroExtemo.java , yy cópialo cópialo Selecciona el fichero en el portapapeles (Ctrl-C). (Ctri-C).

2.

Pega el fichero sobre sobre el el proyecto proyecto (Ctrl-V) (Ctri-V) yy renómbralo renómbralo con con elel nombre nombre AlmacenPuntuacionesFicheroExtAp/.java. AlmacenPuntuacionesFicheroExtApl.ja va.

3.

Modifica los método método listaPuntuaciones lü;taPuntuaciones ()() yy guardar guardarPuntuacion para Puntuación ()() para que las puntuaciones puntuaciones se almacenen almacenen en en la la SD SD pero pero en en una una carpeta carpeta de de tutu aplicación. Realiza esta esta tarea tarea con con una una versión versión de de SDK SDK para para Asteroides Asteroides inferior a la 2.2.

4.

utilizar el siguiente siguiente código código para para crear crear el el directorio: directorio: Puedes utilizar File ruta -= new n ew File (Environment . getExternalStorageDi¡;·ectory () ++ File(Environment.getExternalStorageDirectory() "/Android/data/org.exarnple.asteroides/files/"); "/Android/data/org.example.asteroides/files/"); if {!ruta.exista()) (! r·uta.exi sts()) {{ rut.a.rnkdi rs ();; ruta.mkdirsO

} 5. 6.

resultado ejecutando ejecutando la la aplicación aplicación en en un un terminal terminal con con una una Verifica el resultado la 2.2. 2.2. Desinstala Desinstala la la aplicación aplicación yy verifica verifica sisi elel fichero fichero ha versión inferior a la ha sido eliminado. eliminado.

6.

Ejecuta ahora la aplicación aplicación en en un un terminal terminal con con una una versión versión igual igual oosuperior superior a la 2.2. Desinstala la la aplicación aplicación yy verifica verifica sisi el el fichero fichero ha ha sido sido eliminado. eliminado.

9.4.2.3. Almacenando Almacenando ficheros compartidos compartidos en en el el almacenamiento almacenamiento externo Si quieres crear un fichero fichero que que no no sea sea específico específico para para tu tu aplicación aplicación yy quieres quieresque queno no sea borrado cuando tu aplicación aplicación sea sea desinstalada, desinstalada, puedes puedes crearlo crearlo en en cualquier cualquier directorio del almacenamiento almacenamiento externo. externo. que utilices utilices alguno alguno de de los los directorios directorios públicos públicos creados creados para para Lo ideal es que almacenar diferentes diferentes tipos de de ficheros. ficheros. Estos Estos directorios directorios parten parten de de lala raíz raíz del del de las las carpetas carpetas listadas listadas en en lala tabla tabla almacenamiento externo yy siguen siguen con con alguna alguna de anterior. anterior. la ruta ruta de de un un directorio directoriocompartido, compartido,puedes puedes A partir del del nivel de API 8, 8, para para obtener obtener la utilizar el método método getExternalStoragePublicDirectory(String getExternalSt.oragePubli.cDirectory (St.ri ng tipo). tipo). Como Como

287

El gran libro de Android anterior. parámetro utiliza alguna de las constantes que se indican en la tabla anterior. Guardando los ficheros en las carpetas adecuadas garantizamos que el escáner de medios de Android categoriza los ficheros de forma adecuada. Si utilizas un nivel de API anterior al 8, 8, lo recomendable es crear estas carpetas manualmente. manualmente.

NOTA: Si quieres que tus ficheros estén ocultos al escáner de medios incluye un fichero vacío con nombre .nomedia en la carpeta donde estén almacenados.

9.4.3. Acceder a un fichero de los recursos También tienes la posibilidad de almacenar ficheros en los recursos, es decir, adjuntos al paquete de la aplicación. aplicación. Has de tener en cuenta que estos ficheros no modificados. Por ejemplo, ejemplo, si arrastras cualquier fichero con nombre podrán ser modificados. datos y cualquier nombre extensión a la carpeta res/raw, resíraw, podrás acceder a él usando Resourc es. openRawRe source (R. r a w . da tos ) . Recuerda que ningún fichero Resources.openRawResourceíR.raw.datos). en la carpeta raw será comprimido.

paso; Almacenando puntuaciones en un Ejercicio paso a paso: fichero de recursos. recursos. 1.

Con el explorador de ficheros busca en el terminal un fichero de texto con puntuaciones.txt, creado en alguno de los ejercicios anteriores. nombre puntuaciones.txt,

2.

Extráelo del terminal y pégalo en el proyecto Asteroides en la carpeta res/raw. res/raw.

3.

Selecciona el fichero AlmacenPuntuacionesFicherolnterno.java, AlmacenPuntuacionesFicheroInterno.java, y cópialo en el portapapeles (Ctri-C). (Ctrl-C).

4.

Pega el fichero sobre el proyecto (Ctri-V) (Ctrl-V) y renómbralo con el nombre AlmacenPuntuacionesRecurso.java.

5.

Elimina de esta clase todo el código del método guardarPuntuacion g uar d arPu ntuac .i o n (). () . Al igual que en la clase AlmacenPuntuacionesConstante AlmacénPuntuacionesConstante no se realiza ninguna acción en este método.

6.

Remplaza en el método listaPuntuaciones l istaPunt uacio n es í) () para que las puntuaciones se lean del fichero de los recursos: recursos:

FilelnputStream Fi l e i nput S t ream ff = = context.openFilelnput(FICHERO); cont e x t . o p e n Fi l einput( F.TCHERO) ; por: por: IInputStream npu tStream ff = ~ con tex t .getResources().openRawResource{ . getR e sou rces() . o p enRa wResou rce ( context. R . r aw . .r;unt.:uaciones ) ¡ R.raw.puntuaciones);

7. 7.

La siguiente línea ya no tiene sentido. sentido. Elimínala: prívate static r ing FICHERO = = ""puntuaciones.txt"; pun tuac i o n es.txt " ; statlc St String

8. B.

288

Verifica el resultado. resultado.

Almacenamiento de datos

9.5. con XML XML 9.5. Trabajando Trabajando con Como sabrás, sabrás, XML es uno de los estándares más utilizados en la actualidad para codificar información. información. Es ampliamente utilizado en Internet; Internet; además, además, como hemos de Android. Android. mostrado a lo largo de este libro se utiliza para múltiples usos en el SDK de Entre otras cosas es utilizado para definir Layouts, Layouts, animaciones, animaciones, P..ndroidHanifest , ... AndroidManif est..xml xml,... Una de las mayores fortalezas de la plataforma Android es que se aprovecha del lenguaje de programación Java yy sus librerías. El SDK de Android Android no acaba de Java (JRE), (JRE), ofrecer todo lo disponible para su estándar del entorno de ejecución Java pero es compatible con una fracción muy significativa de la misma. misma. Lo mismo mismo ocurre en lo referente a trabajar con XML; XML; Java dispone de gran cantidad de APIs APis con este propósito pero no todas están disponibles desde Android. Android. Librerías disponibles: Java's Simple API forXML for XML (SAX) (paquetes org.xml.sax.*) org. xml. sax. * ) Document Object Model (DOM) (paquetes org. org . w3c.dom. w3c. dom. *) *)

Librerías no disponibles: disponibles: Streaming Streamíng API for XML (StAX). (StAX). Aunque se dispone de otra librería con xmlpull. vi. v1.Xm1Pu11Parser). funcionalidad equivalente (paquete org. xmipuii. xmiPuiiParser). Java Architecture for XML Binding (JAXB). (JAXB). Resultaría demasiado pesada forXML para Android. Android.

Como podrás ver al estudiar los ejemplos, ejemplos, leer y escribir ficheros XML es muy laborioso y necesitarás algo de esfuerzo para comprender el código empleado. empleado. Vamos a explicar las dos alternativas más importantes, SAX y DOM. DOM. El planteamiento es bastante diferente. diferente. Tras ver los ejemplos podrás decidir decidir qué herramienta se adapta mejor a tus gustos personales o al problema en concreto que tengas que resolver. resolver. El ejemplo utilizado para ilustrar el trabajo con XML va a ser el mismo que que el utilizado en el resto del capítulo: capítulo: almacenar las mejores puntuaciones obtenidas. obtenidas. El formato XML que se utilizará para este propósito se muestra a continuación: continuación: ?> fecha=" .128812202.3410 > «puntuación «nombre>Mi nombre«/nombre> cnombre>Mi nombrec/nombre> «punt os >45000 cpunt os>45000 c/puntos> c/puntuacion> cpuntuacion fecha="128812 2 428132 "> «puntuación fecha="1288122428132"> cnombre>Otro nombre c/nomb:r-e> «nombre>Otro nombre«/nombre> cpun tos >31 OOO< /r)Unto~J > «puntos>31000«/puntos> «/puntu ac i on > c/puntuacion> < /1 is ta___puntuaciones» punt uaciones> «/lista 11

1'

11

11

289

El gran libro de Android 9.5.1.. Procesando XML con SAX 9.5.1 El uso de la API SAX (Simple API for XML) se recomienda cuando se desea un programa de análisis rápido y se quiere reducir al mínimo el consumo de memoria de la aplicación. aplicación. Eso hace que sea muy apropiado para un dispositivo móvil con tamaño. Android. Android. También resulta ventajoso para procesar ficheros de gran tamaño. SAX nos facilita realizar un parser (analizador) sobre un documento XML para así poder analizar su contenido. contenido. Ha de quedar claro que SAX no almacena los datos. Por lo tanto, necesitaremos una estructura de datos donde guardar la información contenida en el XML. Para realizar este parser se van a ir generando una serie de eventos a medida que se vaya leyendo el documento secuencialmente. anterior, SAX generará los siguientes Por ejemplo, ejemplo, al analizar el documento XMl. XML anterior, eventos: eventos: Comienza elemento: lista ____puntuaciones puntuaciones Cornienza elt:.:rnento: puntuación, puntu.acion, con 23 -1.'i.O" Comienza elemento: con atributo fecha=".72881220 íe.cha= " 1288122023410" Comienza element.o: nombre nombrE.:.: Comienza elemento: Texto fl.tl. nombre nomb.re Texto de nodo: Mi Finaliza elemento: nombre Comienza Comienza elemento: puntos Texto de nodo: nodo: 45000 45000 Texto de Finaliza Finaliza elemento: puntos Finaliza elemento: puntuación puntuacion Comienza puntuacion, con fecha=" _l2 88122428 132 " Comienza elemento: puntuación, con atributo fechan"1288122428132" Comi f.:.:nza elemento: eletw.:.!nto: nombre Comienza Tt:;xt:o de nodo: Otro nombre Texto Finaliza elemento : nombre Finali za e1emento: Comienza elemento: eJ.emento ; puntos Texto de nodo: 31000 Texto Finaliza Finaliza elemento: puntos Finaliza puntuacion Finaliza elemento: puntuación Finaliza elemento: lista_puntuaciones lista____puntuaciones

SAX, vamos a escribir métodos Para analizar un documento mediante SAX, asociados a cada tipo de eventos. Este proceso se realiza extendiendo la clase DefaultHandler que nos permite rescribir 5 métodos. DefauitHandier métodos. Los métodos listados a continuación serán llamados a medida que ocurran los eventos del proceso de lectura secuencial del documento. documento. s tart:Document () :comienza startDocument : comienza el Documento XML. endDocument () {) : finaliza documento XML. XML, start:Elernent (String ur i , St:ring nombreLocal, nornbreLocal, String nombreCualif, nornbreCctal if, startElement(String uri, String etiqueta; se indican los parámetros: Attributes atributos} atributos) : comienza una nueva etiqueta; parámetros: uri: La uri del espacio de nombres o vacío, vacío, si no se ha definido. definido. nornbreLocal prefijo. nombreLocal:: nombre local de la etiqueta sin prefijo. nombrecua 1 i f : nombre cualificado de la etiqueta con prefijo. nombreCualif: atributos: atributos; lista de atributos de la etiqueta. etiqueta.

290

Almacenamiento de datos endElement (String uri, String St.r.ing noinbreLoca.1, nombreLocal, Strlng St.ring nombreCualif): nombrecualif): termina termina una etiqueta. eh [J, int int comienzo, comienzo, int int longitud): longitud): devuelve devuelve los loscaracteres caracteres characters (char ch[], dentro de una etiqueta. etiqueta. Es Es decir decir en en caracteres caracteres Devolvería caracteres. Para Para obtener obtener un un String String con con estos estos caracteres: caracteres:string string ss == nev: String (eh, comienzo, longitud). longitud). Más Más adelante adelante veremos veremos un un ejemplo ejemplo de de cómo cómo new string(ch,comienzo, utilizar este método. método.

Ejercicio paso a paso: paso: Almacenando Almacenando puntuaciones puntuaciones en en XML XML con con SAX. S4X. Una vez descritos los principios principios de de trabajo trabajo con con SAX, SAX, pasemos pasemos aa implementar implementarlala interfaz AimacenPuntuaciones AlmacenPuntuaciones mediante mediante esta esta API. API. 1.

rümacenPuntuacionesXML_SAX en en la la aplicación aplicación Asteroides Asteroides Crea la clase AlmacenPuntuacionesXML_SAX y escribe el siguiente siguiente código: código:

publíc AlmacenPuntuacionesXML SAX implements implementa public class AlmacenPuntuacionesXML_SAX AlmacenPuntuaciones AimacenPuntuaciones {{ prívate static String = "puntuaciones.xml"; private St:r-ing FICHERO FICHERO= "puntuaciones.xml"; prívate Context Context contexto; contexto; prívate ListaPuntuaciones ListaPuntuaciones lista; lista; prívate boolean boolean cargadaLista; cargadaLista; public AlmacenPuntuacionesXML_SAX(Context AlmacenPuntuacionesXML_SAX(Context contexto) contexto) {{ thís .contexto == contexto; contexto; this.contexto lista -~. new ListaPuntuaciones(); ListaPuntuaciones () ; cargadaLis ta == false; cargadaLista

} SOverride

@Over:t~J.de

public void voíd guardarPuntuacion(int guardar:Puntuacion( int puntos, puntos, String String nombre, nombre, long fecha) {{ try {{ íf (!cargadaLista ){ if (icargadaLista){ lista.leerXML(contexto.openFilelnputlFICHERO) ) ; lista.leerXML(contexto.openF'ilelnput(F'ICHERO));

} } catch (FileNotFoundException (FileNotFoundException e) e) {{ } catch (Exception (Except.ion e) e) {{ Log.e("Asteroides", e.getMessage(), e); e); Log.e("Asteroides", e.getMessage!), } list a .nuevo(puntos, nombre, nombre, fecha); fecha); lista.nuevo(puntos, try {{ lista.escribirXtJ!L(contexto.openFileOutput.(F'ICHERO lista.escribirXML(contexto.openFileOutput{FICHERO, , Context. MODE_PRIVATE)) f.f0DE_PRIF.4TE) ) ;; (Except.ion e) e) { } catch (Exception

291

El gran libro de Android Log. e ("Asteroides", e.getMessage(), e. gett-1essage () , e!; e) ; Log.e("Asteroides",

} } •SOverride public Vector listaPuntuaciones( int cantidad) { piiblic Vector listaPuntuaciones(int try {{ if (!cargadaLista) í!cargadaLista){{ lista .leerXt-lL (contexto. openFilelnput ( F'LCHERO) ) ; lista.leerXML(contexto.openFilelnput(FJCHKRO)

} catch (Exception e) {{ } catch Log.e("Asteroides", el; Log.eí"Asteroides", e.getMessage(), e); } return lista.aVectorString{); lista.aVect.orString(); 1 La nueva clase comienza definiendo una serie de variables y constantes. constantes. En primer lugar el nombre del fichero donde se guardarán los datos. Con el valor indicado, el fichero se almacenará en /data/data/org.example.asteroides/ /data/ data/ org. example. asteroides/ files/puntuaciones.xml. lugar, como por files/puntuaciones. xmi. Pero puedes almacenarlos en otro lugar, sdcard/puntuaciones. xml. La variable ejemplo en la memoria SO SD indicando indicandc 1 /sdcard/puntuaciones.xml. más importante es lista de la clase L.istaPuntuaciones. ListaPuntuaciones. En ella guardaremos la información contenida en el fichero XML. Esta clase es definida a continuación. continuación. La variable cargadaLista nos indica si lista ya ha sido leída desde el fichero. El código continúa sobrescribiendo los dos métodos de la interfaz. interfaz. En guardarPuntuac ion {) () comenzamos verificando si lista lü;ta ya ha sido cargada, cargada, guardarPuntuacion

para hacerlo en caso necesario. necesario. Es posible que el programa se esté ejecutando por primera vez, existirá En este caso se vez, en tal caso el fichero no existirá. l eNotFoundException al tratar de abrir el producirá una excepción de tipo Fi FiletfctFoundException fichero. Esta excepción es capturada por nuestro código, pero no realizamos ninguna acción dado que no se trata de un verdadero error. error. A continuación se J.ista y se escribe de nuevo el fichero XML. El añade un nuevo elemento a lista siguiente método, listaPuntuacioní), listaPuntuacion () , resulta sencillo de entender al limitarse a métodos definidos en la clase ListaPuntuaciones. 2.

Pasemos a mostrar el comienzo de la clase ListaPuntuaciones. ListaPuntua.ciones. No es necesario almacenarla en un fichero aparte, aparte, puedes definirla dentro de la clase anterior. Para ello, ello, copia el siguiente código justo antes del último } de la clase AlmacenPuntuacionssXML_SAX: AlmacenPuntuacionesXML SAX: private prívate class ListaPuntuaciones { private prívate class Puntuacion Puntuación { int puntos; puntos ; String nombre; nombre ; long fecha ; long fecha;

}

292

- - - - - - - - - - - -

------------------

Almacenamiento de datos private prívate ListcPuntuacion> List listaPuntuaciones; listaPuntuaciones; public ListaPuntuaciones() ListaPuntuaciones() {{ listaPuntuaciones

== new new ArrayListcPuntuacion>(); ArrayList();

} public void nuevo(int nuevo(int puntos, puntos, String String nombre, nombre, long long fecha) fecha) {{ Puntuacion Puntuación puntuacion puntuación = new new Puntuacion(); Puntuación(); puntuacion.puntos puntuación.puntos = puntos; puntos; puntuacion.nombre puntuación.nombre = = nombre; nombre; puntuacion.fecha puntuación.fecha = fecha; fecha; listaPuntuaciones. add(puntuacion); listaPuntuaciones.add(puntuación);

} public VectorcString> Vector aVectorString() aVectorString() {{ VectorcString> result Vector result == new new VectorcString>(); Vector(); for (Puntuacion (Puntuación puntuacion puntuación :: listaPuntuaciones) listaPuntuaciones) { result.add(puntuacion .nombre+" result.add(puntuación.nombre+" "+puntuacion.puntos); "+puntuacion.puntos);

} return result;

} El objetivo de esta clase clase es es mantener mantener una una lista lista de de objetos objetos Puntuacion. Puntuación. Dispone de métodos para insertar ( ) ) yy insertar un un nuevo nuevo elemento elemento (nuevo (nuevoO) con todas todas las las puntuaciones puntuaciones almacenadas almacenadas devolver un listado con (aVectorString (()). (avectorString i ). 3.

Lo verdaderamente interesante interesante de de esta esta clase clase es es que que permite permite lala lectura lectura yy escritura de los datos desde leerXML ( l yy desde un un documento documento XML XML ((leerxMLO escribirXt•IL ). Veamos primero escribirxML () ()). primero cómo cómo leer leer un un documento documento XML XML usando usando código aa continuación continuación del del anterior: anterior: SAX. Escribe el siguiente código public void leerXl\'iL(InputStream leerXML{InputStream entrada) entrada) throws throws Exception Exception {{ SAXParaerFactory fabrica fabrica =- SAXParserFactory. SAXParaerFactory,newlnstance(); SAXParserFacto:ry nev:Inst.:ance () ; SAXParser parser == fabrica.newSAXParser(); fabrica.newSAXParser(); . getXMLReader(); XMLReader lector = parser parser.getXMLReader(); ManejadorXML manejadorXML new Mane ManejadorXML(); Manej adorXt-lL manej adorXML == new j adorXML () ; lector.setContentHandler(manejadorXML); lector,setContentHandler(manejadorXML); lector .parse(new InputSource(entrada)); lector.parse(new InputSource(entrada)); cargadaLista == true; true;

} Para leer un documento XML XML comenzamos comenzamos creando creando una una instancia instancia de de lala lo que que nos nos permite permite crear crear un un nuevo nuevo parser parserXML XML clase SAXParserFactory, lo creamos un un lector, lector, de de la la clase clase XMLReader, XMLReader, de tipo SAXParser. Luego creamos asociado a este parser. Creamos Creamos manejadorXML manejadorXML de de la la clase clase XMLHadler xMLHadier yy asociamos este manejador al al XMLReader. XMLReader. Para Para finalizar finalizar lele indicamos indicamos alal XMLReader qué entrada tiene para para que que realice realice el el proceso proceso de de parser. parser. Una Una vez finalizado el proceso, marcamos marcamos que que el el fichero fichero está está cargado. cargado.

293

El gran libro de Android Androíd Como ves, el proceso es algo largo pero siempre se realiza igual. Donde sí ves, el que tendremos que trabajar algo más es en la creación de la clase XMLHadler, XMLHadier, dado que va a depender del del formato del fichero que queramos leer. leer. Esta clase es listada a continuación. continuación. 4.

Escribir este código a continuación del anterior: class ManejadorXML extends faultHandler sxtends De DefaultHandler prívate String StringBuilder private Bui l der cadena; private Pun tuacion puntuac i o n; prívate Puntuación puntuación;

{

®Override public void startDocument() throws SAXException {{ li.staPuntuaciones (); IistaPuntuaciones == new ArrayList ArrayList(); cadena == new StringBuilder();

} @Override SOverride public void startElement(Str ing uri, String nombreLocal, String startEiement(String nombreCualif, Attributes Att r ibutes atr) throws SAXException {{ cadena .setLength(O); cadena.setLength(0); if (nombreLocal.equals("puntuación")) (nombreLocal.equals( Hpuntu acion ")) {{ puntuacion Pu ntuacion(); puntuación == new Puntuación(); puntuac i o n.fecha puntuación. fecha

(atr.getValue( "fecha") ));; == Long.parseLong Long.parseLong(atr .getValue ("fecha")

} } sOverride public void ccharacters(char haracters(ch ar ch[], eh[], int comienzo, int Ion) lon) caden a .append(ch, comienzo, Ion) lon);; cadena.append(ch,

{{

} sOverride public void endElement(String e ndEl e ment(String uri, String nombreLocal, String nnombreCualif) o mbreCualif) throws SAXException {{ if (nombreLocal.equals("puntos")) (nombreLocal. equals ( "puntos" )) {{

puntuación.puntos == Integer Integer.parseXnt(cadena.toStringO); puntuacion.puntos .parseint (cadena .toString()); } else if (nombreLocal.equals("nombre")) (nombreLocal. e quals(" nombre" )) {{ puntuacion.nombre cadena.toString() ; puntuación.nombre == cadena.toString(); (no mbreLocal. e quals(" punt.uacion "))) { } else if (nombreLocal.equals("puntuación") list.aPuntuaciones.add (puntuacion ); listaPuntuaciones.add(puntuación); } } @Override ®Override public void endDocument() throws SAXException {{

}}

}

294

Almacenamiento de datos Esta clase define un manejador que que captura captura los los cinco cinco eventos eventos generados generados en SAX. En En startDocument startDocument ()() nos nos limitamos limitamos aa en el proceso de parsing en inicializar variables. En startElement startEiement (o) verificamos verificamos que que hemos hemos llegado llegado aa una etiqueta . El tal tal caso, caso, creamos creamos un un nuevo nuevo objeto objeto de de lala clase Puntuacio n e inicializamos el campo Puntuación campo fecha fecha con con el el valor valor indicado indicado en en uno de los atributos.

llamado cuando cuando aparece aparece texto texto dentro dentro de de una una El método ccharactersí) h aracters ( l es llamado ). Nos NOS limitamos limitamos aa caracteres ). etiqueta (( almacenar este texto en la la variable variable cadena cadena para para utilizarlo utilizarlo en en el el siguiente siguiente método. método. SAX no nos garantiza que que nos nos pasará pasará todo todo el el texto texto en en un un solo solo evento; evento; si el texto es muy muy extenso extenso se se realizarían realizarían varias varias llamadas llamadas aa este este método. Por esta razón, el texto se se va va acumulando acumulando en en cadena. cadena. método. endEiement. (()l resulta resulta más más complejo, complejo, dado dado que que en en función función de de El método endElement realizaremos una una tarea tarea diferente. diferente. Si Si se se trata trata qué etiqueta esté acabando realizaremos de o de utilizaremos utilizaremos el el valor valor de de la la variable variable cadena cadena para actualizar el valor correspondiente. correspondiente. Si Si se se trata trata de de añadimos el objeto puntu acion a puntuación a la la lista. lista. 5.

el último último método método de de la la clase clase r.ListaPuntuaciones, ..istaPuntuaci.one s, Introduce a continuación el documento XML: XML: que nos permite escribir el documento public void escribirXML (Outpu t St r e a m ssalida) a lida) {{ escribirXML(OutputStream ria l izer seri a li z a dor = Xml.newSeri a li zer(); XmlSe XmlSerializer serializador Xml.newSerializer(); try { sserializador.setOutput(salida, erializador . setüutput(sal ida, "UTF ···8" ); "ÜTF-8"); 11 serializador.startDo cumen t("UTF - 8 ",, ttrue) rue );; serializador. startDocument ( "UTF-8 seri a lizador.startTa g("", ""lista_puntuaciones"); lista_puntuaciones" ); serializador.startTag, forr (Puntuac (Puntuación puntuación :: li listaPuntuaciones) fo ion puntuacion staPunt u aciones ) {{ serializador .startTag("", "puntuacion" ); serializador.startTag("", "puntuación"); seriali zador .attribute("", "f echa", serializador.attribute("", "fecha", String. valueOf (pun tuacion .fecha ) ) ; String.valueOf(puntuación.fecha)); "nombre"); sserializador.startTag("" e rializador. startTag ( '' " ,, "nombre "); serializador tuac i on. nonmre ); serializador.. text(pun text (puntuación.nombre) ser ializa dor . e ndTa g(" " , "nombre "); seriali zador.endTag("", "nombre"); serializador . startTag("" , "puntos ") ; serializador.startTag("", "puntos"); serial izador . t ext( String. valueOf(punt uaci on.puntos) ); serializador.text(String.vaiueOf(puntuación.puntos)); seriali z ador.endTag("" , "puntos" ); serializador.endTag("", "puntos"); seriali z ador . e ndTag(" " , "p u ntuacion" ) ; serializador.endTag("", "puntuación");

} seri a li z ado r .endTag ("", ""lista_puntuaciones"); lista_puntuacione s" ); serializador.endTag("", seria lizado r .endDocume n t () ; serializador.endDocument(); atch (Except i on e) {{ } ccatch (Exception Log . e("Asteroides ", e.getMessage(), Log.e{"Asteroides", e.getMessage(), ee); ,\.,

} } }

295

El gran libro de Android Como puedes ver todo el trabajo se realiza por medio de un objeto de la clase xmiserial Xml.Se:r:ializer: ouputStream que i zer al que se le asigna como salida el ouputstream hemos pasado como parámetros. parámetros.

9.5.2. Procesando XML con DOM {World Wide DOM (Modelo de Objetos del Documento) es un API creado por W3C (World Web Consortium) que nos permite manipular dinámicamente documentos XML y HTML. Android soporta el nivel de especificación 3, por lo que permite trabajar con definición de tipo de documento (OTO) (DTD) y validación de documentos. documentos. Para no extender en exceso los ejemplos no vamos a entrar en la definición y validación de documentos. Como ya hemos comentado, el planteamiento de DOM es muy diferente al de SAX. DOM permite cargar cualquier tipo de documento XML y manipularlo SAX. directamente en memoria (RAM). (RAM). Podremos crear nuevos nodos, nodos, o modificar los existentes. existentes. Una vez dispongamos de la nueva versión podremos almacenarlo en un fichero o mandarlo por Internet. Trabajar con DOM tiene sus ventajas frente a SAX, SAX, por ejemplo nos evitamos i'Ianej adorXt>IL) y crear una estructura definir a mano el proceso de parser (clase ManejadorXML) para almacenar los datos (clase ListaPuntuaciones). List.aPuntuaciones). Pero también tiene sus inconvenientes: inconvenientes: recorrer un documento DOM puede ser algo complejo, complejo, además, al tener que cargarse todo el documento en memoria puede consumir excesivos recursos para un dispositivo como un teléfono móvil. Este inconveniente cobra especial relevancia al trabajar con documentos grandes. grandes. Para terminar, terminar, DOM procesa la información de forma más lenta. lenta.

Ejercicio paso a paso: Almacenando puntuaciones en XML con DO M. DOM.

®

Veamos cómo se implementa el ejemplo anterior mediante el API DOM. DOM. 1.

Crea la clase AlmacenPuntuacionesXML_DOM AlmacenPuntuacione sXML__DOM y escribe el siguiente código: código: publ ic class c lass AlmacenPuntuacionesXML_DOM AlmacenPuntuacion e sXML_ DOM implements implementa AlmacenPuntuaciones{ public AlmacenPuntuaciones { private stat ic String FICHERO = "pun tuaciones.xml"; static = "puntuaciones.xml"; private contexto ; prívate Context contexto; riv ate Document documento pprivate documento;; pprivate riva te boolean boo lean cargadoDocumento cargadoDocumento;; publ i c AlmacenPuntuacionesXML_DOM(Context AlmacenPuntuacionesXML_ DOM(Context contexto) cont exto ) {{ public this. contexto = = contexto this.contexto contexto;; cargadoDocumento = = false; fal se ;

} @ Ove rr i d e ©Override public void nombre , long fecha) fe cha) {{ void guardarPuntuacion(int puntos, String nombre,

296

Almacenamiento de datos try { if (! cargadoDocument o ) {{ (!cargadoDocumento) leerXML( con tex to .openFileinput( FICHERO) ); leerXML(contexto.openFilelnput(FICHERO));

} FileNotFoundException e) } catch ((FileNotFoundException e) {{ crearXML(); } catch (Exception (Exception e) e) {{ Log. e ( "Asteroides " , e.getMessage(), Log.e("Asteroides", e.getMessage(), e); e); } nuevo(puntos, nombre, nombre, fecha); fecha); try {{ escribirXML( contexto. openFileOutput( FICHERO , escribirXML(contexto.openFileOutput{FICHERO, Context.· '"IODE MGDE_.... PRIVATE) PRIVATE) )) ;; Context } catch (Exception (Exception e) e) {{ Log.e("Asteroid es ", e.getMessage(), Log.e("Asteroides", e.getMessageO, e); e); } } •SOverride

@Over~cide

public Vecto r listaPuntuaciones(int Vector listaPuntuaciones(int cantidad) cantidad) {{ try {{ if (! c arg adoDoc ument o ) {{ (!cargadoDocumento) leerXML( conte x to .openFileinput( FJCHERO)); leerXML (contexto. openFilelnput (FIC/íEiíO) );

} } catch (FileNotFoundExcept (FileNotFoundException e) {{ i on e) ccrearXML(); rearXML(); eption ee)) {{ } catch (Exc (Exception Log. ee(( "Aste r o i d e s ",, ee.getMessageO, . getMessage(), e); "Asteroides" e) ; } aVectorString() ; return aVectorString(); } definiendo una una serie serie de de variables variables yy constantes. constantes. Son Son La clase comienza definiendo ejemplo anterior anterior con con la la excepción excepción de de documento documentode delalaclase clase iguales que en el ejemplo org.w3c.dom.Document.Document. org.wic.dom.Document.Document. En En este este objeto objeto mantendremos mantendremos en en documento XML. XML. Tras Tras el el constructor, constructor, se se definen definen los los dos dos memoria nuestro documento interfaz. Su Su funcionamiento funcionamiento es es similar similar alal ejemplo ejemplo anterior, anterior, métodos de la interfaz. lugar de de definir definir una una clase clase nueva, nueva, definiremos definiremos los losmétodos: métodos: aunque ahora en lugar crearXML(),, leerXML() leerXML(),, nuevo() nuevo(),, aVectorString() aVectorString{) yy escribirXl'4L{) escribirXML(). crearXt4L{) . tienen por por objeto objeto interactuar interactuarcon con elelobjeto objetodocumento. documento. Estos métodos tienen 2.

los dos dos primeros. primeros. Añade Añade el el siguiente siguiente código: código: Veamos los public void crearXML() crearXML{) {{ try {{

DocumentBuilderFactory fabrica Do cumentBui lde r Fac t ory fab rica == DocumentBu i l d erFactor y . newinstance(); DocumentBuilderFactory.newlnstance(); Docume n t Builder con structor == ffabrica.newDocumentBuilder(); abri ca.newDocume n tBu ilder(); DocumentBuilder constructor

297

El gran gran libro de Android documento = constructor.newDocument(); constructor.newDocument(); Element raíz = documento.createElement("list documento.createElement("listajpuntuaciones"); Ele ment raiz a...Jmntuaciones") ; documento.appendChild(raiz); documento.appendChild(raiz) ; cargadoDoc umento = true; cargadoDocumento true; } catch (Exception (Exception e) e) {{ Log. e ( "Asteroides" , e.getMessage(), Log.e("Asteroides", e.getMessage(), e); e) ;

} } public void leerXML(InputStre am entrada) leerXML(InputStream entrada) throws throws Exception Exception {{ DocumentBuilderFactory DocumentBuilderFactory fabrica fabrica == DocumentBuilderFactory.newinstance(); DocumentBuilderFactory.newlnstance(); DocumentBui lder constructor DocumentBuilder constructor == fabrica.newDocumentBuilder(); fabrica.newDocumentBuilder(); documento= documento = constructor.parse(entrada); constructor.parse(entrada); caJ:·gadoDocumento cargadoDocumento = true; true;

} En creax:Xi'lL crearXML () comenzamos construyendo construyendo objetos objetos DocumentBuilderFactory DocumentBuilderFactory y DocumentBuilder para para poder poder crear crear una una nueva nueva instancia instancia de de documento. documento. Creamos un nuevo elemento n to. elemento que que es es añadido añadido en en lala raíz raíz de de docume documento. Finalizamos marcando que que el el documento documento está está creado. creado. En leerY.!'o!L leerXML () el proceso proceso es es similar, similar, aunque aunque ahora ahora llamamos llamamos alal método método parse (()l que se encargará de procesar la entrada. Como encargará de procesar la entrada. Comopuedes puedescomprobar, comprobar, el proceso de lectura del del documento documento es es mucho mucho más más sencillo sencillo en en DOM DOM que que en SAX. SAX. 3.

Veamos los siguientes siguientes dos dos métodos. métodos. Añade Añade elel siguiente siguientecódigo: código: public void nnuevo(int uevo(int puntos puntos,, String String nombre, nombre, long long fecha) fecha) { Element puntuacion createElement ( "ptmtuacion") ; puntuación == documento. documento.createElement("ptmtuacion"); puntuacion . setAttribute ('' fecha" , String. valueOf( fecha));) ; puntuación.setAttribute("fecha", String.valueOf(fecha) Element ee_nombre _ nombre == documento.createElement(" n o mbre" ); documento.createElement("nombre"); Text texto= doc umento.createTextNode(nombre); texto = documento.createTextNode(nombre); e_nombre. e_noinbre . appendChild(texto); appendChild (texto) ; puntuacion.appendChild(e_ nombre); puntuación.appendChild(e_nombre); Element ee_puntos _puntos == docume nto . createElement( "pun t os " ); documento.createElement("puntos"); texto= .createTextNode(String . valueOf(punto s)); texto = documento documento.createTextNode(String.valueOf(puntos)); e_puntos.appendChild(texto ); e_puntos.appendChild(texto); puntuacion.appendChild(e_puntos); puntuación.appendChild(ejiuntos); El e ment rraiz a iz = doc ume nto . getDocumentElement(); Element documento.getDocumentElement(); ra iz.append Child(puntuac i on); raiz.appendChild(puntuación);

} public Vector aVe c tor String() {{ aVectorString() Vector result == new new Vector(); Vec tor result > (); String nombre = "", "", puntos= puntos = ""; ""; Element raiz == doc ume nto . getDocumentElement(); documento.getDocumentElement(); NodeList puntuaciones == raiz.getEleme ntsByTagNa me(" pun tuacion•); raiz.getElementsByTagName("puntuación");

298

Almacenamiento de datos (int ii == 0; O; ii < puntuaciones.getLength(); i++) for {int i++) {{ Node puntuación puntuacion == puntuaciones.item(i); NodeList propiedades == puntuación.getChildNodes(); puntuacion.getChildNodes (); = O; j << propiedades.getLengthO; propiedades.getLength(); j++) for (int j =0; j++) {{ Node propiedad == propiedades.item(j); propiedades . item(j); String etiqueta etiqueta= = propiedad.getNodeName(); (etiqueta.equals("nombre" if (etiqueta . equals ( "noinbre" )))) {{ nombre == propiedad.getFirstChildO.getNodeValue(); propiedad.getFirstChild() .getNodeValue(); (etiqueta.equals(" puntos'' )) {{ } else if (etiqueta.equals("puntos")) puntos= propiedad.getFirstChild() .getNodeValue(); puntos = propiedad.getFirstChildO.getNodeValue(); } } result.add(nombre ++ " " ++puntos); puntos); } return result; 11

11

} El método nuevo O () tiene por objeto insertar dentro dentro de de documento documenr.o una una con los nueva etiqueta los atributos yy etiquetas etiquetas interiores interiores necesarios. necesarios. Comienza creando el elemento puntuación pun tuacion al al que que le le añade añade el el f echa. Luego, crea el elemento nombre atributo fecha. nombre yy le le añade añade el el texto texto correspondiente. correspondiente. Este elemento es añadido añadido como como hijo hijo aa puntuación. puntuacion. El El mismo proceso se repite para el elemento elemento puntos. puntos. Para Para finalizar finalizar el el puntuacion es añadido aa la raíz del elemento puntuación del documento. documento. El método aVectorstringO avectorstri ng () devuelve un un vector vector de de strings strings con con las las puntuaciones almacenadas. Para Para ello, ¡remos iremos recorriendo recorriendo todo todo el el documento comenzando por el elemento raiz. Obtenemos Obtenemos la la lista lista de de nodos puntuaciones para recorrerla en un bucle bucle for. for. Para Para cada cada uno uno de de estos nodos, obtenemos en propiedades los los nodos nodos hijos. hijos. Recorremos Recorremos esta segunda lista en un nuevo bucle, donde donde analizamos analizamos si si el el nombre nombre del del nodo es nombre nombre o puntos, yy guardamos el valor valor asociado asociado al al nodo nodo en en la la variable correspondiente. Antes de pasar pasar al al siguiente siguiente nodo nodo puntuación, puntuacion, añadimos lo obtenido al resultado.

4. 4.

Veamos el último método. método. Añade el siguiente siguiente código: código: public void escribirXML(OutputStream salida) throws throws Exception Exception {{ TransformerFactory fabrica = TransformerFactory.ne^JnstanceO; fabrica= TransformerFactory. newinstance(); Transformer transformador == fabrica.newTransformer(); transformador. setOutputProperty (OutputKeys .OMIT_XML_DECLARATION, transformador.setOutputProperty(OutputKeys. OMIT'_ ){.l1.L_ DECLAR.A.'T'ION, "yes"); "yes 11 ) ; 11 yes 11 ) ; transformador. setOutputProperty (OutputKeys . INDEli!T , "yes"); transformador.setOutputProperty(OutputKeys.INDENT, DOMSource fuente == new DOMSource(documento); StreamResult resultado resultado= = new StreamResult(salida); StreamResult(salida); transformador.transform(fu ente, resultado); transformador.transform(fuente,

} Este método permite escribir el documento documento XML XML utilizando utilizando un un objeto objeto de de la la javax.xml. transform. Transformer. Tras configurarlo clase javax.xmi.transform.Transformar. configurarlo se se le le indica indica

299

El gran libro de Android documento yy como como resultado resultado de de lala trasformación trasformación elel como fuente documento ouputstream como parámetro. parámetro. ouput S tream pasado como 5.

Por desgracia, la la clase clase Transformer Transformer solo solo está está disponible disponibleaa partir partirdel delnivel nivel de API 8. 8. Si quieres implementar implementar una una aplicación aplicación que que sea sea compatible compatiblecon conlala totalidad de teléfonos te te proponemos proponemos que que reemplaces reemplaces elel método método anterior anterior por el siguiente: public püblic void void escribirXML(OutputStream escribirXML(OutputStream salida) salida) throws throws Exception Exception { String ss = serial iza (docume nto . getDocumentElement () ) ; seriaiiza(documento.getDocumentElementO); salida. write (s. getBytes ( ""lJTF ·· 8" )) ; salida.write(s.getBytes("UTF-8"));

} public static String String serializa(Node seriaiiza(Node raiz) raiz) throws throws IOException lOException { resultado == nnew StringBuilder(); StringBuilder resultado ew StringBuilder(); if (raiz. getNodeType () == '1'1:;.\'l'_NODE) (raiz.getNodeType() == Node. Node.TBXT_NODE) resultado.append(raiz.getNodeValue()); resultado.append(raiz.getNodeValue()); else {{ iif f ((raiz rai z ..getNodeType getNodeType ()() !!= = Node . DOCUME.iVT'_NOIJE) { Node.DOCUMBÍlT_NODE) StringBuffer atributos atributos == new new StringBuffer(); StringBuffer(); for (int i=O; . getLength(); ++i) i=0; ii << raiz.getAttributes() raiz.getAttributes().getLength(); ++i) {{ atributos. append (" ") atributos.append(" ") .append(raiz . getAttributes() .item(i) .getNodeName()) .append(rai z.getAttributes().item{i).getNodeName()) ..append("=\"") append ( "= \ " " ) .append(raiz.getAttributes() .item(i) .getNodeValue()) .append(raiz.getAttributes().item(i).getNodeValue()) ..append("\" append ( '' \" ""); );

} resultado . append(" <") .append(raiz.getNodeName ()) resultado.append("<").append(raiz.getNodeName()) ..append(" append ( " ") . append (atributos) . append (" > ") ; ").append(atributos).append(">"); } else {{ resultado.append("
encoding::: \ "UTF"UTF- 8\ 8 \ "?>"); " ? > ") ; encoding,,\ } NodeList listaNodos listaNodos == raiz.getChildNodes(); raiz.getChildNodes(); for (int ii = O; 0; ii << listaNodos.getLength(); listaNodos.getLength(); i++) i++) {{ Node nodo = list aNodos.item(i); listaNodos.item (i); resultado .append( serializa( nodo)); resultado.append(seriaiiza(nodo)); } if (raiz .getNodeType () = Node . lXJCUMEl\f'l'_NODF:) (raiz.getNodeType () !!= Node.DOCUMENT__NODE) { resultado.append(" "); append ( " >" ) ; } } return resultado .toSt ring();; resultado.toString()

}

300

Almacenamiento de datos datos El método serializa seria liza o ( l convierte convierte un un documento documento DOM DOM aa un un string. string. No Noes es específica de nuestro nuestro ejemplo ejemplo pero pero puedes puedes usarla usarla para para convertir convertir cualquier cualquier documento XML. Se trata trata de de una una función función recursiva. recursiva. AA partir partir de de un un nodo nodo que se pasa como parámetro, parámetro, se se encarga encarga de de realizar realizar una una nueva nueva llamada llamada por cada uno de los los nodos nodos que que contiene. contiene. Si Si queremos queremos convertir convertir todo todo elel documento, llamada hay hay que que indicar indicar en en elel parámetro parámetroelel nodo nodo documento, en la primera llamada raíz del documento. documento.

9.6. de datos datos 9.6. Bases Bases de Las bases de datos son una una herramienta herramienta de de gran gran potencia potencia en en lalacreación creación de deaplicaciones aplicaciones de informáticas. hace muy muy poco poco resultaba resultaba muy muy costoso costoso yycomplejo complejoincorporar incorporarbases basesde informáticas. Hasta hace datos a nuestras aplicaciones. aplicaciones. No No obstante, obstante, Android Android incorpora incorpora lala librería librería SQLite SQLiteque quenos nos permitirá utilizar utilizar bases de de datos datos mediante mediante el el lenguaje lenguaje SQL, SQL, de de una una forma forma sencilla sencilla yy sistema. Como Como verás verás en en este este apartado, apartado,almacenar almacenartutu utilizando muy pocos pocos recursos recursos del del sistema. información en una base base de de datos datos no no es es mucho mucho más más complejo complejo que que almacenarlos almacenarlos en en un un fichero y, y, además, además, resulta mucho mucho más más potente. potente. SQL es el lenguaje lenguaje de de programación programación más más utilizado utilizado para para bases bases de de datos. datos. No No resulta complejo entender entender los los ejemplos ejemplos que que se se mostrarán mostrarán en en este este libro. libro. No Noobstante, obstante, si deseas hacer hacer cosas más más complicadas complicadas te te recomiendo recomiendo que que consultes consultes alguno alguno de delos los muchos manuales que se se han han escrito escrito sobre sobre el el tema. tema. Para

manipular una base base de de datos datos en en Android Android usaremos usaremos lala clase clase

SQLiteopenHelper que nos nos facilita facilita tanto tanto la la creación creación de de lala base base de de datos, datos, como como elel SQLíteopenHeiper que

trabajar con futuras versiones versiones de de esta esta base base de de datos. datos. Para Para crear crear un un descendiente descendientede de oncreate(), ( l , yy onupgrade onupgrade()( ¡ yy esta clase hay hay que que implementar implementar los los métodos métodos oncreate onopen {). (l. La La gran gran ventaja ventaja de de utilizar utilizar esta esta clase clase es es que que ella ella se se opcionalmente onOpen preocupará de de abrir la la base base de de datos datos sisi existe existe oo de de crearla crearla sisi no no existe. existe. Incluso Inclusode de base de de datos. datos. actualizar la versión si decidimos decidimos crear crear una una nueva nueva estructura estructura de de lala base Además, esta clase tiene Además, tiene dos dos métodos métodos getReadabieDatabaee getReadableDatabaseo( l yy getwritabieDatabase get>-lri tableDatabase () ( l que que abren abren la la base base de de datos datos en en modo modo solo solo lectura lecturaoolectura lectura escritura. En caso de de todavía todavía no no existir existir la la base base de de datos, datos, estos estos métodos métodos se se y escritura. encargarán de crearla. crearla.

Poli [Media]: Uso de bases Poli[Media]: bases de de datos datos en en Android. Android.

Ejercicio paso aa paso: paso: Utilizando Utilizando una una base base de de datos datos para para guardar puntuaciones. puntuaciones. Pasemos a demostrar demostrar cómo cómo guardar guardar las las puntuaciones puntuaciones obtenidas obtenidas en en Asteroides Asteroides en una base de de datos. datos. Si Si comparas comparas la la solución solución propuesta propuesta con con las las anteriores anteriores verás verás cómo el código necesario necesario es es menor. menor. Además, Además, una una base base de de datos datos te te da da mucha mucha más más

301

El gran libro de Android potencia; por puntuación, potencia; puedes por ejemplo ordenar la salida por puntuación, eliminar filas antiguas, recursos. antiguas, etc. etc. Todo esto sin aumentar apenas el uso de recursos. 1.

JümacenPuntuacionesSQLite en el proyecto Asteroides y Crea la clase AlruacenPuntuacionesSQLite escribe el siguiente código: código:

AlmacenPuntuacionesSQLite public class class AlmacenPuntuacione sSQLite extends exten ds SQLiteOpenHelper implements AlmacenPuntuaciones{ implementa AlrnacenPuntuaciones{

í//Métodos íMétodos de SQLiteOpenHelper SQLiteOpenHelpE:l.' public AlmacenPuntuacionesSQLite(Context context) supe r(cont ext, "puntuaciones", "pu.11tuac iones", nuil, null, 1); super(context,

{

} @Override te{SQLiteDatabase db) {{ ©Ovsrride public void onCrea onCreate(SQLiteDatabase db.execSQL("CREATE TABLS TliliLE puntuaciones ("+ ( "+ "_id INTEGER nn'EGER PRIMARY PRH•!ARY KEY AÜTOINCREMENT, AU'l'OINCREM&'\IT, "+ "+ Iti""'l'EGER, nombre TEXT, fecha f echa LONG)"); "puntos INTEGER,

} @Overri.de ©Override

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // En caso de una nueva nueva. versión habría ha.br.ia. que qlle actualizar J.a.s t.a.blas las tablas }

í//Métodos ít•1étodos de AlmacenPuntuaciones .A..l.mac:enPuntuaciones public void guardarPuntuacion(int guardarPuntuacionfint puntos, String nombre, long fecha)

{

SQLiteDa tabase db == getWritableDatabase(); SQLiteDatabase db. execSQL ( " INSERT INTO puntuaciones VJ.~LUES null , "+ db.execSQL("INSSRT VALUES (( nuil, puntos+", 1'"+nombre+"' "+fecha+" )" ); "+nombre+"',, "+fecha+")");

} public Vector Vector listaPuntuaciones(int cantidad) Vector Vector (); Vector result == new Vector();

{

SQLiteDatabase db == getReadableDatabase(); CUrsor cursor == db . rawQuery ( "SELECI' puntos, nombre FROfl-1 Cursor db.rawQuery("SELECT FROM " + "puntuacioneEl ORDER Lif'.1IT " ^cantidad, +cantidad, null); "puntuaciones ORDSR BY puntos DESC LIMIT nuil); while (cursor.moveToNext ()) { (cursor.moveToNext()){ result.add(cursor.getint(O)+" result.add(cursor.getlnt(0)+" "+cursor.getString(l)); " +cursor.getString(l)); } cursor.close(); cursor.cióse(); return retum result;

} } El constructor de la clase se limita a llamar al al constructor heredado con el perfil: perfil: SQLiteOpenHelperíCont:ext SQLiteOpenHelper(Context contexto, String nombre, SQLiteDatabase.CursorFactory cursor, int versión). version) .

302

Almacenamiento de datos Los parámetros se describen a continuación: continuación: contexto: contexto: contexto usado para abrir o crear la base de datos. datos.

nombre nombre:: nombre de la base de datos que se creará. En nuestro caso

"puntuaciones". "puntuaciones". cursor: se utiliza para crear un objeto de tipo cursor. cursor. En nuestro caso no

lo necesitamos. necesitamos. vversión: ers i on: número de versión de la base de datos empezando desde 1. 1.

En el caso de que la base de datos actual tenga una versión más onUpgrade {) antigua se llamará a onupgrade () para que actualice la base de datos. datos. El método oncreate {) () será invocado cuando sea necesario crear la base de datos. En nuestro caso tendrá solo la tabla puntuaciones que es CREATE table TABLE puntuaciones... puntuaciones ... creada por medio del comando SQL create El método onup grade () no ha sido implementado. onupgrade implementado. Si más adelante decidiéramos crear una nueva estructura para la base de datos, datos, superior, por ejemplo la 2. 2. tendríamos que indicar un número de versión superior, Cuando se ejecute el código sobre un sistema donde se dispone de una 1, será invocado el método onup onupgrade base de datos con la versión 1, grade (). ( l . En él tendríamos que escribir los comandos necesarios para transformar la antigua base de datos en la nueva, nueva, tratando de conservar la información de la versión anterior. anterior. Pasemos

a

describir

de interfaz los dos métodos la El método guardarPuntuacion O () comienza obteniendo una referencia a nuestra base de datos utilizando getWrita bleDatabase (). () . Con ella ejecuta el comando SQL para getwritableDatabase insert INTO into puntuaciones almacenar un nueva fila en la tabla INSERT puntuac i ones ... .. . El método listaPuntuaciones l istaPuntuaciones () comienza obteniendo una referencia a nuestra base de datos utilizando getReadableDatabaseO. getReadab leDat abase () . Realiza una consulta utilizando el método rawQuery () (),, con la que obtiene un cursor que utiliza para leer todas las filas devueltas en la consulta. consulta.

Al macenaPuntuaciones. AlmacenaFiintuaciones.

2.

Modifica el código correspondiente en Asteroides.java para que este método pueda ser seleccionado para almacenar las puntuaciones. puntuaciones.

3. 3.

Verifica su funcionamiento. funcionamiento.

Ejercicio paso a paso: paso: Verificación de los ficheros creados. creados. 1.

View/Other../ Abre la vista File Explorer, Explorer utilizando el menú Window/Show View/Other ../ Explorer. Android/File Explorer

2.

Si estás utilizando varios dispositivos abre la vista Devices y asegúrate de seleccionar el dispositivo donde has ejecutado Asteroides. Asteroides.

303

El gran libro de Android 3. 3.

Busca la ruta data/data/org.example.asteroides

4. 4.

compara el el tamaño tamaño de de cada cada uno uno.. Observa los ficheros creados y compara fufi&jtoisr I Ñame

S Devices S Censóle; . iavattocj JB l jqCat # Emuiator Control| ^ Debug i LogCat (deprecat | ^ i

jt f - . 4- ." ..............................................................................·...............................·..............· ........·....................... ........................................................................................... ·

·

Síze Date Time . Time 2011·07-27 2011-07-27 22:24 22:24 2011·09-23 2011-09-23 10:32 10:32 5120 5120 2011-lü-15 2011-10-15 07:51 07:51 2011·09-23 2011-09-23 10:03 10:03 28 2011·09-23 28 2011-09-23 10:05 10:05 22:24 2011-07-27 22:24 2011·07-27 2011·09-21 12:14 12:14 2011-09-21 215 2011·09-22 20:49 215 2011-09-22 20:49 Size . Date

* tS» org.exampje.asterofdes ¿ ¿i*" « ~ databases datahases puntuaciones m@; puntuaciones « ;a. files files <> & puntuadones.OO Bi@; puntuaciones.bct ^ lib '"" lib «i ia« 0 shared_prefs shared_prefs: % org.examp!e.asteroides._preferences.xmt m oíg.exampleasteroides_preferencesj
""' tao org.example.asteroides

Permissii'• Permissic dn-vxr-xr cirwxrwx -rw-rw--rw-rw-di'\\'XIWX· drvvxrwx -rw-rw--rw-rw~ dl'\vxr-Kr· dn.vxr-xrdrvvxrwx-íV di'\\'XfWX1~ -rw-rw--rw-rw— ' di'\\'Xr-xr· di'\\'XIWX··

9.6.1. Los métodos query() y rawQuery() En el ejemplo anterior hemos utilizado el ( ¡ para el método método rawQuery rawQueryO para hacer hacer una una consulta. consulta. Este método tiene una versión alternativa alternativa con con la la misma misma función función el el método método query (). () . El método query guery () es el descrito en en la la documentación documentación oficial oficial y, y, además, además, es el único disponible en otras clase, como como por por ejemplo ejemplo para para hacer hacer una una consulta consulta en en ContentProvider. Sin embargo, tiene tiene un un inconveniente inconveniente respecto respecto al al método método un ContentProvider. rawQueryO, cantidad de de parámetros parámetros para para controlar controlar lala rawQuery () , has de rellenar gran cantidad búsqueda, lo que lo hace confuso de utilizar. utilizar. Si Si estás estás acostumbrado acostumbrado aa trabajar trabajar con con SQL es posible que este método te resulte incómodo. incómodo. A A continuación continuación se se describen describen los parámetros de ambos métodos: Cursor SQLi t.eDatabase . qu ery ( SQLiteDatabase.query String table, table , //tabla tar (SELECT) //tabla aa consul consultar (SELECT) strlng [] columna, //columnas aa devolver devolver (FROIVJ) (FROM) St:ring[l columns, //columnas String selecUon, //consul t a (WHER.E) selection, //consulta (WHERE) String[J re e mplaza ""?" ?" de String (] selectionArgs selectionArgs,,// //reemplaza de la la consulta consulta groupBy, //agrupado por por (GROUPBY) (GROUPBY) String gr·oupBy, //agrupado String having, havino::J , //condi ción de //condición de f. f. aritmética aritmética String orderBy, /1 ordenado por //ordenado por String limit ) !//cantidad /cant i dad máx. string lírait) máx. de de registros registros Cursor SQLiteDatabase.rawQuery( SQL.i.t.eDat.abas e. rawQu ery{ St ri ng ~Jql, //comando String sql, //comando SQL SQL String[] selectionArgs) selectionArgs)//reemplaza "?" de de la la consulta consulta String[J í /reemplaza "?"

utilizar estos estos métodos. métodos. Supongamos Supongamos Veamos un ejemplo de cómo se podrían utilizar que hemos creado la tabla, tabla, y que que tiene tiene las las columnas columnas texto, texto, entero entero yy numer·o numero.. Si quisiéramos seleccionar las columnas texto texto yy entero entero de de las las filas filas con con elel según el el valor valor de de entero entero yy que que además además el el valor de numero mayor que 2, ordenados según limitado aa un un máximo máximo de de cantidad cantidad (donde (donde número de filas seleccionadas estuviera limitado cantidad ha de ser una variable de tipo entero entero previamente previamente definida), definida), escribiríamos: escribiríamos: u rsor == db.rawQuery("SELECT texto. ntero FROM Cursor ccursor texto, eentero FROM tabla tabla"" ++ " WHERE ); WHSRE numero>2 ORDER BY BY entero LHHT LIMIT " ++ cantidacl, cantidad, null nuil)¡

304

Almacenamiento de datos Cuando uno está acostumbrado acostumbrado al al lenguaje lenguaje SQL SQL esta esta puede puede ser ser lala forma forma más más sencilla de hacer hacer la la consulta. consulta. De De forma forma alternativa alternativa podemos podemos hacer hacer uso uso del del segundo segundo parámetro. de ser ser un un array array de de String, String, de de forma forma que que estos estos Strings Strings remplazan remplazan parámetro. Este ha de en la la cadena cadena del del primer primer parámetro. parámetro. cada una de las las apariciones apariciones del del carácter"?" carácter "?" en Veamos un ejemplo que que sería sería equivalente equivalente al al anterior: anterior: String[] param == new new String[1]; String[l]; param [ O]= Integer.toString(cantidad, Integer.toSt r ing (can t ida d ,lO ); param[0310); Cursor cursor == db.rawQuery("SELECT db. rawQu ery ( "SELECT texto, text.o , entero entero FROM FRON tabla" tabla'' ++ " WHERE í'iHERE numero>2 ORDER ORDER BY BY entero entero LIMIT Lit-liT ?", ? ", param); param) ;

Si en lugar lugar del del método método rawQuery rawQu ery o () queremos queremos utilizar utilizar elel método método gueryO query ( } usaríamos el siguiente código código equivalente equivalente aa los los dos dos anteriores: anteriores:

String [] CAMPOS = {"texto", String[] CAMPOS~ { " texto" , "entero"},"entero"} ; Cursor rsor cursor cursor = db.query("tabla", db.qu ery( " tab l a " , CAMPOS, CA.t>1POS, "numero>2", "nu mero>2", nuil, null , Cu null, null , "entero", " entero " , Integer.taString(cantidad)); Integer. t: o S'U: .i.ng (cantidad)); nuil, nuil,

t

Ejercicio paso paso aa paso; paso: Utilización Utilización del del método métodoqueryQ query()para para Ejercicio guardar puntuaciones. puntuaciones.

1. Remplaza la la llamada llamada al al método método rawQuery rawQue r y o () del del ejercicio ejercicio anterior anterior por por elel siguiente código:

= {"puntos", String[] CAMPOS CAMPOS= {" puntos" , "nombre"}; "nombre "}; Cursor cursor=db.query("puntuaciones", cursor=db.query("puntuaciones ", CAMPOS, CANPOS, nuil, null, nuil, null , nuil, nuil, null, null, "puntos", " puntos" , Integer.toStringfcantidad)); Integer. toString (cantidad)); 2. 2.

Verifica que el funcionamiento funcionamiento es es idéntico. idéntico.

9.7. 9. 7. Utilizando Utilizando la la clase clase ContentProvider ContentProvider Los proveedores de contenidos contenidos (contení (content providers) providers) son son uno uno de de los los bloques bloques constructivos más importantes importantes de de Android. Android. Nos Nos van van aa permitir permitiracceder accederaa información información la inversa, inversa, compartir compartir nuestra nuestra información información proporcionada por otras aplicaciones, aplicaciones, oo aa la con otras aplicaciones. en los los que que se se basan basan los los ContentProviders, ContentProviders, Tras describir los los principios principios en pasaremos aa demostrar demostrar cómo cómo acceder acceder aa ContentProviders ContentProviders creados creados por por otras otras aplicaciones. Esta operación aplicaciones. operación resulta resulta muy muy útil útil dado dado que que te te permitirá permitirá tener tener acceso acceso aa la lista lista de de contactos, contactos, el el registro registro de de llamadas llamadas oo los los información interesante, interesante, como como la ficheros multimedia multimedia almacenados almacenados en en el el dispositivo. dispositivo. Terminaremos Terminaremos este este apartado apartado mostrando cómo crear tu propio propio ContentProvider, ContentProvider, de de forma forma que que otras otras aplicaciones aplicaciones información. puedan acceder aa tu información.

305

El gran libro de Androíd Android

9.7.1. Conceptos básicos 9. 7. 1.1. El modelo de datos 9.7.1.1. La forma en la que un ContentProvider almacena la la información información es es un un aspecto aspecto de de diseño interno, de forma que podríamos utilizar cualquiera de de los los métodos métodos descritos descritos capítulo. No obstante, cuando hagamos en este capítulo. hagamos una una consulta al al ContentProvider ContentProvider se se devolverá un objeto de tipo cursor. cursor. Esto Esto hace hace que que la la forma forma más más práctica práctica para para almacenar la información sea en una base de datos. datos. Utilizando términos del modelo de bases de de datos, datos, un un ContentProvider ContentProvider proporciona sus datos aa través de una tabla simple, simple, donde cada fila fila es es un un registro registro yy cada columna es un tipo de datos con un un significado significado particular. particular. Por Por ejemplo, ejemplo, el el ContentProvider que utilizaremos en el siguiente siguiente ejemplo ejemplo se llama llama CaiiLog, callLog, yy permite acceder al registro de llamadas del del teléfono. teléfono. La información información que que nos nos proporciona tiene la estructura que se muestra aa continuación: continuación: id _id 1 3 4 S 5

date

12/10/10 12/10/10 12/11/10 12/11/10 13/11/10 13/11/10 14/11/10

16:10 20:42 12:15 22:10

number number 555123123 555453455 555123123 555783678

Duration Duration 65 65 356 356 90 90 542 542

Type Type INCOMING TYPE INCOMINGTYPE OUTGOING TYPE TYPE OUTGOING MISSED TYP E MISSED_TYPE OUTGOING TYPE TYPE OUTGOING

Tabla 1: Ejemplo de estructura de datos de un ContentProvider. ContentProvider.

Cada registro incluye el campo numérico _iidd que que lo identifica identifica de de forma forma única. única. Como veremos a continuación, continuación, podremos utilizar este este campo campo para para identificar identificar una una concreto. llamada en concreto. La forma de acceder a la información de un un ContentProvider ContentProvider es es muy muy similar similar al al proceso descrito para las bases de datos. datos. Es decir, decir, vamos vamos aa poder poder realizar realizar una una consulta (incluso utilizando el lenguaje SQL), SQL), tras la la cual cual se se nos nos proporcionará proporcionará un un objeto de tipo cursor. cursor. Este objeto, objeto, contiene una una información información con una una estructura estructura similar a la mostrada en la tabla anterior. anterior.

9.7.1.2. Las URI Para acceder a un ContentProvider en particular particular va aa ser necesario necesario identificarlo identificarlo con con una URI. Una URI (ver estándar RFC 2396) 2396) es una una cadena de de texto texto que que permite permite identificar un recurso de información. información. Suele utilizarse utilizarse frecuentemente frecuentemente en en Internet, Internet, por ejemplo para acceder a una página web. Una Una URI URI está está formada formada por por cuatro cuatro partes, tal y como se muestra a continuación: continuación: refix >: // / / :////

La parte los ContentProvider ha ha de de ser ser siempre siempre ix> de todos los apartado, utilizaremos utilizaremos un un ContentProvider ContentProvider content. En el primer ejemplo de este apartado, donde Android almacena el registro de llamadas. llamadas. Para Para acceder acceder aa este este ContentProvider utilizaremos la siguiente URI: URI: cont ent://call_ log/calls content://calilog/calls

306

Almacenamiento de datos En la Tabla 22 encontrarás otros ejemplos ejemplos de de URI URI que que te te permitirán permitirán acceder acceder aa otras informaciones almacenadas almacenadas en Android. Android. Para acceder aa un elemento elemento concreto concreto has has de de indicar indicar un un en en la la URI. URI. Por Por ejemplo, si te interesa solo acceder acceder aa la la llamada llamada con con identificador identificador 44 (normalmente (normalmente corresponderá a la cuarta llamada llamada de de la la lista), lista), has has de de indicar: indicar: content://call_log/calls/ content://cali log/calls/4 4

Un mismo ContentProvider puede puede contener contener múltiples múltiples conjuntos conjuntos de de datos datos identificados por diferentes diferentes URI. URI. Por Por ejemplo, ejemplo, para para acceder acceder aa los los ficheros ficheros multimedia multimedia utilizaremos el almacenados en el móvil utilizaremos el ContentProvider ContentProvider Mediastore, tvlediaStore, utilizando utilizando algunos de los siguientes siguientes ejemplos ejemplos de de URI: URI: content://media/int.ernal/ content://media/internal/images images content:// media /external/video/5 content://media/external/video/5 content://media /*/audio content://media/*/audio

Cada ContentProvider ContentProvidersuele sue\e definir definir constantes constantes con con sus sus correspondientes correspondientes URI. URI. android. provider. CallLog. Por ejemplo, android.provider. callLog. Calis. Calls. CONTENTJJRI CONTwrT___URI corresponde corresponde con con content: 1/call_log/calls. content://call_log/calls.

Y la constante: constante: r android. provider. MediaStore .lmdio. Media. IJiiTERl'\!AL __CONTENT android,provider.MediaStore.Audio.Media.INTERNAL_CONTEN r __URI. _URI.

Corresponde con content: content:! //media/intemal/audio. /mectia/int.ernal/audio.

9. 7 .2. Acceder a la 9.7.2. la información información de de un un ContentProvider ContentProvider Android utiliza los ContentProvider para para almacenar almacenar diferentes diferentes tipos tipos de de información. información. En la tabla siguiente los ContentProvider ContentProvider más más importantes importantes disponibles disponibles en en Android: Android : Clase

Información almacenada

Browser

Enlaces favoritos, historial de de navegación, historial de de búsquedas

content:/ /browser/bookmarks content://browser/bookmarks

Calllog CallLog

Llamadas entrantes, salientes salientes pérdidas. y pérdidas.

content:/ /call_log/calls content://callJog/calls

Contacts

Lista de contactos del usuario. usuario. content:/ /contacts/people content://contacts/people

MediaStore

Ficheros de audio, vídeo ee imágenes, almacenados en almacenadispositivos de almacenamiento internos y externos.

content://media/internal/images content://med¡a/internal/images content:/ /media/external/video content://media/external/video content:/ /media/* /audio content://med¡a/*/audio

Setting

Preferencias del sistema. sistema .

content://settings/system/ringtone content;//settings/system/ringtone content://settings/system/notificatio content://settings/system/notificat¡o n_sound

Ejemplos de URIs URis

307

El gran libro de Android Clase

Información almacenada

URis Ejemplos de URIs

Palabras definidas por el UserDictionary usuario, utilizadas en los (a partir de 1.5) métodos de entrada predictivos. predictivos.

content:/ /u ser_ dictionary/words content://user_d¡ctionary/words

Mensajes SMS y MMS Telephony mandados mandados o recibidos desde (a partir de 1.5) el teléfono.

content://sms content:/ /sms content://sms/¡nbox content:/ /sms/inbox content:/ /sms/sent content://sms/sent content:/ /mms content://mms

Calendar Permite consultar y editar los los (a partir de 4.0) eventos del calendario

content:/ /com.android.calendar/time content://com.android.calendar/time content:/ /com.android.calendar/events content://com.android.calendar/events

Tabla 2: ContentProviders disponibles en Android.

9.7.2.1. Leer información de un ContentProvider Cont ntProvider Veamos un ejemplo que permite leer el registro de llamadas del teléfono. teléfono. Crea una nueva aplicación con los siguientes datos: datos: Project ñame: name: ContentCallLog ContentCal l Log Bu i ld Target: Target : Android And:coid 1.5 1.5 Build Ap plication ñame: name: ContentCallLog ContentCall Log Application Package ñame: name : org.example.contentcalllog org . example.contentcalllog lLog Create Activity: ContentCal ContentCallLog Min SDK Versión: Version: 3 Mln

Añade en el fichero res/1ayout/main. res/:La.yout/main. xrr.i xml la línea subrayada; subrayada: "l. .O " encoding="utf-8"V encoding = 11 Ut~f-8"?> < < .s./.~~-~?-~-~~--~-1?.-~--~~~-~-~~-~-!.-~-~?.~.?.. Al solicitar el el permiso read_contats READ_CONTATS podremos podremos acceder acceder al al registro registro de de llamadas. llamadas. oncreate de de la la actividad actividad principal principal elel siguiente siguiente código: código: Añade al final del del método oncreate String [] TIPO_LLAMADA 'l'IPO_LLA!Y'l.ADA =~ {"","en trante", "saliente", "perdida"}; String[] "entrante","saliente","perdida"}; TextView salida = (TextView) {TextView) findViewByld(R.id.salida); findViewByld (R. id. salida); Uri llamadas llamadas~ Uri.parse("content://cal l _log/calls"); - Uri.parseí"content://call_log/calls"); Cursor ce == managedQuery(1laraadas, managedQuery{llamadas, nuil, null , nuil, null , nuil, null , nuil); null ); while (c.moveToKext0) (c.moveToNext()) {{ salida.append("\n" salida.appsnd("\n" + DateFormat.fonnat{"dd/MM/yy DateFormat.format("dd/Ml'-1/yy k;mm k:mm (", (", e . get.Long (e. getColunmlndex (Calls. Dl1TE))) c.getLong(c.getColumnlndex(Calis.DATE))) c.get.String(c.get.Columnindex(Calls . DURATION)) ++ ") ") "" + c.getString(c.getColumnlndex(Calis.DURATION)) + c.getString(c.getColumnlndex(Calis.tiUMBER)) c .get.String(c.get.Colunmindex{Calls . lvllHBER)) ++ ", ", "" + TIPO_LLAMADA[Integer.parselnt(c.getString( TIPO_LLAM.I\.DA [Integer . parseint {e. getString { c.getColumnindex(Calls.'I'YPEilil); c.getColumnlndex(CalIs.TYPE)))] );

} En primer lugar se define define un un array array de de strings, strings, de de forma forma que que tipo_llamada[i) TIPO_ LLAtJIADA lll corresponda a "entrante", "entrante", tipo__llamada[2], TIPO_LLAMADA [2] , corresponda corresponda aa "saliente", "saliente", etc. etc. Luego se crea el el objeto salida salida que que es es asignado asignado al al Textview Textview correspondiente correspondiente del del Layout. Layout. Ahora comienza lo interesante, interesante, creamos creamos la la URI, URI, llamadas llamadas asociada asociada aa content: 1 /call_log/calls. Para Para realizar realizar la la consulta consulta creamos creamos elel cursor, cursor, c.c. Se Setrata trata content ://caii_iog/caiis.

de la misma clase que hemos hemos utilizado utilizado para para hacer hacer una una consulta consulta en en una una base basede dedatos, datos, pero ahora la la información información será será suministrada suministrada por por un un ContentProvider ContentProvider por por medio medio del del () . Este Este método método permite permite varios varios parámetros parámetros para para indicar indicar método manageQuery (). que nos nos interesan, interesan, de de forma forma similar similar aa como como se se hace hace en exactamente los elementos que en una base de datos. Estos Estos parámetros parámetros serán serán estudiados estudiados más más adelante. adelante. Al Al no no indicar indicar todas las las llamadas llamadas registradas. registradas. ninguno se devolverán todas No tenemos más que desplazarnos desplazarnos por por todos todos los los elementos elementos del del cursor cursor (c.moveToNext()) añadiendo la la salida salida (salida.appendO) (salida. append {) ) la la información información (e. moveToNext () ) e ir añadiendo En concreto concreto fecha, fecha, duración, duración, número número de de teléfono teléfono yy correspondiente aa cada registro. registro. En tipo de llamada. llamada. Una vez vez que que el el cursor cursor se se encuentra encuentra situado situado en en una una fila fila determinada, determinada, información de de una una columna columna utilizando utilizando los los métodos métodosgetstringO, getstring ( ¡, podemos obtener la información getint getrnt (), ( l , getLong () í l yy getFioac getFloat () () dependiendo dependiendo del del tipo tipo de de dato datoalmacenado. almacenado.Estos Estos índice el índice índice de de columna. columna. Para Para averiguar averiguar elel índice métodos necesitan como parámetros parámetros el () indicando de cada columna columna utilizaremos utilizaremos el el método método getColumnlndex getcolumnrnd.exíl indicando elel nombre nombrede de la columna. caso estos estos nombres nombres son son "date", "date", "duratíon", "duratíon", "nutnber" "number" yy columna. En nuestro caso "type ". En el ejemplo, ejemplo, en en lugar lugar de de utilizar utilizar estos estos nombres nombres se se han han utilizado utilizado cuatro cuatro "type". constantes definidas con con estos estos valores. valores.

309

El gran libro de Android Especial mención tiene tiene la la columna columna "date" "date" que que nos nos devuelve devuelve un unentero enterolargo largoque que un instante concreto concreto de de una una fecha. fecha. Para Para mostrarla mostrarlaen en elelformato formatodeseado deseado representa un hemos utilizado el método método estático estático format format({l ) de de lalaclase claseDateFormat. DateFormat. El resultado de ejecutar ejecutar este este programa programa se se muestra muestra aa continuación: continuación;

giAO Helio ¡Woríd, Conté ntCailLoi 14/07/10 11: 28 {455)67931 «50, entrame 14/07/10 11: 50 (84) 635471 108, entrante 14/07/10 19::33 {0)618614135, perdida 14/07/10 20::38 {05618614135, saliente 14/07/10 20::38 (30) 67931^¿ 350, saliente 14/07/10 20::44 (35) 6t861 20 15/07/10 2 38 (371) 6576; 3814, entrame 116/07/10 14: 40 (66) 657631 314, entrante h 6/07/10 15: 53 10) 64626 K 17, saliente 16/07/10 16:11 {0)963228^25, perdida 116/07/10 7:54(0) 64626K 47, perdida 116/07/10 19:33(0) 646261C 17, perdida 3:21 (32) 646261 347, saliente 3:58(139)6576; 8814, entrante Veamos con más detalle detalle el el método método managedQuery managedQuery()()::

Cursor managedQuery(U:d. managedQuery(Uri uri, url, String[] String[] proyeccion, proyección, String String seleccion, selección, Stringll String [] argsSelecc, ai'gsSelecc, String String orden) ox'den) Donde los parámetros parámetros corresponden corresponden a: a: uri

URI URI correspondiente correspondiente al al ContentProvider ContentProvideraaconsultar. consultar,

proyeccion proyección

Lista Lista de de columnas columnas que que queremos queremos que que nos nosdevuelva. devuelva,

se l eccion selección

Cláusula Cláusula SOL SQL correspondiente correspondiente aa WHERE. whsre.

argsSelecc

Lista Lista de de argumentos argumentos utilizados utilizados en en elel parámetro parámetroseleccion. selección,

orden

Cláusula Cláusula SOL SQL correspondiente correspondienteaa ORDER order BY. by.

Para ilustrar el el uso uso de de estos estos parámetros parámetros remplaza remplaza en en elelejemplo ejemploanterior anteriorlalalínea: línea: Cursor ec = (llamadas, nnuil, ull , null , null ); - managedQuery managedQuery(llamadas, nuil,, null nuil, nuil);

por: por: String[] proyeccion proyección == new new String[] String[] {{ Calls. Dlrl'E, Calls. DUF&i'l'ION, Calls . .NUMBER, Calls. 'l'YPE }}; ; Calis.DATE, Calis.DURATION, Calis.NUMBER, Calis.TYPE String[] an:¡-sSelecc argsSelecc == new new String[J String[] {"J."}; {"1"}; Cursor ec = = managedQuery( managedQuery{ llamadas~ llamadas,

proyección, proyeccion, 11 type == ?", "type ?", argsSelecc, "date DESC"); DESC");

310

!í // !// í /1 // !! // !/ //

Uri Url del del ConterltProvider ContentProvider

Columnas qLte que nos nos interesan interesan Colnm...r1.as consulta consulta ~VHEl~E WHERE parámetros parámetros de de la la consulta consulta anterior anterior Ordenado Ordenado por por fecha fecha,, orden orden ascendente ascendente

Almacenamiento de datos De esta forma nos devolverán solo las columnas indicadas en proyección. proyeccíon. Esto supone un ahorro de memoria en caso de que existan muchas columnas. columnas. En el siguiente parámetro se indica las filas que nos interesan por medio de una consulta de tipo WHERE. where. En caso de encontrar algún carácter ? éste es sustituido por el primer string a.rgseJ.ecc . En caso de haber más caracteres ? se irían etring del parámetro argselecc. sustituyendo siguiendo el mismo orden. orden. Cuando se sustituyen los interrogantes comillas. Por lo tanto, cada elemento de argSelecc argselecc es introducido entre comillas. tanto, en el ejemplo, WHERE resultante es "wkere "ívHERE type = 'i'". • 1 • ". Esta consulta ejemplo, la consulta where implica que solo se mostrarán las llamadas entrantes. entrantes. El último parámetro sería equivalente a indicar en SQL "sorteo "SORTED BY DESC",, es decir, decir, el resultado estará by date desc ordenado por fecha en orden ascendiente. ascendiente.

9.7.2.2. Escribir información en un ContentProvider Añadir un nuevo elemento en un ContentProvider resulta muy sencillo. sencillo. Para ilustrar cómo se hace escribe el siguiente código al principio del ejemplo anterior: anterior: ContentValues valores = = new ContentValues{); ContentValues(); valores.put(Calls.DATE, Date() ); valores . put. (Calis .DATE, new Date () .getTime() . gecTime () ); valores.put(Calls.NUMBER, valores.put(Calis.NUMBER,

"555555555"); "555555555") ;

valores.put(Calls.DURATION, valores.put(Calis.DURATION, "55"); "55") ; valores .put (Calls. TYPE, Calls. INCOMING_._TYPE); valores.put(Calis.TYPE, Calis.INCOMING TYPE); Uri nuevoElemento

getContentResolver() .insert( == getContentResolver().insert{ Calls. CONTENT.._URI, Calis.CONTENT ORI, valores);

Como puedes ver comenzamos creando un objeto ContentValues contentValues donde vamos valores, nombre de columna y valor asociado a la almacenado una serie de pares de valores, columna. ver () .inserto . insert () pasándole la columna. A continuación, se llama a getcontentResol getContentResolver() URI del ContentProvider y los valores a insertar. insertar. Este método nos devuelve una URI que apunta de forma específica al elemento que acabamos de insertar. Podrías utilizar esta URI para hacer una consulta y obtener un cursor al nuevo elemento y así poder modificarlo, borrarlo u obtener el _ro. id. Recuerda que has de pedir el permiso modificarlo, \'iRI'I'E CONTAC'l'S. WRITE_CONTACTS. Si ejecutas ahora el programa, programa, la nueva llamada insertada ha de aparecer en primer lugar. lugar.

ESA

KHa 19:08

Helio World, ContentCaillog! 29/09/10 19:08 ¡55) 555555555, entrante 28/09/10 10:22 (19)63030662149347, entrante 25/09/10 20:03 (59)646261047, entrante 25/09/10 21:39 (48)679314350, entrante 25/09/10 20:37 (331) 679314350, entrante 25/09/10 19:36 (153) 679314350, entrante 25/09/10 11:22 (0)647984172, entrante 24/09/10 21:25 (673) 679314350, entrante 24/09/10 14:02 (48) 63030662149344, entrante

311 311

El gran libro de Android Estamos modificando el el registro registro de de llamadas llamadas del del sistema, sistema, por por lolo tanto, tanto, también también información desde desde las las aplicaciones aplicaciones del del sistema. sistema. puedes verificar esta información

CIA

¡I BSa 19:34

9.7.2.3. Borrar yy modificar elementos elementos de de un un ContentProvider ContentProvider método dele deiete para eliminar eliminar elementos elementos de de un un ContentProvider. ContentProvider. Puedes utilizar el método te ({)J para int ContentPr ovider.delete(Uri uri, 'ri, String ContentProvider.deiete(Ori String seleccion, selección, String[] Stringü argsSelecc) argsSelecc)

Este método devuelve el el número número de de elementos elementos eliminados. eliminados. Los Los tres tres parámetros parámetros del método se detallan a continuación: continuación: uri uri.

URI URI correspondiente correspondiente al al ContentProvider ContentProvideraa consultar. consultar.

seleccion selección

Cláusula SQL SQL correspondiente correspondiente aa l~HERE. where.

argsSelecc argsSelecc

Lista de de argumentos argumentos utilizados utiüzados en en el el parámetro parámetro seleccion. selección.

Si quisiéramos eliminar un un solo solo elemento elemento podríamos podríamos obtener obtener su su URI URI ee indicarlo indicarlo en el primer parámetro, dejando dejando los los otros otros dos dos aa null. nuil. Si Si por por elel contrario contrario quieres quieres puedes utilizar utilizar el el parámetro parámetro seleccion. selección. Por Por ejemplo, ejemplo, sisi eliminar varios elementos puedes quisiéramos eliminar todos los los registros registros de de llamada llamada del del número número 555555555, 555555555, escribiríamos: getContentResolver {) . dele te {Calls.. COlJ'PEi'!'!'_URI, getContentResolver().deiete(Calis CONTENT_URI, ••"nuniber=' n umber= 1 555555555' :, , null 555555555, nuil))

;

¡

También puedes utilizar el el método método update update {)o para para modificar modificar elementos elementos de de un un ContentProvider. int Cont.ent.Provider. update (Ud. ur i, ContentValues ContentProvider.update{Uri uri, ContentValues valores, valores, String seleccion, selección, String [][] argsSelecc) argsSelecc)

Por ejemplo, si quisiéramos modificar modificar los los registros registros con con número número 555555555, 555555555, por por el número 444444444, escribiríamos: ContentValues valores2 vaj.ores2 = - new new Content.Values(); ContentValues {) ,va lores2.put(Calls.NU11BER, "444444•144''); valoresZ.put{Calis.NUMBER, "444444444") ; 9etContentResolver {) update (Calls. getContentResolver {) ..update (Calis . CONTENT'_.UFI.I, CONTENT_„.URI, valores2, valores2, "number= '555 555555 '", null ); "number='555555555'", nuil);

9.7.3. Creación de un ider un ContentPro ContentProvider En este apartado vamos vamos aa describir describir los los pasos pasos necesarios necesarios para para crear crear tutu propio propio ContentProvider. En concreto concreto vamos vamos aa seguir seguir tres tres pasos: pasos:

312

Almacenamiento de datos 1) Definir una estructura de de almacenamiento almacenamiento para para los los datos. datos. En En nuestro nuestro caso caso usaremos una base de datos SQLite. SQLite. 2) Crear nuestra clase extendiendo contentProvider. contentPr.·ovider. 3) Declarar el ContetProvider en en el el AndroidManifest. Androidt·1anifest. xrnl xml de de nuestra nuestra aplicación. aplicación. Si no deseas compartir tu información información con con otras otras aplicaciones, aplicaciones, no no es es necesario necesario ContentProvider. En En este caso resulta resulta mucho mucho más más sencillo sencillo usar usar una una base base crear un ContentProvider. se ha ha explicado explicado en en el el apartado apartado anterior. anterior. En En este este de datos directamente, directamente, tal yy como se apartado vamos a seguir el mismo mismo ejemplo ejemplo descrito descrito en en los los anteriores anteriores apartados apartados del del capítulo, decir, vamos a crear crear un un ContentProvider ContentProvider que que nos nos permita permita compartir compartir lala capítulo, es decir, lista de puntuaciones con otras otras aplicaciones. aplicaciones. Posiblemente, Posiblemente, no no se se trate trate de de una una de suponer, suponer, que que ninguna ninguna aplicación aplicación esté esté interesada interesada en en realista; es de situación muy realista; información. No obstante, esta información. obstante, hemos hemos pensado pensado que que va va aa resultar resultar más más sencillo sencillo ejemplo. continuar con el mismo ejemplo. Crea una nueva aplicación con los siguientes siguientes datos: datos: Project ñame: name: PuntuacionesProvider PuntuacionesProvider Build Target: Android 1.5 1.5 Application ñame: narne: PuntuacionesProvider PuntuacionesProvider Package ñame: name: org.example.puntuacionesprovider org.exarnple.puntuacionesprovider Create Activity: ActividadPrincipal ActividadPrincipal Min SDK Versión: Version: 3

9.7.3.1. Definir la estructura estructura de almacenamiento almacenamiento del del ContentProvider ContentProvider El objetivo último de un ContentProvider ContentProvider es es almacenar almacenar información información de de forma forma permanente. tanto, resulta resulta imprescindible imprescindible utilizar utilizar alguno alguno de de los los mecanismos mecanismos permanente. Por lo tanto, tema, o en el el siguiente, siguiente, para para almacenar almacenar datos. datos. Como Como se se ha ha estudiado estudiado descritos en este tema, en el apartado anterior, anterior, podemos podemos realizar consultas consultas aa un un ContentProvider ContentProvider de de forma forma nos devuelve devuelve un un objeto objeto similar a una base de datos (podemos hacer hacer consultas consultas SQL SQL yy nos cursor}. Por lo tanto, tanto, la la forma forma más más sencilla sencilla de de almacenar almacenar los los datos datos de de un un de tipo cursor). ContentProvider es en una base base de datos. datos. De De esta esta forma, forma, si si nos nos solicitan solicitan una una consulta consulta SQL, no tendremos más que que trasladarla trasladarla aa nuestra nuestra base base de de datos, datos, yy el el objeto objeto cursor cursor que nos devuelva será el resultado resultado que que nosotros nosotros devolveremos. devolveremos. datos de de nuestro nuestro ContentProvider ContentProvider añade añade una una nueva nueva clase clase Para crear la base de datos con nombre PuntuacionesSQLiteHeiper PuntuacionesSQLiteHelper ee introduce introduce el el siguiente siguiente código: código: public class PuntuacionesSQLiteHeiper PuntuacionesSQLiteHelper extends extends SQLiteOpenHelper SQLiteOpenHelper

{

PuntuacionesSQLiteHelper(Context context) context) { public PuntuacionesSQLiteHeiper(Context super (context, "puntuaciones", •puntuaciones•, nuil, null, 1) 1);; super(context, }

@Override ©Override public void onCreate(SQLiteDatabase onCreate(SQLiteDatabase db) db) {{ db. execSQL ('' CREATE TABLE puntuaciones puntuaciones {" (" db.execSQL("CREATE + "_id " id INTEGER PRIMAR PRIMARY AUTOINCREMENT, Y KEY AUTO XNCREMENT, 11"

313

El gran libro de Android + +

pun tos INTEGER, " "puntos + "nombre TEXT TEXT,, " + + "fecha " fecha LONG)"); LONG ) ¡ 11

11

11 )

} ©Overrida public void onUpgrade(SQLiteDatabase db,

int ooldVersion, l dVersion , int newVersion) n e wVers ion ) { /1 c aso tie de una nueva versión venJiém habría que actualizar. i i En caso actualizar las tablas }

} La clase que acabamos de añadir al proyecto se encarga de crear la base de datos puntuaciones extendiendo la clase SQLiteOpenHelper. SQLiteOpenHeiper. Este proceso fue descrito en el datos. Dado que estamos trabajando sobre el mismo apartado dedicado a las bases de datos. ejemplo, la tabla creada es idéntica y lo mismo ocurre con el código. código. Para una explicación más detallada recomendamos consultar este apartado. apartado.

9.7.3.2. Extendiendo la clase ContentProvider laboriosa: la creación de una clase descendiente de Ahora abordamos la parte más laboriosa: con tentProvi d er. Los métodos principales que tenemos que implementar son: ContentProvider. son: getType {) () -- Devuelve el tipo MIME de los elementos del ContentProvider. ContentProvider. query () - Permite realizar consultas al ContentProvider. queryO ContentProvider. insert 0 (J - Inserta nuevos datos. datos. de J ete o () -Borra deiete Borra elementos del ContentProvider. ContentProvider. () - Permite modificar los dates datos existentes. update O existentes.

La clase ContentProvider cont:entProvider toma las precauciones necesarias para evitar problemas con las llamadas simultáneas de varios procesos, por lo tanto, tanto, en la aspecto. creación de una subclase no nos tenemos que preocupar de este aspecto. Añade una nueva clase con nombre PuntuacionesProvider e introduce el siguiente código: código: publ ic class c las s PuntuacionesProvider Puntu acionesProvider extends e xtends Conten tProvider {{ public ContentProvider ublic static s t atic final String AUTORIDAD ppublic AUTORIDAD = ""org.example.puntuacionesprovider"; 01:g . exampl e . puntuac iones p rovider " ; ppublic ublic static final Uri CONTENT_URI CONTE'NT_ UR.T = = Uri.parse("content://" Uri. parse (" corltent:// " + .Z\UTORIDltD /puntuaciones "); AUTORIDAD + ''"/puntuaciones"); public static final int 1'0D08_ L08_ELE11.E1'1J'POS = TOOGS_LOS_ELEMENTOS = 1; 1; publ i c astatic t a tic final int UN__ELEMENTO UN_E'LE'ME1'J~'O = = 2; 2; public pprívate r í v a te static s t a ti c Ur i Matcher URI_l'1r!.TCHER ull; UriMatcher URJ_MATCHER = nnuil; static {{ URI_ M.l!TC'HER = UriMatc her (UriMatcher. NO^ÍATCH) NO_,,fL'iTCH) ;; URI_MATCHER = new UriMatcher 11 pt..nltuac i ones l:, UF?.l"_ Ml!'TCHE'R . addURI ( AU'TORI DAD , "puntuaciones", URI_MATCHER.addüRI[AUTORIDAD, TODOS'_LOS_ ELElvJEl"!TOS) ¡ TODOS_LOS_BLEMENTOS);

314

Almacenamiento de datos URI_MA'I'CHER URI_MATCHER.addURI(AUTORIDAD, "puntuaciones/#", UN_BLEMENTO); .addURI ( AU'l'CJRTDllD, "puntuaciones/ #", [;'N_E'LEMENTO ); } publ ic static final String Tll.BLl! public TABLA == "puntuaciones" "puntuaciones";; private prívate SQLiteDatabase baseDeDatos;

®Over·:r-ide ©Override

public ptiblic boolean onCreate() onCreateO {{ PuntuacionesSQLiteHelper dbHelper = = new PuntuacionesSQLiteHelper(getContext()); baseDeDatos = dbHelper . getWritableDatabase(); dbHelper.getWritableDatabase(); return baseDeDatos != != null nuil && baseDeDatos baseDeDatos.isOpen(); .isOpen();

} } Como no podría ser de otra forma la clase extiende contentProvider. A A continuación creamos constantes, AUTOH.IDAD autoridad y uri, que identificarán nuestro ContentProvider mediante la URI: URI: content. : //org.example .punt.uac.ionesprovid.er/puntuaciones content.://org.exaraple.puntuacionesprovider/puntuaciones

Las siguientes líneas permiten crear el objeto estático URI uri __r.l.l\.TCHER matcher de la clase uriMatcher. En Java es habitual utilizar variables estáticas finales para para albergar objetos que no van a cambiar en toda la vida de la aplicación, es decir que son constantes. constantes. Conviene recordar que solo se creará un objeto URI_M.ATCHER uri matcher aunque se instancie instancle varias veces la clase PuntuacionesP:n)v.ider. Puntuacionesprovider. La clase uriMatcher UriMatcher permite diferenciar entre distintos tipos de URI que vamos a manipular. En nuestro /puntuaciones,, que identifica todas caso permitimos dos tipos de URI: acabada en /puntuaciones las puntuaciones almacenadas y acabada en /puntuaciones/# /puntuaciones/#,, donde# donde # hay que reemplazarlo por un código numérico que coincida con el campo _id id de nuestra tabla. Cada tipo de URI ha de tener un código numérico asociado; en nuestro caso NO_fviATCH 'I'ODOS_LOS_ELEMENTOS (1) y UN_ ELEíVIENTO (2). NO_MATCH (-1), TODOS_LOS_ELEMENTOS UN_ELEMENTO

tabla, que identifica identifica la La declaración de variables termina con la constante TABLA, tabla que usaremos para almacenar la información y el objeto baseDeDatos donde se almacenará la información. oncreate A continuación está el método on create () que es llamado cuando se crea una instancia de esta clase. Básicamente, se crea un BQLiteHelper SQLiteHelper a partir de la clase descrita en el apartado anterior (PuntuacionesSQLiteHelper) y se asigna la base de datos resultante a la variable baseDeDatos. Devolvemos true solo en el caso de creación. que no haya habido problemas en su creación. Veamos la implementación del método getType getTypeO nos () que a partir de una URI nos devuelve el tipo MIME que le corresponde: corresponde: •#;Ovex: .l.-idt:: iSOverrida

public String getType getType(final (final Uri uri) { switch ((ÜRI_MATCHSR.match(uri)) URl_t1i\TCHER . match (uri) ) { { case TODOS_LOS_ELEMENTOS: TODOS_LOs_ELE.Jw!EN"I'OS : case

android.cursor.dir/vnd.org.exampl return "vnd. android. cursor. dir/vnd. org . examplee.puntuacion" . puntuación" ; UN_ELEJ~tEl'JTO : UN_EIjBMENTO:

315

El gran libro de Android return "vnd.android.cursor . item/vnd.org . example.puntuacion"; "vnd.android.cursor,item/vnd.org.example.puntuación"; default default:: throw new IllegalArgumentEx ception("URI incorrecta:" ); IllegalArgumentException("URI incorrecta: " ++ uri uri);

} } NOTA: Los tipos MiME MIME fueron fueron creados creados para para identificar identificar un un tipo tipo de de datos datos concreto concretoque que un correo correo electrónico, electrónico, aunque aunque en enlalaactualidad actualidadson sonutilizados utilizadospor por añadíamos como anexo aa un muchos sistemas yy protocolos. genérico/ protocolos. Un Un tipo tipo MiME MIME tiene tiene dos dos partes partes Upo_ tipo_...genérico/ t.:.I:J)O_f:)SIJe cL F.i.co, por / g.i..t~ .i.Irt..?Qt:~/-)J)f.-:q, / J:t:rn.l, etc. tipo_ especifico, por ejemplo ejemplo Íínage image/gif, hmge/jpeg, t:ext:: texC/html, etc. Existe un convenio para para identificar identificar los los tipos tipos MIME MIME que que proporciona proporciona un un ContentProvider. Si Si se se trata trata de de un un recurso recurso único, único, utilizamos: utilizamos: vnd. android . cursor. i tern/vnd. E'LE.MEJ:·rto vnd.android.cursor.i tem/vnd.ELEMENTO

y si se trata de una colección colección de de recursos recursos utilizamos: utilizamos: vnd. android. curnor. dir/vnd . .ELEMENTO vnd.android,cursor.dir/vnd.ELEMENTO

donde ELEMENTO elemento ha ha de de ser ser remplazado remplazado por por un un identificador identificador que que describa describaelel tipo tipo de datos. example. puntuacion. Utilizar datos. En nuestro nuestro caso caso hemos hemos elegido elegido org. org.example.puntuación. Utilizar prefijos para definir el el elemento elemento minimiza minimiza elel riesgo riesgo de de confusión confusión con con otro otro ya ya existente. A continuación hemos de de sobrescribir sobrescribir los los métodos métodos query query,, insert, insert, delete deiete yy update que permitan consultar, consultar, insertar, insertar, borrar borrar yy actualizar actualizar elementos elementos de de nuestro nuestro

por el el primer primer método: método: ContentProvider. Comencemos por @ ()·ver·:c ide ©Override public Cursor query (Uri uri, ng[] projection, query(Uri uri, Stri String[] projection, String String seleccion, selección, String[] argSeleccion, String String [] argSeleccion, String orden) orden) { SQLiteQueryBuilder queryBuild er = new queryBuilder new SQLiteQueryBuilder(); SQLiteQueryBuilder();

queryBuilder.setTabl es( 1'llBLA) ; queryBuilder.setTables(TABLA); switch ((URI^ldATCHER. URI.....MATCHER .match( uri ))) match (uri)

{ case ·TOD08. TODOS_LOS_ELEMENTOS: .... LO$ ....E L:EJvJElJTOS : break; case UN_ ___ ELE11ENTO: UN__BLEMENTO: String id= gments() id = uri uri .. getPathSe getPathSegments () ..get(l); get {1) ,• queryBuilder.appendWhere id == "" ++ id); queryBuilder. appendwhere (("" __id id) ; break; default: throw new IllegalArgumentException("URI t a ""+uri); +uri); IllegalArgumentException("URI incorrec incorrecta } return queryBuilder .query(ba s eDeDatos , proyeccion, queryBuilder.query(baseDeDatos, proyección, seleccion, selección, argSeleccion, null, nuil, null, nuil, orden); orden); } El método query í) () que que hemos hemos de de implementar implementar tiene tiene parámetros parámetros similares similares que que SQLi teQueryBuilder..query que ry (). SQLiteQueryBuilder (). Por Por lo lo tanto, tanto, no no tenemos tenemos más más que que trasladar trasladar lala consulta a nuestra base base de de datos. datos. No No obstante obstante existe existe un un pequeño pequeño inconveniente, inconveniente, sisi

316

Almacenamiento de datos nos pasan una URI que identifique un solo elemento, elemento, como la mostrada a continuación: continuación: content://org. example . puntuacionesprovider/puntuaciones /324 content://org.example.puntuacionesprovider/puntuaciones/324

Hemos de aseguramos asegurarnos que solo se devuelve el elemento con _ict=324. _id=324. Para conseguirlo se introduce una cláusula awítch, switch, que en caso de tratarse de una URI URI t:JN___ELEMENTO, >·mERE de la consulta la condición de tipo un elemento, añada a la cláusula whese correspondiente mediante el método apendl1here () . La cláusula where WIIERE puede tener apendwhere (). seleccion. más condiciones si se ha utilizado el parámetro selección.

(SOverride public Uri insert (Uri uri, ContentValues valores) { insert(Uri llong o ng IdFila I dFila == baseDeDatos baseDe Da t os ..insert( Tl,BLA , nuil, null , valores); insert (TABL-A, if (IdFila >> O) 0) { rreturn e t urn ContentUris. withAppendedid ( CONTEN'T_.... URI, IdFila); ContentUris.withAppendedId(CONTENT_URI, els e {{ } else hrow new SQLException ("E r r or al a l insertar i n se r tar registro en "+uri); " +uri ) ; tthrow SQLException("Error

} } @Override ®Override ppublic ublic int del ete (Uri uri, Str ing selección, s e l e ccion, String[] argSeleccion) a r gSeleccion) {{ delete(Uri String switch ((ü'Rl_MATCHER. URL__)1!l'I'CHER. match match (uri) (u ri))) { cas __L05'.... ELEMEJ.V'I'OS : casee 'IODO$ TODOS__LGS__ELEMENTOS: break break;;

case ÜN_ELEMENTO: case UN_ELE'ME'l'J'TO : String id == uri.getPathSegments().get(1); uri . getPathSegments() . get(l); if (Tex tUtils . isEmpty (se l ecc ion)) {{ (TextUtils.isBmpty(selección)) 11 selecci o n = "_id id - " + id; selección }} else e lse {{ selecc i on = "_id selección ANO (" ( " + selección se l eccion + ")"; ")"; " i d = " + id + "" AND } break; default: throw new IllegalArgumentException("URI IllegalArgumentExc eption ( "URI incorrecta: " + uri); u r i ); } return re t u rn baseDeDatos. base DeDatos . delete dele te (TABLA, ( 'T'ABLl1 , selección, seleccion , argSeleccion) argSe l eccion) ,;-

} El método insert () no requiere explicaciones adicionales. adicionales.

delete El método de l ete (o, l , igual como ocurrió con el método gueryO, query () , presenta el el inconveniente de que pueden habernos indicado una URI que identifique un solo elemento (.../puntuaciones/324). (... /puntuaciones/324 ). En el método queryO, query () , solucionamos este SQLiteQueryBuilder.appendwhereO. problema llamando a SQL i teQueryB u i l der . appendwhere (} . Sin embargo, embargo, ahora clase, por lo que nos vemos obligados a no disponemos de un objeto de esta clase, realizar este trabajo a mano. seleccion, mano. En caso de no haberse indicado nada en selección, este parámetro valdrá "_id " id == 324"; y en caso de haberse introducido una '555 • " , selección seleccicm valdrá "_id " id = 324 and AND condición, condición, por ejemplo "numero = '555'", '555'}". (numero = '555')". 317

El gran libro de Android ·@Over-ride ®Ove.rride public update (Uri uri, Co ntent Values valores pubiic int update(Uri ContentValues valores,, String seleccion selección,, String[] ArgumentosSeleccion) ArgumentosSelecc ion) { switch (URI_l1A'I'CHER (URI__Í'1ATCHER..match(uri match (uri)))) { case 'POD08_LOS_ELE1·JE1VTOS TODOS_LOS_ELEMENTOS::

break; case Ul'J ELEJ:.fEl•J'I'O : UN___ ELEMENTO:

id = uri.getPathSegments().get(1); String id= uri.getPathSe gments() .get(l); if (TextUtils.isEmptyíselección)) (TextUti ls . isEmp t y (seleccion ) ) {{ seleccion selección = ""_id id - " ++ id; }} else {{ seleccion selección = ""_id AND (" ++ selecc selección i o n ++ id = "" ++ id ++ "" .~D

!1\ 11.

' '

} break; default default:: throw new IIllegalArgumentException("URI llegalArgumentEx ception ( "l:JRI incorrect.a ); incorrecta:: " ++ uri uri); } return baseDeDatos.update(TABLA, baseDeDa t os. update ( 'l't1BUl , valores, selecc i on , selección, ArgumentosSel eccion) ; ArgumentosSeleccion); } Finalizamos con el método uupdate p date () que es muy similar a delete () ()..

9. 7.3.3. Declarar el ContentProvider en AndroidManifest.xml 9.7.3.3. AndroidManifest.xrnl Si queremos que nuestro contentProvider ContentProvider sea visible a otras aplicaciones resulta resulta en el imprescindible hacérselo saber al sistema declarándolo en el An droi dMan ifest .xml. Para conseguirlo no tienes más que añadir el siguiente AndroidManifest.xrnl. código dentro de la etiqueta : : > 1 1 '

1

La declaración de un cont e ntProvide r requiere que se especifiquen dos ContentProvider atributos: atributos: name: ñame: nombre cualificado de la clase donde hemos implementado nuestro nuestro

ContentProvider. ContentProvider. authoríties : parte de correspondiente a la autoridad de las URI authorities: URI que que

vamos a publicar. Puede indicarse más de una autoridad. También se pueden indicar otros atributos en la etiqueta . Veamos los más importantes: label label;: etiqueta describiendo el ContentProvider que será mostrada al al

usuario. usuario. Esta etiqueta como una referencia a un recurso de tipo string. icon: una referencia a un recurso de tipo drawab/e icón: drawable con un icono que represente nuestro ContentProvider.

318

Almacenamiento de datos enabJ.e: enabie; indica si está habilitado. habilitado. El valor por defecto es true. exported: exportad: indica si puede ser accedido desde otras aplicaciones. Valor por defecto true. Si está a false faise solo podrá ser utilizado por aplicaciones

con el mismo ID de usuario que la aplicación donde se crea. crea. readPermision: readPermision: indica si los clientes podrán consultar la información. información. ,.,ritePermi sion: indica si los clientes podrán modificar la información. writePermision: permission: permission: el nombre de un permiso que el cliente ha de solicitar para acceder al ContentProvider. ContentProvider. Para más información consultar el capítulo sobre seguridad. mult i process : el valor por defecto es false, false , en este caso se creará un multiprocess: único proceso para contener el ContentProvider. true , se ContentProvider. Si se indica true, creará un nuevo proceso por cada cliente que quiera hacer uso del ContentProvider. pprocess: roceGs : nombre del proceso en el que el ContentProvider ha de ejecutarse. ejecutarse. Habitualmente, todos los componentes de una aplicación se ejecutan en el mismo proceso creado para la aplicación. Si no se indica lo contrario, el nombre del proceso coincide con el nombre del paquete de la aplicación (si lo deseas puedes cambiar este nombre con el atributo process de la etiqueta ). ) . Si prefieres que un componente de la aplicación se ejecute en su propio proceso, has de utilizar este atributo. atributo. initorder: ini torder: orden en que el ContentProvider ha de ser instalado en relación a otros ContentProviders del mismo proceso. proceso. syncable: indica si la información del ContentProvider está sincronizada con el servidor.

11

Práctica: La etiqueta provider. provider.

1.

Trata de introducir nuevos atributos a la etiqueta . .

2.

Observa los resultados obtenidos.

9.7.4. 9. 7 .4. Acceso a PuntuacionesProvider desde Asteroides Una vez hemos creado y declarado nuestro ContentProvider vamos a probarlo Asteroides. Como hemos hecho en ejemplos anteriores, vamos desde la aplicación Asteroides. a crear una nueva clase que implemente la interfaz AimacenPuntuaciones. AlmacenPuntuaciones.

Crea una nueva clase en la aplicación Asteroides AlmacenPuntuacionesProvider. Introduce el siguiente código:

con

el

nombre

AlmacenPuntuacio n e sProvider public class AlmacenPuntuacionesProvider iimplements mplemen ta AlmacenPun tuaciones { AimacenPuntuaciones pri vate Activity activity; activity ; prívate

319

El gran libro de Android Androíd public AlmacenPuntuacionesProvider(Activity AlmacenPuntuacionesProvider(Activity activity) activity) this. act i v ity == activity; this.activity

{

} public void guardarPuntuacion(int puntos, puntos, String String nombre, nombre, long long fecha) fecha) Uri uri == Uri. parse ( Uri.parse( "content://org . examp.l.e.puntuaci.onesprovi der/puntuaciones" ) ; "content://org.example.puntuacionesprovider/puntuaciones"); ContentValues l ores == new ContentValues(); ContentValúes va valores ContentValues(); valores . put ("nomb re", nombre); valores.put("nombre", valores . put (" p untos '', puntos); valores.put("puntos", valores.put(" fecha ", fecha); valores.put("fecha", fecha); try {{ ac t ivity .getContentResolv er() .insert(uri, valo res); activity.getContentResolverO.insertfuri, valores); } catch (Exception e) {{ Toast.makeText( Toast.makeText{ aactivity, c t ivity, "Ve r i f icar que está iinstalado n sta lad o ''"+ + "Verificar ""org.example.puntuacionesprovider", org. example .puntuacionesp:r·ovider" , Toast.LENGTH„LONG).show(); Toast. LENGTH.... LONG ) . show () ; Log .e (" Asteroides ", "Error ); Log.e("Asteroides", "Error:: " ++ e.toString() e.toString(),, ee);

} } public Vector listaPuntuaciones(int listaPuntuaciones(int cantidad) cantidad) { Vector result = (); = new Vector Vector(); Uri uri == Uri. parse ( Uri.parse( "conten t://org.exampl e.punt uacionesprovider/puntuaciones "); "content://org.example.puntuacionesprovider/puntuaciones"); Cu r sor cursor == activity .ma n a g e dQue ry(uri, null, Cursor activity.managedQuery(uri, nuil, null, nuil, null, fecha DESC" ); nuil, ""fecha DESC"); if (cursor != null) nuil) { while (cursor.moveToNext ( )) { (cursor.moveToNext()) String nombre == cursor.getString( ccursor.getColumnIndex("nombre")); urso r . getCo lumninde x(" nombre" )); int puntos puntos == ccursor.getlnt( ursor . g et lnt( ccursor.getColumnlndex("puntos")); ursor . ge t Columnindex (" puntos") ); resul t. a dd(puntos ++ "" "" ++ nombre); result.add(puntos nombre);

} cursor.close(); cursor.cióse() ;

} return rresult; esult;

} } Para utilizar esta nueva clase, modifica modifica en en el el principio principio de de la la clase clase Asteroides Asteroides yy de la clase Puntuaciones la declaración de de la la variable variable almacen almacén por: por: this ); AlmacenPuntuaciones almacen almacén ~~ new new AlmacenPuntuacionesProvider( AlmacenPuntuacionesProvider(this);

320

{

CAPÍTULO 10. CAPÍTULO 10.

Internet: sockets, HTTP HTTP yy Internet: sockets, servicios web servicios web

Los teléfonos Android suelen suelen disponer disponer de de conexión conexión aa Internet. Internet. Esto Esto nos nos permite permite no no solo almacenar los datos datos en en nuestro nuestro dispositivo, dispositivo, sino sino compartirlos compartirlos con con otros otros usuarios. En el primer primer punto punto del del capítulo capítulo trataremos trataremos de de resolver resolver elel problema problema de de la herramienta herramienta básica: básica: los lossockets. sockets. comunicar dos aplicaciones aplicaciones en en Internet Internet mediante mediante la Existen otras alternativas alternativas de de más más alto alto nivel, nivel, como como el el uso uso del del protocolo protocolo HTTP, HTTP, que que será estudiada en en el segundo segundo punto punto del del capítulo. capítulo. Para Para terminar, terminar, se se tratará tratará una una alto nivel, nivel, los los servicios serviciosweb. web. tercera alternativa, todavía todavía de de más más alto

En este capítulo implementaremos implementaremos el el mismo mismo ejemplo ejemplo que que en en elel capítulo capítulo anterior, anterior, en las puntuaciones puntuaciones obtenidas obtenidas en en Asteroides, Asteroides, pero pero ahora ahora en es decir, almacenaremos almacenaremos las un servidor de Internet. Internet. Utilizaremos Utilizaremos las las tres tres alternativas alternativas descritas descritas en en elel párrafo párrafo anterior. No obstante, obstante, has has de de tener tener claro claro que que estos estos mecanismos mecanismos están están relacionados relacionados entre sí. Por ejemplo, si si utilizas utilizas servicios servicios web, web, internamente internamente se se utilizará utilizaráelel protocolo protocolo sockets para para establecer establecer lalacomunicación. comunicación. HTTP y además además este este protocolo protocolo utiliza utiliza sockets

Objetivos: • • • • • • • •

Repasar las alternativas alternativas principales principales para para intercambiar intercambiar datos datos por porInternet. Internet. Describir el uso de de socket socket como como herramienta herramienta básica básica de de una una aplicación aplicación para para comunicarse con otras otras aplicaciones aplicaciones por por Internet. Internet. un protocolo protocolo basado basado en en sockets sockets sobre sobreTCP. TCP. Mostrar cómo se programaría programaría un Describir el funcionamiento del del protocolo protocolo HTTP HTTP Mostrar cómo se pueden programa programa peticiones peticiones HTTP HTTP desde desde Android. Android. Definir el concepto de de servicio servicio Web Web yy comparar comparar las las alternativas alternativas más más importantes. Mostrar el acceso aa servicios servicios web web de de terceros terceros desde desde un un cliente clienteAndroid. Android. Aprender a crear nuestro nuestro propio propio servidor servidor de de servicios servicios Web. Web.

321

El gran libro de Android

1 0.1. Comunicaciones en Internet Internet mediante mediante sockets sockets 10.1. Comunicaciones en Antes de definir que es es un socket conviene aclarar aclarar los los roles roles oo configuraciones configuraciones que que en un un proceso proceso de de comunicación. comunicación. Las Las dos dos pueden tomar las aplicaciones aplicaciones en configuraciones más importantes importantes que que pueden pueden tomar tomar son: son: las las llamadas llamadas "arquitectura "arquitectura cliente/servidor". Esta Esta segunda segunda es es la la que que utilizaremos utilizaremos igual a igual" y la "arquitectura cliente/servidor". en los ejemplos de este capítulo, capítulo, por por tanto, tanto, conviene conviene aclarar aclarar este este aspecto. aspecto.

10.1.1.

La arquitectura arquitectura cliente/servidor cliente/servidor

Las aplicaciones en Internet suelen suelen seguir la la arquitectura arquitectura cliente/servidor. cliente/servidor. Esta Esta arquitectura se caracteriza por descomponer el el trabajo trabajo en en dos dos partes partes (es (es decir decir dos dos programas): el servidor, servidor, que que centraliza el el servicio, servicio, yy el el cliente, cliente, que que controla controla la programas): la interacción con el usuario. usuario. El servidor servidor ha ha de ofrecer ofrecer sus sus servicios servicios aa través través de de una una dirección conocida. Algunos ejemplos ejemplos de de aplicaciones aplicaciones basadas basadas en en la la arquitectura arquitectura correo electrónico. electrónico. Se Se suelen suelen seguir seguir las las siguientes siguientes cliente/servidor son WWN WWW o el correo arquitectura: pautas de comportamiento en esta arquitectura:

Cliente

Servidor

1servidor. 1- Se conecta al servidor.

se conecte. conecte. 1- A la espera de que algún cliente se

2- Solicita alguna información al servidor. servidor.

2- Recibe solicitud.

3- Recibe la respuesta. respuesta.

3- Envía respuesta.

4- Ir al punto 2.

4- Ir al punto 2. 2.

5- Cierra la conexión

5- Cierra la conexión. conexión . 6- Ir al punto 1. 1.

10.1.2.

¿Qué es es un socket? ¿Qué

Cada una de las diferentes aplicaciones en Internet Internet (web. (web, correo correo electrónico,...) electrónico, .. . ) ha ha de poder intercambiar información información entre programas programas situados situados en en diferentes diferentes ordenadores o dispositivos. Con este este propósito, propósito, se se va va aa hacer hacer uso uso del del nivel nivel de de el transporte de la pila de protocolos protocolos TCP/IP, TCP/IP, cuyo cuyo objetivo objetivo final final es es permitir permitir el intercambio de información aa través de de la red de de forma forma fiable fiable yy transparente. transparente.

_....

-

...,...,....,._.

~ Poli[Media]:

Poli Media : El E/ Interfaz Socket. Socket.

La interfaz socket define las las reglas que que un un programa programa ha ha de de seguir seguir para para utilizar utilizar los servicios del nivel nivel de transporte en en una una red red TCP/IP. TCP/IP. Esta Esta interfaz interfaz se se basa basa en en el el concepto de socket. Un socket es es el el punto final final de de una una comunicación comunicación bidireccional bidireccional

322

Internet: sockets, http hHp yy servicios web

entre dos programas que intercambian información información aa través través de de Internet Internet (socket (socket se se traduce literalmente como enchufe). enchufe). Dado que en un mismo dispositivo/ordenador podemos podemos estar estar ejecutando ejecutando de de aplicaciones que forma simultánea diferentes aplicaciones que utilizan utilizan Internet Internet para para comunicarse, comunicarse, resulta imprescindible identificar identificar cada socket socket con con una una dirección dirección diferente. diferente. Un Un socket socket se va a identificar por la dirección IP del del dispositivo dispositivo donde donde está, está, mas mas un un número número de de puerto (de 16 bits). En Internet Internet se se suele suele asociar asociar aa cada cada aplicación aplicación un un número número de de puerto concreto (por ejemplo: ejemplo: 80 para la la web, web, 25 25 para para el el correo correo electrónico, electrónico, 77 para para ECHO o 4661 para eDonkey). eDonkey). Una conexión conexión está está determinada determinada por por un un par par de de sockets, extremos de la conexión. conexión. sockets, que son los extremos Existen dos tipos de socket, socket, socket stream yy socket socket datagram. Veamos Veamos en en qué qué se diferencian: diferencian:

10.1.2.1.Sockets stream (TCP) Los sockets stream ofrecen un un servicio servicio orientado orientado aa conexión, conexión, donde donde los los datos datos se se transfieren como un flujo continuo sin encuadrarlos encuadrarlos en en registros registros oo bloques. bloques. Este Este tipo tipo de socket se basa en el protocolo TCP, TCP, que que es es un un protocolo protocolo orientado orientado aa conexión. conexión. Esto implica que, que, antes de transmitir información, información, hay hay que que establecer establecer una una conexión conexión entre los dos sockets. Mientras uno de de los los sockets sockets atiende atiende peticiones peticiones de de conexión conexión (servidor), (servidor), el otro solicita la conexión (cliente). (cliente). Una Una vez vez que que los los dos dos sockets sockets están están conectados, ya se puede transmitir datos conectados, datos en en ambas ambas direcciones. direcciones. El El protocolo protocolo incorpora al programador, programador, de de forma transparente, transparente, la la corrección corrección de de errores. errores. Es Es decir, decir, sisi detecta que parte de la información no llegó llegó aa su su destino destino correctamente, correctamente, ésta ésta volverá volverá a ser trasmitida. Además, Además, no limita limita el tamaño máximo máximo de de información información aa transmitir. transmitir.

10.1.2.2.Sockets datagram (UDP) Los sockets datagram se basan en el protocolo protocolo UDP UDP yy ofrecen ofrecen un un servicio serv1c1o de de transporte sin conexión. conexión. Es decir, decir, podemos podemos mandar mandar información información aa un un destino destino sin sin necesidad de realizar una conexión previa. previa. El El protocolo protocolo UDP UDP es es más más eficiente eficiente que que TCP, pero tiene el inconveniente que TCP, que no no se se garantiza garantiza la la fiabilidad. fiabilidad. Además, Además, los los datos se envían y reciben en datagramas datagramas (paquetes (paquetes de de información) información) de de tamaño tamaño limitado. La entrega de un datagrama datagrama no no está está garantizada: garantizada: estos estos pueden pueden ser ser duplicados, duplicados, perdidos o llegar llegar en un orden orden diferente diferente ai al que que se se envió. envió. La gran ventaja de este tipo de sockets sockets es es que que apenas apenas introduce introduce sobrecarga sobrecarga sobre la información transmitida. transmitida. Además, Además, los los retrasos introducidos introducidos son son mínimos, mínimos, lo lo que los hace especialmente interesantes para para aplicaciones aplicaciones en en tiempo tiempo real, real, como como la la transmisión de audio y vídeo sobre sobre Internet. Internet. Sin Sin embargo, embargo, presenta presenta muchos muchos inconvenientes al programador; programador: cuando transmitimos transmitimos un un datagrama datagrama no no tenemos tenemos la la certeza de que este llegue a su destino, destino, por por lo lo que, que, si si fuera fuera necesario, necesario, tendríamos tendríamos que implementar nuestro propio mecanismo mecanismo de de control control de de errores. errores. Otro Otro inconveniente es el hecho hecho de que existe un un tamaño tamaño máximo máximo de de datagrama, datagrama, unos unos 1.500 bytes dependiendo de la la implementación. implementación. Si la la información información aa enviar enviar es es mayor, mayor, tendríamos que fraccionarla y enviar varios varios datagramas datagramas independientes. independientes. En En el el destino tendríamos que concatenarlos en el el orden orden correcto. correcto.

323

El gran libro de Android si deseas deseas una una comunicación comunicación libre libre de de errores errores yy sin sin En conclusión, si preocupaciones para el el programador programador es es más más conveniente conveniente que que utilices utilices sockets sockets stream. stream. Es el tipo de socket socket que que utilizaremos utilizaremos en en los los siguientes siguientesejemplos. ejemplos.

1 0.1 .3. 10.1.3.

Un ejemplo ejemplo de de un un cliente/servidor cliente/hervidor de de ECHO ECHO

El servicio ECHO suele suele estar estar instalado instalado en en el el puerto puerto 77 de de máquinas máquinas Unix Unixyypermite permite comprobar que la máquina máquina está está operativa operativa yy que que se se puede puede establecer estableceruna unaconexión conexión con ella. El funcionamiento de un un servidor servidor ECHO ECHO es es muy muy sencillo: sencillo: cuando cuando alguien alguien se se conecta espera que le le envíe envíe algo algo yy lele responde responde exactamente exactamente con con lala misma misma El cliente cliente actúa actúa de de forma foima contraria; contraria; envía envía datos datos alalservidor servidoryy información recibida. El luego comprueba que los los datos datos recibidos recibidos son son idénticos idénticos aa los lostransmitidos. transmitidos.

Ejercicio paso aa paso: paso: Un Un clíente cliente de de ECHO. ECHO. El siguiente ejemplo muestra muestra cómo cómo podrías podrías desarrollar desarrollar un un cliente cliente de deECHO ECHOque que utiliza un socket stream. stream. . 42 . .146 . 127 ha NOTA: Para que el ejemplo ejemplofimcione funcione en en la la dirección dirección IP IP lSB 158.42.146.127 hade dehaber haberun un servidor de ECHO en fUncionamiento. funcionamiento. En En caso caso de de no no ser serasí, así, puedes puedesremplazar remplazarlalaIP IPpor por la de un servidor de ECHO en enfUncionamiento funcionamiento oorealizar realizarelelsiguiente siguienteejercicio. ejercicio.

1.

Crea la aplicación aplicación C/ienteECHO, ClienteECHO, donde donde se se cree cree una una actividad actividadcon connombre nombre ClienteECHO.

2.

Remplaza el código código por: por; public cclass lass ClienteECHO tends Activity ClienteECHO ex extends Activity { priv ate extView prívate extview output output;; ®Ove:crj.de i c void e (Bundle savedinstanceState) ©Override pubJ. public void onCreat onCreate(Bundle savedlnstanceState) {{ ssuper.onCreate(savedlnstanceState); uper.onCreate (savedinsta nc eState); setCon tentView(R . layout . ma .i.n );; setContentView(R.layout.mairí) output = (TextView) findVie wByid (R. id. Te x t\liew0.1 ); findViewByld(R.id.TextViewOj); ejecutaCliente(); ejecutaClienteO ;

} private oid ejecutaClient e () { prívate vvoid ejecutaClienteO String ip=" l5B.42 146 ..127" 127 11 ; ; ip=l:158 . 42 ..146 int puerto=7; log(" sockett 11" ++ ip ip ++ "" 11" ++ puerto) puerto);; log ( '' socke try { Socket sk = ne w Socket(ip,puerto); new Socket(ip,puerto); BufferedReader eentrada nt rada == new new BufferedReader( BufferedReader( r(sk.getinputStream())); new InputStreamReade InputStreairiReader(sk.getlnputStreamO));

324

Internet: sockets, hHp hltp yy servicios servicios web web PrintWriter salida == new new PrintWriter PrintWriter(( new OutputStreamWriter(sk.getOutputStream()) , true ); OutputStreamWriter(sk.getOutputStreamO),true); log(" enviando ... " ); log("enviando..."); salida.println( "Hola t-1undo") salida.printlnC'Hola Mundo");; log ("recibiendo .... . . "" ++ entrada . readLine () ) ; log("recibiendo entrada.readLineO); sk . e lose () ; sk.cióse } catch (Exception e) e) {{ llog("error: og ("error: " ++ e. toString ()) ; e.toString()); }

} privat e void log(String private log(String string) string) { output. append(string ++ "\n" ); output.append(string "\n"); }

} La parte interesante se ecutarcliente (l. En se encuentra encuentra en en el el método método ej ejecutarciienteO. En cliente ha ha de de conocer conocer lala dirección dirección del del socket socket del del primer lugar, todo cliente caso los los valores valores se se indican indican en en elel par par de de variables variables ip ipyy servidor; en este caso tenemos la la certeza certeza de de que que elel servidor servidor admita admita lala conexión, conexión, puerto. Nunca tenemos por lo que es obligatorio obligatorio utilizar utilizar una una sección sección try/catch. try/catch. La La conexión conexión propiamente dicha se realiza realiza con con el el constructor constructor de de lala clase clase socket. socket. Siempre hay que tener previsto previsto que que ocurra ocurra algún algún problema, problema, en en tal talcaso, caso, se se se pasará pasará aa la la sección sección catch. catch. En En caso caso contrario, contrario, creará la excepción yy se obteniendo el el Inputstream inputstream yy elel outputstr outputstreara asociadoalal continuaremos obteniendo eam asociado nos permitirá permitirá obtener obtener las las variables, variables, ent entrada salida socket. Lo cual nos r·ada yy salida podremos recibir recibir yy transmitir transmitir información. información. ElEl programa programa mediante las que podremos cadena "Hola "Hola Mundo Mundo", tras lo lo que que visualiza visualiza lala información información transmite la cadena ", tras recibida. Si todo es es correcto, correcto, ha ha de de coincidir coincidircon con lolotransmitido. transmitido. recibida.

3.

la aplicación aplicación el el permiso permiso INTERNET. INTERNET. Solicita en la

4.

Ejecuta la la aplicación aplicación yy verifica verifica sisi elel servidor servidor responde. responde. Recuerda Recuerda que quees es haya arrancado arrancado este este servicio servicio en en elel servidor. servidor. posible que no se haya

t' paso: Un Un servidor servidorde de ECHO. ECHO. Ejercicio paso aa paso: un servidor servidor de de ECHO ECHO en en tu tu ordenador. ordenador. Vamos a implementar un 1.

Crea un nuevo proyecto proyecto Java Java (no (no para paraAndroid) Android)con con nombre nombreServidorECHO. ServidorECHO

2.

proyecto la la clase clase servidorECHO servidorEcnocon con elel siguiente siguientecódigo: código: Crea en este proyecto ass ServidorEC HO {{ public cl class ServidorECHO

public gs[]) {{ pubiic static void void main(String main(String ar args[]) try { (7) ; ServerSocket sk == new new ServerSocket ServerSocket(7); whil whilee (true (true)) {

325

El gran libro de Android Socket cliente= k.accept(}; cliente = ssk.acceptO; BufferedReader entrada entrada == new new BufferedReader( BufferedReader( new InputStreamReader(cliente.getinputStream(}}}; InputStreatiiReader(cliente.getInputStream() )) ; riter( PrintWriter salida salida == new new PrintW PrintWriterf new Outpu tStreamWriter(cliente.getOUtputStream(}}, true} ; OutputStreamWriter(cliente.getOutputStreamO),true); String datos = entrada . readLine(}; entrada.readLine(); salida.println(datos}; salida.println(datos) ; c li ente. e lose (} ; cliente.cióse();

} } catch (IOException (lOException e} e) { System println(e}; System,.out. ofit .println (e) ; } } } En este caso utilizaremos utilizaremos la la clase clase serversocket. serversocket asociada asociada alal puerto puerto 77 para crear un socket socket que que acepta acepta conexiones. conexiones. Luego, Luego, se se introduce introduceun un bucle bucle infinito para que el el servidor servidor esté esté perpetuamente perpetuamente en en servicio. servicio. En En lala siguiente línea el servidor servidor no no se se detendrá detendrá hasta hasta que que un un cliente cliente se seconecte. conecte. Cuando ocurra esto, todo todo el el intercambio intercambio de de información información se se realizará realizará aa través de un nuevo socket ient.e . socket creado creado con con este este propósito, propósito, elel socket sockete:!. cliente. El resto del código es similar similar al al cliente, cliente, aunque aunque en en este este caso caso primero primero se se recibe y luego se transmite transmite lo lo mismo mismo que que ha ha recibido. recibido. 3.

Sustituye la dirección dirección IP IR en en ClienteECHO ClierteECHO por por lala IP IR de de tu tu ordenador. ordenador. ElEl comando ipconfig ipconfig (Windows) (Windows) te te permite permite averiguar averiguar lala dirección dirección IP IR de de tutu ordenador. No utilices como como IP IR 127 127.0.0.1 (localhost) dado dado que, que, aunque aunquese se ordenador. .0.0.1 (localhost) misma máquina, máquina, la la IP IR del del emulador emulador es es diferente diferenteaalaladel del PC. PC. ejecuten en la misma

4.

Ejecuta primero el el servidor servidor yy luego luego el el cliente cliente para paraverificar verificarque quefunciona. funciona.

NOTA: Si la IP de tu tu ordenador ordenador es es privada privada no no podrás podrás crear crear un unservidor servidoraccesible accesibledesde desde cualquier parte de de Internet. Internet. En En este este caso, caso, utiliza utiliza el elemulador emuladorooun undispositivo dispositivoAndroid Androidreal real que se conecte por por WiFi WiFi aa la la misma misma red redde de tu tu ordenador. ordenador. Si Sino, no, elelterminal terminalno noencontrará encontraráelel servidor.

1 0.1.4. 10.1.4.

Un servidor por ara las por sockets sockets para las puntuaciones puntuaciones

Siguiendo la estructura básica básica de de un un cliente cliente yy un un servidor servidor TCP TCP que que acabamos acabamos de de ver, i ones para ver, va a resultar resultar muy muy sencillo sencillo implementar implementar lala interfaz interfaz AlmacenPuntuac. AlmacenPuntuaclones para que varios clientes con con dispositivos dispositivos Asteroides Asteroides puedan puedan conectarse conectarse aa un un servidor servidor para intercambiar puntuaciones. El primer lugar tenemos que que diseñar diseñar un un protocolo protocolo que que permita permita realizar realizar las las dos dos operaciones que ha ha de implementar implementar la la interfaz. interfaz. Un Un posible posible ejemplo ejemplo de de interacción interacción cliente/servidor se muestra aa continuación: continuación: Para consultar puntuaciones: Cliente: Cliente;

326

PUNTUACIONES\n puntuacionesXü

Internet: sockets, http y servicios web Servidor: Servidor:

19000 Pedro Perez\n 117500 7500 María Suarez\n 113000 3000 Juan Garcla\n Garcia\n

Para almacenar puntuaciones: puntuaciones; Cliente: Cliente:

32000 Eva Gutierrez\n

Servidor:

OK\n

En segundo lugar, lugar, hay que elegir un número de puerto para realizar la el1234. comunicación; comunicación; por ejemplo el 1234.

^

Ejercicio paso a paso: Almacenando las puntuaciones mediante un protocolo basado en sockets.

1.

... / Crea un nuevo proyecto Java para el servidor (Archivo/Nuevo/Proyecto (Archivo/Nuevo/Proyecto.../ Proyecto Java) con nombre ServidorPuntuacionesSocket.

2.

Pulsa con el botón derecho en la carpeta src de este proyecto y selecciona Nueva/Clase. Nueva/Clase. Introduce como nombre ServidorPuntuaciones. ServidorPuntuaciones.

3.

Remplaza en código por el que se muestra a continuación: pu bli c cl a s s ServidorPuntuacion es {{ public class ServidorPuntuaciones args [ ] ) { ppublic u blic static void main(String args[]) Vector puntuaciones = nnew e w Vector(); Vector (); try {{ rSocket ss = new n e w Serv erSocket (1234) (123 4 );,• Serve ServerSocket ServerSocket System. out .println .pri n t ln("Esperando conexion es .. . "); ( "Esperando conexiones..; while (true) (true ) {{ cliente= s.accept(); Socket cliente = s.acceptO; BufferedReader entrada = new BufferedReader( new InputStreamReader(cliente.getlnputStreamO)); Input StreamReade r (clie nte.getinputStream())); PrintWriter( PrintWriter salida = new PrintW riter( new OutputStreamWriter(cliente.getOutputStreamO), OutputStreamWriter(cliente.getOutputStream()) , true ); true); String St r ing datos dat o s = entrada.readLine(); e nt r ada.readLine (); if (datos . e quals(" PUNTUACIONES" )){ i f (datos.equals("PUNTUACIONES")){ n
} } else {{ puntuac iones.add( O, ddatos); atos ); puntuaciones.add(0, sal i d a. p ri nt l n( "OK" ); salida.println("OK"); 327

El gran libro de Android cliente.close(); cliente.cióse();

} catch (IOException (lOException e) e) { System. out. println(e); System.out.println(e);

4.

Ejecuta el proyecto proyecto como como Aplicación Aplicación Java. Java.

5.

Verifica que en la ... " la vista vista Consola Consola aparece: aparece: "Esperando "Esperando conexiones conexiones..."

6.

Cambia la perspectiva perspectiva aa modo modo Debug Debug yy Observa Observa lala vista vista de de lala esquina esquina superior izquierda.

-Debug " _ ■ :Z°. 11J Servidqrf>untuaciones q} S ServibofPumuactones {1} [Java [Java AppiJqtiqn] Appiícation] Jll «fi C:\Program C\Prograrn Files Files (x86)\Java~r~\bin\j~vaw.exe Íx88>\j3va\¡re6\bin\jai/aw.exe(03!02/2012 (03/02/201220:50:53) 20:50:53)

Desde esta vista podrás podrás detener detener la la aplicación aplicación pulsando pulsandoelel cuadro cuadrorojo. rojo.

NOTA: Si ejecutas de de nuevo nuevo la la aplicación aplicación dará dará un un error. error. Esto Esto es es debido debidoaaque quelala aplicación ya lanzada lanzada no no es es detenida detenidayy esta esta aplicación aplicacióntiene tieneasociado asociadoelelpuerto puerto1234. 1234. El sistema no permitirá permitirá que que una una nueva nueva aplicación aplicación escuche escucheeste estepuerto. puerto. 7.

Abre el proyecto proyecto Asteroides Asteroides yy crea crea lala siguiente siguiente clase: clase: public class AlmacenPuntuacione sSocket implementa AlmacenPuntuacionesSocket implements AlmacenPuntuaciones{ AlmacenPuntuaciones{ public void guardarPuntuacion(int { guardarPuntuacion(int puntos, puntos, String String nombre, nombre, long long fecha) fecha){ try {{ Socket sk == new X.X.X.X ", 1234); new Socket(" Socket("X.X.X.X", 1234); BufferedReader entrad a = entrada = new new BufferedReader( BufferedReader( new InputStreamReader(sk.getlnputStream())); InputStreamReader(sk.getInputStream())); PrintWriter salida salida == new new PrintWriter( PrintWriter( new OutputStreamWriter(sk.getOutputStream()) ,true); OutputStreamWriter(sk.getOutputStreamO),true); salida.println(puntos salida.printlnfpuntos ++ "" "" ++ nombre); nombre); String respuesta = entrada.readLine(); entrada.readLine(); if (!respuesta.equals("OK" (!respuesta.equals(" OK")) )) {{ Log. e ( 11 Ast.eroides n, 11"Error: Error : rrespuesta espuest.a de r Log.e("Asteroides", de sex:vido servidor incorrecta" ); incorrecta"); sk. e lose () ; sk.cióse(); } catch (Exception e) e) {{ Log.e("As teroides" , e. toString(), e); Log.e("Asteroides", e.toString{), e);

328

Internet: hHp yy servicios servicios web web Internet; sockets, http public Vector listaPuntuaciones(int listaPuntuaciones(int cantidad) cantidad} { Vector result result == new new Vector(); Vector(}; try {{ Socket sk == new Socket("X.X.X.X", Socket( "X.X . X . X" , 1234); 1234}; BufferedReader entrada entrada == new new BufferedReader( BufferedReader( new InputStreamReader(sk.getlnputStream())); InputStreamReader(sk.getinputStream(}}}; PrintWriter salida == new new PrintWriter( PrintWriter( new OutputStreamWriter(sk.getOutputStreamO),true); OutputStreamWriter(sk.getüutputStream(}} ,true}; salida.println("PUNTUACIONES" }; salida.println("PUNTUACIONES"); int n = 0; O; String respuesta; do {{ respuesta= entrada . readLine(}; respuesta = entrada.readLine(); i£ (respuesta != if != nuil) null} {{ result.add(respuesta}; result.add(respuesta); n++ ; n++;

} } while (n << cantidad cantidad && && respuesta respuesta != != nuil); null}; sk.close(}; sk.cióse(); e} {{ } catch (Exception e) Log.e("Asteroides", e.toString(}, e) e};; Log.e("Asteroides", e.toString(), } return result;

8.

} } Has de de sustituir sustituir las las dos dos apariciones apanc1ones de de "x.x.x.x" "X. x.x . x" por por lala dirección dirección IP IP donde esté ejecutándose el el servidor. servidor.

NOTA: El comando ipconf ig (Windows) te ipconfig te permite permite averiguar averiguar la la dirección dirección 1P IPde de tutu como IP IP 127.0.0.1 127.0.0.1 (localhost) (localhost) dado dado que, que, aunque aunquese seejecuten ejecutenen en ordenador. No utilices como la misma máquina, la IP IP del emulador emulador es es diferente diferente aa la la del del PC. PC. 9.

También has has de de recordar recordar que que ahora ahora la la aplicación aplicación Asteroides Asteroides necesita necesita elel permiso internet. INTERNET.

Ejecuta Asteroides 10. Ejecuta Asteroides yy accede accede aa visualizar visualizar la la lista lista de de puntuaciones puntuaciones yy luego luego echa una partida nueva. nueva. 11.. Verifica que 11 que en en la la vista vista Consola Consola aparecen aparecen las las consultas. consultas.

12. Para terminar, reemplaza reemplaza la la IP IP por por la la siguiente siguiente "158.42.146.127" "158.42.146.127" para para servidor compartido, compartido. conectarte a un servidor NOTA: Es posible que este este servicio servicio no no hoya haya sido sido iniciado. iniciado. 13. Comprueba si otros 13. otros usuarios usuarios han han accedido accedido aa este este servidor servidor yy aparecen aparecen sus sus puntuaciones.

329

El gran libro de Android Androíd

Preguntas de repaso yy reflexión: reflexión: El El interfaz interfaz socket. socket. 10.2. La web web y y el el protocolo protocolo HTTP HTTP 1 0.2. La Dentro del mundo de Internet Internet destaca destaca una una aplicación, aplicación, que que es es con con mucho mucho lalamás más utilizada: Word Wide Web Web o, o, coloquialmente, coloquialmente, WWW; WWW; nos nos referiremos referiremos aa esta esta aplicación como la Web. Web. Su Su gran gran éxito éxito se se debe debe aa lala facilidad facilidad de de uso, uso, dado dadoque que simplifica el acceso aa todo todo tipo tipo de de información información yy aa que que esta esta información información es es presentada de forma forma atractiva. atractiva. Básicamente, Básicamente, lala web web nos nos ofrece ofrece un un servicio servicio de de distribuida en en miles miles de de servidores servidores en en todo todo Internet, Internet, que quenos nos acceso a información distribuida permite ir navegando por por todo todo tipo tipo de de documentos documentos multimedia multimedia gracias graciasaaun unsencillo sencillo sistema de hipervínculos. Para la comunicación entre entre los los clientes clientes yy los los servidores servidores de de esta esta aplicación, aplicación, se se emplea el protocolo HTTP HTTP (HyperText {HyperText Transfer Transfer Protocof) Protocoí) que que será será elel objeto objeto de de estudio de este apartado.

10.2.1.

El protocolo protocolo HTTP HTTP

HTTP es un sencillo protocolo protocolo cliente-servidor cliente-servidor que que articula articula los los intercambios intercambios de de información entre los los navegadores navegadores web web yy los los servidores servidoresweb. web. Fue Fuepropuesto propuestopor porTim Tim Berners-Lee, atendiendo aa las las necesidades necesidades de de un un sistema sistema global global de dedistribución distribuciónde de información como la la World World Wide Wide Web. Web. En En la la web web los los servidores servidores han hande deescuchar escucharen en el puerto 80, esperando la la conexión conexión de de algún algún cliente clienteWeb Web..

.. -......

~,,,.

~~~ Poli[Media]:

Poli Media : El El protocolo protocolo http. http.

A continuación describimos los los pasos pasos habituales habituales que que se se siguen siguen en en un un ejemplo ejemplo de interacción en este protocolo: protocolo: 1) El usuario quiere acceder acceder aa la la página página http://www.upv.es/dir/pag.html. http://www.upv.es/dir/paq.html.Para Para lo cual pulsa en un un enlace enlace de de un un documento documento HTML HTML oo lala introduce introduce directamente en el campo campo Dirección Dirección del del navegador navegadorWeb. Web. 2) El navegador averigua averigua la la dirección dirección IP IP de de www.upv.es. www.upv.es. 3) El navegador establece establece una una conexión conexión con con elel puerto puerto80 80de deesta estaIP. IP. 4) El navegador envía envía por por esta esta conexión conexión (.J (J carácter carácterde desalto saltode delínea): línea): GET //dir/pag.html d i r/pag.html .JJ 5) El servidor envía la la página página aa través través de de lala conexión: conexión: .J J d rEAD > J .J .JJ Página dde

330

Internet: hHp yy servicios servicios web web Internet; sockets, htlp

6) El servidor cierra la la conexión. conexión. Este proceso se repite repite cada cada vez vez que que el el navegador navegador necesita necesita un un fichero fichero del del servidor. se ha ha bajado bajado un un documento documento HTML HTML en en cuyo cuyo interior interior están están servidor. Por ejemplo, si se se repite repite un un total total de de cinco cinco veces, veces, insertadas cuatro imágenes, imágenes, el el proceso proceso anterior anterior se documento HTML HTML yy cuatro una para el documento cuatro para para las las imágenes. imágenes. un protocolo protocolo sin sin estado. estado. Cada Cada petición petición contiene contiene lala Como ves, se trata de de un información necesaria para para ser ser atendida. atendida. Si Si deseamos deseamos mantener mantener un un estado estado tendrá tendrá que ser implementado usando usando algún algún mecanismo mecanismo adicional adicional (por (porejemplo ejemplo las lascookies). cookies).

11 1.

Ejercicio paso aa paso: Estudio Estudio del del protocolo protocolo HTTP HTTP utilizando utilizando el comando telnet. Abre un navegador navegador web web yy accede accede aa la la página: página: (en (en caso caso de de que que elel servidor servidorno no responda, puedes realizar el el ejercicio ejercicio con con cualquier cualquier página página de de otro otro servidor). servidor). El carácter ~ - se obtiene obtiene pulsando pulsando simultáneamente simultáneamente Gr> yy <4>, <4>. http: 1/www. dcomq. upv. es/ -·j tomas/corta.html tomas/corta. html http://www.dcomg.upv.es/~j

2.

Visualiza el contenido contenido HTML HTML de de la la página página (menú (menú "Ver/Código "Ver/Código fuente", fuente", "Herramientas/ Ver código fuente", fuente", oo similar). similar).

3.

Desde un intérprete intérprete de de comandos comandos (símbolo (símbolo del del sistema/shell) sistema/shell) escribe: escribe: t.elnet wivw.dcorag.upv.es www.dcomg . upv . es 80 80 telnet.

Este comando permite permite establecer establecer una una conexión conexión TCP TCP con con el el puerto puerto 80 80 del del servidor. A partir de de ahora ahora todo todo lo lo que que escribas escribas será será enviado enviado alal servidor servidor (aunque en muchos casos no no lo lo veas veas en en pantalla) pantalla) yy todo todo lo lo que que el el servidor servidor envíe será impreso impreso en en pantalla. pantalla.

NOTA: Windows 77 tiene desactivado por por defecto defecto el elcomando comando Telnet. Telnet.Para Parahabilitarlo: habilitarlo: SlSin Tur n Windows fealures on or off i To íurn a feature on, setect ta check box To turn s feature off, ctesr ta check box. A írlfed bca means that onfy part of íhe f estufe is íumed on. Print and Doeunient S í RAS Connection Mj | .Remote Orfferentiat | i SÍP Listener Please waít whíie Windows makes changas to j Services f or NFS i Stmpk Network | features. This might take severa! minutes. j Simple TCPP servic | : Sub&ystem for ÜWIX | : Tabiet PC Componi | : Telret Client | ; Telret Ser/er L.TFIP.aietó

331

Android El gran libro de Android Instrucciones: programas. losprogramas. Todos los control>Todos de control> Panel de Inicio>Panel Clic en el menú lnicio>

hay (sihay Telnet(si ciiemeTelnet eldiente (marca) el selecciona (marca) Windows, selecciona de Windows, característica de Haz clic en la curva característica seleccionarlas). puedes seleccionarlas). p ermitirpuedes diferentes servicios que desees permitir diforentes componenteaa agregarelelcomponente de agregar después de reiniciar después que reiniciar tengas que que tengas Haz clic en Aceptar (puede que efocto). surtan efecto). fin de que los cambios surtan

4. 4.

exactamente: teclea exactamente: conexión teclea la conexión establezca la Cuando se establezca

GET /~jtomas/corta.htmU /- jtomas /co rta.html.J ejercicio repite elel ejercicio caso, repite tal caso, En tal borrar. En Si te equivocas no uses de borrar. tecla de la tecla uses la 3. desde el punto 3. 5.

10.2.2. 0.2.2. 1

del HTML del contenido HTML con elel contenido coincide con obtenida coincide respuesta obtenida la respuesta Observa que la apartado 2.

HTTP protocolo HTTP del protocolo 1.0 del Versión Versión 1.0

ampliar deampliar necesidad de vio lala necesidad se vio pronto se WV\NV, pronto aplicación WW\A/, la aplicación de la Con la popularización de versión definió lala versión Se definió funcionalidades. Se nuevas funcionalidades. permitir nuevas para permitir protocolo para este sencillo protocolo permitirelel de permitir además de POST,..) además (PUT, POST,..) métodos (PUT, nuevos métodos añadía nuevos 1.0 del protocolo que añadía servidor . cliente yy servidor. entre cliente intercambio de cabeceras entre

........

't~-"A'...

v1 .0. HTTP v1.0. protocolo HTTP Rol i [Media]: El protocolo Poli[Media]:

•

1.0: versión 1.0: para lala versión interacción para de interacción ejemplo de un ejemplo muestra un A continuación se muestra

Cliente: Cliente :

HTTP/1.0 J.J / d i:c/ p ag . ht:m.l HTTP/1.0 GET /dir/pag.html _¡ v3. 2 «J Explorer v3.2 Internet Explorer User - Agent: Internet Üser-Agent: ,J mi._ ordenador . u pv . e¡; J Host: mi_ordenad.or.upv.es i mageí:jpeg J.J Accspt: image/gif, irnage/jpeg t:ext/htm.l, image/gif, Accept : text/html, J < enhlanco> .J Servidor: http/i.i .J OK j 200 ok HTTPí.l.l 200 .J Server; Microsoft-IIS/5.0 Microsoft-IIS/5.0 J Server: GMT J.J 15:49:22 GMT 2002 15:49:22 Feb 2002 25 Feb Last-Modified; Mon, 25 Last - Modified: Mon, t:ext/htm.l.J Con tent-Type: text/htmlj Content-Type: blanco> d < enblanco .J .J < HTML > J .J d lEAD> J .J c/TITLE> J cTITLE>Pági n a de ...