Cette page décrit les modifications apportées à chaque version des bibliothèques Android Game Development Kit (AGDK). Jusqu'à la version 1.2.4, on parlait de SDK Android Game.
2023.3.0.0 (2 juin 2023)
Cette version inclut plusieurs corrections de bugs.
| corrigé | Correction de problèmes de stabilité dans GameActivityEvents. |
Bibliothèque de conseils sur la mémoire Android
| fonctionnalité | Mise à jour du modèle de machine learning sur lequel repose la bibliothèque, ce qui peut améliorer les résultats pour les téléphones plus récents. |
| corrigé | Correction d'un bug qui provoquait le plantage de la bibliothèque si le nombre maximal de clés d'instrumentation était supérieur au nombre d'histogrammes. |
| fonctionnalité | Mise à jour des fonctionnalités de collecte de télémétrie dans la bibliothèque afin de créer des rapports plus précis sur les délais d'affichage des frames. |
2023.2.0.0 (27 avril 2023)
Cette version inclut plusieurs corrections de bugs.
| corrigé | Correction de la libération anticipée de la mémoire avec historicalEventTimes. |
| corrigé | Résolution du problème de dépassement de historicalEventTimesNanos sur les systèmes 32 bits. |
Bibliothèque de conseils sur la mémoire Android
| corrigé | Correction d'un bug qui empêchait la version statique de la bibliothèque d'être associée correctement. |
| corrigé | Correction d'un bug qui empêchait la bibliothèque de charger correctement les éléments TensorFlow Lite requis. |
2023.1.0.0 (15 mars 2023)
Cette version majeure comporte des mises à jour du système permettant de créer des bibliothèques plus rapidement à partir de la source.
| modification | L'interface de l'historique des événements a été modifiée pour contourner la limite de 32 bits. |
| fonctionnalité | Fournit un accès utilisateur aux modifications de configuration. |
| fonctionnalité | Optimisation de la plupart des appels JNI pour la gestion des événements tactiles. |
| corrigé | Correction de la gestion par défaut des événements tactiles par l'OS, comme la gestion des boutons système. |
| fonctionnalité | Ajout de la possibilité de détecter l'état de connexion des claviers physiques. |
| fonctionnalité | Ajout de la possibilité de signaler les données de mouvement (accéléromètre/gyroscope) de l'appareil principal (téléphone) ainsi que des contrôleurs. |
| modification | Modification de l'API et du format de la base de données de définition de contrôleurs pour réduire l'encombrement de la mémoire et accepter des fonctionnalités supplémentaires. |
Bibliothèque Android Frame Pacing
| fonctionnalité | Des statistiques de frame Vulkan ont été ajoutées. |
| fonctionnalité | Une nouvelle API permettant d'effacer les statistiques de frames a été ajoutée. |
| modification | Les journaux sont tous silencieux en mode version et peuvent être activés en mode débogage. |
2022.0.0 (15 mars 2022)
Cette version majeure inclut la bibliothèque de conseils sur la mémoire et plusieurs correctifs pour d'autres bibliothèques.
| fonctionnalité | Ajout de la gestion des encarts pour positionner l'UI du jeu autour du code IMEI et des encoches. |
| fonctionnalité | Ajout de filtres d'événements de touche et de mouvement. |
| corrigé | Corrections apportées pour éviter de perdre des événements d'entrée et empêcher la consommation de tous les événements d'entrée. |
| modification | Les rapports sur la mémoire sont désormais des séries temporelles plutôt que des histogrammes. |
| fonctionnalité | Possibilité de définir par programmation un intervalle d'importation. |
| corrigé | Correction d'un bug lié à la clé API |
Bibliothèque Android Frame Pacing
| fonctionnalité | Améliorations apportées au mode automatique |
| fonctionnalité | Ajout de fonctions "uninjectTracer" |
Bibliothèque de conseils sur la mémoire Android
| fonctionnalité | Ajout de la bibliothèque de conseils sur la mémoire |
2021.1.0 (12 juillet 2021)
Le SDK Android Game est désormais appelé "Android Game Development Kit". Cette version majeure inclut plusieurs nouvelles bibliothèques ainsi que des corrections de bugs mineurs dans les bibliothèques Android Frame Pacing et Android Performance Tuner.
| fonctionnalité | GameActivity est un nouveau composant qui remplace et améliore l'activité native du NDK. |
| fonctionnalité | GameTextInput est un nouveau composant qui améliore l'interaction avec le clavier virtuel Android. |
| fonctionnalité | GameController est un nouveau composant qui facilite les interactions avec les contrôleurs externes et leur gestion. |
1.2.4 (21 avril 2021)
Cette version est une correction de bug pour Android Performance Tuner.
| correction | Correction apportée au temps de chargement et à l'enregistrement de la durée sur les appareils avec des données CLOCK_BOOTTIME incohérentes. |
1.2.3 (10 mars 2021)
Cette version ajoute Oboe au SDK Game. Aucune modification n'a été apportée à la bibliothèque Android Frame Pacing ni à Android Performance Tuner.
Oboe est une bibliothèque C++ Open Source pour les contenus audio hautes performances sur Android. Il fournit une API native unique qui fonctionne sur Android 4.1 (niveau d'API 16) ou version ultérieure.
1.2.2 (12 février 2021)
Cette version comporte des améliorations de l'API Android Performance Tuner en termes de temps de chargement, ainsi que plusieurs corrections de bugs. Aucune modification n'a été apportée à la bibliothèque Android Frame Pacing.
| fonctionnalité | Les événements de chargement doivent désormais être regroupés avec les appels à TuningFork_startLoadingGroup et TuningFork_stopLoadingGroup. |
| corrigé | L'appel de TuningFork_flush importe immédiatement les données au lieu de les mettre en file d'attente pour une importation ultérieure. |
| correction | Échec intermittent de l'importation en raison de la mise en forme JSON des heures. |
| correction | Problème lié aux importations sur les builds. |
1.2.1 (16 décembre 2020)
Ce build est une version interne d'Android Performance Tuner et une mise à niveau des bibliothèques Jetpack de la version alpha à la version bêta. Aucune modification n'a été apportée aux API Android Frame Pacing ou Android Performance Tuner.
Notez que les bibliothèques du SDK Game doivent désormais être référencées individuellement lors de l'association, au lieu d'être associées à la bibliothèque générique "gamesdk". Consultez les paramètres de compilation pour Android Frame Pacing : OpenGL, Android Frame Pacing : Vulkan et Android Performance Tuner.
| fonctionnalité | Lorsqu'un joueur envoie un jeu en arrière-plan pendant le chargement, un événement est transmis afin d'analyser ultérieurement l'abandon du chargement. |
1.2.0 (29 octobre 2020)
Le principal changement dans cette version est l'ajout d'un mécanisme permettant d'enregistrer les temps de chargement. Des corrections de bugs ont également été apportées. Notez que le SDK Game est désormais disponible via la bibliothèque Jetpack dans les bibliothèques ADGK.
Bibliothèque Android Frame Pacing
| fonctionnalité | Prise en charge du changement de la fréquence d'actualisation en mode automatique. Notez que, si vous utilisez plusieurs fréquences d'actualisation dans Android 11, vous devez appeler SwappyGL_setWindow ou SwappyVk_setWindow, que le mode automatique soit activé ou non. |
| correction | Correction de bugs liés au mode automatique. |
| correction | Correction de bugs dans Vulkan. |
| fonctionnalité | Temps de chargement. Les nouvelles fonctions TuningFork_startRecordingLoadingTime et TuningFork_stopRecordingLoadingTime doivent être appelées pour enregistrer les événements de temps de chargement annotés.
Le délai entre le démarrage de l'application en mode TuningFork_init et le premier tick est automatiquement enregistré. |
| modification | L'ancienne méthode permettant de définir une annotation de temps de chargement ne fonctionne plus. |
| fonctionnalité | Événements de cycle de vie.TuningFork_reportLifecycleEvent doit être appelé après l'appel du code Java onCreate approprié, etc. Des rapports d'erreur détaillés peuvent ainsi être générés depuis Android Performance Tuner. |
| modification | D'autres métriques de mémoire sont désormais enregistrées lorsque TuningFork_enableMemoryRecording(true) est appelé. |
| modification | Changement de modèle de mémoire. Le nombre maximal de métriques de chaque type est désormais spécifié au démarrage, au lieu d'allouer l'espace pour toutes les combinaisons d'annotations possibles. Consultez TuningFork_MetricLimits dans tuningfork.h. |
| correction | Pas d'importation pour les connexions facturées à l'usage. |
1.1.0 (10 juin 2020)
Cette version des bibliothèques AGDK intègre la création de rapports basés sur les métriques Android Performance Tuner et la bibliothèque de réglages de qualité (également appelée Tuning Fork). Cette bibliothèque est disponible pour les moteurs de jeux natifs ainsi que pour Unity et présente les fonctionnalités suivantes :
| fonctionnalité | Intégration à la bibliothèque Android Frame Pacing pour enregistrer automatiquement les temps de rendu et autres métriques de rendu. |
| fonctionnalité | Les informations de temps de rendu sont enregistrées dans des histogrammes et importées régulièrement. |
| fonctionnalité | Annotation des données temporelles avec l'état actuel du jeu. |
| fonctionnalité | Les caractéristiques, les annotations et les paramètres de qualité de l'appareil sont importés avec les données temporelles pour permettre une analyse transversale. |
| fonctionnalité | Traitement spécial des annotations qui indiquent le temps de chargement des niveaux. Les données de fréquence de frame ne sont pas enregistrées lors du chargement, mais la durée de chaque période de chargement l'est. |
| fonctionnalité | Possibilité d'enregistrer des informations temporelles personnalisées (à l'aide de startTrace et d'endTrace). |
1.0.2 (30 mars 2020)
Cette version inclut des corrections de bugs et des changements du comportement du mode automatique.
| correction | Corrections de bugs apportées pour la destruction et la réinitialisation de Swappy. |
| modification | Les pipelines sont maintenant activés par défaut. Si les pipelines automatiques sont activés, Swappy peut décider de les désactiver lorsque la charge de travail est très faible. |
| modification | Lorsque le mode automatique est activé, Swappy ne modifie l'intervalle d'échange que lorsque 15 % des frames au cours d'une fenêtre de deux secondes sont plus rapides ou plus lents que prévu. Notez que Swappy n'effectue jamais un échange plus lent que l'intervalle spécifié par l'utilisateur. |
1.0.1 (19 février 2020)
Cette version vise principalement à corriger des bugs.
| correction | Nettoyage des ressources à la sortie au niveau du chemin de code SwappyFallback dans Vulkan. |
| correction | SwappyVk_destroySwapchain ne détruit plus les ressources de l'appareil s'il existe plusieurs chaînes d'échange. |
| correction | La version de Swappy est maintenant imprimée dans logcat. |
| correction | Plantages et interblocages dans Swappy_destroy pour les niveaux d'API 24 et inférieurs. |
| fonctionnalité | Prise en charge des gestionnaires de threads personnalisés (Swappy_setThreadFunctions). |
| fonctionnalité | Prise en charge des hooks correspondant aux fonctions Vulkan (SwappyVk_setFunctionProvider). |
1.0.0 (5 décembre 2019)
Cette version initiale des bibliothèques AGDK intègre la bibliothèque Android Frame Pacing.
| fonctionnalité | Affichage de la synchronisation du tampon. |
| fonctionnalité | Prise en charge du mode d'actualisation et des pipelines automatiques. |
| fonctionnalité | Collecte des statistiques de rendu des images. |
| fonctionnalité | Sélection élégante du comportement au moment de l'exécution, en fonction de la présence des fonctionnalités Android, OpenGL et Vulkan nécessaires à Swappy. |
| fonctionnalité | Association statique et dynamique de la bibliothèque. |
| fonctionnalité | Prise en charge des appareils avec plusieurs fréquences d'actualisation. |