Migrar apps para o Android 15

Este documento oferece uma visão de alto nível das fases típicas de desenvolvimento e teste que podem ajudá-lo a fazer um plano de prontidão que esteja bem alinhado com os de lançamento da plataforma e garante uma ótima experiência para seus usuários em Android 15

A cada versão do Android, introduzimos novos recursos e comportamentos mudanças com o objetivo de tornar o Android mais útil, mais seguro e mais eficiente. Em muitos casos, seu aplicativo funcionará exatamente como esperado, em outros casos, pode ser necessário atualizar o app para se adaptar às mudanças da plataforma.

Os usuários podem começar a receber a nova plataforma assim que o código-fonte for lançado no AOSP (Android Open Source Project), por isso é importante que seus apps estejam prontos, com o desempenho esperado para os usuários e, de preferência, aproveitando novos recursos e APIs para aproveitar ao máximo a nova plataforma.

Uma migração típica tem duas fases, que podem ser simultâneas:

• Garantir a compatibilidade do app (até a versão final do Android 15)
• Direcionar aos novos recursos e APIs da plataforma (assim que possível, depois de versão final)

Garantir a compatibilidade com o Android 15

É importante testar a funcionalidade do seu app existente em relação o Android 15 para garantir uma ótima experiência aos usuários que fizerem a atualização para a versão mais recente do Android. Algumas mudanças na plataforma podem afetar a forma como seu app se comporta. Por isso, é importante testar cedo e completamente ajustes no seu app.

Geralmente, é possível ajustar o app e publicar uma atualização sem precisar fazer mudanças. a targetSdkVersion do app. Da mesma forma, você não precisa usar novas APIs ou mude a compileSdkVersion do app, embora isso possa depender da forma como do app foi criado e a funcionalidade da plataforma que ele está usando.

Antes de iniciar os testes, familiarize-se com o comportamento mudanças para todos os apps. Essas mudanças podem afetar seu app, mesmo que você não mudar a targetSdkVersion dele.

Realizar testes de compatibilidade

Na maioria dos casos, testar a compatibilidade com o Android 15 é semelhante aos testes comuns de apps. Este é um bom momento para analisar o aplicativo principal diretrizes de qualidade e práticas recomendadas para testes.

Para testar, instale o app publicado no momento em um dispositivo que esteja executando Android 15 e trabalhe em todos os fluxos e funcionalidades enquanto procura problemas. Para ajudar você a concentrar seus testes, Confira as mudanças de comportamento para todos os apps introduzidas no Android 15 que podem afetar o funcionamento do app ou fazer com que falhar.

Além disso, analise e teste os usos de conteúdos não SDK restritos do Google Cloud. Substitua as interfaces restritas que o app usa um SDK público ou equivalente do NDK. Fique de olho nos avisos do Logcat que destacam essas acessos e use o método StrictMode detectNonSdkApiUsage() para capturar programaticamente.

Por fim, teste totalmente as bibliotecas e os SDKs no seu app para garantir se funcionam como esperado no Android 15 e seguem as práticas práticas de privacidade, desempenho, UX, tratamento de dados e permissões. Se você encontrar um problema, tente atualizar para a versão mais recente do SDK ou entre em contato com o desenvolvedor do SDK para receber ajuda.

Quando terminar o teste e fizer as atualizações, recomendamos publicar seu app compatível imediatamente. Isso permite que os usuários testem o app antecipadamente ajuda a garantir uma transição tranquila para seus usuários conforme eles atualizam para Android 15

Atualizar versão de destino do app e criar com novas APIs

Depois de publicar uma versão compatível do app, a próxima etapa é adicionar suporte total ao Android 15 atualizando a targetSdkVersion e aproveitar as novas APIs e recursos do Android 15. Você poderá fazer essas atualizações assim que estiver pronto. Lembre-se do Google Requisitos do Google Play para segmentar a nova plataforma.

À medida que você planeja seu trabalho para oferecer suporte total ao Android 15, consulte a mudanças de comportamento que afetam os apps destinados ao Android 15. Essas mudanças esperadas de comportamento podem causar problemas funcionais que você precisa endereço IP. Em alguns casos, essas mudanças exigem desenvolvimento significativo, por isso nós e recomendamos que você os aprenda e resolva o mais cedo possível. Para ajudar identificar mudanças de comportamento específicas que afetam seu aplicativo, use a tag de compatibilidade de controle para testar seu app com as mudanças selecionadas ativadas.

As etapas a seguir descrevem como oferecer suporte total ao Android 15.

Acessar o SDK, alterar o destino, criar com novas APIs

Para iniciar o teste de suporte total ao Android 15, use a versão mais recente versão de pré-lançamento do Android Studio para fazer o download do SDK do Android 15 e outras ferramentas de que você precisa. Em seguida, atualize a targetSdkVersion e compileSdkVersion e recompile o app. Consulte o guia de configuração do SDK para detalhes.

Testar o app para Android 15

Depois de compilar o aplicativo e instalá-lo em um dispositivo que executa Android 15, começar a testar para garantir que o app funcione corretamente ao segmentar o Android 15. Algumas mudanças de comportamento se aplicam somente quando seu app é destinado à nova plataforma, então, convém analisar essas mudanças antes de começar.

Assim como nos testes básicos de compatibilidade, trabalhe em todos os fluxos e funcionalidades para verificar se há problemas. Concentre seus testes no Mudanças de comportamento para apps destinados ao Android 15. Está Esse também é um bom momento para verificar se o app está de acordo com as principais diretrizes de qualidade de apps. e as práticas recomendadas para testes.

Revise e teste os usos de interfaces restritas não SDK aplicáveis. Fique de olho nos avisos do Logcat que destacam esses acessos e usam o método StrictMode detectNonSdkApiUsage() para capturá-los programaticamente.

Por fim, teste totalmente as bibliotecas e os SDKs no seu app para garantir se funcionam como esperado no Android 15 e seguem as práticas práticas de privacidade, desempenho, UX, tratamento de dados e permissões. Se você encontrar um problema, tente atualizar para a versão mais recente do SDK ou entre em contato com o desenvolvedor do SDK para receber ajuda.

Testar usando alternâncias de compatibilidade de apps

O Android 15 inclui alternâncias de compatibilidade que facilitam o teste do app com mudanças de comportamento esperadas. Para um app depurável, as alternâncias permitem que você:

• Teste as mudanças esperadas sem realmente mudar a targetSdkVersion do app. Você pode usar as alternâncias para forçar a ativação de mudanças específicas de comportamento esperado e avaliar o impacto no app existente.
• Concentre seus testes somente em mudanças específicas. Em vez de ter que resolver todas as mudanças esperadas de uma só vez, as alternâncias permitem as desativar, exceto as que você quer testar.
• Gerencie alternâncias por meio do adb. É possível usar comandos adb para ativar e desativar as mudanças alternáveis no seu ambiente de teste automatizado.
• Depure mais rapidamente usando códigos de mudança padrão. Cada mudança alternável tem ID e nome exclusivos que podem ser usados para depurar rapidamente a causa raiz no registro saída.

À medida que você se prepara para alterar a versão de destino do seu aplicativo ou enquanto estiver usando desenvolvimento para o Android 15, as alternâncias podem ajudar. Para mais informações, consulte Mudanças no framework de compatibilidade (Android 15).