Migrar seus apps para o Android 10

Olá! O Android 10 tem muitas APIs novas para criar novas experiências, bem como comportamentos atualizados do sistema que podem afetar seu app quando ele for executado em dispositivos com o 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 preparar para lançar o app. Esse é um bom momento para analisar as principais diretrizes de qualidade de apps 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. Analisar as mudanças com antecedência ajuda a identificar possíveis áreas de impacto e depurar os 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, primeiro verifique se você está usando a versão mais recente do Android Studio. Para saber mais, leia Configurar o SDK.

Realizar testes

Com as preparações descritas anteriormente concluídas, você pode criar seu app e testá-lo ainda mais para garantir que ele funcione corretamente quando destinado ao Android 10. Esse é outro bom momento para analisar as principais diretrizes de qualidade de apps e as práticas recomendadas para testes.

Ao criar seu app com o targetSdkVersion definido como 29, há mudanças específicas na 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 app ou causar falhas, mesmo que você ainda não use novas APIs.