Migrar seus apps para o Android 10

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

Para começar, recomendamos que você analise as mudanças de comportamento do sistema, as mudanças de privacidade e os novos recursos e APIs. Em seguida, migre seus apps nestas duas fases:

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

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

Fase 1: compatibilidade básica

O objetivo dessa fase é identificar regressões de funcionalidade ou outros impactos quando o app é executado no Android 10, resolvê-los e publicar uma versão atualizada para os usuários. Em muitos casos, não é necessário mudar o targetSdkVersion do app nem usar novas APIs, embora seja possível mudar o compileSdkVersion para oferecer suporte à compatibilidade.

É importante testar a funcionalidade do app em todos os fluxos, porque algumas mudanças na plataforma podem afetar o comportamento dele. Ao publicar a versão compatível do app, recomendamos notificar os usuários sobre o suporte ao Android 10 nas notas de atualização.

Para que os usuários tenham uma transição tranquila para o Android 10, recomendamos publicar 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 é o mesmo que você realiza ao se 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.

Conheça as mudanças de comportamento que podem afetar seu app. Essas mudanças serão aplicadas ao app, mesmo que você não tenha mudado o targetSdkVersion. Analisar as mudanças com antecedência vai ajudar você a identificar possíveis áreas de impacto e depurar problemas com mais rapidez.

O Android 10 inclui mudanças extensas de privacidade. Portanto, analise 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, configure o SDK do Android 10 (API 29) no Android Studio e mude targetSdkVersion e compileSdkVersion para 29.

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

Algumas mudanças de comportamento podem causar regressões ou falhas. Por isso, revise as mudanças e teste minuciosamente antes de publicar uma atualização do app que mude o targetSdkVersion.

Acessar o SDK

Para receber os pacotes do 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 as novas APIs.