APIs do Android 5.1

API de nível: 22

O Android 5.1 (LOLLIPOP_MR1) é uma atualização da versão Lollipop que oferece novos recursos para usuários e desenvolvedores de apps. Este documento fornece uma introdução às principais novas APIs.

Para ter uma visão geral dos novos recursos da plataforma, confira os destaques do Android Lollipop.

Atualização do nível da API

Para começar a criar apps para o Android 5.1, use o SDK Manager para fazer o download da plataforma do SDK do Android 5.1 e das imagens do sistema. Em seguida, configure o projeto de desenvolvimento do app para usar um targetSdkVersion de "22". Instale o app em uma imagem do sistema Android 5.1, teste e publique o app atualizado com essa mudança.

Você pode usar as APIs do Android 5.1 e, ao mesmo tempo, oferecer suporte a versões mais antigas, adicionando condições ao código que verifiquem o nível da API do sistema antes de executar APIs não compatíveis com sua minSdkVersion. Para saber mais sobre como manter a compatibilidade com versões anteriores, leia Compatibilidade com diferentes versões da plataforma.

Para mais informações sobre como os níveis de API funcionam, leia O que é um nível de API?

Compatibilidade com diversos cartões SIM

O Android 5.1 adiciona compatibilidade para o uso de mais de um cartão SIM de operadora de telefonia de uma vez. Esse recurso permite que os usuários ativem e usem outros chips em dispositivos com dois ou mais slots para chips.

É possível acessar informações sobre o chip ativo no momento por meio da classe SubscriptionManager, incluindo se o dispositivo é considerado em roaming na rede atual. Essas informações são úteis para desenvolvedores que querem limitar ou desativar o acesso aos dados dos apps para usuários de dispositivos sensíveis a cobranças de acesso a dados. Seu app pode ser alertado sobre mudanças na conexão de rede atual de um dispositivo solicitando a permissão READ_PHONE_STATE e definindo SubscriptionManager.OnSubscriptionsChangedListener no objeto SubscriptionManager.

Classes HTTP obsoletas

O uso das classes org.apache.http e android.net.http.AndroidHttpClient foi descontinuado no Android 5.1. Essas classes não estão mais sendo mantidas, e você precisa migrar qualquer código de app que use essas APIs para as classes URLConnection o mais rápido possível.

Serviços da operadora

O Android 5.1 oferece suporte para provedores de serviços de telecomunicações para criar apps que podem executar tarefas de provisionamento de operadora em um dispositivo Android. Essas APIs oferecem uma maneira segura e flexível para apps desenvolvidos por operadoras realizarem essas tarefas e serem distribuídos pelo Google Play. Os apps que usam essas funções precisam ser assinados por um certificado que corresponda ao certificado no cartão de circuito integrado universal (UICC) do dispositivo.

As APIs de serviço da operadora foram adicionadas às classes TelephonyManager, SmsManager e CarrierMessagingService. Os apps podem verificar o acesso a essas APIs chamando o método hasCarrierPrivileges(). Os apps que chamam essas APIs sem acesso recebem uma SecurityException.