En esta página, se describen los cambios realizados en cada versión de las bibliotecas de Android Game Development Kit (AGDK). Hasta la versión 1.2.4, estas bibliotecas se conocían como el SDK de juegos de Android.
2023.3.0.0 (2 de junio de 2023)
Esta versión incluye varias correcciones de errores.
| corrección | Se realizaron correcciones de estabilidad en GameActivityEvents. |
Biblioteca de Memory Advice de Android
| función | Se actualizó el modelo de aprendizaje automático que potencia la biblioteca, lo que puede permitir mejores resultados para los teléfonos más nuevos. |
| corrección | Se corrigió un error por el que fallaba la biblioteca si la cantidad máxima de teclas de instrumentación superaba el recuento de histogramas. |
| función | Se actualizaron las funciones de recopilación de telemetría en la biblioteca, lo que permite generar informes más detallados de los tiempos de renderización de fotogramas. |
2023.2.0.0 (27 de abril de 2023)
Esta versión incluye varias correcciones de errores.
| corrección | Se corrigió la liberación anticipada de memoria con historyEventTimes. |
| corrección | Se corrigió el problema con el desbordamiento de historyEventTimesNanos en sistemas de 32 bits. |
Biblioteca de Memory Advice de Android
| corrección | Se corrigió un error que impedía que la versión estática de la biblioteca se vinculara correctamente. |
| corrección | Se corrigió un error en el que la biblioteca no podía cargar correctamente los recursos necesarios de TensorFlow Lite. |
2023.1.0.0 (15 de marzo de 2023)
Esta actualización importante incluye actualizaciones del sistema de compilación para compilar bibliotecas más rápido desde la fuente.
| cambiaste | Se cambió la interfaz para los tiempos de eventos históricos a fin de superar el límite de 32 bits. |
| función | Se proporcionó al usuario acceso a los cambios de configuración. |
| función | Se optimizó la mayoría de las llamadas JNI en el control de eventos táctiles. |
| corrección | Se corrigió el control predeterminado del SO de eventos táctiles, como el control de botones del sistema. |
| función | Se agregó la capacidad de detectar el estado de conexión de los teclados de hardware. |
| función | Se agregó la capacidad de informar datos de movimiento (acelerómetro/giroscopio) desde el dispositivo principal (es decir, el teléfono celular) y los controles. |
| cambiaste | Se cambió la API y el formato de la base de datos de definición del controlador para reducir el uso de memoria y admitir funciones adicionales. |
Biblioteca de Android Frame Pacing
| función | Se agregaron estadísticas de fotogramas de Vulkan. |
| función | Se agrega una nueva API para borrar estadísticas de fotogramas. |
| cambiaste | Los registros son silenciosos en el modo de lanzamiento y se pueden habilitar en el modo de depuración. |
2022.0.0 (15 de marzo de 2022)
Esta actualización importante incluye la biblioteca de consejos sobre memoria y varias correcciones para otras bibliotecas.
| función | Se agregó el control de las inserciones para el posicionamiento de la IU del juego alrededor del IME y los cortes. |
| función | Se agregaron filtros de eventos de teclas y movimiento. |
| corrección | Se realizaron correcciones para evitar la pérdida de eventos de entrada y evitar que se consuman todos ellos. |
| cambiaste | Los informes de memoria ahora son como series temporales en lugar de histogramas |
| función | Permitir que se configure el intervalo de carga de forma programática |
| corrección | Se corrigió el error de la clave de API dañada. |
Biblioteca de Android Frame Pacing
| función | Mejoras en el modo automático |
| función | Agrega funciones "uninjectTracer". |
Biblioteca de Memory Advice de Android
| función | Se agregó la biblioteca de Memory Advice |
2021.1.0 (12 de julio de 2021)
Cuando solíamos referirnos a este producto como el SDK de juegos de Android, ahora se lo conoce como Android Game Development Kit. Esta actualización principal incluye varias bibliotecas nuevas, junto con correcciones de errores menores en las bibliotecas de Android Frame Pacing y Android Performance Tuner.
| función | GameActivity es un componente nuevo que reemplaza y mejora la NativeActivity del NDK. |
| función | GameTextInput es un nuevo componente que mejora la interacción con el teclado en pantalla de Android. |
| función | GameController es un componente nuevo que facilita la interacción con controladores externos y su administración. |
1.2.4 (21 de abril de 2021)
Esta es una versión de corrección de errores para Android Performance Tuner.
| corrección | Se corrigió el tiempo de carga y el registro de la duración en dispositivos con CLOCK_BOOTTIME inconsistente. |
1.2.3 (10 de marzo de 2021)
Esta versión agrega Oboe al SDK de juegos. No se realizaron cambios en la biblioteca de Android Frame Pacing ni en Android Performance Tuner.
Oboe es una biblioteca C++ de código abierto para audio de alto rendimiento en Android. Oboe brinda una única API nativa que funciona en Android 4.1 (nivel de API 16) y versiones posteriores.
1.2.2 (12 de febrero de 2021)
Esta versión tiene mejoras en la API de tiempos de carga para Android Performance Tuner y varias correcciones de errores. No se realizaron cambios en la biblioteca Android Frame Pacing.
| función | Ahora, los eventos de carga deben agruparse con llamadas a TuningFork_startLoadingGroup y TuningFork_stopLoadingGroup. |
| corrección | Llamar a TuningFork_flush sube los datos de inmediato en lugar de ponerlos en cola para subirlos después. |
| corrección | Se produjo un error intermitente en la carga debido al formato JSON de los tiempos. |
| corrección | Un problema con las cargas en compilaciones de lanzamiento. |
1.2.1 (16 de diciembre, 2020)
Este es un lanzamiento interno de la función para Android Performance Tuner y una promoción de las bibliotecas de Jetpack de la versión alfa a la versión beta. No se realizaron cambios en las API de Android Frame Pacing ni de Android Performance Tuner.
Ten en cuenta que ahora se debe referir a las bibliotecas del SDK de juegos de manera individual cuando vincules con ellas, en lugar de vincular con la biblioteca genérica "gamesdk". Consulta la configuración de la compilación para Android Frame Pacing: OpenGL, Android Frame Pacing: Vulkan y Android Performance Tuner.
| función | Cuando un jugador ejecuta en segundo plano un juego durante la carga, se envía un evento para analizar el abandono de carga más adelante. |
1.2.0 (29 de octubre de 2020)
El cambio principal en esta versión es la adición de un mecanismo para registrar los tiempos de carga. También se corrigieron algunos errores. Ten en cuenta que el SDK de juegos ahora está disponible a través de la biblioteca de Jetpack para las bibliotecas de AGDK.
Biblioteca de Android Frame Pacing
| función | Compatibilidad con el cambio de frecuencia de la actualización del modo automático Ten en cuenta que, para admitir varias frecuencias de actualización en Android 11, independientemente de que se use el modo automático o no, se debe llamar a SwappyGL_setWindow o a SwappyVk_setWindow. |
| corrección | Corrección de errores en modo automático. |
| corrección | Corrección de errores de Vulkan. |
| función | Tiempos de carga. Se debe llamar a las funciones nuevas TuningFork_startRecordingLoadingTime y TuningFork_stopRecordingLoadingTime para registrar los eventos de tiempo de carga con anotaciones.
El tiempo desde el inicio de la app hasta TuningFork_init y la primera marca se registran automáticamente. |
| cambiaste | El método anterior para configurar una anotación del tiempo de carga dejará de funcionar. |
| función | Eventos de ciclo de vida. Se debe llamar a TuningFork_reportLifecycleEvent después de que se llame al onCreate adecuado de Java, etc., lo que habilita los informes de fallas detallados desde Android Performance Tuner. |
| cambiaste | Ahora, se registran más métricas de memoria cuando se llama a TuningFork_enableMemoryRecording(true). |
| cambiaste | Cambio en el modelo de memoria. Ahora, la cantidad máxima de métricas de cada tipo se especifica al inicio, en lugar de asignar espacio para todas las combinaciones de anotaciones posibles. Consulta TuningFork_MetricLimits en tuningfork.h. |
| corrección | No se realizaron cargas en conexiones de uso medido. |
1.1.0 (10 de junio de 2020)
Esta versión de las bibliotecas de AGDK cuenta con el informe de métricas de Android Performance Tuner y la biblioteca de ajustes de calidad (también conocida como Tuning Fork). Esta biblioteca está disponible para motores de juegos nativos y Unity, y presenta las siguientes funciones:
| función | Se realiza una integración con la biblioteca de Android Frame Pacing a fin de registrar automáticamente la latencia de fotogramas y otras métricas de procesamiento. |
| función | La información de latencia de fotogramas se graba en histogramas y se sube de forma periódica. |
| función | La anotación de los datos de latencia se basa en el estado actual del juego. |
| función | Las características, las anotaciones y la configuración de calidad del dispositivo se suben junto con los datos de latencia para permitir un análisis integral. |
| función | Se tratan de manera especial las anotaciones que indican el tiempo de carga de los niveles. Durante la carga, no se graban los datos de marcas de fotogramas, pero sí la duración de cada período de esta. |
| función | Se incluye la capacidad para grabar información de latencia personalizada (mediante startTrace y endTrace). |
1.0.2 (30 de marzo de 2020)
Esta versión incluye correcciones de errores y cambios en el comportamiento del modo automático.
| corrección | Se corrigieron errores de destrucción e inicialización nueva de Swappy. |
| cambiaste | La canalización ahora está activada de forma predeterminada. Swappy podrá desactivar la canalización automática cuando la carga de trabajo sea muy baja. |
| cambiaste | Si el modo automático está habilitado, Swappy decidirá cambiar el intervalo de intercambio cuando el 15% de los fotogramas en una ventana de 2 segundos sean más rápidos o más lentos de lo esperado. Ten en cuenta que Swappy nunca establecerá un intercambio más lento que el especificado por el usuario. |
1.0.1 (19 de febrero de 2020)
Esta es, esencialmente, una versión de corrección de errores.
| corrección | Limpia los recursos en la salida, en la ruta de acceso del código SwappyFallback en Vulkan. |
| corrección | SwappyVk_destroySwapchain ya no destruye los recursos del dispositivo si hay más de una cadena de intercambio. |
| corrección | La versión de Swappy ahora se imprime en logcat. |
| corrección | Se corrigieron interbloqueos y fallas en Swappy_destroy para el nivel de API 24 y versiones anteriores. |
| función | Se admiten administradores de subprocesos personalizados (Swappy_setThreadFunctions). |
| función | Se admite el hook de funciones de Vulkan (SwappyVk_setFunctionProvider). |
1.0.0 (5 de diciembre de 2019)
Esta versión inicial de las bibliotecas de AGDK incluye la biblioteca de Android Frame Pacing.
| función | Se incluye sincronización del búfer de pantalla. |
| función | Se admite la canalización y el modo de frecuencia de actualización automática. |
| función | Recopilación de estadísticas de procesamiento de fotogramas. |
| función | La selección del comportamiento durante el tiempo de ejecución se realizar de manera fluida en virtud de las funciones de Android, OpenGL y Vulkan requeridas por Swappy que estén presentes. |
| función | Se incluye vinculación estática y dinámica de la biblioteca. |
| función | Se admiten dispositivos con varias frecuencias de actualización. |