Ativar a otimização de apps com o R8

Para oferecer a melhor experiência do usuário, otimize seu app para que ele seja o menor e mais rápido possível. Nosso otimizador de apps, chamado R8, simplifica o app removendo código e recursos não utilizados, reescrevendo o código para otimizar a performance de execução e muito mais. Para os usuários, isso significa:

• Tempo de inicialização mais rápido
• Uso da memória reduzido
• Melhoria na renderização e na performance de execução
• Menos ANRs

Visão geral da otimização do R8

O R8 usa um processo de várias fases para otimizar o tamanho e a velocidade do app. As principais operações incluem o seguinte:

• Redução de código (também conhecida como tree shaking): o R8 identifica e remove códigos inacessíveis do aplicativo e das dependências da biblioteca. Ao analisar os pontos de entrada do app (como Activities ou Services definidos no manifesto), o R8 cria um gráfico de código referenciado e remove tudo o que não for referenciado.

• Otimizações lógicas: o R8 reescreve o código para melhorar a eficiência da execução e reduzir a sobrecarga. As principais técnicas incluem:

  • Inlining de método: o R8 substitui um local de chamada de método pelo corpo real do método chamado. Isso elimina a sobrecarga de uma chamada de função e permite que o R8 realize outras otimizações.

  • Mesclagem de classes: o R8 combina conjuntos de classes e interfaces em uma única classe. Isso reduz o número de classes no app, diminuindo a pressão da memória e melhorando a velocidade de inicialização.

• Ofuscação (também conhecida como minificação): para reduzir o tamanho do arquivo DEX , o R8 encurta os nomes de classes, campos e métodos (por exemplo, com.example.MyActivity pode se tornar a.b.a).

Desde a versão 8.12.0 do Plug-in do Android para Gradle (AGP), o R8 também otimiza os recursos como parte das fases de otimização. Para mais informações, consulte Redução otimizada de recursos.

Ativar a otimização

Para ativar a otimização do app, defina isMinifyEnabled = true (para otimização de código) e isShrinkResources = true (para otimização de recursos) no script de build do app no build de lançamento build's, conforme mostrado no código a seguir. Recomendamos que você sempre ative as duas configurações. Também recomendamos ativar a otimização do app apenas na versão final do app que você testa antes da publicação, geralmente o build de lançamento, porque as otimizações aumentam o tempo de build do projeto e podem dificultar a depuração devido à forma como o código é modificado.

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

Melhorar a otimização do R8

Os benefícios de desempenho do R8 estão diretamente relacionados à quantidade de base de código que o R8 pode otimizar. Para aproveitar ao máximo o R8, siga as práticas recomendadas:

• Ativar o R8 no modo completo
• Ativar a ofuscação, a otimização e a redução
• Ativar a redução de recursos e a redução otimizada de recursos
• Refinar as regras de manutenção para permitir a otimização máxima de classes, campos e métodos.

Para ajudar a refinar as regras de manutenção, use o analisador de configuração do R8.

O analisador de configuração do R8 permite fazer o seguinte:

• Acompanhar e melhorar a qualidade geral da configuração do R8 monitorando as métricas fornecidas pelo relatório do analisador de configuração do R8.
• Encontrar as regras de manutenção mais amplas, aquelas que impedem a maior parte da otimização
• e entender qual otimização elas impedem para refiná-las.

O analisador de configuração do R8 está disponível na versão 9.3.0-alpha05 do AGP ou na versão 9.3.7-dev do R8. Para mais informações, consulte Analisar a configuração do R8.

Otimizar a redução de recursos para apps ainda menores

A versão 8.12.0 do Plug-in do Android para Gradle (AGP) apresenta a redução otimizada de recursos, que visa integrar a otimização de recursos e códigos para criar apps ainda menores e mais rápidos.

Antes da redução otimizada de recursos, a Android Asset Packaging Tool (AAPT2) gerava regras de manutenção que tratavam a redução de recursos separadamente do código, muitas vezes retendo códigos ou recursos inacessíveis que se referiam uns aos outros.

Com a redução de recursos otimizada, os recursos são considerados como parte do código do programa, formando o gráfico de referência. Quando uma coleção de códigos ou recursos não é referenciada, ela não é protegida por uma regra de manutenção e pode ser removida.

Ativar a redução otimizada de recursos

Para ativar o novo pipeline de redução de recursos otimizada para AGP 8.12 ou 8.13, adicione o seguinte ao arquivo gradle.properties do projeto:

android.r8.optimizedResourceShrinking=true

Se você estiver usando o AGP 9.0.0 ou uma versão mais recente, não será necessário definir android.r8.optimizedResourceShrinking=true. A redução otimizada de recursos é aplicada automaticamente quando isShrinkResources = true está ativada na configuração do build.

Verificar e configurar as configurações de otimização do R8

Para permitir que o R8 use todos os recursos de otimização, remova a seguinte linha do arquivo gradle.properties do projeto, se ela existir:

android.enableR8.fullMode=false # Remove this line from your codebase.

A ativação da otimização do app dificulta a compreensão dos stack traces, especialmente se o R8 renomear nomes de classes ou métodos. Para receber stack traces que correspondam corretamente ao código-fonte, consulte Recuperar o stack trace original.

Se o R8 estiver ativado, também será necessário criar perfis de inicialização para uma performance ainda melhor na inicialização.

Se você ativar a otimização do app e ela causar erros, confira algumas estratégias para corrigi-los:

• Adicione regras de manutenção para manter alguns códigos intactos.
• Adote otimizações de forma incremental.
• Atualize o código para usar bibliotecas mais adequadas para otimização.

Se você quiser otimizar a velocidade do build, consulte Configurar como o R8 é executado para saber como configurar o R8 com base no seu ambiente.

Mudanças no comportamento da versão do AGP e do R8

A tabela a seguir descreve os principais recursos introduzidos em várias versões do Plug-in do Android para Gradle (AGP) e do compilador R8.