Tutorial Android #13 – Configurando Preferências

Padrão

Olá novamente pessoal! Estão curtindo a série? Espero que sim! 🙂

Hoje vamos adicionar ao nosso aplicativo Lista de Restaurantes a opção do usuário configurar de que forma deve ocorrer a listagem dos restaurantes (nome, tipo, ordem alfabética, etc.).

Pra começar, vamos criar um arquivo XML que tomará conta das configurações de preferência. Dessa forma, crie o arquivo preferencias.xml e coloque-o em res/xml (a pasta ainda não existe… então crie-a). O conteúdo dele será:

&lt;PreferenceScreen xmlns:android=&quot;http://schemas.android.com/apk/res/android&quot;&gt;<br />
	&lt;ListPreference<br />
	    android:key=&quot;listagem&quot;<br />
	    android:title=&quot;Modo de Listagem&quot;<br />
	    android:summary=&quot;Escolha o modo de listagem a ser utilizado&quot;<br />
	    android:entries=&quot;@array/nomes_ordenacao&quot;<br />
		android:entryValues=&quot;@array/opcoes_ordenacao&quot;<br />
		android:dialogTitle=&quot;Escolha o modo de listagem&quot; /&gt;<br />
&lt;/PreferenceScreen&gt;

Em seguida, vamos criar o arquivo arrays.xml que definirá os dois arrays referenciados no XML definido acima. O arquivo arrays.xml deverá ser salvo na pasta res/values. Seu conteúdo é listado a seguir:

&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;<br />
&lt;resources&gt;<br />
	&lt;string-array name=&quot;nomes_ordenacao&quot;&gt;<br />
	    &lt;item&gt;Por Nome, Ascendente&lt;/item&gt;<br />
	    &lt;item&gt;Por Nome, Descendente&lt;/item&gt;<br />
	    &lt;item&gt;Por Tipo&lt;/item&gt;<br />
	    &lt;item&gt;Por Endereço, Ascendente&lt;/item&gt;<br />
	    &lt;item&gt;Por Endereço, Descendente&lt;/item&gt;<br />
	&lt;/string-array&gt;<br />
	&lt;string-array name=&quot;opcoes_ordenacao&quot;&gt;<br />
	    &lt;item&gt;nome ASC&lt;/item&gt;<br />
	    &lt;item&gt;nome DESC&lt;/item&gt;<br />
	    &lt;item&gt;tipo, nome ASC&lt;/item&gt;<br />
	    &lt;item&gt;endereco ASC&lt;/item&gt;<br />
	    &lt;item&gt;endereco DESC&lt;/item&gt;<br />
	&lt;/string-array&gt;<br />
&lt;/resources&gt;

O próximo passo é a criação da Activity responsável pelas preferências. Vamos criar a classe EdicaoPreferencias, que estenderá PreferenceActivity, dentro do pacote net.rafaeltoledo.restaurante:

package net.rafaeltoledo.restaurante;</p>
<p>import android.os.Bundle;<br />
import android.preference.PreferenceActivity;</p>
<p>public class EdicaoPreferencias extends PreferenceActivity {</p>
<p>	@Override<br />
	public void onCreate(Bundle savedInstanceState) {<br />
		super.onCreate(savedInstanceState);</p>
<p>		addPreferencesFromResource(R.xml.preferencias);<br />
	}<br />
}

Também é necessário atualizar o arquivo AndroidManifest.xml, já que adicionamos uma nova Activity ao nosso projeto.

&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;<br />
&lt;manifest xmlns:android=&quot;http://schemas.android.com/apk/res/android&quot;<br />
    package=&quot;net.rafaeltoledo.restaurante&quot;<br />
    android:versionCode=&quot;1&quot;<br />
    android:versionName=&quot;1.0&quot; &gt;</p>
<p>    &lt;uses-sdk android:minSdkVersion=&quot;8&quot; /&gt;</p>
<p>    &lt;application<br />
        android:icon=&quot;@drawable/ic_launcher&quot;<br />
        android:label=&quot;@string/app_name&quot; &gt;<br />
        &lt;activity<br />
            android:label=&quot;@string/app_name&quot;<br />
            android:name=&quot;.ListaRestaurantes&quot; &gt;<br />
            &lt;intent-filter &gt;<br />
                &lt;action android:name=&quot;android.intent.action.MAIN&quot; /&gt;</p>
<p>                &lt;category android:name=&quot;android.intent.category.LAUNCHER&quot; /&gt;<br />
            &lt;/intent-filter&gt;<br />
        &lt;/activity&gt;<br />
        &lt;activity android:name=&quot;.FormularioDetalhes&quot;&gt;<br />
        &lt;/activity&gt;<br />
        &lt;activity android:name=&quot;.EdicaoPreferencias&quot;&gt;<br />
        &lt;/activity&gt;<br />
    &lt;/application&gt;</p>
<p>&lt;/manifest&gt;

Continuando, vamos agora vincular a nossa nova Activity ao menu de opções. Primeiramente, vamos editar o arquivo opcao.xml, que se encontra em res/menu.

&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;<br />
&lt;menu xmlns:android=&quot;http://schemas.android.com/apk/res/android&quot;&gt;<br />
	&lt;item android:id=&quot;@+id/adicionar&quot;<br />
	    android:title=&quot;Adicionar&quot;<br />
	    android:icon=&quot;@drawable/adicionar&quot;/&gt;<br />
	&lt;item android:id=&quot;@+id/prefs&quot;<br />
	    android:title=&quot;Configurações&quot;<br />
	    android:icon=&quot;@drawable/menu_preferencias&quot;/&gt;<br />
&lt;/menu&gt;

O ícone referenciado é padrão do sistema e, como mostrado no último post, pode ser encontrado na própria instalação da SDK. Este ícone utilizado se chama ic_menu_preferences (que eu renomeei para menu_preferencias em nosso projeto).

Agora, vamos modificar o método onOptionsItemSelected na classe ListaRestaurantes para mapear esta nova opção adicionada ao menu:

@Override<br />
public boolean onOptionsItemSelected(MenuItem item) {<br />
	if (item.getItemId() == R.id.adicionar) {<br />
		startActivity(new Intent(ListaRestaurantes.this, FormularioDetalhes.class));<br />
		return true;<br />
	} else if (item.getItemId() == R.id.prefs) {<br />
		startActivity(new Intent(this, EdicaoPreferencias.class));<br />
		return true;<br />
	}</p>
<p>	return super.onOptionsItemSelected(item);<br />
}

Neste ponto, se você rodar a aplicação, já poderá conferir o menu:

Agora, já que a parte visual está pronta, vamos aplicar a ordenação a nossa lista. Primeiramente, precisamos que o método obterTodos() da classe GerenciadorRestaurantes precisa receber o método de ordenação por parâmetro e aplicá-lo a SQL. Modifique-o para que fique assim:

public Cursor obterTodos(String ordenacao) {<br />
	return getReadableDatabase().rawQuery(&quot;select _id, nome, endereco, tipo, &quot; +<br />
			&quot;anotacoes FROM restaurantes ORDER BY &quot; + ordenacao, null);<br />
}

Agora, precisamos de um atributo na classe ListaRestaurantes que nos permita saber a ordenação selecionada e aplicá-la a listagem. Adicione um atributo à classe chamado prefs do tipo SharedPreferences.

SharedPreferences prefs = null;

Em seguida, adicione a inicialização do atributo no método onCreate(), próximo ao seu início.

prefs = PreferenceManager.getDefaultSharedPreferences(this);

E modifique a chamada ao método obterTodos() logo em seguida:

listaRestaurantes = gerenciador.obterTodos(prefs.getString("ordenacao", "nome"));

Por fim, vamos fazer com que seja aplicada as alterações realizadas pelo usuário em tempo de execução, já que, por enquanto, é necessário fechar a aplicação para que a nova ordenação tenha efeito. Adicione esta linha ao fim do método onCreate():

prefs.registerOnSharedPreferenceChangeListener(prefListener);

Em seguida, vamos criar o listener dentro da classe ListaRestaurantes:

private OnSharedPreferenceChangeListener prefListener = new OnSharedPreferenceChangeListener() {</p>
<p>	public void onSharedPreferenceChanged(SharedPreferences sharedPreferences,<br />
			String key) {<br />
		if (key.equals(&quot;ordenacao&quot;)) {</p>
<p>		}<br />
	}<br />
};

Continuando, vamos isolar a inicialização da lista em um método à parte, deixando o método onCreate() mais limpo. Crie o método inicializarLista():

private void inicializarLista() {<br />
	if (listaRestaurantes != null) {<br />
		stopManagingCursor(listaRestaurantes);<br />
		listaRestaurantes.close();<br />
	}</p>
<p>	listaRestaurantes = gerenciador.obterTodos(prefs.getString(&quot;listagem&quot;, &quot;nome&quot;));<br />
	startManagingCursor(listaRestaurantes);<br />
	adaptador = new AdaptadorRestaurante(listaRestaurantes);<br />
	setListAdapter(adaptador);<br />
}

Agora, referenciamos o recém-criado método inicializarLista() no método onCreate():

@Override<br />
public void onCreate(Bundle savedInstanceState) {<br />
	super.onCreate(savedInstanceState);<br />
	setContentView(R.layout.main);</p>
<p>	prefs = PreferenceManager.getDefaultSharedPreferences(this);<br />
	gerenciador = new GerenciadorRestaurantes(this);<br />
	inicializarLista();<br />
	prefs.registerOnSharedPreferenceChangeListener(prefListener);<br />
}

E então, também fazemos uma chamada ao método inicializarLista() dentro do nosso prefListener:

private OnSharedPreferenceChangeListener prefListener = new OnSharedPreferenceChangeListener() {</p>
<p>	public void onSharedPreferenceChanged(SharedPreferences sharedPreferences,<br />
			String key) {<br />
		if (key.equals(&quot;listagem&quot;)) {<br />
			inicializarLista();<br />
		}<br />
	}<br />
};

E pronto! Já temos o nosso aplicativo funcionando! 🙂

Se você perdeu alguma coisa ou quiser baixar o projeto, só clicar aqui!

Tá ficando interessante, não? Aguardem que vai ficar mais bacana ainda!