Notepad Tutorial - Ejercicio 2

Ejercicio 2

En este ejercicio añadiremos una segunda Activity para crear, editar y eliminar notas.

Paso 1

Abrimos el proyecto Notepadv2 en Eclipse. El punto de inicio de este proyecto es la solución del ejercicio 1:

1. File > New > Android Project
2. Seleccionamos Create project from existing source
3. Seleccionamos el directorio Notepadv2 que nos hemos descargado antes
4. La mayoría de propiedades del proyecto se rellenan automáticamente. Seleccionamos el Target, en Android Labs nos recomiendan seleccionar la versión del sdk menor para que sea compatible con la mayor cantidad de dispositivos.
5. Pulsamos en Finish

Como veis son los mismo pasos que para el ejercicio 1.


Paso 2


En primer lugar, vamos a crear el menú contextual que permitirá a los usuarios borrar las notas una a una. Miramos la clase Notepadv2.
Para que cada elemento de la lista en el ListView sea accesible desde el menú de contexto, llamamos al método registerForContextMenu() pasándole el ListView:

                registerForContextMenu (getListView ());

Como nuestra Activity hereda de la clase ListActivity, getListView()nos devuelve el objeto local ListView. Ahora, cada elemento del ListView activa el menú contextual.

Ahora completamos el método onCreateContextMenu(), que será similar al menú de opciones. Añadiremos una línea para poder eliminar una nota desde el menú:

        public boolean onCreateContextMenu(Menu menu, View v
                ContextMenuInfo menuInfo) {
                        super.onCreateContextMenu(menu, v, menuInfo);
                        menu.add(0, DELETE_ID, 0, R.string.menu_delete);
        }


Paso 3

Ahora tenemos que controlar lo que hacemos cuando seleccionamos la opción del menú contextual. El método que tenemos que implementar es:

             public boolean onContextItemSelected(MenuItem item) {
                      switch(item.getItemId()) {
                           case DELETE_ID:
                                 AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
                                 mDbHelper.deleteNote(info.id);
                                 fillData();
                                 return true;
                      }
                      return super.onContextItemSelected(item);
              }
Para saber que ítem tenemos que eliminar lo hacemos con un objeto de tipo AdapterContextMenuInfo, que obtenemos con el método getMenuInfo().


Paso 4

Todavía en la clase Notepadv2 creamos el siguiente método:

        private void createNote() {

             Intent i = new Intent(this, NoteEdit.class);
             startActivityForResult(i, ACTIVITY_CREATE);
        }

El método startActivityForResult() lanza el Intent devolvuendo un valor, en este caso un int.


Paso 5

Rellenamos el método:

         @Override
            protected void onListItemClick(ListView l, View v, int position, long id) {
               super.onListItemClick(l, v, position, id);
                  Cursor c = mNotesCursor;
                  c.moveToPosition(position);
                  Intent i = new Intent(this, NoteEdit.class);
                  i.putExtra(NotesDbAdapter.KEY_ROWID, id);
                  i.putExtra(NotesDbAdapter.KEY_TITLE, c.getString(
                              c.getColumnIndexOrThrow(NotesDbAdapter.KEY_TITLE)));
                  i.putExtra(NotesDbAdapter.KEY_BODY, c.getString(
                      c.getColumnIndexOrThrow(NotesDbAdapter.KEY_BODY)));
                  startActivityForResult(i, ACTIVITY_EDIT);
            }

Este método se invoca cada vez que seleccionamos un elemento de la lista. Con Intent.putExtra() añadimos la información de la nota, para así poderla editar más tarde.



Paso 6

Los métodos anteriores createNote() y onListItemClick() se llaman de manera asíncrona. Para controlar el retorno de la llamada lo haremos sobreescribiendo el método onActivityResult(). Esto lo podemos hacer ya que hemos lanzado el Intent con startActivityForResult().

         @Override
           protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
                   super.onActivityResult(requestCode, resultCode, intent);
                   Bundle extras = intent.getExtras();
                   switch(requestCode) {
                         case ACTIVITY_CREATE:
                                 String title = extras.getString(NotesDbAdapter.KEY_TITLE);
                                 String body = extras.getString(NotesDbAdapter.KEY_BODY);
                                 mDbHelper.createNote(title, body);
                                 fillData();
                                 break;
                         case ACTIVITY_EDIT:
                                 Long rowId = extras.getLong(NotesDbAdapter.KEY_ROWID);
                                 if (rowId != null) {
                                       String editTitle = extras.getString(NotesDbAdapter.KEY_TITLE);
                                       String editBody = extras.getString(NotesDbAdapter.KEY_BODY);
                                       mDbHelper.updateNote(rowId, editTitle, editBody);
                                 }
                                 fillData();
                                 break;
                         }
                   }
           }

Diferenciamos entre la modificación o creación de una nota. En la creación recogemos del Bundle el title y el body, y llamamos a mDbHelper.createNote(). En la modificación primero tenemos que conseguir el Id de la fila, después también conseguimos el title y el body del Bundle y llamamos a mDbHelper.updateNote().



Paso 7

En este paso simplemente echamos un vistazo al fichero note_edit.xml. Es el layout más complejo del ejercicio pero únicamente vemos que de nuevo sólo está layout_weight=1. Este parámetro nos indica la "importancia" o peso del elemento en la vista. Por defecto el valor es 0.
Este es el layout de la pantalla de edición de una nota.

Paso 8

Para poder la pantalla de edición de las notas, creamos un clase que llamamos NoteEdit que herede de Activity y sobreescribimos el método onCreate(Bundle):

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.note_edit);
    
        mTitleText = (EditText) findViewById(R.id.title);
        mBodyText = (EditText) findViewById(R.id.body);
    
        Button confirmButton = (Button) findViewById(R.id.confirm);
    
        mRowId = null;
        Bundle extras = getIntent().getExtras();
        if (extras != null) {
            String title = extras.getString(NotesDbAdapter.KEY_TITLE);
            String body = extras.getString(NotesDbAdapter.KEY_BODY);
            mRowId = extras.getLong(NotesDbAdapter.KEY_ROWID);
        
            if (title != null) {
                mTitleText.setText(title);
            }
            if (body != null) {
                mBodyText.setText(body);
            }
        }
    
        confirmButton.setOnClickListener(new View.OnClickListener() {


            public void onClick(View view) {
                // TODO
            }
          
        });
    }

Paso 9
Ahora completamos el método onClick() que nos faltaba por rellenar:

            public void onClick(View view) {
                Bundle bundle = new Bundle();
            
                bundle.putString(NotesDbAdapter.KEY_TITLE, mTitleText.getText().toString());
                bundle.putString(NotesDbAdapter.KEY_BODY, mBodyText.getText().toString());
                if (mRowId != null) {
                    bundle.putLong(NotesDbAdapter.KEY_ROWID, mRowId);
                }
              
                Intent mIntent = new Intent();
                mIntent.putExtras(bundle);
                setResult(RESULT_OK, mIntent);
                finish();
            }


Paso 10

El último paso es añadir nuestra Activity al AndroidManifest.xml para que la Activity sea visible para Android:

1. Doble click en el fichero AndroidManifest.xml para abrirlo.
2. Click en la pestaña Application del editor de Manifest.
3. En la sección Application Nodes pulsamos en Add...
4. Nos aseguramos que tenemos seleccionado Activity y click en OK.
5. De nuevo en la sección Application Nodes pulsamos en la nueva Activity, y a la derecha escribimos .NoteEdit en el campo Name*. Pulsamos Intro.

También podemos añadirlo manualmente en el fichero AndroidManifest.xml de la siguiente manera:
          <activity android:name=".NoteEdit"></activity>



Y a correr!

Notepad Tutorial - Ejercicio 1

En Android Labs nos proponen un tutorial bastante completo, Notepad Tutorial, un gestor de notas.

El tutorial se sigue en forma de ejercicios, 3 más uno extra. De cada ejercicio tenemos un código base y su solución por si tenemos algún problema.

Nos descargamos el código base y las soluciones, y nos preparamos el entorno para empezar con el ejercicio 1.


Ejercicio 1

En este ejercicio 1 construiremos una lista de notas a la que podremos añadir nuevas notas, pero no editaralas.


Paso 1

Abrimos el proyecto Notepadv1 en Eclipse. Este proyecto es el punto de inicio para el ejercicio 1.

1. File > New > Android Project
2. Seleccionamos Create project from existing source
3. Seleccionamos el directorio Notepadv1 que nos hemos descargado antes
4. La mayoría de propiedades del proyecto se rellenan automáticamente. Seleccionamos el Target, en Android Labs nos recomiendan seleccionar la versión del sdk menor para que sea compatible con la mayor cantidad de dispositivos.
5. Pulsamos en Finish

Yo no he tenido problemas, pero si en vuestro caso tenéis algún problema con el AndroidManifest.xml, con el botón derecho en el proyecto seleccionamos Android Tools > Fix Project Properties, para que dejen de salirnos.


Paso 2

Echamos un vistazo a la clase NotesDbAdapter, que nos servira para acceder a la base de datos SQLite que utilizaremos para guardar las notas.

Al principio de la clase tenemos unas cuantas constantes declaradas:

    private static final String DATABASE_CREATE =
            "create table notes (_id integer primary key autoincrement, "
                    + "title text not null, body text not null);";

Esta es la consulta que crea la tabla de notas, que contiene 3 campos, _id, title y body, de los que también tenemos sus constantes:

  public static final String KEY_TITLE = "title";
    public static final String KEY_BODY = "body";
    public static final String KEY_ROWID = "_id";

También tenemos una constante que identifica la clase a la hora de escribir en log:

  private static final String TAG = "NotesDbAdapter";

El constructor de la clase NotesDbAdapter toma como parámetro un objeto de clase Context. Esto es para poder acceder a propiedades y métodos del sistema (Android).

En el método open() creamos un instancia de la clase DatabaseHelper, que es un clase local que implementa SQLiteOpenHelper. Con el método getWritableDatabase() obtenemos la base de datos.

Con el método close() simplemente cerramos la conexión con la base de datos.

Al método createNote() le pasamos un String title y otro body para crear una nueva nota en la base de datos. Si se crea bien, devolveremos un long que sera el _id del nuevo registro creado en la tabla.

Con deleteNote() podemos eliminar un registro de la tabla pasándole el _id.

Para obtener todos los registros de la tabla usaremos fetchAllNotes(). Este método nos retorna un Cursor (según Android Labs el sistema es más eficiente que con collections). Dentro del método llamamos a SQLiteDatabase.query() con los parámetros: nombre de la tabla (String), columnas que queremos recuperar (array de Strings, y otros campos que dejamos a null para obtener todos los datos sin agrupar, ni ordernar. (Ver detalles en SQLiteDatabase).

fetchNote() funciona de una forma similar que fetchAllNotes(), pero le pasamos un _id para obtener un registro determinado.

Para actualizar un nota utilizaremos updateNote(), al que le pasaremos _id de la nota que modificar, y los valores actualizados.


Paso 3

Abrimos el fichero res/layout/notepad_list.xml y vemos un LinearLayout vacío. Si alguien no identifica o conoce algo que se pase por HelloLinearLayout.


Paso 4
.
Copiamos el siguiente cógido en res/layout/notepad_list.xml para crear la vista del listado de notas

<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content">
<ListView android:id="@android:id/list"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
<TextView android:id="@android:id/empty"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/no_notes"/>
 </LinearLayout>


Es una vista bastante sencilla, en la que tenemos un ListView y un TextView. Suponiendo que ya conocemos un poco de vistas (si no, mirar HelloLinearLayout), lo importante son los id de estos dos elementos. Vemos que empiezan los dos por @android:id/, esto quiere decir que nos lo proporciona la plataforma Android. Pues usaremos 'automáticamente' @android:id/list cuando tengamos notas y @android:id/empty cuando no haya notas.


Paso 5

Para cada fila o item de la lista también deberemos generar una vista. Creamos un fichero nuevo en res/layout y lo llamamos notes_row.xml. El contenido será:

<?xml version="1.0" encoding="utf-8"?>
<TextView android:id="@+id/text1"  
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>

Podemos observar que en el id tenemos los carácteres @+. El + indica que los elementos que usan esta vista se generan dinámicamente y el id se creará automáticamente si todavía no existe.


Paso 6

Abrimos la clase Notepadv1 y le cambiamos la clase padre Activity por ListActivity. Esta clase añade funcionalidad extra para trabajar con listas.

Si miramos el código vemos que tenemos un atributo mNoteNumber que todavía no usamos, pero que haremos servir para numerar las notas.

También vemos que sobreescribimos tres métodos:

1. onCreate: llamado cuando la Activity empieza. Una especie de main
2. onCreateOptionsMenu: llamado cuando el usuario pulsa en botón de menu
3. onOptionsItemSelected: cuando pulsamos en el botón de menú, normalmente lanzamos una lista de acciones, como por ejemplo "Crear Nota". Pues este método es llamado cuando el usuario pulsa en una opción de estas.

Paso 7

El método onCreate() debe quedarnos así:

@Override
         public void onCreate(Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                setContentView(R.layout.notepad_list);
                mDbHelper = new NotesDbAdapter(this);
                mDbHelper.open();
                fillData();
         }

Después de las dos líneas típicas de un onCreate() (super.onCreate() y setContenView()), creamos la instancia del NotesDbAdapter, al que le pasamos el context. Abrimos la conexión y rellenamos los datos con fillData(), método que todavía no hemos implementado.


Paso 8

En el método onCreateOptionsMenu() copiamos:

@Override
         public boolean onCreateOptionsMenu(Menu menu) {
              boolean result = super.onCreateOptionsMenu(menu);
              menu.add(0, INSERT_ID, 0, R.string.menu_insert);
              return result;
         }

Para que el código compile debemos añadir en el res/value/strings.xml:

Add Item

Y añadimos en la clase Notepadv1 la siguiente constante:

public static final int INSERT_ID = Menu.FIRST;


De esta manera hemos añadido un botón ("Add Item") que aparecerá cuando pulsemos en el botón de menú del dispositivo.


Paso 9

En onOptionsItemSelected() copiamos:

@Override
        public boolean onOptionsItemSelected(MenuItem item) {
              switch (item.getItemId()) {
                 case INSERT_ID:
                 createNote();
                 return true;
              }
    
              return super.onOptionsItemSelected(item);
         }

Este método se ejecutará cuando pulsemos en un opción del menú. Recibe como parámetros un MenuItem, el cuál comprobamos si es la primera opción ("Add  Note") para crear una nota nueva con createNote(). Finalmente llamaremos al método de la superclase con super.onOptionsItemSelected().


Paso 10

Para este ejercicio 1 implementaremos un versión poco útil del método createNote(). Simplemente crearemos una nota nueva vacía asignándole un titulo incluyendo un contador. La nota no se podrá modificar de momento.

private void createNote() {
             String noteName = "Note " + mNoteNumber++;
             mDbHelper.createNote(noteName, "");
             fillData();
        }

Paso 11

Por último tenemos que implementar el método fillData(). El código es:

private void fillData() {
              Cursor c = mDbHelper.fetchAllNotes();
              startManagingCursor(c);


              String[] from = new String[] { NotesDbAdapter.KEY_TITLE };
              int[] to = new int[] { R.id.text1 };
      
              SimpleCursorAdapter notes =
                    new SimpleCursorAdapter(this, R.layout.notes_row, c, from, to);
              setListAdapter(notes);
        }

Para rellenar los datos usamos un SimpleCursorAdapter. Cuando creamos un objeto SimpleCursorAdapter le pasamos los siguientes parámetros:

• this --> Contexto
• int layout --> identificador del layout que contiene la lista de elementos a rellenar
• Cursor --> Cursor de la base de datos
• String[] --> Array de las columnas a rellenar
• int[] --> Array de las vistas/layouts que mostrarán los datos

Para poder trabajar con el cursor, la clase Activity nos da el método startManagingCursor(Cursor c).

Paso 12

Ejecutamos la aplicación

Application Fundamentals I

Como dije hace unos días, voy intentar resumir el articulo Application Fundamentals de Android Labs. Lo haré en dos partes.

Supongo que a estas alturas ya sabéis que el lenguaje de programación utilizado es Java. Así que para los que estamos familiarizados con este lenguaje, en principio no tendremos grandes problemas para empezar a programar en Android. Para los que no, quizás es recomendable empezar con algún tutorial de Java.

El código java compilado y los recursos utilizados en nuestra aplicación se empaquetan en un fichero de extensión APK (Android Package).

Este fichero APK lo podemos considerar como una aplicación, ya que por cada aplicación tenemos un fichero APK. Para instalarnos una aplicación debemos obtener su fichero APK, ya sea a través del Android Market o de algún otro medio.(Sí, es posible y legal)

Aunque el lenguaje de programación sea Java, las aplicaciones Android no trabajan de la misma manera. Gracias a la DalvikVM una aplicación tiene estas características:

• Cada aplicación corre en un único proceso Linux.
• Cada proceso corre en una VM.
• Cada proceso es asignado a un único User ID.

Nota: este es el comportamiento normal, pero es posible que dos aplicaciones compartan el mismo UserID para ver los ficheros entre ellas. Y también correr en el mismo proceso compartiendo la misma VM.

Application Components

• Activities: una Activity es una IU que realiza una actividad o acción. Una aplicación puede tener una simple Activity o varias. Por ejemplo, podemos tener una Activity que liste mensajes, otra que nos permita escribirlos, etc.. Todas estas acciones son clases que heredan de la clase Activity.
• Services: es una acción sin IU pero que corre en modo background durante un tiempo indefinido. Por ejemplo, en una aplicación para escuchar música, probablemente tendremos una IU para escoger la(s) canción(es) que queremos escuchar, esto sería una Activity. En cambio, lo que es la reproducción de música en sí será un servicio, ya que si hacemos ostras cosas, como navegar, consultar el correo, etcétera, queremos seguir escuchando la música. Todas las clases que implementan servicios heredan de Service.
• Broadcast Receivers: es un componente que aparentemente no hace nada, pero que recibe y reacciona a algunos eventos. Por ejemplo, cuando la batería esta baja, cambiamos de zona horaria, recibimos un mensaje (como en la imagen), etc.. Los broadcast receivers no tienen IU, pero suelen lanzar una Activity o un notificación a través del NotificationManager .Cada clase hereda de BrodcastReceiver. 

• Content Provieders: los Content Providers hacen posible que cierta información de nuestra aplicación, sea accesible desde otras aplicaciones. Los datos podemos almacenarlos en sistema de ficheros con SQLite u otros medios. Nuestras clases Content Providers heredan de ContentProvider, y tendremos un conjunto de métodos con los que conseguir los datos que nos interesen. Un ContentProvider se activa cuando lo reclama un ContentResolver.

Intents

Los componentes Activity, BrodcastReceiver y Service se activan a través de unos mensajes asíncronos llamados Intents. Nuestros Intents heredan de la clase Intent y contienen el mensaje. A cada tipo componente se le llama de una manera distinta, pasándole la URI (entre otros parámetros):

• Activity: Context.startActivity() o Activity.startActivityForResult(). El primer método simplemente lanza la acción, y el segundo espera una respuesta.
• Service: Context.startService()
• BrodcastReceiver: Varias formas -->  Context.sendBroadcast(),Context.sendOrderedBroadcast(), y Context.sendStickyBroadcast()

Manifest

Para que Android pueda iniciar un componente de una aplicación debemos definirlo en un archivo xml. Este archivo se llama AndroidManifest.xml, y estará incluido en el paquete APK junto con los demás recursos.

Además de declarar los componentes, en este fichero también tenemos que incluir las bibliotecas que necesita la aplicación, y también determinar los permisos que el usuario deberá otorgar a la aplicación para su correcto funcionamiento.

Un ejemplo:

                  <?xml version="1.0" encoding="utf-8"?>

                      <manifest . . . >

                          <application . . . >

                               <activity android:name="com.example.project.FreneticActivity"

                                             android:icon="@drawable/small_pic.png"

                                             android:label="@string/freneticLabel" 

                                            . . .  >

                               </activity>

                                . . .

                          </application>

                    </manifest>

En el atributo de name de la <activity> tenemos la subclase de Activity que implimenta la funcionalidad. El icon (icono) y la label (etiqueta) apuntan a los ficheros del directorio de recursos /res/drawable que contiene un icono y una etiqueta.

Los demás componentes (<service>, <receiver>, <provider>) se declaran de una forma similar. Los componentes que no se declaran en el AndroidManifest.xml nunca se podrán ejecutar porque no son visibles para la aplicación. Sin embargo, los <broadcastReceiver> pueden ser declarados tanto en el AndroidManifest como en hardcode. Para ello deberán registrarse con la llamada Context.registerReceiver().

Esta mini-introducción del AndroidManifest.xml se puede completar con The AndroidManifest.xml File.

Intent Filters

Un objecto Intent puede llamar explícitamente a un componente. Gracias al AndroidManifest.xml, Android lo puede encontrará y lo activará. Pero si la llamada no es explícita, Android debe localizar el componente que mejor corresponda a la llamada. Android consigue hacer esto gracias a los IntentFilters. Un IntentFilter le indica a Android cual es el mejor handler para ese tipo de componente. Cosa que también declararemos en el AndroidManifest.xml. Completando el ejemplo anterior:

                <?xml version="1.0" encoding="utf-8"?>

                       <manifest . . . >

                           <application . . . >

                                <activity android:name="com.example.project.FreneticActivity"

                                              android:icon="@drawable/small_pic.png"

                                              android:label="@string/freneticLabel" 

                                        . . .  >

                                     <intent-filter . . . >

                                            <action android:name="android.intent.action.MAIN" />

                                            <category android:name="android.intent.category.LAUNCHER" />

                                     </intent-filter>

                                     <intent-filter . . . >

                                           <action android:name="com.example.project.BOUNCE" />

                                           <data android:mimeType="image/jpeg" />

                                           <category android:name="android.intent.category.DEFAULT" />

                                     </intent-filter>

                              </activity>

                                  . . .

                           </application>

                       </manifest>

El primer <intent-filter> del ejemplo (la combinación de "android.intent.action.MAIN" y "android.intent.category.LAUNCHER") es muy común, ya que indica que esta Activity es el punto de entrada de la aplicación y que se mostrará en el menú de aplicaciones que puede ejecutar el usuario.

En el segundo <intent-filter> se declara una Activity que podrá manejar datos de tipo image/jpg. "android.intent.category.DEFAULT" es la category que pondremos cuando nuestra Activity no sea ninguna otra específica.

Un componente puede tener cualquier número de IntentFilter. Si no tienen ninguno puede ser activado solamente cuando se llame explícitamente desde el código.

Para completar esta info Intents and Intent Filters.

Hello Views VI

List View

Para crear una lista de elementos scrollables utilizaremos ListView. Estos elementos se insertarán automáticamente en la lista usando un ListAdapter.

En el ejemplo que nos proponen en Android Labs, veremos una lista de países que leeremos de un array de strings. Cuando seleccionemos un elemento, un Toast se mostrará diciéndonos su posición en la lista.

Los pasos resumidos son:

1. Crear el proyecto con Eclipse indicando la Activity HelloListView
2. Crear un fichero llamado list_item.xml y copiar el contenido en el directorio res/layout/. Es el layout para cada elemento de la lista.
3. Modificar la clase padre de HelloListView. Ahora tiene que heredar de ListActivity
4. Rellenar el método onCreate()
5. Copiar el array de paises (o lo que queramos listar)
6. Ejecutar la aplicación

Ahora vamos comentar los puntos más importantes del ejemplo.

• Podemos ver que list_item.xml simplemente nos dice que cada elemento de la lista será una TextView. Aquí podríamos añadir por ejemplo una imagen al lado del texto.
• ¿Porqué heredamos de ListActivity? Pues porque un ListActivity nos permite mostrar una lista de elementos vinculados a un data source, como un array. Además permite eventos sobre los elementos de la lista.
• En el método onCreate() vemos cosas interesantes. Por ejemplo, que no cargamos ningún fichero de layout. En vez de esto, indicamos un ListAdapter con setListAdapter(ListAdapter), que añade automáticamente un ListView que rellena toda la pantalla de la ListActivity.
• Al setListAdapter(ListAdapter) le pasamos como parámetros un ArrayAdapter. Para construir este objeto tenemos que pasarle el contexto (en nuestro caso con el this), el layout que utilizaremos para mostrar los elements (list_item.xml), y el array o lista de objecto que queremos mostrar (los países).
• El método setTextFilterEnabled(boolean) de la ListView hace posible que podamos filtrar el listado.
• El método setOnItemClickListener(OnItemClickListener) define un onClick listener para cada elemento, como vimos en el HelloGridView.
• La manera de definir el array de strings, en hardcode, no es la mejor. Para hacerlo de una manera más elegante y práctica es mejor referenciarlo desde un fichero externo. El array deberemos declararlo de la siguiente forma, y ubicándolo el fichero strings.xml en el directorio res/values:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="countries_array">
<item>Bahrain</item>
<item>Bangladesh</item>
<item>Barbados</item>
<item>Belarus</item>
<item>Belgium</item>
<item>Belize</item>
<item>Benin</item>
</string-array>
</resources>

• Ahora para cargar el ListAdapter tenemos que pasar el array de strings de la siguiente forma:

                   String[] countries = getResources().getStringArray(R.array.countries_array);

                   setAdapter(new ArrayAdapter(this, R.layout.list_item, countries));


Dudas
Me surge la duda de si el método setTextFilterEnabled(boolean) sólo funciona cuando nuestros elementos son TextView, o siempre aunque sean de otro tipo y el filtro se haga por algún identificador o descripción.

Notas
Como nos indica Android Labs en el ejemplo, android ya proporciona unos layouts de serie, cosa que no conocía hasta ahora. Os dejo el enlace.