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 que você analise as mudanças de comportamento do sistema, as mudanças de privacidade e novos recursos e APIs e, em seguida, migre seus apps nestas duas fases:

  1. Garanta a compatibilidade básica. Assim que possível, verifique se o app já publicado está pronto para usuários que estão atualizando ou comprando novos dispositivos com o Android 10. Teste o app para verificar se ele é totalmente funcional e publique a versão compatível dele 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 o targetSdkVersion do app e crie com as novas APIs relevantes para ele.

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

Fase 1: compatibilidade básica

O objetivo dessa fase é identificar quaisquer regressões de funcionalidade ou outros impactos quando o app estiver sendo 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 ou usar novas APIs, embora você possa mudar o compileSdkVersion para oferecer suporte à compatibilidade.

É importante testar a funcionalidade do app existente em todos os fluxos, já que 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 desse sistema operacional.

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 o app. Essas mudanças de comportamento serão aplicadas ao app, mesmo que você não tenha mudado 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 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ê poderá 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 precisará considerar as mudanças de comportamento do sistema que se aplicam ao seu app ao direcionar para 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 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 testá-lo ainda mais 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 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.