domingo, 3 de agosto de 2014
Documentación y ApiDemos
Aunque en este libro vas a aprender mucho, resultaría imposible tocar todos los aspectos de Android y a 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:
…\adt-bundle-windows-…\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:
Muchos de los recursos utilizados en este libro puedes encontrarlos en:
Para resolver dudas puntuales sobre programación te recomendamos la Web de preguntas y respuestas:
La aplicación ApiDemos
Otra opción muy interesante para aprender nuevos aspectos de programación consiste en estudiar ejemplos. Con este propósito se ha incluido en el SDK de Android una aplicación, ApiDemos. Está formada por cientos de ejemplos, donde no solo podrás ver las funcionalidades disponibles en el API de Android, sino que además podrás estudiar su código.
Para crear un proyecto con esta aplicación sigue los siguientes pasos: Selecciona File > New > Project… e indica Android Sample Project. Pulsa Next y aparecerá un cuadro de diálogo similar al siguiente:
Has de seleccionar un nivel de API para crear el proyecto. A continuación selecciona uno de los proyectos de ejemplo: en nuestro caso ApiDemos. Pulsa Finish para crear el proyecto.
Si no ha habido ningún 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: 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: 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 envio de SMS.
Preference: Varios ejemplos de uso de preferencias.
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 gran cantidad de descendientes de esta clase para representar una interfaz gráfica (botones, cajas de texto, entradas...). Visualiza estos ejemplos para mostrar las diferentes posibilidades.
Una vez seleccionado un ejemplo, si quieres estudiar su código, búscalo en la carpeta src. Para organizar mejor el código se han creado diferentes espacios de nombre de paquetes.
NOTA: En algunas versiones del SDK, al compilar ApiDemos, aparecen errores de compilación. Para solucionarlo, puedes probar con otra versión de o intenta corregir los errores.
NOTA: Si cuando ejecutas la aplicación no te deja y te indica el siguiente error:
Ocurre porque una aplicación con el mismo nombre de paquete (com.example.android.apis) ya existe y además ha detectado que la aplicación ha sido firmada con un certificado digital diferente al que estáis utilizando vosotros. Si hubiera sido creado por el mismo desarrollador reemplazaría la aplicación ya instalada por la que queremos instalar.
Se soluciona desinstalando antes la aplicación. Tienes dos opciones:
- Como lo haces habitualmente en tu dispositivo: Ajustes/Aplicaciones/ ApiDemos/Desinstalar
- Desde la línea de comando:
adb uninstall com.example.android.apis
NOTA: Este mismo problema también te ocurrirá cuando tengas instalado el entorno de desarrollo (Eclipse) en dos PC. Cada entorno de desarrollo tiene un certificado digital diferente. Cuando trates de instalar una aplicación en tu dispositivo físico, te aparecerá un error, si la aplicación ya ha sido instalada con el otro entorno.
