Proyecto ejemplo con Android Studio

En este tutorial, describiremos un proyecto Android que permite implementar una pantalla de presentación, además de añadir una librería para la creación de un archivo pdf en el directorio interno de descargas del dispositivo, a partir de los datos mostrados por pantalla. Todo esto se realizará con el nuevo IDE Android Studio 1.0.

El objetivo de este proyecto no es detallar el proceso de creación de un archivo pdf, sino presentar algunas funcionalidades que nos permitan una mayor adaptación al entorno Android Studio, centrándose principalmente en el proceso de añadir dependencias a un proyecto (en este ejemplo el uso de una librería para crear ficheros con extensión pdf).

Para desarrollar este caso práctico utilizaremos un proyecto de ejemplo, que permitirá, a partir de una serie de datos inicializados de una agenda telefónica (tipo, número y datos de contacto telefónico), mostrarlos en un componente de tipo ListView, permitiendo al usuario seleccionar el contacto, mostrando en un campo auxiliar información complementaria del contacto seleccionado. Además, se implementa un componente de tipo Button, que permitirá la creación de un archivo pdf con los datos mostrados por pantalla.

Como siempre, puedes descargar todo el código de este proyecto, con el botón que aparece al final de esta publicación. También podrás ver este proyecto explicado en el próximo Video Premium de esta serie.

Se comenzará en primer lugar por enumerar los elementos necesarios para el desarrollo del proyecto denominado «ListaContactos»:

• Clase SplashScreenActivity, que herede de la clase base Activity, encargada de lanzar una pantalla de presentación al iniciar la aplicación, proporcionando una mayor inmersión del usuario en la aplicación.
• Clase MainActivity, que herede de la clase base Activity, encargada de mostrar los contactos almacenados en un componente de tipo selección ListView.
• Clase Adaptador, que herede de la clase base ArrayAdapter, encargada de construir la vista de cada uno de los items que se mostrarán en el componente ListView.
• Clase Contacto (librería auxiliar), que permita crear nuevos objetos Contacto, formado por los métodos getters y setters (métodos de acceso a propiedades).
• Layout activity_main.xml, formado por un componente de tipo selección ListView, encargado de mostrar los contactos almacenados, un componente de tipo EditText que permitirá mostrar datos complementarios del ítem seleccionado por el usuario, y un componente de tipo Button, que posibilita la creación del fichero pdf.
• Layout itemcontacto.xml, que construirá la vista de cada ítem del componente ListView. Se definen dos componentes de tipo TextView.
• Layout activity_splash_screen.xml, formado por una componente de tipo ImageView, que mostrará el logotipo de la aplicación.
• Librería «droidText.0.4.jar», que permita la creación de un fichero pdf con los datos de contactos almacenados.

Documentación código fuente

ListaContactos\app\src\main\java\com\academiaandroid\listacontactos\MainActivity.java

Clase MainActivity

Hereda de la clase base Activity, encargada de mostrar los contactos almacenados en un componente de tipo selección ListView, y que permitirá, además de mostrar los datos del contacto al seleccionar un ítem de la lista, almacenar en un archivo con extensión .pdf, los datos de los contactos mostrados por pantalla, con tan solo pulsar el botón «Crear PDF».

Métodos que implementa

Evento onClick, que permite crear un archivo pdf con los datos de contacto mostrados por pantalla:

Añadir Splash Screen a un proyecto con Android Studio

1. En primer lugar será necesario crear una nueva Activity, a través de la ruta File > New… > Activity > Blank Activity, y definir tanto el nombre de la Activity como del layout.
2. Se deberá añadir un componente de tipo ImageView al layout creado, y asignarle una imagen en la propiedad «src»:
3. A continuación, dentro de la nueva clase SplashScreenActivity, se definirían las siguientes instrucciones:
   
   /*Clase SplashScreenActivity, que hereda de la clase base Activity, encargada de lanzar una pantalla de presentación al iniciar la aplicación.*/ public class SplashScreenActivity extends Activity { /*Variable que inicializa el tiempo de retraso que simulará la carga de la aplicación.*/ private static final long SPLASH_SCREEN_DELAY = 3000; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestWindowFeature(Window.FEATURE_NO_TITLE); setContentView(R.layout.activity_splash_screen); /*Se declara e inicializa la clase TimerTask, que permitirá lanzar una nueva Activity al finalizar el tiempo de espera, además de cerrar la Activity actual. */ TimerTask task = new TimerTask() { @Override public void run() { Intent intent = new Intent(SplashScreenActivity.this, MainActivity.class); startActivity(intent); finish(); } }; /*Se declara e inicializa la clase Timer, que posibilita la programación de la tarea a lanzar. El objeto creado, invocará al método schedule(), que recibirá entre sus parámetros la tarea a realizar y el tiempo de espera hasta la ejecución de dicha tarea.*/ Timer timer = new Timer(); timer.schedule(task, SPLASH_SCREEN_DELAY); } }

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

   /*Clase SplashScreenActivity, que hereda de la clase base Activity, encargada de lanzar una pantalla de presentación al iniciar la aplicación.*/ public class SplashScreenActivity extends Activity {       /*Variable que inicializa el tiempo de retraso que simulará la carga de la aplicación.*/     private static final long SPLASH_SCREEN_DELAY = 3000;       @Override     protected void onCreate(Bundle savedInstanceState) {         super.onCreate(savedInstanceState);         requestWindowFeature(Window.FEATURE_NO_TITLE);         setContentView(R.layout.activity_splash_screen);         /*Se declara e inicializa la clase TimerTask, que permitirá lanzar una nueva Activity al finalizar el tiempo de espera,         además de cerrar la Activity actual. */         TimerTask task = new TimerTask() {             @Override             public void run() {                 Intent intent = new Intent(SplashScreenActivity.this, MainActivity.class);                 startActivity(intent);                 finish();             }         };         /*Se declara e inicializa la clase Timer, que posibilita la programación de la tarea a lanzar.         El objeto creado, invocará al método schedule(), que recibirá entre sus parámetros la tarea a realizar         y el tiempo de espera hasta la ejecución de dicha tarea.*/         Timer timer = new Timer();         timer.schedule(task, SPLASH_SCREEN_DELAY);     } }

4. Por último, dentro del archivo AndroidManifest.xml, se deberá registrar la Activity como se muestra a continuación:
   
   [...] <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > [...] <activity android:name="com.academiaandroid.listacontactos.SplashScreenActivity" android:label="@string/title_activity_splash_screen" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <!--La siguiente línea es la que permite que la Activity que se inicie al ejecutar la aplicación sea SplashScreenActivity.java.--> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> [...]

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

   [...] <application     android:allowBackup="true"     android:icon="@drawable/ic_launcher"     android:label="@string/app_name"     android:theme="@style/AppTheme" >     [...]     <activity         android:name="com.academiaandroid.listacontactos.SplashScreenActivity"         android:label="@string/title_activity_splash_screen" >         <intent-filter>             <action android:name="android.intent.action.MAIN" />             <!--La siguiente línea es la que permite que la Activity             que se inicie al ejecutar la aplicación sea SplashScreenActivity.java.-->             <category android:name="android.intent.category.LAUNCHER" />         </intent-filter>     </activity> </application> [...]

Permisos para crear un fichero pdf

En la siguiente línea se proporcionan permisos de escritura para la aplicación, que permitirá la creación de un fichero pdf en la memoria externa del dispositivo.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

Monitorización de memoria:

Esta característica está disponible desde la opción Tools > Android > Memory Monitor. Dicha vista permite conectarse a una aplicación que se ejecuta en un dispositivo y controlar el uso de memoria en el tiempo.

En esta imagen se puede apreciar el consumo de memoria realizado por el proyecto de ejemplo, mostrando en todo momento la memoria libre y asignada.

Acceso a «File Explorer»

Para poder acceder a los directorios y carpetas del dispositivo, bastará con seleccionar el icono  denominado Android Device Monitor, que podrá encontrarse en las herramientas del IDE Android Studio. Al pulsar sobre dicho icono, mostrará la vista DDMS (Dalvik Debug Monitor Server) desde la que poder acceder a la ventana «File Explorer», y así descargar el archivo pdf creado con la aplicación:
 

Añadir dependencia a proyecto de ejemplo

Para el proyecto que se ha descrito, ha sido necesaria la implementación de la librería «droidText.0.4.jar», siguiendo los pasos que se comentan a continuación:

• Se selecciona el módulo «app» del proyecto «ListaContactos».
• A continuación, se pulsa sobre el módulo con el botón derecho del ratón, y se selecciona la opción «Open Module Settings».
• Con el módulo seleccionado en la parte izquierda de la pantalla, se pulsa en la pestaña «Dependencies«, y a continuación en el símbolo «+» situado a la derecha de la pantalla.
• Entre las opciones del menú contextual, se selecciona la opción «File dependency», y posteriormente, se localiza el archivo .jar en el directorio «libs» (para este ejemplo se trata de la librería «droidText.0.4.jar»).
• Una vez seleccionado, se podrá visualizar dentro del archivo «build.gradle» del módulo «app» la nueva dependencia añadida:

Nota: Para este proceso, previamente se ha copiado el archivo .jar dentro de la carpeta «libs» del módulo creado con el proyecto. Para obtener una visión más descriptiva del proceso, se recomienda revisar el tutorial»Añadir dependencias a proyecto en Android Studio«.

Descarga del Proyecto