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
- Adiciona a classe
CalendarContract.Colors
para representar
uma tabela de cores no provedor de
agenda. A classe fornece campos para acessar
as cores disponíveis para uma determinada conta. As cores são referenciadas por
COLOR_KEY
,
que precisa ser exclusivo para um determinado nome/tipo de conta. Esses valores só podem ser
atualizados pelo adaptador de sincronização.
- Adição de
ALLOWED_AVAILABILITY
e
ALLOWED_ATTENDEE_TYPES
para suporte a troca/sincronização.
- Adiciona
TYPE_RESOURCE
(como salas de conferência) para participantes e
AVAILABILITY_TENTATIVE
,
bem como EVENT_COLOR_KEY
para eventos.
CalendarContract.Colors
para representar
uma tabela de cores no provedor de
agenda. A classe fornece campos para acessar
as cores disponíveis para uma determinada conta. As cores são referenciadas por
COLOR_KEY
,
que precisa ser exclusivo para um determinado nome/tipo de conta. Esses valores só podem ser
atualizados pelo adaptador de sincronização.ALLOWED_AVAILABILITY
e
ALLOWED_ATTENDEE_TYPES
para suporte a troca/sincronização.TYPE_RESOURCE
(como salas de conferência) para participantes e
AVAILABILITY_TENTATIVE
,
bem como EVENT_COLOR_KEY
para eventos.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étodosgetSuggestionsAttributes()
egetSuggestionsCount()
, 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
- O novo método
setDefaultBufferSize(int, int)
emSurfaceTexture
define o tamanho padrão dos buffers de imagem. Esse método pode ser usado para definir o tamanho da imagem ao produzir imagens comCanvas
(usandolockCanvas(Rect)
) ou OpenGL ES (usando uma EGLSurface). - Foram adicionadas definições para os tipos enumerados da extensão GL_OES_EGL_image_external do OpenGL ES:
GL_REQUIRED_TEXTURE_IMAGE_UNITS_OES
,GL_SAMPLER_EXTERNAL_OES
,GL_TEXTURE_BINDING_EXTERNAL_OES
eGL_TEXTURE_EXTERNAL_OES
.
Acessibilidade
- Os clientes de
RemoteViews
agora podem usar o métodosetContentDescription()
para definir e receber a descrição de conteúdo de qualquer visualização no layout inflado. - Os métodos
getMaxScrollX()
,getMaxScrollY()
,setMaxScrollX()
esetMaxScrollY()
permitem que os apps recebam e definam o deslocamento máximo de rolagem para um objetoAccessibilityRecord
. - Quando o modo de exploração por toque está ativado, uma nova configuração segura
ACCESSIBILITY_SPEAK_PASSWORD
indica se o usuário solicita que o IME fale o texto inserido nos campos de senha, mesmo quando um fone de ouvido não está em uso. Por padrão, nenhum texto de senha é falado, a menos que um fone de ouvido esteja em uso.
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 objetosCursor
normais em objetosCrossProcessCursor
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
MediaMetadataRetriever
adiciona a nova constanteMETADATA_KEY_LOCATION
para permitir que os apps acessem informações de local de uma imagem ou vídeo.CamcorderProfile
adiciona os perfis de resolução QVGA (320x240). O nível de qualidade é representado pelas constantesQUALITY_QVGA
eQUALITY_TIME_LAPSE_QVGA
.- Os novos métodos
setVideoStabilization()
,getVideoStabilization()
eisVideoStabilizationSupported()
permitem verificar e gerenciar a estabilização de vídeo para umCamera
.
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.