Última revisión de 13:45 11 nov 2013

Trabajo en proceso, espera cambios frecuentes. Tu ayuda y retroalimentación son bienvenidos. Ver página de charlas.

DESARROLLO DE APLICACIONES CON ANDROID SDK

Contenido

• 1 ¡Bienvenido a este curso!
• 2 Preparar la apalicación
  • 2.1 La clase diálogo
  • 2.2 La clase VentanaDialogo solo un botón
    • 2.2.1 AlertDialog
  • 2.3 Añadiendo mas botones
    • 2.3.1 Pasando información entre las clases
      • 2.3.1.1 Clase Bundle
    • 2.3.2 Opciones de tipo ratio
    • 2.3.3 checkButton como opciones
  • 2.4 Ficheros con lo visto hasta ahora
  • 2.5 ProgressDialog
    • 2.5.1 Barra de progreso circular
    • 2.5.2 Barra de progreso horizontal
  • 2.6 DatePickerDialog
  • 2.7 TimePickerDialog

¡Bienvenido a este curso!

Ejemplos bá.sicos

Primera aplicación  | Cajas de dialogo | Un ejemplo de cajas de dialogo  | Volver

Preparar la apalicación

• Vamos a realizar una app, en la que vamos a usar la forma recomendada para abrir la ventanas de diálogo
• Para realizar este tipo de acciones tenemos dos opciones. Una de ellas ya está depreciate y se recomienda usar fragment
• En este caso lo vamos a hacer con fragment, concretamente heredando de la clase DialogFragment. Al final de este tema pondré el código de como hacerlo de la otra manera que en principio es más sencilla, pero menos flexible.

La clase diálogo

Nuestra aplicación va a constar de dos clases

1. la activity que va a ser nuestra pantalla con los botones
2. La ventana diálogo que en función del botón que presionemos visualizará una ventana de diálogo u otra

La clase VentanaDialogo solo un botón

• La clase VentanaDialogo va a ser un Fragment especializado DialogFrament
• Como todo Fragment a la hora de ser ejecutado dependera de una Activity que inicia su ciclo de vida
• Los métodos callback que se ejecutan cuando se inicia el DialogFragment son onCreateDialog() y onCreateView()

• Si vamos a usar una clase ya existen (AlerteDialog, ...), se escribe el código en onCreateDialog(), sin embargo si fuéramos a realizar una caja de diálogo personalizada donde tuviéramos que definirnos un layout, podríamos sobreescribir el callback onCreteView().
• Escribamos el código para visualizar una caja de diálogo ya establecida AlertDialog()

   public Dialog onCreateDialog(Bundle instancia) {
 
     /*Creamos un objeto de la clase AlertDialog (nuestra caja de dialogo prediseñada*/	
      AlertDialog msj = new AlertDialog.Builder(getActivity());
 
      /*Le damos propiedades según nuetra conveniencia, la personalizamos*/
      msj.setTitle(titulo)
       	   .setMessage(mensaje)
	   .setPositiveButton("OK",new DialogInterface.OnClickListener() {
	    @Override
		public void onClick(DialogInterface dialog, int which) {
				// TODO Auto-generated method stub
				((Dialogo)getActivity()).opcionSI(tipo);
		}
	   });
        /*Voy debugando en el LogCat */
	Log.i("Depurando","Alert Dialog configurado ");
 
        /*Retorno mi caja de diálogo*/
        return msj.create();
   }

• En el cuerpo creamos un objeto de la clase AlertDialog, que explicamos en la siguiente sección, pero como vemos en la imagen es una clase que extiende de Dialog

• Este médoto devuelve un objeto de la clase Dialog que nos retorna el método create de nuestro AlertDialog creado con AlertDialog.Builder

Veamos el código de setPositiveButton(...)

setPositiveButton(CharSequence texto, DialogInterface.OnClickListener listener)

Los paŕametros

1. texto es un CharSequence que establecerça el texto del botón
2. lisener es un objeto listener que escuchará el objeto evento generado, cuando hagamos un click en el botón.

• Este listener es una implementación de la interfaz DialogInterface
• Para crear una instancia de la implementación de la interfaz lo hacemos invocando al método OnClickListnener()
• Como implementamos la interfaz debemos sobreescribier su método onClick()
• El método onClick()recibe dos parámetros:

1. El objeto Dialog que ha generado el evento.
2. un entero que identifica el botón que ha generado el evento (útil si puedo tener varios botones como en el caso de un ratio o un check, que veremos posteriormente).

El cuerpo del bucle

     ((Dialogo)getActivity()).opcionSI(tipo);

• Lo que hacemos es invocar al método opcionSI() que está en la clase Dialogo (la otra de nuestro ejemplo).
• Como estamos en un Fragment, éste para entrar en ejecución depende de una Activity que la ha invocado, siempre podemos acceder a dicha Activity con el método getActivity() de la clase Fragment correspondiente.
• No olvidemos que un DialogFragment es un Fragment.
• Siempre Hemos de hacer un cast al tipo concreto de Activity que vamos a obtener con el método getActivity() en este caso nuestro Dialogo

AlertDialog

• Es una clase que hereda de Dialog y tiene ya un layout establecido la cual se adapta visualmente en fución de que asignemos valores a propidades de la clase
• Una vez creado el objeto le damos las propiedades que necesarias
• Los métodos que asignas propiedades son muy intuitivos, y permiten asignar

1. Un título setTitle
2. Un mensaje de texto
3. Uno, dos o tres botones
4. Una lista de items seleccionables, opcionalmente con casilla de verificación (puedo seleccionar varios-checkButtons) u opciones excluyentes (radio buttons).
5. El método setCancelable(boolean) convierte la ventana de dialogo en modal respecto al botón de retroceso

• Observar que para dar las diferentes propiedades puedo hacerlo seguido

objeto.propiedad1()
     .propiedad2()
     ....
     .propiedadn();

• De igual forma que hemos visto los métodos anteriores tenemos disponibles otras opciones

     AlertDialog.Buider.setNegativeButton(CharSequence titulo, DialogInterface.OnClickListener(..));
     AlertDialog.Buider.setNeutralButton.(CharSequence titulo, DialogInterface.OnClickListener(..));

Añadiendo mas botones

• Vamos a preparar nuestra aplicación para visualcizar diferentes cajas de diálogo.
• Queremos tener en la clase Dialogo (Recordemos que es nuestra Activity), una interfaz con tantos botones como cajas de diálogo diferentes queremos que nos visualice nuestra app.

En concreto vamos a hacer una app que nos visualice hasta 9 cajas de diálogo diferentes según vamos a ir viendo.

La dinámica de nuestra aplicación va a ser la siguiente

1. Al arrancar la app se visualizará la interfaz de la Activity Dialogo (imagen anterior).
2. Presionaremos un botón.
3. Creamos un objeto de la clase VentanaDialogo
4. En función del botón presionado se preparará la caja de diálogo con una u otra información.
5. Se visualizará la caja de diálogo donde podremos botones y/o opciones para seleccionar.
6. Una vez tomada una opción de la ventana de diálogo haremos algo que visualice la opción tomada, o simplemente visualizaremos el diálogo como en el caso de barra de progreso

• La siguiente imagen intenta ilustrar con un sencillo diagrama de transición la relación entre las clases

A continuación vamos a ver como abordamos cada una de las cuestiones anteriores

Pasando información entre las clases

• Primero vemos cómo asociar los valores a la clase
• A continuación como leer los valores desde la clase

Poniendo los valores

• El primero paso es crear un objeto de la clase VentanaDialogo y de alguna forma le hemos de pasar información para que sepa ese objeto qué botón de los 10 que tenemos lo ha creado.
• Para ello podríamos usar un constructor, pero en android cuando una activity u otro tipo de app javase carga en la pila de ejecución tiene un ciclo de vida. Esto hace que el método callback onCreate() u otro que sepamos que se ejecuta cuando se crea el objeto de la clase realice todo lo que queremos que ocurra cuando se instancia un objeto de la clase. Por este mot aivo no se suelen usar constructores en android, aunque sí que se podría. Pero no sería el primer método que se ejecutaría al instanciar el objeto de la clase.
• Para pasar parámetros entre clases en android podemos usar un método estático en la clase a la que queremos pasar parámetros
• En nuestro caso en la clase VentanaDialogo.
  • Será un método estático para que lo pueda invocar antes de crear el objeto
  • Este mismo método me generará un objeto de la clase y me lo retornará
  • Dentro de él crearemos un objeto de la clase Bundle (ver sección siguiente), y le pasamos los parámetros

	public static VentanaDialogo inicializaVentana(int tipo, String titulo, String mensaje){
		Log.i("inicializaVentana","haciendo poco");
		VentanaDialogo v = new VentanaDialogo();
		Bundle parametros = new Bundle();
		Log.i("Depurando","en el estatico de inicializaVentana");
		parametros.putInt("tipo",tipo);
		parametros.putString("titulo",titulo);
    	        parametros.putString("mensaje",mensaje);
		v.setArguments(parametros);
		return v;
	}

• En nuestro caso queremos pasar dos valores
• tipo es entero que representará el botón que hemos presionado usaremos la lista expuesta a continuación
• título es un String que va a ser el título de la caja de diálogo (todas las cajas de diálogo tendrán un título

   final int ALERTAOK = 1;
   final int ALERTASINO = 2;
   final int ALERTASINOCANCEL = 3;
   final int ALERTARATIO = 4;
   final int ALERTACHECK= 5;
   final int BARRAPROGRESO1 = 6;
   final int BARRAPROGRESO2 = 7;
   final int DIALOGOHORA = 8;
   final int DIALOGOFECHA = 9;

• Ahora queda poner los valores, lo debe de hacer la clase Dialogo cuando declara un objeto de la clase VentanaDialogo, veámoslo en el código

 public void clickOk (View v){
	VentanaDialogo mensaje=VentanaDialogo.inicializaVentana(ALERTAOK,"INFORMACION","Acepta esta opción");
         .....
  }

Leyendo los valores

• Ahora en la clase VentanaDialogo debemos leer estos valores
• Ello lo haremos dentro del método de Callback que se ejecuta cuando el objeto entra en ejecución en este caso en onCreateDialog(...)
• Para ello usamos el método Bundle getArgument() de la clase Fragment que retorna los argumentos que se pasan a un Fragement cuando este ha sido instanciado con ellos. Nos retorna un Bundle
• Posteriormente usaremos los métodos getxxx(etiqueta, valor), complementarios a los setxxx(etiquet, valor) usados para pasar los valores
• como se puede ver en el código se puede hacer en una línea.

	String titulo = getArguments().getString("titulo");
	int tipo = getArguments().getInt("tipo");

• De esta forma ya tenemos el tipo de botón que ha presionado la acción, ahora discretizamos con un switch

@Override
public Dialog onCreateDialog(Bundle instancia) {
.....
	String titulo = getArguments().getString("titulo");
	int tipo = getArguments().getInt("tipo");
....
   switch (tipo){
	case ALERTAOK://Ventana tipo OK
		Log.i("Depurando","En on CreateDialog CAso 1 ");
		alertaOk();
                .....
	case ALERTASINO://Ventana tipo SI NO
		alertaSiNo();
                .....
	case ALERTASINOCANCEL://Ventana de tipo Si NO CANCEL
		alertaSiNoCancel();
                ..... 
	case ALERTARATIO://Ventana de tipo opciones Ratio
		Log.i("VentanaDialogo","en el switch caso 4");
		alertaOpcionesRatio();
                ..... 
	case ALERTACHECK://Ventana de tipo Opciones Check
		alertaOpcionesCheck();
                ..... 
	case BARRAPROGRESO1:
		Log.i("OnCreateDialog","Dentro de opcion 6 antes de ir al progress");
		progress1();
                ..... 
	case BARRAPROGRESO2:
		progress2();
                ..... 
	case DIALOGOHORA:
		alertaHora();
                ..... 
	case DIALOGOFECHA:
		alertaFecha();
                ..... 
	}
                ..... 
}

Clase Bundle

• Esta clase va a permitir pasar datos entre diferentes activity y/o Framgment
• Esta clase implementa la interfaz Parcelable y Ser
• La forma de hacerlo es la siguiente:

1. Creamos un objeto de la clase Bundle
2. Usando los métodos putxxx(etiqueta, valor), vamos preparando parejas etiqueta-valor para pasar a un objeto activity o fragment
3. No vamos a poder pasar objetos complejos, sí tipo privitivos.
4. Una vez que hayamos terminado de confeccionar todas las parejas etiqueta-valor con los métodos putxxx, asociamos el Bundle a clase Activity o Fragment que le queremos asociar el valor, con el método setArguments(Bundle) de la clase Activity o Fragment.
5. Y ya está, luego en la clase podremos recuperar estos valores.

Opciones de tipo ratio

• Tenemos diferentes opciones y queremos seleccionar solo una
• En este caso usaremos el método setSingleChoiceItems(charSequence[] lista,int item_seleccionado,listener)
• Observamos el botón correspondiente para esta accion
• El código siguiente visualiza como adaptar un AlertDialog a este tipo de opciones

private void alertaOpcionesRatio() {
		// TODO Auto-generated method stub
       	CharSequence[] sexo={"Hombre","Mujer","Prefiero no contestar"};
        AlertDialog msj =  AlertDialog.Builder(getActivity());
	msj.setTitle(titulo)
	   .setSingleChoiceItems(sexo,-1,new DialogInterface.OnClickListener() {
		@Override
		public void onClick(DialogInterface dialog, int elemento) {
			// TODO Auto-generated method stub
 
			((Dialogo)getActivity()).opcionRatio(sexo[elemento]);
		}
	});
	}

• El método opcionRatio(String opcion) es un método de la clase Dialogo al que pasamos la opcion seleccionada
• En nuestro caso lo único que hace es visualizar la opción

public void opcionRatio(CharSequence elemento) {
	// TODO Auto-generated method stb
	Toast.makeText(this,"Ha seleccionado la opcion "+elemento,Toast.LENGTH_SHORT).show();
}

checkButton como opciones

• Tenemos diferentes opciones y queremos seleccionar algunas de ellas
• En ella el usuario debe checkear distintas opciones (seleccionar idiomas)
• En este caso debemos invocar al método setMultiChoiceItems
• Este método le pasamos el vector de opciones, un vector de boolenos que nos dice cada opción si está o no seleccionada y un listener.

private void alertaOpcionesCheck() {
	// TODO Auto-generated method stub
        CharSequence[] idiomas={"Español","Inglés","Alemán","Rumano"};
	boolean []idiomasSeleccionados = new boolean[idiomas.length];
        AlertDialog msj =  AlertDialog.Builder(getActivity());
	msj.setTitle(titulo)
	   .setMultiChoiceItems(idiomas, idiomasSeleccionados, new DialogInterface.OnMultiChoiceClickListener() {
		@Override
		public void onClick(DialogInterface dialog, int which, boolean isChecked) {
			// TODO Auto-generated method stub
		((Dialogo)getActivity()).opcionCheck(idiomas,idiomasSeleccionados);
 
		}
}

• En este caso al método setMultiChoiceItems(...) le pasamos tres parámetros

1. idiomas que es el vector de opciones que queremos visualizar
2. idiomasSeleccionados es un vector de booleanos que muestra si cada opción está o no seleccionada
3. Una instancia de una clase listener para escuchar los objetos eventos generados por cualquier botón de las opciones

• De nuevo invocamos a un método de la clase Dialogo opcionCheck(...), al que pasamos el vector de idiomas y el de booneanos.
• El cuerpo del bucle quedaría

public void opcionCheck(CharSequence[] idiomas, boolean[] idiomasSeleccionados) {
	// TODO Auto-generated method stub
	String msj;
	msj = "Idiomas seleccionados: \n";
	for (int i=0; i<idiomas.length;i++)
		if (idiomasSeleccionados[i])
			msj+=idiomas[i]+"\n";
	Toast.makeText(this, msj,Toast.LENGTH_SHORT).show();
}
</sourece>
===Ventana dialogo con direfentes opciones===
*Es una alternativa a visualizar el radio, en cuanto el usuario seleciona uno ya queda seleccionado
*En este caso añadimos el método setItems, en lugar de setMessage
*El método setItems como primer parámetro le pasaremos un vector de charSequences y el segundo es un listener
*Vemos el código
<source lang=java>
public void clickMsgOpciones(View v){
 
       AlertDialog.Builder caja = new AlertDialog.Builder(this);
       caja.setTitle("Indica sexo")
           .setItems(sexo, new DialogInterface.OnClickListener() {
		 	uublic void onClick(DialogInterface dialog, int elemento) {
			// TODO Auto-generated method stub
			      Toast t = Toast.makeText(getApplicationContext(), "Has seleccionado "+sexo[elemento],Toast.LENGTH_LONG);
			      t.show();
			      dialog.cancel();
		       }
		 	});
      AlertDialog alert = caja.create();
      alert.show();
}

Ficheros con lo visto hasta ahora

• Se pueden descargar los ficheros de lo hecho hasta ahora

1. La clase Dialogo.java Archivo:Dialogo.pdf
2. La clase VentanaDialogo.java Archivo:VentanaDialogo.pdf

ProgressDialog

Barra de progreso circular

Barra de progreso horizontal

• Ahora le diremos que el objeto que tiene la forma horizontal de línea
• En este caso tenemos una barra que se va rellenando
• Esto implica que el progreso tendrá un valor inicial e irá modificando hasta llegar a estar totalmente rellena
• Vamos a añadir un botón para cancelar

DatePickerDialog

TimePickerDialog