Incluir cenas de Addressables

Esta página descreve como configurar o Android Performance Tuner para incluir cenas do Addressables no Unity.

Addressables (link em inglês) permitem que os desenvolvedores carreguem conteúdo dinamicamente no momento da execução. Isso pode incluir cenas que não estão presentes nas configurações do build do Unity quando o .apk é criado. Antes do Android Performance Tuner 1.5.1, essas cenas não eram reconhecidas pelo Android Performance Tuner e não podiam ser inspecionadas no Play Console.

Requisitos

O suporte a cenas do Addressables tem os seguintes requisitos:

• Android Performance Tuner 1.5.1 ou mais recente
• Unity 2019.3 ou mais recente
• Pacote do Addressables 1.19.4 ou mais recente

Adicionar cenas do Addressables

Para que o Android Performance Tuner reconheça suas cenas do Addressables, faça o seguinte:

1. Quando estiver tudo pronto para testar o app, acesse Window > Android Performance Tuner > Setup e abra a guia Addressable Settings.

   Figura 1. Janela de configurações do Addressables.

2. Clique no botão Update Addressables Scenes.

Por padrão, todas as cenas contidas em AddressableAssetSettingsDefaultObject são incluídas no Android Performance Tuner. A janela agora mostra uma lista de todas as cenas que foram encontradas, com o valor delas salvo no arquivo .proto.

Figura 2. Cenas do Addressables listadas pelo Android Performance Tuner.

Para mudar o objeto de configurações do Addressables do qual as cenas são extraídas, faça o seguinte:

1. Acesse a pasta Assets/AndroidPerformanceTuner_gen/Runtime/Resources e abra o objeto de script SetupConfig no Inspector.

2. Insira o caminho do objeto de configurações personalizado no campo Addressables Settings Object Path, incluindo o nome do arquivo.

Para evitar problemas de compatibilidade com versões anteriores, recomendamos que você atualize as cenas do Addressables quando o layout delas estiver quase pronto.

O Android Performance Tuner coleta apenas dados de cenas que estavam no arquivo .apk que foi enviado ao Play Console.

Como redefinir cenas do Addressables

Para redefinir as cenas do Addressables, clique em Reset Addressables Scenes na guia Addressables Settings. No entanto, isso invalida a compatibilidade com a versão publicada do app.

Se você atualizar dinamicamente o objeto SetupConfig no app sem publicar uma nova versão, vai haver erros no Play Console, já que as relações entre cena e valor não serão preservadas.

Como definir cenas do Addressables em anotações

Se você estiver usando anotações padrão, o Android Performance Tuner vai definir automaticamente a cena correta. Caso esteja usando anotações personalizadas, chame ConvertAddressableScenePathToAPTSceneIndex():

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});