Documentación y aplicaciones de ejemplo

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

Donde encontrar documentación

Puedes encontrarl una completa documentación del SDK localmente en:

…\sdk\docs\index.html

Se incluye la descripción de todas las clases (Develop > Reference), conceptos clave y otro tipo de recursos. Esta documentación también está disponible en línea a través de Internet:

http://developer.android.com/

Muchos de los recursos utilizados en este libro puedes encontrarlos en:

http://www.androidcurso.com/

Para resolver dudas puntuales sobre programación te recomendamos la Web de preguntas y respuestas:

http://stackoverflow.com/

Repositorio de ejemplos de GitHub

Otra opción muy interesante para aprender nuevos aspectos de programación consiste en estudiar ejemplos. Google ha preparado un repositorio de ejemplos en GitHub que pueden ser instalados desde Android Studio.

Ejercicio: Instalación de un ejemplo desde GitHub

1.     Selecciona File > New > Import Sample… Aparecerá la siguiente ventana:

Los proyectos se encuentran clasificados en categorías: Admin, Background, Connectivity, Content, Input, Media, Notification, … Selecciona un proyecto de alguna de estas categorías. A la derecha podrás leer una breve descripción o ver una vista previa. 

2.   Pulsa Next para pasar a la siguiente ventana. Podrás configurar el nombre de la aplicación, explorar el proyecto accediendo a su sitio web en GitHub e indicar la carpeta donde quieres descargarlo:  

3.   Pulsa Finish y a continuación ejecuta el proyecto seleccionado.

La aplicación ApiDemos

La aplicación ApiDemos suele estar instalada en mucho de los AVD. Está formada por cientos de ejemplos, donde no solo podrás ver las funcionalidades disponibles en la API de Android, sino que además podrás estudiar su código[1].
 

Ejercicio: Instalación de ApiDemos en Android Studio

Para crear un proyecto con la aplicación ApiDemos, sigue los siguientes pasos :

1.      Desde un dispositivo AVD abre API Demos. Los dispositivos con versión 7.0 suelen tener preistalada esta aplicación.

2.      Prueba algunos de los cientos de ejemplos que incorpora.

3.      Descarga el fichero siguiente y descomprime en una carpeta:

http://www.dcomg.upv.es/~jtomas/android/ficheros/ApiDemos22.zip

4.      Selecciona File > New > Import Project… y seleciona la carpeta.

5.      Una vez corregido algún pequeño error, ya puedes ejecutar ApiDemos. Verás como los diferentes ejemplos se organizan por carpetas. En el nivel superior tenemos:

Accessibility: Aspectos de accesibilidad, como trackball, touch o texto a voz.

Animation: Una gran variedad de efectos y animaciones.

App: Trabajando a nivel de aplicación con Activity, Alarm, Dialog, Service, etc.

Content: Describe cómo leer datos desde ficheros, recursos y archivos XML.

Graphics: Una gran cantidad de ejemplos gráficos tanto en 2D como en 3D.

Media: Reproducción de audio y vídeo con las clases MediaPlayer y VideoView.

NFC: Ejemplos de uso de Near Field Communication.

OS: Servicios del sistema operativo. Incluye sensores, vibrador o envío de SMS.

Preference: Varios ejemplos de uso de preferencias.

Security: Contiene un ejemplo sobre encriptación.

Text: Diferentes ejemplos de manipulación y visualización de texto.

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

6.     Prueba alguna de la demo que se incluye. Luego resulta sencillo localizar la clase Java que la implementa, buscando en el explorador del proyecto.
[1] https://github.com/android/platform_development/tree/master/samples/ApiDemos