Migrar seus apps para o Android 10

Olá! O Android 10 tem muitas novas APIs para criar novas experiências, além de comportamentos atualizados do sistema que podem afetar seu app quando ele estiver sendo executado em dispositivos Android 10.

Para começar, recomendamos analisar as mudanças de comportamento do sistema, as mudanças de privacidade e os novos recursos e APIs e, em seguida, migrar seus apps nestas duas fases:

  1. Garanta a compatibilidade básica. Assim que possível, verifique se o app publicado está pronto para usuários que estão atualizando ou comprando novos dispositivos com o Android 10. Teste seu app para verificar se ele está totalmente funcional e publique a versão compatível para os usuários.
  2. Crie com os recursos e as APIs do Android 10. Em seguida, conheça os novos recursos e APIs do Android 10. Configure seu ambiente de desenvolvimento, mude a targetSdkVersion do app e crie com as novas APIs relevantes para ele.

As seções a seguir destacam o que você precisará fazer em cada uma dessas fases. Antes de começar, prepare um dispositivo ou um emulador para executar e testar seu app.

Fase 1: compatibilidade básica

O objetivo desta fase é identificar quaisquer regressões de funcionalidade ou outros impactos quando o app estiver em execução no Android 10, resolvê-los e publicar uma versão atualizada para os usuários. Em muitos casos, não é necessário mudar a targetSdkVersion do app ou usar novas APIs, embora você possa mudar a compileSdkVersion para oferecer compatibilidade.

É importante testar a funcionalidade do seu app existente em todos os fluxos, porque algumas mudanças na plataforma podem afetar o comportamento dele. Quando você publicar a versão compatível do app, recomendamos que notifique os usuários sobre a compatibilidade com o Android 10 nas notas de atualização.

Para proporcionar aos usuários uma transição tranquila para o Android 10, recomendamos a publicação de uma versão compatível do app o mais rápido possível, de preferência antes que os dispositivos comecem a receber atualizações do Android 10.

Realizar testes

O teste de compatibilidade envolve o mesmo tipo de teste que você realiza ao se preparar para lançar o app. Esse é um bom momento para analisar as principais diretrizes de qualidade do app e as práticas recomendadas para testes.

Familiarize-se com as mudanças de comportamento conhecidas que podem afetar seu app. Essas mudanças de comportamento serão aplicadas ao app, mesmo que você não tenha modificado a targetSdkVersion. A análise prévia das alterações vai ajudar você a identificar possíveis áreas de impacto e depurar quaisquer problemas mais rapidamente.

O Android 10 inclui extensas alterações de privacidade. Verifique as principais mudanças de privacidade e entenda os possíveis impactos no seu app.

Fase 2: criar com o Android 10

Quando estiver tudo pronto, você poderá conhecer os novos recursos e APIs do Android 10 e aprimorar seu app com novas experiências. Para começar a desenvolver com as novas APIs, você precisará configurar o SDK do Android 10 (API 29) no Android Studio e mudar targetSdkVersion e compileSdkVersion para 29.

Ao mudar a targetSdkVersion, você também precisará considerar as mudanças de comportamento do sistema que se aplicam ao seu app quando estiver segmentando o Android 10 (API 29) ou versões mais recentes.

Algumas mudanças de comportamento podem causar regressões ou falhas. Por isso, analise as mudanças e faça um teste completo antes de publicar uma atualização de app que altera sua targetSdkVersion.

Acessar o SDK

Para ter os pacotes de SDK para criar seu app com o Android 10, verifique primeiro se você está usando a versão mais recente do Android Studio. Para saber mais, leia Configurar o SDK.

Realizar testes

Depois de concluir as etapas descritas anteriormente, você pode criar seu app e testá-lo para garantir que ele funcione corretamente ao ser direcionado ao Android 10. Esse é outro bom momento para analisar as principais diretrizes de qualidade de apps e as práticas recomendadas para testes.

Quando você cria seu app com a targetSdkVersion definida como 29, há mudanças específicas da plataforma que você precisa conhecer. Algumas dessas mudanças, descritas na página Mudanças de comportamento do Android 10, podem afetar significativamente o comportamento do seu app ou causar falhas, mesmo que você ainda não use novas APIs.