- O R8 remove o código e os recursos que ninguém usa, reescreve o restante e encurta os nomes para criar aplicativos menores, com tempos de inicialização mais rápidos e menos problemas de falta de resposta.
- É recomendável ativar a otimização na versão de lançamento e ajustar as regras de conservação, que são o principal obstáculo que impede o R8 de funcionar em plena capacidade.
- O analisador de configuração do R8 mede a quantidade de código disponível para ser reduzida, otimizada e ofuscada, e sinaliza regras amplas, duplicadas ou inúteis.
- Concluir a tarefa com App Bundles, imagens leves, ajustes de idioma e densidade, e medição de tamanho constante faz uma diferença real na velocidade de download.
Comprimir um aplicativo Android não se resume a excluir arquivos individuais; é um delicado equilíbrio entre tamanho, velocidade de inicialização e uso de memória. O otimizador integrado do Android, o R8, realiza grande parte desse trabalho sem que você precise escrever uma única linha de código : ele analisa quais códigos e recursos estão sendo realmente usados, remove o que não está sendo utilizado e reescreve o restante para executar com menos sobrecarga. O que os usuários do seu aplicativo percebem são tempos de inicialização mais rápidos, menor uso de memória, uma interface mais fluida e menos mensagens de erro.
A chave é dar espaço para o R8 trabalhar. Quanto maior a porção do seu código que o R8 puder acessar, melhores serão os resultados. Regras de conservação excessivamente amplas são o obstáculo mais comum , pois restringem classes e métodos que podem não ser chamados dinamicamente, juntamente com suas dependências. Refinar essas regras, medir e testar novamente é o ciclo que diferencia um aplicativo lançado de forma simples de um aplicativo verdadeiramente otimizado.
O que exatamente o R8 faz e por que você deveria confiar nele?
O R8 funciona em uma série de fases interligadas. Primeiro, ele analisa seus pontos de entrada reais, como as atividades ou serviços declarados no manifesto, constrói um mapa de tudo o que é referenciado e descarta tudo o que estiver fora desse mapa . Em seguida, ele realiza otimizações lógicas: substitui chamadas pelo corpo do método chamado, mescla classes e interfaces, simplifica estruturas e reduz a sobrecarga de execução. Finalmente, ele abrevia os nomes de classes, campos e métodos, de modo que algo como `com.example.MyActivity` pode acabar sendo chamado de `aba`, com a consequente economia de metadados.
- Menos código mortoAs dependências que você usa apenas em uma pequena porcentagem deixam de ter toda a sua importância.
- Execução mais eficienteA inserção de métodos e a fusão de classes reduzem as chamadas e a pressão sobre a memória.
- Arquivos DEX mais levesA ofuscação preserva metadados e acelera o carregamento de classes.
- Recursos ajustadosDesde a versão 8.12 do plugin Gradle, o R8 também participa da otimização de recursos.
Do ponto de vista do usuário, isso se traduz em tempos de inicialização mais rápidos, menor consumo de memória, renderização aprimorada e menos problemas de travamento do aplicativo. A recomendação oficial é clara: habilite a otimização na versão de lançamento . Para testes diários ou desenvolvimento de bibliotecas, geralmente não vale a pena, pois o tempo de compilação aumenta e a depuração se torna mais complicada quando os nomes mudam.
Ative a otimização com base na versão do plugin Gradle.
Se você estiver trabalhando com versões recentes do plugin do Android para Gradle, as coisas foram bastante simplificadas. Basta habilitar uma única flag dentro do bloco de otimização do tipo de build de release e colocar suas regras de keep em um conjunto de código-fonte específico, com arquivos terminados em .keep, por exemplo, dentro de src/main/keepRules. Essa nova abordagem abrange tanto o código quanto os recursos e inclui regras de plataforma padrão equivalentes às regras ProGuard anteriores com otimização, portanto, não há necessidade de declarar arquivos adicionais.
Em projetos que utilizam versões anteriores do plugin, a abordagem padrão envolve dois parâmetros no tipo de build de release: um que habilita a minificação de código e outro que habilita a redução de recursos. A abordagem sensata é habilitar ambos simultaneamente e adicionar o arquivo de regras otimizado gerado pelo próprio sistema, além do seu próprio arquivo de regras, se necessário. Misturar builds de release sem essas opções é uma das maneiras mais sutis de desperdiçar megabytes de dados dos seus usuários.
Modo completo e redução de recursos otimizada
O modo completo do R8 está ativo por padrão há anos e aplica suposições mais rigorosas sobre o uso de reflexão e chamadas dinâmicas. Se alguém já escreveu uma propriedade que o desativa, é melhor excluí-la : mantê-la desativada reduz o potencial do otimizador. No entanto, o modo completo pode exigir regras extras em projetos com muito código dinâmico, portanto, sempre teste-o com uma versão de produção real e não apenas com testes unitários.
A otimização da redução de recursos foi introduzida na versão 8.12 do plugin e, desde a versão 9.0, é aplicada automaticamente quando a redução de recursos está habilitada. A ideia é tratar os recursos como parte do grafo de código : anteriormente, a ferramenta de empacotamento gerava regras de preservação que mantinham ativos recursos inacessíveis e código que se referenciava mutuamente; agora, se um conjunto de código e recursos não for usado, ele não é protegido e desaparece. Em aplicativos com muitas variações de formato, foram medidas reduções de tamanho bem acima de cinquenta por cento.
O Analisador de Configuração R8 e suas três pontuações
Esta ferramenta de análise indica se a sua configuração está ajudando ou atrapalhando. Ela gera estatísticas sobre qual porcentagem do seu código-fonte está realmente sujeita a redução, otimização e ofuscação . Se a pontuação de redução for de 66%, significa que o R8 pode remover código de dois terços do seu código-fonte; se a pontuação de otimização for a mesma, significa que ele só pode aplicar inserção de métodos, fusão de classes e outras técnicas a dois terços do código. A pontuação de ofuscação mede o quanto de código pode ser encurtado para economizar metadados.
Além das métricas gerais, o relatório detalha o impacto de cada regra de conservação e as propriedades de otimização que ela bloqueia. Ele também identifica regras originárias de bibliotecas de terceiros , o que é muito útil, pois os autores dessas bibliotecas não estão familiarizados com sua implementação específica e, às vezes, escrevem regras tão genéricas que paralisam a otimização em partes do seu aplicativo que não têm nenhuma relação com sua funcionalidade.
Como gerar o relatório sem perder tempo
Para iterar rapidamente sobre suas regras, existe uma tarefa específica do Gradle que analisa a configuração de lançamento sem empacotar o APK ou o pacote. O ciclo de feedback é muito mais curto e o relatório HTML aparece na pasta `reports` do módulo, dentro de um diretório dedicado ao R8. Esta é a opção recomendada quando você está ajustando regras e deseja ver o efeito imediato de cada alteração.
Se preferir a análise automática, qualquer versão de lançamento também gera um arquivo HTML com os resultados do mapeamento. Você pode desativar essa geração automática com a propriedade experimental correspondente, caso a considere incômoda. Em versões mais antigas do plugin, a solução alternativa é adicionar uma versão recente do R8 ao classpath do projeto e executar a compilação com uma propriedade do sistema especificando o diretório onde o relatório deve ser salvo.
Aprimore as regras de conservação sem prejudicar o aplicativo.
O objetivo é preservar apenas o que é realmente acessível por meio de reflexão, nada mais, nada menos. Comece examinando as regras que bloqueiam a otimização em um grande número de classes , revisando quais elementos elas protegem e verificando se elas são realmente invocadas dinamicamente. Em seguida, restrinja o escopo: em vez de preservar um pacote inteiro com todos os seus membros, limite a regra a classes e membros específicos. E antes de implementar a alteração, execute testes que cubram as classes, campos e métodos afetados.
Além disso, tenha cuidado com regras subsumidas. Se uma regra protege um pacote inteiro e outra protege uma classe dentro desse pacote, a segunda não contribui em nada e a primeira está bloqueando otimizações que você pode não precisar. Decida qual das duas está correta: se a regra específica estiver bem escrita, remova a regra geral e libere o restante do pacote; se a regra geral estiver correta, remova-a mesmo assim, mas reescreva-a para que afete apenas o essencial. Em seguida, execute o analisador novamente e compile uma versão completa para verificar se tudo ainda está funcionando.
Regras duplicadas, não utilizadas e de biblioteca
O analisador identifica duas fontes claras de código desnecessário: regras que não correspondem a nenhuma classe, método ou campo na compilação atual e regras idênticas repetidas no mesmo arquivo ou em arquivos diferentes. As primeiras geralmente são deixadas como lixo após refatoração ou remoção de dependências ; as últimas complicam a manutenção sem trazer nenhum benefício. Limpá-las torna a configuração mais fácil de ler e depurar.
Com bibliotecas de terceiros, há pouca margem de manobra, pois suas regras vêm empacotadas e você não pode editá-las seletivamente. A abordagem prática é documentar o impacto em um relatório e notificar o mantenedor , ou replicar temporariamente essas regras em seu projeto, excluindo as mais abrangentes, e medir o ganho potencial antes de decidir se vale a pena correr o risco.
ProGuard e R8: semelhantes, mas não idênticos.
Durante anos, o ProGuard fez quatro coisas: removeu elementos não utilizados, otimizou bytecode, ofuscou nomes e adicionou informações de pré-verificação. O R8 continua de onde parou e vai além: insere métodos de forma mais agressiva, mescla classes, converte enumerações em inteiros quando possível e tem uma melhor compreensão dos recursos do Kotlin . Ele também compila mais rápido e, com a simplificação da biblioteca principal, permite o uso de APIs Java modernas em versões mais antigas do Android.
Em relação às regras, o R8 aceita as do ProGuard e adiciona alguns modificadores próprios, como aqueles que forçam ou impedem a inserção de um método específico. A conversão de nomes não altera o comportamento, mas complica a leitura dos rastreamentos de pilha : ela sempre preserva o arquivo de mapeamento para cada versão, a fim de recuperar o rastreamento original quando ocorre uma falha em produção.
Erros comuns na minimização e como resolvê-los
Os mesmos problemas continuam surgindo: "classe não encontrada" devido a uma classe excluída, "método inexistente" devido a um método renomeado, modelos que não são serializados porque perderam seus nomes ou bibliotecas que assumem que nada mudará. O diagnóstico quase sempre envolve verificar o que está sendo acessado via reflexão e adicionar a regra mínima necessária . Para investigar, habilite o uso, a inicialização e a impressão de mapeamentos em um arquivo temporário ou desabilite temporariamente otimizações específicas para isolar a causa do problema.
Vale ressaltar também que ferramentas externas que regeneram ou corrigem arquivos DEX podem quebrar as otimizações cuidadosamente implementadas pelo R8. Se sua cadeia de compilação inclui uma etapa desse tipo, revise-a antes de culpar o otimizador . E se o desempenho da compilação for uma preocupação, existem ajustes disponíveis para adaptar o R8 ao seu ambiente sem sacrificar seus benefícios.
Reduzir recursos: imagens, densidades e idiomas.
Os recursos geralmente representam uma grande parte do pacote. Converter bitmaps para WebP reduz o tamanho do arquivo, mantendo a qualidade , e os drawables vetoriais evitam a duplicação do mesmo ícone para cada densidade. Configurar apenas os buckets de densidade que você realmente usa e limitar os idiomas incluídos reduz significativamente o tamanho do arquivo, especialmente em aplicativos com muitas traduções. Para PNGs que você não pode converter, existem utilitários de compressão com perda mínima.
Isso também ajuda a colorir programaticamente um único recurso para tons de cinza em vez de agrupar várias versões coloridas, carregar imagens grandes e desnecessárias sob demanda na inicialização e remover recursos órfãos usando a inspeção de código da IDE. Se um recurso for referenciado apenas por código morto, a redução otimizada o detecta e remove , algo que não acontecia antes porque os dois processos eram executados separadamente.
Layouts, estilos e hierarquias de visualização
Aplanar hierarquias não reduz o tamanho do APK, mas melhora o desempenho, que é a outra metade do objetivo. Substitua o aninhamento desnecessário de contêineres por um ConstraintLayout bem projetado , extraia componentes comuns com `include` e defina estilos para evitar atributos duplicados. O inspetor de layout ajuda a detectar árvores de visualização absurdamente profundas que tornam a inflação mais lenta.
Pacotes de aplicativos, módulos dinâmicos e bibliotecas nativas
Publicar em formato de pacote é revolucionário: a loja gera pacotes personalizados para cada dispositivo, de modo que cada usuário baixa apenas o código e os recursos de que precisa. Os downloads são significativamente menores do que com um APK universal, pois esse formato filtra idiomas, densidades de dispositivos e arquiteturas que não se aplicam. Além disso, os recursos podem ser distribuídos em módulos de recursos que são baixados sob demanda, com base em critérios condicionais ou instantâneos.
Em relação às bibliotecas nativas, incluir apenas as arquiteturas que você suporta e manter a compressão ativada evita a inclusão de binários que ninguém executará. Se você compilar com o Bazel em vez do Gradle, também poderá integrar o R8 ao pipeline, embora seja importante lembrar que esse suporte não é oficialmente suportado para o desenvolvimento de aplicativos Android.
Meça o tamanho e monitore a evolução.
Sem medição, não há otimização. O analisador de APK da IDE mostra o tamanho real do pacote, e uma tarefa personalizada do Gradle pode gerar um relatório de tamanho após cada build. Adicionar essa verificação à integração contínua automatiza o controle de tamanho e impede que algumas novas dependências aumentem o tamanho do binário sem que ninguém perceba.
Como o comportamento mudou entre as versões?
Vale a pena revisar a evolução recente, pois ela explica muitas configurações antigas que não são mais relevantes. A versão 8.0 habilitou o modo completo por padrão ; a 8.6 aprimorou o rastreamento, incluindo o rastreamento de arquivos e linhas para qualquer minSdk; a 8.12 introduziu a redução otimizada de recursos e o rastreamento automático no Logcat; a 9.0 habilitou-o por padrão, filtrou opções globais em regras de consumidor e otimizou a verificação de nulos em Kotlin; a 9.1 reempacotou as classes por padrão; e a 9.3 introduziu o bloco de otimização simplificado e o conjunto de regras .keep.
Com tudo isso em mente, o que realmente faz a diferença é uma rotina simples: habilitar a otimização na versão de lançamento, revisar o relatório do analisador periodicamente, remover regras desnecessárias, limpar recursos e imagens, distribuir com pacotes e medir o tamanho a cada lançamento. São pequenos passos que, combinados, transformam um aplicativo pesado e lento em um que baixa num instante e inicia instantaneamente . E como o código e as dependências continuam crescendo, a revisão deve ser contínua: o que está otimizado hoje se torna inadequado assim que uma nova biblioteca é adicionada ou um recurso com seus próprios recursos é incorporado.
Perguntas frequentes
O que exatamente o R8 faz com o código da minha aplicação?
Ele analisa os pontos de entrada declarados, constrói um mapa de referência e remove tudo o que não é alcançável a partir deles. Em seguida, reescreve o código restante para ser executado com menos sobrecarga e encurta os nomes de classes, campos e métodos para economizar espaço.
Como faço para habilitar a otimização R8 nas versões mais recentes do plugin Gradle?
É ativado por meio de um parâmetro dentro do bloco de otimização do tipo de compilação de lançamento, que abrange tanto o código quanto os recursos. Suas próprias regras são inseridas em um conjunto específico de código-fonte, em arquivos com a extensão .keep.
Qual a diferença entre reduzir o código e reduzir os recursos?
A redução de código elimina classes, campos e métodos inacessíveis, enquanto a redução de recursos remove imagens, layouts e outros arquivos não utilizados. Nas versões modernas, ambas as tarefas são integradas em um único grafo de referência, evitando a retenção de recursos vinculados apenas a partir de código obsoleto.
Para que serve o Analisador de Configuração R8?
Meça a porcentagem do seu código-fonte que permanece disponível para redução, otimização e ofuscação, e analise o impacto de cada regra de preservação. Com esses dados, você pode identificar regras muito abrangentes, duplicadas e regras que não correspondem mais a nada.
Por que uma regra de conservação ampla prejudica o desempenho do meu aplicativo?
Porque impede que o R8 altere não apenas o que essa regra protege, mas também tudo o que depende dela. O resultado é mais código no pacote, mais metadados e menos espaço para aplicar inserção de métodos ou fusão de classes.
É melhor publicar usando App Bundles em vez de um APK universal?
Sim, porque a loja gera pacotes personalizados para cada dispositivo, e cada usuário baixa apenas os recursos de idioma, densidade e arquitetura de que precisa. Esse ajuste reduz significativamente o tamanho do download sem exigir que você mantenha arquivos separados.
Como posso ler um rastreamento de pilha a partir de uma compilação ofuscada?
Você precisa do arquivo de mapeamento gerado a cada versão de desenvolvimento e da ferramenta de rastreamento R8. Versões recentes inclusive rastreiam automaticamente os logs na janela Logcat da IDE.
Vale a pena otimizar uma biblioteca que pretendo publicar?
A otimização completa funciona melhor quando o R8 visualiza todo o grafo da aplicação, de modo que a maior parte do trabalho seja feita durante a compilação da aplicação final. Mesmo assim, uma biblioteca pode preparar cuidadosamente suas regras de consumo para evitar otimizações que bloqueiem projetos que a integrem.
Índice
- 1 O que exatamente o R8 faz e por que você deveria confiar nele?
- 2 Ative a otimização com base na versão do plugin Gradle.
- 3 Modo completo e redução de recursos otimizada
- 4 O Analisador de Configuração R8 e suas três pontuações
- 5 Como gerar o relatório sem perder tempo
- 6 Aprimore as regras de conservação sem prejudicar o aplicativo.
- 7 Regras duplicadas, não utilizadas e de biblioteca
- 8 ProGuard e R8: semelhantes, mas não idênticos.
- 9 Erros comuns na minimização e como resolvê-los
- 10 Reduzir recursos: imagens, densidades e idiomas.
- 11 Layouts, estilos e hierarquias de visualização
- 12 Pacotes de aplicativos, módulos dinâmicos e bibliotecas nativas
- 13 Meça o tamanho e monitore a evolução.
- 14 Como o comportamento mudou entre as versões?
- 15 Perguntas frequentes



