En esta página, se describe la configuración de Android Performance Tuner para incluir escenas Addressable en Unity.
Las escenas Addressable permiten a los desarrolladores cargar contenido de forma dinámica durante el tiempo de ejecución. Esto puede incluir escenas que no están presentes en la configuración de compilación de Unity cuando se compila el archivo .apk. Antes de Android Performance Tuner 1.5.1, esta herramienta no reconocía esas escenas y no se podían inspeccionar en Play Console.
Requisitos
La compatibilidad con las escenas Addressable tiene los siguientes requisitos:
- Android Performance Tuner 1.5.1 o una versión posterior
- Unity 2019.3 o una versión posterior
- El paquete de Addressable 1.19.4 o una versión posterior
Cómo agregar escenas Addressable
Para que Android Performance Tuner reconozca tus escenas Addressable, haz lo siguiente:
Cuando todo esté listo para probar tu app, ve a Window> Android Performance Tuner > Setup y abre la pestaña Addressables Settings.
Figura 1: Ventana Addressables Settings.Haz clic en el botón Update Addressables Scenes.
De forma predeterminada, todas las escenas que contiene AddressableAssetSettingsDefaultObject se incluyen en Android Performance Tuner.
La ventana ahora muestra una lista de todas las escenas que se encontraron junto con su valor, como se guardó en el archivo .proto.
Figura 2: Escenas Addressable enumeradas por Android Performance Tuner.
Para cambiar el objeto de configuración de Addressable desde el que se extraen las escenas, haz lo siguiente:
Ve a la carpeta Assets/AndroidPerformanceTuner_gen/Runtime/Resources y abre el objeto de secuencia de comandos SetupConfig del Inspector.
Inserta la ruta de acceso al objeto de configuración personalizado del campo Addressables Settings Object Path, incluido el nombre del archivo.
Te recomendamos que actualices las escenas Addressable cuando tu diseño de escenas sea semifinal para evitar problemas de retrocompatibilidad.
Android Performance Tuner solo recopila datos de las escenas que estaban presentes en el archivo .apk que se subió a Play Console.
Cómo restablecer escenas Addressable
Para restablecer las escenas Addressable, haz clic en Reset Addressables Scenes en la pestaña Addressables Settings. Sin embargo, esto interrumpe la compatibilidad con la versión publicada actualmente de la app.
La actualización dinámica del objeto SetupConfig en la app sin publicar una nueva versión generará errores en Play Console, ya que no se conservarán las relaciones entre valores y escenas.
Cómo configurar escenas Addressable en las anotaciones
Si usas anotaciones predeterminadas, Android Performance Tuner establece automáticamente la escena correcta.
Si usas anotaciones personalizadas, llama a ConvertAddressableScenePathToAPTSceneIndex():
tuner.SetCurrentAnnotation(new Annotation
{
Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
Difficulty = Difficulty.Medium
});