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 Android 10.

Para começar, recomendamos que você analise as mudanças de comportamento do sistema, mudanças de privacidade e novos recursos e APIs para 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 dele para os usuários.
  2. Criar 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 o targetSdkVersion do app e crie com as novas APIs relevantes para seu app.

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

Fase 1: compatibilidade básica

O objetivo dessa fase é identificar quaisquer regressões de funcionalidade ou outros impactos quando o app for executado no Android 10. Em seguida, resolva-os e publique 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 suporte à compatibilidade.

É importante testar a funcionalidade do 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 notificar os usuários sobre o suporte ao Android 10 nas notas de atualização.

Para oferecer aos usuários uma transição tranquila para o Android 10, recomendamos publicar uma versão compatível do app o quanto antes, 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 na preparação 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 mudado o targetSdkVersion. Analisar as mudanças com antecedência ajudará você a identificar possíveis áreas de impacto e depurar problemas mais rapidamente.

O Android 10 inclui extensas mudanças de privacidade. Leia também 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ê pode explorar 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 a targetSdkVersion, você também vai precisar considerar as mudanças de comportamento do sistema que se aplicam ao seu app quando o app for destinado ao 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 do app que mude o 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 fazer mais testes para garantir que ele funcione corretamente quando destinado ao Android 10. Esse também é um bom momento para analisar as principais diretrizes de qualidade de apps e as práticas recomendadas para testes.

Ao criar 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.