APIs do Android 4.0.3

Nível da API:15

O Android 4.0.3 (ICE_CREAM_SANDWICH_MR1) é uma versão incremental da família de plataformas Android 4.0 (ICE_CREAM_SANDWICH). Esta versão inclui novos recursos para usuários e desenvolvedores, mudanças na API e várias correções de bugs.

Para desenvolvedores, a plataforma Android 4.0.3 está disponível como um componente para download do SDK do Android. A plataforma para download inclui uma biblioteca e uma imagem do sistema Android, além de um conjunto de skins de emulador e mais. Para começar a desenvolver ou testar no Android 4.0.3, use o Android SDK Manager para fazer o download da plataforma no SDK.

Visão geral da API

As seções abaixo fornecem uma visão geral técnica das novas APIs no Android 4.0.3.

API Social Stream no provedor de contatos

Os apps que usam dados de fluxo social, como atualizações de status e check-ins, agora podem sincronizar esses dados com cada um dos contatos do usuário, fornecendo itens em um fluxo com fotos para cada um deles.

A tabela do banco de dados que contém o fluxo social de um contato individual é definida por android.provider.ContactsContract.StreamItems, o Uri para o qual está aninhado no diretório ContactsContract.RawContacts ao qual os itens do fluxo pertencem. Cada tabela de fluxo social inclui várias colunas para metadados sobre cada item de fluxo, como um ícone que representa a origem (um avatar), um rótulo para o item, o conteúdo do texto principal, comentários sobre o item (como respostas de outras pessoas) e mais. As fotos associadas a um fluxo são armazenadas em outra tabela, definida por android.provider.ContactsContract.StreamItemPhotos, que está disponível como um subdiretório do URI android.provider.ContactsContract.StreamItems.

Consulte android.provider.ContactsContract.StreamItems e android.provider.ContactsContract.StreamItemPhotos para mais informações.

Para ler ou gravar itens do fluxo social de um contato, um app precisa solicitar a permissão do usuário declarando <uses-permission android:name="android.permission.READ_SOCIAL_STREAM"> e/ou <uses-permission android:name="android.permission.WRITE_SOCIAL_STREAM"> nos arquivos de manifesto.

Provedor de agenda

Widgets da tela inicial

A partir do Android 4.0, os widgets da tela inicial não precisam mais incluir o próprio padding. Em vez disso, o sistema agora adiciona padding automaticamente para cada widget, com base nas características da tela atual. Isso leva a uma apresentação mais uniforme e consistente de widgets em uma grade. Para auxiliar os aplicativos que hospedam widgets da tela inicial, a plataforma fornece um novo método getDefaultPaddingForWidget(). Os aplicativos podem chamar esse método para receber o padding definido pelo sistema e contabilizá-lo ao calcular o número de células a serem alocadas para o widget.

Verificação ortográfica

  • Para apps que acessam serviços de verificação ortográfica, um novo método cancel() cancela todas as tarefas pendentes e em execução da verificação ortográfica em uma sessão.
  • Para serviços de verificação ortográfica, uma nova flag de sugestões, RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS, permite que os serviços distingam sugestões de maior confiança de outras de menor confiança. Por exemplo, um verificador ortográfico pode definir a flag se uma palavra de entrada não estiver no dicionário do usuário, mas tiver sugestões prováveis, ou não definir a flag se uma palavra de entrada não estiver no dicionário e tiver sugestões menos úteis.

    Os apps conectados ao verificador ortográfico podem usar a flag RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS em combinação com outros atributos de sugestão, bem como os métodos getSuggestionsAttributes() e getSuggestionsCount(), para determinar se as palavras inseridas serão marcadas como erros de digitação e oferecer sugestões.

  • Um novo estilo FLAG_AUTO_CORRECTION para períodos de texto indica que a correção automática está prestes a ser aplicada a uma palavra/texto que o usuário está digitando/compondo. Esse tipo de sugestão é renderizado de maneira diferente para indicar que a correção automática está acontecendo.

Bluetooth

Os novos métodos públicos fetchUuidsWithSdp() e getUuids() permitem que os apps determinem os recursos (UUIDs) aceitos por um dispositivo remoto. No caso de fetchUuidsWithSdp(), o sistema realiza uma descoberta de serviço no dispositivo remoto para receber os UUIDs com suporte e, em seguida, transmite o resultado em uma intent ACTION_UUID.

Kit de ferramentas de interface

Os novos métodos setUserVisibleHint() e getUserVisibleHint() permitem que um fragmento defina uma dica de visibilidade para o usuário. O sistema adia o início de fragmentos que não são visíveis para o usuário até que os carregadores de fragmentos visíveis sejam executados. A dica de visibilidade é "true" (verdadeiro) por padrão.

Gráficos

Acessibilidade

Conversão de texto em voz

  • O novo método getFeatures() foi adicionado para consultar e ativar o suporte a TTS de rede.
  • Adiciona uma nova classe de listener, UtteranceProgressListener, que os mecanismos podem registrar para receber notificações de erros de síntese de voz.

Banco de dados

  • Uma nova classe CrossProcessCursorWrapper permite que os provedores de conteúdo retornem resultados para uma consulta entre processos com mais eficiência. A nova classe é um bloco de construção útil para agrupar cursores que serão enviados para processos remotamente. Ele também pode transformar objetos Cursor normais em objetos CrossProcessCursor de forma transparente.

    A classe CrossProcessCursorWrapper corrige problemas comuns de desempenho e bugs que os aplicativos encontraram ao implementar provedores de conteúdo.

  • O construtor CursorWindow(java.lang.String) agora usa uma string de nome como entrada. O sistema não distingue mais entre janelas de cursor locais e remotas. Por isso, CursorWindow(boolean) foi descontinuado.

Intents

Adiciona novas categorias para segmentar tipos comuns de aplicativos no dispositivo, como CATEGORY_APP_BROWSER, CATEGORY_APP_CALENDAR, CATEGORY_APP_MAPS e muito mais.

Câmera

Permissões

Estas são as novas permissões:

  • android.Manifest.permission#READ_SOCIAL_STREAM e android.Manifest.permission#WRITE_SOCIAL_STREAM: permitem que um adaptador de sincronização leia e grave dados de fluxo social em um contato no provedor de contatos compartilhado.

Para conferir uma visão detalhada de todas as mudanças na API do Android 4.0.3 (nível 15 da API), consulte o Relatório de diferenças da API.

Nível da API

A API do Android 4.0.3 recebe um identificador inteiro, 15, que é armazenado no próprio sistema. Esse identificador, chamado de "nível da API", permite que o sistema determine corretamente se um app é compatível com o sistema antes de instalá-lo.

Para usar as APIs introduzidas no Android 4.0.3 no seu app, é necessário compilar o app em uma plataforma Android compatível com o nível 15 da API ou mais recente. Dependendo das suas necessidades, talvez seja necessário adicionar um atributo android:minSdkVersion="15" ao elemento <uses-sdk>.

Para mais informações, consulte o documento Níveis da API.