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, consulte 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 seu 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. Para isso, adicione condições ao seu código que verificam o nível da API do sistema antes de executar APIs que não têm suporte da 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 é o nível da 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 chip.

É possível acessar informações sobre o chip ativo no momento por meio da classe SubscriptionManager, incluindo se o dispositivo está 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 alterações 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

As classes org.apache.http e android.net.http.AndroidHttpClient foram descontinuadas no Android 5.1. Essas classes não são mais 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 a provedores de serviços de telecomunicações para criar apps que possam executar tarefas de provisionamento de operadora em um dispositivo Android. Essas APIs oferecem uma maneira segura e flexível de 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 um SecurityException.