Prévia para desenvolvedores do 12L

Esta é a Prévia do 12L, um programa que oferece tudo o que você precisa para tornar seus apps compatíveis e começar a criar para a próxima atualização com recursos do 12L para o Android 12. O programa não tem custos financeiros, e você pode fazer o download do SDK e das ferramentas da Prévia para começar imediatamente.

Cronograma, marcos e atualizações

Cronograma de prévias e versões Beta para desenvolvedores do 12L

O programa de Prévia do 12L vai de outubro de 2021 até o lançamento público final do AOSP, planejado para o início de 2022. Faremos atualizações mensais dos ambientes de desenvolvimento e teste. Cada uma incluirá ferramentas do SDK, imagens de sistema, documentos, referência da API e diferenças de API. O programa inclui os marcos abaixo:

Cronograma Build Tipo Ações do desenvolvedor
Outubro Prévia para desenvolvedores 1 O build de referência anterior tinha como foco o feedback dos desenvolvedores, com um pequeno número de novos recursos, APIs e mudanças de comportamento. Janela de prioridades para feedback sobre APIs. Descobrir novas APIs e mudanças de comportamento e informar problemas ou solicitações importantes durante esse período. Começar os primeiros testes de compatibilidade de apps.
Dezembro Beta 1 Versão inicial com qualidade Beta e atualização via OTA para usuários que se inscreveram no Android Beta. Continuar o teste de compatibilidade, aguardar o feedback dos usuários do Android Beta. Notificar os desenvolvedores de SDK e biblioteca sobre qualquer problema.
Janeiro Beta 2 APIs finais Iniciar o teste de compatibilidade final para apps, SDKs e bibliotecas. Lançar versões compatíveis. Compilar apps de acordo com o SDK oficial da API 32, se necessário.
Fevereiro Beta 3 Atualização Beta incremental Iniciar o teste de compatibilidade final para apps, SDKs e bibliotecas. Lançar versões compatíveis. Compilar apps de acordo com o SDK oficial da API 32, se necessário.
1º trimestre de 2022 Última versão Lançamento da versão 12L para o AOSP e o ecossistema Lançar atualizações compatíveis para apps, SDKs e bibliotecas.

Fases de prévia

Para os desenvolvedores, o foco durante a Prévia para desenvolvedores é o feedback sobre a API e a compatibilidade de apps. A compatibilidade de apps significa garantir que a versão atual do app esteja certa e seja executada corretamente na nova plataforma.

Os builds da Prévia para desenvolvedores fornecem um ambiente de teste e desenvolvimento inicial que pode ser usado para testar o app usando os recursos do 12L. Apesar de não haver planos para adicionar alterações interruptivas nesta versão, ainda recomendamos que você teste o app para identificar possíveis problemas de compatibilidade para que seja possível planejar a migração ou o desenvolvimento de recursos, se necessário. É muito importante enviar seu feedback durante esse período. Também é interessante se preparar para algumas mudanças de API em cada uma dessas atualizações.

A Beta 1 oferece um ambiente mais completo e estável para criação e testes do 12L. É a primeira versão que disponibilizamos aos usuários iniciais inscritos no Programa Android Beta. Na versão Beta, os usuários iniciais usarão o app em dispositivos Pixel. Portanto, recomendamos que você acompanhe o feedback desses usuários e lance as atualizações compatíveis para resolver possíveis problemas, sem mudar a versão de destino do app.

A partir da versão Beta 2, os comportamentos e as APIs do sistema estarão finalizados. Esse é o momento de começar os testes finais e o trabalho de desenvolvimento necessários para garantir que uma versão compatível do app esteja pronta para os usuários receberem a atualização. No momento, o 12L terá um nível de API padrão (API de nível 32).

Com as APIs finais, também é necessário mudar o foco para os testes de compatibilidade finais e lançar os apps atualizados aos usuários e desenvolvedores downstream. Também é possível criar usando as APIs finais e refinar os novos códigos que estejam usando os novos recursos ou APIs.

Destinar à plataforma e ao nível de API opcional do 12L

A atualização do 12L inclui algumas APIs novas para desenvolvedores. Enquanto as APIs ainda estão em desenvolvimento, a plataforma do 12L usa o nível de API provisório "Sv2". Quando as APIs estiverem finalizadas, a plataforma do 12L usará o nível da API "32".

Para os desenvolvedores, será opcional (mas recomendado) que os apps sejam destinados ao nível da API 12L (targetSdkVersion="32") para atender aos requisitos do Google Play. Consulte detalhes sobre os requisitos mais recentes de destino do Google Play neste artigo.

O que está incluído na Prévia do 12L?

O programa de Prévia do 12L inclui tudo o que você precisa para testar os apps já existentes em diversos tamanhos de tela, tecnologias de rede, chipsets de CPU e GPU e arquiteturas de hardware.

SDK e ferramentas

Com o Android Studio, é possível fazer o download dos componentes abaixo usando o SDK Manager:

  • SDK e ferramentas do 12L
  • Imagem do sistema do emulador do 12L para todos os tamanhos de tela (somente 64 bits, consulte as notas da versão)

Lançaremos atualizações para essas ferramentas de desenvolvimento em cada marco, sempre que necessário.

Consulte Instalar o 12L para começar. Consulte as notas da versão para ver problemas conhecidos.

Imagens do emulador e do sistema Pixel

A maioria das mudanças do 12L foi projetada para dispositivos de tela grande, de modo que não serão visíveis em dispositivos menores, como smartphones. A fim de oferecer um ambiente de execução para testar os novos recursos, fornecemos um emulador do 12L que pode ser usado com qualquer configuração de dispositivo de emulador que tenha suporte ao Android Studio Bumblebee Beta 3 ou mais recente.

Durante a Prévia, é altamente recomendável testar o app usando o emulador do 12L com uma configuração de tablet, dobrável ou computador.

Consulte Instalar o 12L para ver detalhes sobre como configurar o emulador do 12L.

Como meta secundária, também é bom testar a compatibilidade em smartphones, já que eles também receberão o 12L. A partir da versão Beta 1, forneceremos imagens do sistema para todos os dispositivos Pixel compatíveis e também imagens GSI para maior suporte a desenvolvimento e testes. Acesse a página de downloads quando a versão Beta 1 estiver disponível para usar uma imagem do sistema de desenvolvimento e teste.

Atualizações OTA para o Pixel pelo programa Android Beta

A partir da versão Beta 1, se você tiver um dos dispositivos Google Pixel abaixo, poderá fazer a inscrição no programa Android Beta para Pixel e receber atualizações over the air (OTA) para os marcos do 12L:

  • Pixel 6 Pro
  • Pixel 6
  • Pixel 5a com 5G
  • Pixel 5
  • Pixel 4a (5G)
  • Pixel 4a
  • Pixel 4

Após a inscrição, o dispositivo receberá atualizações OTA frequentes até o lançamento da versão final do 12L.

Quando a inscrição estiver disponível, acesse g.co/androidbeta para se inscrever.

Publicação e APIs de prévia

A versão de prévia do 12L inicialmente oferece um sistema apenas para desenvolvimento e uma biblioteca Android que não tem um nível padrão de API. Se quiser direcionar à nova plataforma e criar com as novas APIs do 12L durante esse período, defina targetSdkVersion e a minSdkVersion do app como "Sv2" e a compileSdkVersion do Gradle como "Sv2" para destinar o app à versão da Prévia do 12L. Veja mais informações em Atualizar sua configuração do build para o 12L.

A prévia do 12L fornece APIs de pré-lançamento. As APIs não são oficiais até o lançamento do SDK final. Isso significa que pode haver mudanças nas APIs ao longo do tempo, especialmente durante a fase de Prévia para desenvolvedores do programa. Apresentaremos um resumo das mudanças a cada versão do 12L.

Na versão Beta 2, as APIs do desenvolvedor serão finalizadas e você poderá fazer o download do SDK oficial do 12L no Android Studio, direcionar para o nível oficial da API, 32 e compilar usando as APIs oficiais. Os apps compilados usando versões anteriores do SDK não poderão ser instalados em imagens do sistema que oferecem suporte a APIs finais.

Até que as APIs sejam finalizadas, o Google Play impede a publicação de apps destinados ao nível Sv2 da API. Quando o SDK final estiver disponível, será possível direcionar para o nível oficial da API do Android 12L e publicar o app no Google Play pelos canais de lançamento Alfa, Beta e de produção. Enquanto isso, caso você queira distribuir um app destinado ao Android 12L para testadores, é possível o enviar por e-mail ou oferecer o download direto no seu site a qualquer momento.

Fique por dentro

Durante a Prévia do 12L, ao testar usando a Prévia para desenvolvedores e nas versões Beta, é altamente recomendável manter seu ambiente de desenvolvimento atualizado. Notificaremos você quando novas atualizações estiverem disponíveis pelos canais abaixo:

Mais informações

Para saber mais sobre o 12L, consulte os recursos de documentação abaixo:

  • Veja um resumo sobre os recursos e as mudanças de comportamento documentados que podem afetar os desenvolvedores de apps na página de Recursos e mudanças do 12L.
  • Veja listas e descrições dos problemas conhecidos e as mudanças transitivas específicas de cada versão Beta ou da Prévia para desenvolvedores nas notas da versão.

Referências da API e relatórios de diferenças

A referência da API do 12L completa da versão Beta está disponível on-line. Quando as novas APIs estão em desenvolvimento, elas têm uma marca-d'água para visibilidade e usam "Sv2" como o nível da API. Observe que essas APIs só poderão ser usadas se você usar o SDK da Prévia do 12L para criação.

Quando o SDK oficial do 12L estiver disponível, a referência da API marcará as novas APIs com o nível oficial 32.

Para ver detalhes das APIs novas, modificadas, descontinuadas e removidas em cada versão, recomendamos começar com os relatórios de diferenças listados nas notas de versão.

As mudanças nos relatórios de diferenças contêm links para a documentação de referência da API relacionada.

Recursos de suporte

Ao testar e desenvolver com o 12L, use os canais abaixo para relatar problemas e enviar feedback:

  • Acesse a página Feedback e problemas para ver informações completas sobre como relatar problemas e enviar sua opinião.

  • O Issue Tracker da Prévia para desenvolvedores do Android é nosso principal rastreador de problemas. Usando essa ferramenta, você pode relatar bugs, problemas de desempenho e enviar feedback de forma geral. Também é possível consultar os problemas conhecidos e encontrar soluções alternativas. Você receberá atualizações sobre o problema relatado quando ele for classificado e enviado à equipe de engenharia do Android para análise. Para ver detalhes sobre como relatar vários tipos de problemas, consulte a seção Onde relatar problemas.

  • Na Comunidade Beta do Android (em inglês) é possível se conectar com outros usuários e desenvolvedores que também estão trabalhando com a versão Beta do 12L. Compartilhe observações e ideias e encontre respostas para suas dúvidas.

Primeiros passos

Para começar, configure um emulador de testes de compatibilidade seguindo as etapas em Instalar o 12L. Otimize seu app para telas grandes e crie uma experiência melhor para os usuários. Agradecemos sua participação no programa de Prévia do 12L.