Como continuar compatível com versões anteriores

Testar o Compose

O Jetpack Compose é o kit de ferramentas de interface recomendado para Android. Saiba como adicionar a funcionalidade de pesquisa no Compose.

Filtrar uma lista →

A SearchView e a barra de ações estão disponíveis apenas no Android 3.0 e versões mais recentes. Para oferecer compatibilidade com plataformas mais antigas, você pode retornar à caixa de diálogo de pesquisa. A caixa de pesquisa é uma interface fornecida pelo sistema que é sobreposta ao app quando invocada.

Definir os níveis mínimo e preferencial da API

Para configurar a caixa de diálogo de pesquisa, primeiro declare no manifesto que você quer oferecer compatibilidade com dispositivos mais antigos, mas que quer segmentar o Android 3.0 ou versões posteriores. Assim, seu aplicativo usa automaticamente a barra de ações no Android 3.0 ou mais recente e o sistema de menus tradicional em dispositivos mais antigos:

<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="15" />

<application>
...

Disponibilizar a caixa de diálogo de pesquisa para dispositivos mais antigos

Para invocar a caixa de diálogo de pesquisa em dispositivos mais antigos, chame onSearchRequested() sempre que um usuário selecionar o item de menu de pesquisa no menu de opções. Como os dispositivos Android 3.0 e versões mais recentes mostram a SearchView na barra de ações (conforme demonstrado na primeira lição), somente versões anteriores à 3.0 chamam onOptionsItemSelected() quando o usuário seleciona o item de menu de pesquisa.

Kotlin

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    return when (item.itemId) {
        R.id.search -> {
            onSearchRequested()
            true
        }
        else -> false
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.search:
            onSearchRequested();
            return true;
        default:
            return false;
    }
}

Verificar a versão de compilação do Android durante a execução

Durante a execução, verifique a versão do dispositivo para garantir que o uso incompatível da SearchView não ocorra em dispositivos mais antigos. No código de exemplo, isso acontece no método onCreateOptionsMenu():

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {

    menuInflater.inflate(R.menu.options_menu, menu)

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        val searchManager = getSystemService(Context.SEARCH_SERVICE) as SearchManager
        (menu.findItem(R.id.search).actionView as SearchView).apply {
            setSearchableInfo(searchManager.getSearchableInfo(componentName))
            setIconifiedByDefault(false)
        }
    }
    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {

    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.options_menu, menu);

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        SearchManager searchManager =
                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
        SearchView searchView =
                (SearchView) menu.findItem(R.id.search).getActionView();
        searchView.setSearchableInfo(
                searchManager.getSearchableInfo(getComponentName()));
        searchView.setIconifiedByDefault(false);
    }
    return true;
}