Perfis de imagem de inicialização

O Android 11 ou versões mais recentes oferecem suporte à geração de perfis de imagem de inicialização, que encapsulam informações sobre o código de vários componentes do sistema, como o servidor do sistema e o classpath de inicialização. O Android Runtime (ART) usa essas informações para realizar otimizações em todo o sistema, algumas das quais são essenciais para o desempenho do Android e afetam a execução de todo o código não nativo (nível do sistema ou do app). Em alguns casos, os perfis de imagem de inicialização podem afetar o desempenho da execução e o consumo de memória em porcentagens de dois dígitos.

Receber informações do perfil de inicialização

Os perfis de imagem de inicialização são derivados dos perfis de apps executados durante jornadas críticas do usuário (CUJs). Em uma configuração específica do dispositivo, o ART captura (como parte dos perfis JIT) os métodos e as classes do classpath de inicialização usados pelos apps e, em seguida, registra essas informações no perfil do app (por exemplo, /data/misc/profiles/cur/0/com.android.chrome/primary.prof), onde elas são indexadas pelo arquivo Dalvik EXecutable (DEX) do classpath de inicialização (consulte o formato de perfil do ART).

Analise os perfis de app registrados durante as CUJs para determinar qual parte do caminho de classe de inicialização é mais usada e mais importante para otimizar. Para conferir um exemplo, consulte o Formato de perfil do ART. Incluir todos os métodos ou classes afeta negativamente a performance. Portanto, concentre-se nos caminhos de código mais usados. Por exemplo, se um método do classpath de inicialização for usado por um único app, ele não poderá fazer parte dos perfis de inicialização. Cada dispositivo precisa configurar a seleção de método/classe com base na seleção de CUJ e na quantidade de dados produzidos pelo teste.

Para agregar informações do caminho de classe de inicialização de todos os perfis de app individuais no dispositivo, execute o comando adb shell cmd package snapshot-profile android. Você pode usar as informações agregadas como base para o processamento e a seleção de método/classe sem agregar manualmente perfis individuais, embora seja possível fazer isso se quiser.

Perfil da imagem de inicialização

Figura 1. Processo para conseguir os perfis de imagem de inicialização

Dados do perfil da imagem de inicialização

Os perfis de imagem de inicialização incluem os seguintes arquivos e dados.

  • Perfil para o caminho de classe de inicialização (frameworks/base/config/boot-image-profile.txt). Determina quais métodos do caminho de classe de inicialização são otimizados, qual classe é incluída na imagem .art de inicialização e como os arquivos DEX correspondentes são organizados.

  • Lista de classes pré-carregadas. Determina quais classes são pré-carregadas no Zigoto.

  • Perfil para os componentes do servidor do sistema (frameworks/base/services/art-profile). Determina quais métodos do servidor do sistema são otimizados/compilados, qual classe é incluída na imagem .art de inicialização e como os arquivos DEX correspondentes são dispostos.

Formato do perfil do ART

O perfil do ART captura informações de cada um dos arquivos DEX carregados, incluindo informações sobre métodos que valem a pena otimizar e classes usadas durante a inicialização. Quando a criação de perfil da imagem de inicialização está ativada, o ART também inclui o caminho de classe de inicialização e os arquivos JAR do servidor do sistema no perfil e anota cada arquivo DEX com o nome do pacote que o utiliza.

Por exemplo, faça o dump do perfil da imagem de inicialização bruta com o seguinte comando:

adb shell profman --dump-only --profile-file=/data/misc/profman/android.prof

Isso produz uma saída semelhante a:

=== Dex files  ===
=== profile ===
ProfileInfo [012]

core-oj.jar:com.google.android.ext.services [index=0] [checksum=e4e3979a]
        hot methods: 520[], 611[] …
        startup methods: …
        classes: …
...
core-oj.jar:com.android.systemui [index=94] [checksum=e4e3979a]
        hot methods: 520[], 521[]…
        startup methods: …
        classes: …

No exemplo acima:

  • core-oj.jar é usado por com.google.android.ext.services e com.android.systemui. Cada entrada lista os dois pacotes usados em core-oj.jar.

  • Ambos os processos usam o método com o índice DEX 520, mas apenas o processo systemui usa o método com o índice DEX 521. A mesma lógica se aplica às outras seções do perfil (por exemplo, classes de inicialização).

Durante o processamento de dados, filtre métodos/classes com base no uso, concedendo prioridade a processos em nível de sistema (por exemplo, o servidor do sistema ou systemui) ou a métodos que podem não ser usados com frequência, mas ainda são importantes (por exemplo, métodos usados pelo app de câmera).

O formato de perfil anota internamente cada método com várias flags (inicialização, pós-inicialização, quente, abi), que são mais do que mostradas no formato apenas de despejo. Para usar todos os indicadores, modifique os scripts disponíveis.

Recomendações

Siga as diretrizes abaixo para ter os melhores resultados.

  • Implante a configuração para gerar perfis de imagem de inicialização em vários dispositivos de teste e agregue os resultados antes de gerar o perfil de imagem de inicialização final. A ferramenta profman oferece suporte à agregação e seleção de vários perfis de imagem de inicialização, mas funciona apenas com a mesma versão da imagem de inicialização (mesmo caminho de classe de inicialização).

  • Dê prioridade de seleção aos métodos/classes usados pelos processos do sistema. Esses métodos/classes podem usar um código que não é usado com frequência por outros apps, mas que ainda é essencial para otimizar.

  • O formato dos dados de uma única execução de dispositivo é muito diferente de dispositivos de teste que executam CUJs reais. Se você não tiver uma grande frota de dispositivos de teste, use o mesmo dispositivo para executar várias CUJs e aumentar a confiança de que as otimizações do perfil de imagem de inicialização vão funcionar bem na produção. Esse cenário é descrito abaixo.

Configurar dispositivos

Para ativar a configuração do perfil de inicialização usando as propriedades do sistema, use um dos métodos abaixo.

  • Opção 1:configurar propriedades manualmente (funciona até reinicializar):

    adb root
    adb shell stop
    adb shell setprop dalvik.vm.profilebootclasspath true
    adb shell setprop dalvik.vm.profilesystemserver true
    adb shell start
    
  • Opção 2:use um local.prop (efeito permanente até que o arquivo seja excluído). Para fazer isso, siga estas etapas:

    1. Crie um arquivo local.prop com o conteúdo:

      dalvik.vm.profilebootclasspath=true
      dalvik.vm.profilesystemserver=true
      
    2. Execute os seguintes comandos:

      adb push local.prop /data/
      adb shell chmod 0750 /data/local.prop
      adb reboot
      
  • Opção 3: use a configuração do dispositivo para definir as seguintes propriedades do lado do servidor:

    persist.device_config.runtime_native_boot.profilesystemserver
    persist.device_config.runtime_native_boot.profilebootclasspath`
    

Gerar perfis de imagem de inicialização

Use as instruções abaixo para gerar um perfil básico de imagem de inicialização usando testes em um único dispositivo.

  1. Configure o dispositivo.

    1. Configure o dispositivo conforme descrito em Como configurar dispositivos.

    2. (Opcional) O novo formato de perfil leva tempo para limpar e substituir os outros perfis. Para acelerar a coleta de perfis, redefina todos os perfis no dispositivo.

      adb shell stop
      adb shell find "/data/misc/profiles -name *.prof -exec truncate -s 0 {} \;"
      adb shell start
      
    3. Execute as CUJs no dispositivo.

  2. Capture o perfil usando o seguinte comando:

    adb shell cmd package snapshot-profile android
    
  3. Extraia o perfil usando o seguinte comando:

    adb pull /data/misc/profman/android.prof
    
  4. Navegue até os arquivos JAR do classpath de inicialização usando os seguintes comandos:

    m dist
    ls $ANDROID_PRODUCT_OUT/boot.zip
    
  5. Gere o perfil da imagem de inicialização usando o seguinte comando profman.

    profman --generate-boot-image-profile --profile-file=android.prof --out-profile-path=... --out-preloaded-classes-path=...
    
  6. Usando dados, ajuste o comando profman usando as sinalizações de limite de seleção disponíveis.

    • --method-threshold
    • --class-threshold
    • --clean-class-threshold
    • --preloaded-class-threshold
    • --upgrade-startup-to-hot
    • --special-package

    Para conferir a lista completa, consulte a página de ajuda do profman ou o código-fonte.