Игры для Android

Библиотека игр для Android дублирует Android Game SDK, который доступен для загрузки в виде бинарного файла. Вместо ручной загрузки и интеграции Android Game SDK в вашу сборку вы можете использовать библиотеку androidx.

Для получения дополнительной информации об Android Game SDK см. документацию по SDK и примечания к выпуску SDK .

В этой таблице перечислены все артефакты, входящие в группу androidx.games .

Артефакт Стабильный релиз Предварительная версия для выпуска Бета-версия Альфа-версия
игры-активность 4.0.0 - 4.4.0-beta01 -
игровой контроллер 2.0.2 - - 2.3.0-alpha01
игровая-частота-кадров 2.1.3 - - 2.3.0-alpha01
игры-память-советы 2.0.1 - 2.1.0-beta01 2.3.0-alpha01
игры-текст-ввод 4.0.0 - 4.3.0-бета01 -
тюнер производительности игр 2.0.0 - - 2.3.0-alpha01
Последнее обновление этой библиотеки: 19 ноября 2025 г.

Требования

игры-память-советы

Для работы API MemoryAdvice требуется, чтобы ваше приложение было собрано с использованием NDK версии r23.* или новее.

Объявление зависимостей

Чтобы добавить зависимость от игры, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых вам артефактов в файл build.gradle для вашего приложения или модуля; библиотека games-activity интегрировала ту же версию библиотеки game-text-input , поэтому приложения GameActivity не могут повторно включить зависимость game-text-input :

классный

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.3"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:2.0.0"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:4.0.0"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:2.0.2"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:4.0.0"
}

Котлин

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:2.1.3")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:2.0.0")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:4.0.0")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.2")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:4.0.0")
}
}

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Добавить свойства Gradle

Возможно, вам потребуется добавить свойства в файл gradle.properties , расположенный в том же каталоге, что и файл build.gradle вашего приложения (или модуля). Если файл gradle.properties отсутствует, создайте его.

Если вы используете Android Studio 4.0, убедитесь, что gradle.properties содержит следующие строки:

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Если вы используете Android Studio 4.1 или более позднюю версию, убедитесь, что gradle.properties содержит следующие строки:

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Добавление пакетов с помощью CMake

Чтобы сделать импортированные пакеты Game SDK доступными, добавьте следующее в файл CMakeLists.txt вашего основного приложения:

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

Это позволит вам включать заголовочные файлы из Android Game SDK в код вашей игры:

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

В файле CMakeLists.txt вашего основного приложения найдите target_link_libraries для основной разделяемой библиотеки. Добавьте ссылки на статические библиотеки Android Game SDK, чтобы включить их в вашу разделяемую библиотеку:

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Советы по управлению памятью в играх, версия 2.1

Версия 2.1.0-beta01

29 ноября 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.1.0-beta01 . Версия 2.1.0-beta01 содержит следующие коммиты.

Версия 2.1.0-alpha01

15 ноября 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.1.0-alpha01 . Версия 2.1.0-alpha01 содержит следующие коммиты.

Новые функции

  • Обновлена ​​модель памяти библиотеки для повышения точности прогнозов.

Изменения в API

  • Добавлен новый API-функция getAvailableMemory() , которая возвращает приблизительный объем памяти, который можно безопасно выделить, в байтах.

Версия 2.1.0-alpha01

26 июля 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.1.0-alpha01 . Версия 2.1.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Добавить функцию GetAvailableMemory

Исправлены ошибки

  • Обновить модель рекомендаций по использованию памяти
  • Исправить целевой объект сборки shared memory_advice

Советы по управлению памятью в играх, версия 2.0

Версия 2.0.1

20 сентября 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.1 . Версия 2.0.1 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, приводящая к сбою в потоке наблюдателя состояния из-за того, что поток не был подключен к JVM.

Версия 2.0.0

6 сентября 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0 . Версия 2.0.0 содержит следующие коммиты.

Основные особенности версии 2.0.0

  • В этой версии обучена и выпущена новая модель машинного обучения.
  • Реализован API для прогнозирования объема свободной памяти.

Версия 2.0.0-rc01

26 июля 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-rc01 . Версия 2.0.0-rc01 содержит следующие коммиты.

Новые функции

  • Включена новая модель для более точного прогнозирования оставшейся памяти.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой функция Memory Advice не работала с общей библиотекой STL.

Версия 2.0.0-beta04

24 мая 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-beta04 . Версия 2.0.0-beta04 содержит следующие коммиты.

Новые функции

  • Обновлена ​​модель машинного обучения, лежащая в основе библиотеки, что позволит получить более качественные результаты для новых телефонов.

Версия 2.0.0-beta03

5 апреля 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-beta03 . Версия 2.0.0-beta03 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой библиотека не могла корректно загрузить необходимые ресурсы TensorFlow Lite.

Версия 2.0.0-beta02

22 марта 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-beta02 . Версия 2.0.0-beta02 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, препятствовавшая корректной компоновке статической версии библиотеки.

Версия 2.0.0-beta01

22 февраля 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-beta01 . Версия 2.0.0-beta01 содержит следующие коммиты.

Новые функции

  • Никаких новых изменений.

Версия 2.0.0-alpha01

8 февраля 2023 г.

Выпущена версия androidx.games:games-memory-advice:2.0.0-alpha01 . Версия 2.0.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Значительное увеличение версии в связи с рефакторингом файлов сборки.

Исправлены ошибки

  • Теперь неправильная настройка ресурсов библиотеки приводит к ошибке вместо сбоя.

Games-Memory-Advice версия 1.0.0

Версия 1.0.0-beta03

9 ноября 2022 г.

Выпущена версия androidx.games:games-memory-advice:1.0.0-beta03 . Версия 1.0.0-beta03 содержит следующие коммиты.

Новые функции

  • Никаких новых изменений.

Версия 1.0.0-beta01

9 марта 2022 г.

Выпущена версия androidx.games:games-memory-advice:1.0.0-beta01 . Версия 1.0.0-beta01 содержит следующие коммиты.

  • С момента выхода версии 1.0.0-alpha01 изменений не наблюдалось.

Версия 1.0.0-alpha01

23 февраля 2022 г.

Выпущена версия androidx.games:games-memory-advice:1.0.0-alpha01 . Версия 1.0.0-alpha01 содержит следующие коммиты.

Новые функции

  • Эта библиотека на языке C предоставляет возможность запрашивать и получать обратные вызовы для отслеживания изменений в состоянии памяти устройства, на котором запущена игра.

Изменения в API

  • Это первая версия библиотеки для предоставления рекомендаций по использованию памяти. Полный API см. в заголовочном файле include/memory_advice/memory_advice.h.

Внешний вклад

  • Библиотека зависит от TensorFlow, лицензию которого, а также лицензии транзитивных зависимостей можно найти по адресу https://github.com/tensorflow/tensorflow .

Games-Text-Input Version 4.3

Версия 4.3.0-beta01

19 ноября 2025 г.

Выпущена версия androidx.games:games-text-input:4.3.0-beta01 . Версия 4.3.0-beta01 содержит следующие изменения .

  • В этом релизе модуль androidx.games:games-text-input переходит из альфа-версии в бета-версию.

Games-Text-Input Version 3.0

Версия 3.0.4

7 августа 2024 г.

Выпущена версия androidx.games:games-text-input:3.0.4 . Версия 3.0.4 содержит следующие изменения .

Исправлены ошибки

  • Исправлена ​​функциональность удаления как с выделением текста, так и без него.

Games-Activity Версия 4.0

Версия 4.4.0-beta01

19 ноября 2025 г.

Выпущена версия androidx.games:games-activity:4.4.0-beta01 . Версия 4.4.0-beta01 содержит следующие изменения .

  • В этом релизе модуль androidx.games:games-activity переходит из альфа-версии в бета-версию.

Версия 4.4.0-alpha01

22 октября 2025 г.

Выпущена версия androidx.games:games-activity:4.4.0-alpha01 . Версия 4.4.0-alpha01 содержит следующие коммиты .

Исправлены ошибки

  • Улучшена защита от ANR в native_app_glue .
  • Перенесено использование устаревшего ALooper_pollAll на ALooper_pollOnce .

Версия 4.3.0-alpha01

13 августа 2025 г.

Выпущены androidx.games:games-activity:4.3.0-alpha01 и androidx.games:games-text-input:4.3.0-alpha01 . Версия 4.3.0-alpha01 содержит следующие коммиты .

Новые функции

  • Поддерживается размер страницы 16 КБ по умолчанию.
  • Поддержка мыши для GameActivity.

Исправлены ошибки

  • Исправлена ​​ошибка, приводящая к состоянию гонки между событиями жизненного цикла onDestroy и onCreate .
  • Исправлена ​​ошибка, из-за которой приложениям приходилось вручную сохранять символ для инициализации нативного кода.
  • Улучшена обработка касаний GameActivity .
  • Исправлена ​​ошибка, из-за которой GameTextInput некорректно генерировался как разделяемая библиотека.

Версия 4.2.0-alpha01

26 марта 2025 г.

Выпущены androidx.games:games-activity:4.2.0-alpha01 и androidx.games:games-text-input:4.2.0-alpha01 . Версия 4.2.0-alpha01 содержит следующие коммиты .

Новые функции

  • Обновите Gradle до версии 8.8.1 ( 1ed0153 )
  • Обновление до Java 17 ( 1ed0153 )

Исправлены ошибки

  • Исправлена ​​ошибка в GameActivity , из-за которой getLocaleScript , getLocaleCountry и getLocaleVariant сообщали язык локали вместо запрошенного значения ( 1198bb0 ).
  • Исправлена ​​ошибка в GameActivity , из-за которой мы неправильно сообщали о событиях открытия и закрытия программной клавиатуры. ( a63ecca )
  • Исправлена ​​ошибка в GameTextInput при обработке многобайтовых эмодзи ( 9d54c68 )

Версия 4.0.0

12 февраля 2025 г.

Выпущены androidx.games:games-activity:4.0.0 и androidx.games:games-text-input:4.0.0 . Версия 4.0.0 содержит следующие коммиты .

Основные особенности версии 4.0.0

  • Теперь AAR-файлы содержат предварительно скомпилированные статические библиотеки. Ожидается, что код приложения будет использовать эти библиотеки через префабы и включать только заголовочные файлы (например, #include "GameActivity.h" ), а не саму реализацию (например #include "GameActivity.cpp" ).
  • Кроме того, информация о локализации Android теперь доступна нативному коду, использующему GameActivity .

Исправлены ошибки

  • В GameTextInput исправлено множество ошибок. Теперь библиотека более стабильна и работает со многими популярными программными и аппаратными клавиатурами.

Версия 4.0.0-rc01

29 января 2025 г.

Выпущены версии androidx.games:games-activity:4.0.0-rc01 и androidx.games:games-text-input:4.0.0-rc01 . Версия 4.0.0-rc01 содержит следующие коммиты .

Версия 4.0.0-beta01

15 января 2025 г.

Выпущены версии androidx.games:games-activity:4.0.0-beta01 и androidx.games:games-text-input:4.0.0-beta01 . Версия 4.0.0-beta01 содержит следующие коммиты .

Исправлены ошибки

  • Более подробно задокументирована новая функциональность, связанная с языковыми настройками.
  • Добавлены типы данных для всех типов перечислений.

Версия 4.0.0-alpha01

16 октября 2024 г.

Выпущены androidx.games:games-activity:4.0.0-alpha01 и androidx.games:games-text-input:4.0.0-alpha01 . Версия 4.0.0-alpha01 содержит следующие коммиты .

Новые функции

  • Теперь GameTextInput поддерживает клавиши «Влево»/«Вправо».

Изменения в API

  • Устаревшие Java-интерфейсы GameTextInput были удалены.
  • Теперь префабы для GameActivity и GameTextInput включают все исходные файлы. Использование директивы #include <GameActivity.cpp> больше не рекомендуется. Вместо этого, пожалуйста, используйте ссылки на подходящие статические или динамические библиотеки, например, game-activity::game-activity_static в CMake . Эти библиотеки поставляются в AAR-файле.

Исправлены ошибки

  • Внесено множество исправлений в GameTextInput . Исправлена ​​функциональность ввода и удаления текста.
  • Улучшена совместимость с большинством популярных программных клавиатур.
  • Исправлена ​​обработка специальных символов на аппаратных клавиатурах.
  • Исправлена ​​редкая ошибка доступа к нулевому указателю в GameActivity .

Games-Activity Версия 3.0

Версия 3.0.5

7 августа 2024 г.

Выпущена версия androidx.games:games-activity:3.0.5 . Версия 3.0.5 содержит следующие изменения .

Исправлены ошибки

  • Новая версия GameActivity , соответствующая версии 3.0.4 GameTextInput (исправлена ​​ошибка удаления текста в полях ввода).

Версия 3.0.4

10 июля 2024 г.

Выпущена версия androidx.games:games-activity:3.0.4 . Версия 3.0.4 содержит следующие изменения .

Исправлены ошибки

  • Исправлена ​​обработка нулевых указателей.
  • Исправлена ​​ошибка, из-за которой отсутствовали обновления состояния для некоторых состояний в функции обратного вызова onConfiguration() .

Версия 3.0.3

17 апреля 2024 г.

Выпущены androidx.games:games-activity:3.0.3 и androidx.games:games-text-input:3.0.3 . Версия 3.0.3 содержит следующие коммиты .

Исправлены ошибки

  • Исправлены проблемы совместимости с некоторыми программными клавиатурами.

Версия 3.0.2

3 апреля 2024 г.

Выпущены androidx.games:games-activity:3.0.2 и androidx.games:games-text-input:3.0.2 . Версия 3.0.2 содержит следующие коммиты .

Исправлены ошибки

  • Мы внесли несколько исправлений в GamesTextInput , направленных на улучшение поддержки программных и аппаратных клавиатур. Также исправлена ​​ошибка, из-за которой GameTextInput не использовался без GameActivity .

Версия 3.0.1

20 марта 2024 г.

Выпущены androidx.games:games-activity:3.0.1 и androidx.games:games-text-input:3.0.1 . Версия 3.0.1 содержит следующие коммиты .

Исправлены ошибки

  • Исправлена ​​ошибка, связанная с вводом и отображением специальных символов.

Версия 3.0.0

6 марта 2024 г.

Выпущены androidx.games:games-activity:3.0.0 и androidx.games:games-text-input:3.0.0 . Версия 3.0.0 содержит следующие коммиты .

Основные особенности версии 3.0.0

  • GameTextInput был переработан и готов к использованию в играх.
  • В обеих библиотеках были внесены некоторые изменения по сравнению с версией 2.0.0.

Исправлены ошибки

  • Исправлены проблемы совместимости со старыми версиями NDK.
  • Исправлены проблемы сборки для Windows.

Версия 3.0.0-rc01

21 февраля 2024 г.

Выпущены коммиты androidx.games:games-activity:3.0.0-rc01 и androidx.games:games-text-input:3.0.0-rc01 . Версия 3.0.0-rc01 содержит эти коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой лупер некорректно обрабатывал события клавиатуры.

Версия 3.0.0-beta01

29 ноября 2023 г.

Выпущены версии androidx.games:games-activity:3.0.0-beta01 и androidx.games:games-text-input:3.0.0-beta01 . Версия 3.0.0-beta01 содержит следующие изменения.

Версия 3.0.0-alpha01

15 ноября 2023 г.

Выпущены модули androidx.games:games-activity:3.0.0-alpha01 и androidx.games:games-text-input:3.0.0-alpha01 . Версия 3.0.0-alpha01 содержит следующие изменения.

Изменения в API

  • Размеры структур GameActivityMotionEvent и GameActivityCallbacks изменились.
  • onEditorAction изменяет тип возвращаемого значения с логического (boolean) на void.
  • Теперь setImeEditorInfo ожидает в качестве параметров перечисления, а не целых чисел.
  • Внутренние функции класса GameActivityEvents перенесены в файл GameActivityEvents_internal.h .
  • GameTextInput типы ввода также являются перечислениями, а не целыми числами.

Игры-Задания, версия 2.1

Версия 2.1.0-alpha02

6 сентября 2023 г.

Выпущены модули androidx.games:games-activity:2.1.0-alpha02 и androidx.games:games-text-input:2.1.0-alpha02 . Версия 2.1.0-alpha02 содержит следующие изменения.

Исправлены ошибки

  • Улучшена совместимость с 32-битными устройствами.

Версия 2.1.0-alpha01

26 июля 2023 г.

Выпущена версия androidx.games:games-activity:2.1.0-alpha01 . Версия 2.1.0-alpha01 содержит следующие коммиты.

Новые функции

  • Предоставить возможность переопределять создание экземпляра SurfaceView
  • Добавить отчет о версиях SDK.

Изменения в API

  • Для параметра historicalEventTimes используйте int64_t вместо long , чтобы избежать переполнения на 32-битных системах.
  • Добавить метод GameActivity_restartInput
  • Добавить встроенную функцию обратного вызова для обработки изменения видимости программной клавиатуры.

Исправлены ошибки

  • Оптимизация обработки событий касания
  • Правильное уничтожение события GameActivityMotionEven
  • Исправлена ​​ошибка в расчете индекса функции GameActivityMotionEvent_getHistoricalAxisValue
  • Исправить битовые маски для фильтра движения

Игровая активность, версия 2.0

Версия 2.0.2

24 мая 2023 г.

Выпущена версия androidx.games:games-activity:2.0.2 . Версия 2.0.2 содержит следующие коммиты.

Исправлены ошибки

  • Исправлены ошибки стабильности в GameActivityEvents ( b/278017467 )

Версия 2.0.1

5 апреля 2023 г.

Выпущена версия androidx.games:games-activity:2.0.1 . Версия 2.0.1 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка преждевременного освобождения памяти при использовании historicalEventTimes .
  • Исправлена ​​проблема с переполнением объекта historicalEventTimesNanos в 32-битных системах.

Версия 2.0.0

8 марта 2023 г.

Выпущена версия androidx.games:games-activity:2.0.0 . Версия 2.0.0 содержит следующие коммиты.

Основные особенности версии 2.0.0

  • Изменен интерфейс для отображения истории событий, чтобы преодолеть 32-битное ограничение.
  • Предоставлен пользователю доступ к изменениям конфигурации, например, к изменению ориентации экрана.
  • В структуре contentRect представлена ​​актуальная информация.
  • Предложен более простой способ настройки SurfaceView по умолчанию.
  • Исправлена ​​стандартная обработка событий касания в операционной системе, аналогичная обработке событий нажатия системных кнопок.
  • В обработке событий касания оптимизирована большая часть вызовов JNI; ранее это влияло на производительность.

Версия 2.0.0-rc01

22 февраля 2023 г.

Выпущена версия androidx.games:games-activity:2.0.0-rc01 . Версия 2.0.0-rc01 содержит следующие коммиты.

Версия 2.0.0-beta01

8 февраля 2023 г.

Выпущена версия androidx.games:games-activity:2.0.0-beta01 . Версия 2.0.0-beta01 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​обработка системных кнопок. ( 2a103e )

Версия 2.0.0-alpha01

11 января 2023 г.

Выпущена версия androidx.games:games-activity:2.0.0-alpha01 без изменений. Версия 2.0.0-alpha01 содержит следующие коммиты.

Игровые задания, версия 1.2

Версия 1.2.2

7 декабря 2022 г.

Выпущена версия androidx.games:games-activity:1.2.2 . Версия 1.2.2 содержит следующие коммиты.

Исправлены ошибки

  • Теперь максимальное количество событий движения можно установить во время выполнения программы.

Версия 1.2.2-alpha01

9 ноября 2022 г.

Выпущена версия androidx.games:games-activity:1.2.2-alpha01 . Версия 1.2.2-alpha01 содержит следующие коммиты.

Изменения в API

  • Теперь API также содержит информацию о версии в виде GAMEACTIVITY_PACKED_VERSION ( I287e6 ).
  • Добавлен коллбэк onContentRectChanged , который вызывается при изменении прямоугольника в окне, куда должен быть помещен контент. ( I81396 )

Исправлены ошибки

  • Исправлено переполнение буфера событий. Теперь как inputBuffer -> keyEvents , так и motionEvents являются динамически выделяемыми буферами. ( Ic00f6 )
  • При нехватке памяти функция корректно завершает работу. Добавлена ​​обработка ошибок realloc() при изменении размера буферов.

Версия 1.2.1

13 июля 2022 г.

Выпущена версия androidx.games:games-activity:1.2.1 . Версия 1.2.1 содержит следующие коммиты.

Исправлены ошибки

  • Исправлены проблемы с отсутствующим файлом .aar в предыдущей версии.

Версия 1.2.0

15 июня 2022 г.

Выпущена версия androidx.games:games-activity:1.2.0 . Версия 1.2.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.1.0

  • Разрешить производным классам GameActivity обрабатывать загрузку собственных библиотек.
  • Всегда загружайте нативную библиотеку в методе GameActivity.onCreate.
  • В случае отсутствия других библиотек, будет выполнена загрузка библиотеки с именем "main".

Игровые задания, версия 1.1

Версия 1.1.0

23 февраля 2022 г.

Выпущены androidx.games:games-activity:1.1.0 и androidx.games:games-controller:1.1.0 . Версия 1.1.0 содержит следующие изменения.

Важные изменения с версии 1.0.0

Игровая деятельность:

  • WindowInsets прослушивает и запрашивает информацию о вырезе окна и ответе IME.
  • Добавьте фильтры по ключевым и движенческим событиям.
  • Исправлены ошибки:
    • Добавлены недостающие сообщения для обеспечения совместимости с NativeActivity.
    • Исправить подпись onNativeWindowResized.
    • Исправление потерь входных событий

Версия 1.1.0-rc01

9 февраля 2022 г.

Выпущены версии androidx.games:games-activity:1.1.0-rc01 и androidx.games:games-controller:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие изменения.

Версия 1.1.0-beta03

26 января 2022 г.

Выпущена версия androidx.games:games-activity:1.1.0-beta03 . Версия 1.1.0-beta03 содержит следующие коммиты.

Исправлены ошибки

  • Исправить подпись onNativeWindowResized
  • Сохраняйте дескриптор нативного окна в onSurfaceChanged

Версия 1.1.0-beta02

15 декабря 2021 г.

Выпущена версия androidx.games:games-activity:1.1.0-beta02 . Версия 1.1.0-beta02 содержит следующие коммиты.

Исправлены ошибки

  • Устранить состояние гонки в настройках фильтра событий.

Версия 1.1.0-beta01

17 ноября 2021 г.

Выпущена версия androidx.games:games-activity:1.1.0-beta01 . Версия 1.1.0-beta01 содержит следующие коммиты.

Новые функции

  • Добавлена ​​поддержка запроса отступов окна и отслеживания изменений отступов. Это позволяет играм реагировать на всплывающее окно ввода и обрабатывать отступы в виде водопада и выреза камеры.

Изменения в API

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

Исправлены ошибки

  • Избегайте обработки всех ключевых событий: громкость, камера и т. д. теперь передаются в систему.

Версия 1.1.0-alpha01

29 сентября 2021 г.

Выпущена версия androidx.games:games-activity:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты.

Изменения в API

  • В функцию обратного вызова GameActivityCallbacks добавлена ​​функция onContentRectChanged

Исправлены ошибки

  • В файл android_native_app_glue.h добавлены отсутствующие сообщения:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

Версия 2.0.0

7 августа 2024 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0 . Версия 2.0.0 содержит следующие изменения .

Основные особенности версии 2.0.0

  • С момента выхода версии 2.0.0beta01 существенных изменений нет, мы просто помечаем этот релиз как стабильный.

Версия 2.0.0-beta01

10 января 2024 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-beta01 без изменений по сравнению с последним альфа-релизом. Версия 2.0.0-beta01 содержит следующие коммиты.

Версия 2.0.0-alpha07

29 ноября 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha07 . Версия 2.0.0-alpha07 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой в отчетах телеметрии памяти иногда отображались неверные значения.

Версия 2.0.0-alpha06

1 ноября 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha06 . Версия 2.0.0-alpha06 содержит следующие коммиты.

Версия 2.0.0-alpha05

23 августа 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha05 . Версия 2.0.0-alpha05 содержит следующие коммиты.

Новые функции

  • Библиотека Protobuf переведена на Protobuf lite.

Исправлены ошибки

  • Исправлены проблемы с висячим указателем.

Версия 2.0.0-alpha04

19 апреля 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha04 . Версия 2.0.0-alpha04 содержит следующие коммиты.

Новые функции

  • Обновлены функции сбора телеметрии в библиотеке, что позволяет получать более подробные отчеты о времени рендеринга кадров.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой библиотека аварийно завершала работу, если максимальное количество ключей инструментирования превышало количество ключей гистограммы.

Версия 2.0.0-alpha03

22 февраля 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha03 . Версия 2.0.0-alpha03 содержит следующие коммиты.

Исправлены ошибки

  • Программа Games-Performance-Tuner перенесена в новый процесс выпуска. Изменений в поведении быть не должно.

Версия 2.0.0-alpha02

8 февраля 2023 г.

Выпущена версия androidx.games:games-performance-tuner:2.0.0-alpha02 . Версия 2.0.0-alpha02 содержит следующие коммиты.

Изменения в API

  • Добавлен API TuningFork_predictQualityLevels , который поможет предсказать правильный уровень качества/параметры точности, которые следует использовать.

Games Performance Tuner 1.6

Версия 1.6.1-alpha01

9 ноября 2022 г.

Выпущена версия androidx.games:games-performance-tuner:1.6.1-alpha01 . Версия 1.6.1-alpha01 содержит следующие коммиты.

Новые функции

  • Никаких новых изменений.

Версия 1.6.0

15 июня 2022 г.

Выпущена версия androidx.games:games-performance-tuner:1.6.0 . Версия 1.6.0 содержит следующие изменения.

Важные изменения с версии 1.5.0

  • Исправлена ​​ошибка, из-за которой функция getpid возвращала 0 при попытке получить телеметрию памяти.
  • Остановлено выполнение команды StopLoadingGroup при отсутствии активной группы загрузки.

Games Performance Tuner 1.5.0

Версия 1.5.0

9 февраля 2022 г.

Выпущена версия androidx.games:games-performance-tuner:1.5.0 . Версия 1.5.0 содержит следующие изменения.

Важные изменения по сравнению с версией 1.4.0

  • Изменяйте интервал между загрузками программно, а не задавайте его жестко в исходных настройках.
    • Добавлена ​​функция: TuningFork_setAggregationStrategyInterval
  • Исправлена ​​ошибка, связанная с повреждением памяти в ключе API для API<=23

Версия 1.5.0-rc01

26 января 2022 г.

Выпущена версия androidx.games:games-performance-tuner:1.5.0-rc01 . Версия 1.5.0-rc01 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка, связанная с повреждением памяти в ключе API для API<=23.

Версия 1.5.0-beta02

15 декабря 2021 г.

Выпущена версия androidx.games:games-performance-tuner:1.5.0-beta02 . Версия 1.5.0-beta02 содержит следующие коммиты.

Изменения в API

  • Удалено изменение из TuningFork_Settings , нарушающее ABI.

Версия 1.5.0-beta01

29 сентября 2021 г.

Выпущена версия androidx.games:games-performance-tuner:1.5.0-beta01 . Версия 1.5.0-beta01 содержит следующие коммиты.

Новые функции

  • Никаких изменений по сравнению с альфа-версией. В той версии было:
    • Изменяйте интервал между загрузками программно, а не задавайте его жестко в исходных настройках.

Изменения в API

  • Никаких изменений по сравнению с альфа-версией. В той версии было:
    • Новая функция: TuningFork_setAggregationStrategyInterval
    • В TuningFork_Settings: aggregation_strategy_intervalms_or_count

Версия 1.5.0-alpha01

18 августа 2021 г.

Выпущена версия androidx.games:games-performance-tuner:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит следующие коммиты.

Новые функции

  • Теперь интервал между загрузками APT можно устанавливать программно, а не с помощью файла настроек.

Изменения в API

  • Добавлена ​​функция: TuningFork_setAggregationStrategyInterval
  • В структуру TuningFork_Settings добавлено поле: aggregation_strategy_intervalms_or_count

Games-Activity Версия 1.0.0

Версия 1.0.0

4 августа 2021 г.

Выпущены модификации androidx.games:games-activity:1.0.0 , androidx.games:games-controller:1.0.0 и androidx.games:games-text-input:1.0.0 . Версия 1.0.0 содержит эти изменения.

Основные особенности версии 1.0.0

Это первый релиз стабильных версий Games-Activity, Games-Controller и Games-Text-Input. Дополнительную информацию см. на домашней странице AGDK .

Версия 1.0.0-rc01

12 июля 2021 г.

Выпущена версия androidx.games:games-activity:1.0.0-rc01 . Версия 1.0.0-rc01 содержит следующие коммиты.

Исправлены ошибки

  • Исправлен тип возвращаемого значения для GameActivityCallbacks::onSaveInstanceState

Версия 1.0.0-beta01

30 июня 2021 г.

Выпущена версия androidx.games:games-activity:1.0.0-beta01 . Версия 1.0.0-beta01 содержит следующие коммиты.

Изменения в API

  • Переименуйте GameActivityInputInfo в GameActivityPointerAxes .
  • Функция обратного вызова onNativeWindowResized теперь возвращает ширину и высоту окна.
  • Функция обратного вызова onContentRectChanged удалена.
  • onLowMemory был переименован в onTrimMemory .
  • GameActivity_setWindowFormat удален.
  • Улучшена модель владения для GameActivityMotionEvents и указателей GameActivityMotionEvent .
  • Улучшена модель владения состоянием пользователя в функции обратного вызова onSaveInstanceState .

Версия 1.0.0-alpha01

16 июня 2021 г.

Выпущена версия androidx.games:games-activity:1.0.0-alpha01 .

Новые функции

  • Games-Activity — это новая библиотека, которая заменяет NativeActivity в качестве рекомендуемого способа интеграции игр на C/C++ с Android.

Игровой контроллер версии 2.3

Версия 2.3.0-alpha01

13 августа 2025 г.

Выпущены коммиты androidx.games:games-controller:2.3.0-alpha01 , androidx.games:games-memory-advice:2.3.0-alpha01 и androidx.games:games-performance-tuner:2.3.0-alpha01 . Версия 2.3.0-alpha01 содержит следующие коммиты .

Новые функции

  • Поддерживается размер страницы 16 КБ по умолчанию.

Игровой контроллер версии 2.2

Версия 2.2.0-alpha01

26 марта 2025 г.

Выпущены коммиты androidx.games:games-controller:2.2.0-alpha01 , androidx.games:games-memory-advice:2.2.0-alpha01 и androidx.games:games-performance-tuner:2.2.0-alpha01 . Версия 2.2.0-alpha01 содержит следующие коммиты .

Новые функции

  • Обновите Gradle до версии 8.8.1 ( 1ed0153 )
  • Обновление до Java 17 ( 1ed0153 )
  • Измените targetSdk на 35 ( eddf605 )

Игровой контроллер версии 2.0

Версия 2.0.2

12 июня 2024 г.

Выпущена версия androidx.games:games-controller:2.0.2 . Версия 2.0.2 содержит следующие изменения .

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой обратные вызовы подключения контроллеров не срабатывали для контроллеров, уже подключенных до вызова Paddleboat_init .
  • Исправлена ​​ошибка, из-за которой сенсорные панели игровых контроллеров не регистрировали нажатия в Paddleboat_processGameActivityMotionInputEvent без ручного включения оси давления.
  • Исправлена ​​ошибка, из-за которой события сенсорной панели игрового контроллера не помечались как обрабатываемые функцией Paddleboat_processGameActivityMotionInputEvent .

Версия 2.0.1

20 сентября 2023 г.

Выпущена версия `androidx.games:games-controller:2.0.1`. Версия 2.0.1 содержит следующие коммиты.

Исправлены ошибки, связанные с игровым контроллером:

  • Исправлена ​​редкая ошибка NullReferenceException в обработчике onInputDeviceChanged .
  • Исправлена ​​ошибка, предотвращающая некорректную регистрацию некоторых USB-клавиатур в качестве игровых контроллеров.

Версия 2.0.0

8 марта 2023 г.

Выпущена версия androidx.games:games-controller:2.0.0 . Версия 2.0.0 содержит следующие коммиты.

Основные особенности версии 2.0.0

  • Добавлена ​​возможность определять состояние подключения аппаратных клавиатур.
  • Добавлена ​​возможность передавать данные о движении (акселерометр/гироскоп) как с основного устройства (например, телефона), так и с контроллеров.
  • Изменены API и формат базы данных определений контроллеров для уменьшения потребления памяти и поддержки дополнительных функций.

Версия 2.0.0-alpha01

11 января 2023 г.

Выпущена версия androidx.games:games-controller:2.0.0-alpha01 . Версия 2.0.0-alpha01 содержит следующие коммиты.

Новые функции

  • Аппаратное обнаружение клавиатуры
  • Встроенная поддержка передачи данных о движении от датчиков (т.е. получение данных с гироскопа и акселерометра непосредственно с телефона).
  • Новый оптимизированный формат данных сопоставления контроллеров.

Изменения в API

  • Новые вызовы API для аппаратной клавиатуры: Paddleboat_getPhysicalKeyboardStatus и Paddleboat_setPhysicalKeyboardStatusCallback
  • Новые вызовы API для интегрированной передачи данных о движении с датчиков: Paddleboat_getIntegratedMotionSensorFlags и Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • Новые вызовы API для пересмотренного формата данных сопоставления контроллеров: Paddleboat_addControllerRemapDataFromFd , Paddleboat_addControllerRemapDataFromFileBuffer
  • Устаревшие вызовы API сопоставления: Paddleboat_addControllerRemapData и Paddleboat_getControllerRemapTableData

Исправлены ошибки

  • Исправлена ​​проблема совместимости с событиями движения из GameActivity 1.2.2 и выше.

Игровой контроллер версии 1.1.0

Версия 1.1.0

23 февраля 2022 г.

Выпущены androidx.games:games-activity:1.1.0 и androidx.games:games-controller:1.1.0 . Версия 1.1.0 содержит следующие изменения.

Важные изменения с версии 1.0.0

Игровая деятельность:

  • WindowInsets прослушивает и запрашивает информацию о вырезе окна и ответе IME.
  • Добавьте фильтры по ключевым и движенческим событиям.
  • Исправлены ошибки:
    • Добавлены недостающие сообщения для обеспечения совместимости с NativeActivity.
    • Исправить подпись onNativeWindowResized.
    • Исправление потерь входных событий

Версия 1.1.0-rc01

9 февраля 2022 г.

Выпущена версия androidx.games:games-controller:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты.

Версия 1.1.0-beta01

26 января 2022 г.

Выпущена версия androidx.games:games-controller:1.1.0-beta01 без изменений по сравнению с 1.1.0-alpha01 . Версия 1.1.0-beta01 содержит следующие коммиты.

Версия 1.1.0-alpha01

15 декабря 2021 г.

Выпущена версия androidx.games:games-controller:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты.

Новые функции

Добавлена ​​поддержка отображения состояния батареи, вибрации с двумя двигателями, управления освещением и передачи данных об осях движения на поддерживаемых контроллерах при работе на Android S или более поздних версиях.

Изменения в API

  • Добавлена ​​функция Paddleboat_setMotionDataCallback для регистрации функций обратного вызова для обработки данных о движении контроллера.
  • Добавлена ​​функция Paddleboat_setControllerLight для изменения настроек подсветки контроллера.
  • Добавлена ​​структура Paddleboat_Controller_Battery в Paddleboat_Controller_Data
  • Новые сооружения:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Новые перечисления:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Новые флаги контроллера:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Исправлены ошибки

  • Добавлена ​​альтернативная запись в базе данных deviceId для контроллера PS4.
  • Добавлена ​​запись в базу данных API >=31 для контроллера PS5.

Игровой контроллер версии 1.0.0

Версия 1.0.0

4 августа 2021 г.

Выпущены модификации androidx.games:games-activity:1.0.0 , androidx.games:games-controller:1.0.0 и androidx.games:games-text-input:1.0.0 . Версия 1.0.0 содержит эти изменения.

Основные особенности версии 1.0.0

Это первый релиз стабильных версий Games-Activity, Games-Controller и Games-Text-Input. Дополнительную информацию см. на домашней странице AGDK .

Версия 1.0.0-rc02

21 июля 2021 г.

Выпущена версия androidx.games:games-controller:1.0.0-rc02 . Версия 1.0.0-rc02 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​ошибка упаковки, из-за которой импорт префабов завершался с ошибкой при пустых, неиспользуемых вариантах архитектуры/версии.

Версия 1.0.0-rc01

12 июля 2021 г.

Выпущена версия androidx.games:games-controller:1.0.0-rc01 . Версия 1.0.0-rc01 содержит следующие коммиты.

Исправлены ошибки

  • Исправлена ​​проблема несовместимости с последней версией GameActivity

Версия 1.0.0-beta01

30 июня 2021 г.

Выпущена версия androidx.games:games-controller:1.0.0-beta01 . Версия 1.0.0-beta01 содержит следующие коммиты.

Изменения в API

  • Функции, которые ранее возвращали логическое значение в случае успеха или неудачи, теперь возвращают перечисление Paddleboat_Error_Code .
  • Paddleboat_onPause переименована в Paddleboat_onStop
  • Paddleboat_onResume переименована в Paddleboat_onStart
  • Функция Paddleboat_processGameActivityEvent разделена на две части: Paddleboat_processGameActivityKeyInputEvent и Paddleboat_processGameActivityMotionInputEvent
  • Удалены расширенные функции контроллера, для использования которых требовалась сборка с использованием предварительной версии SDK Android S.
  • Добавлена ​​функция Paddleboat_getBackButtonConsumed
  • Теперь функции обратного вызова для отображения состояния контроллера и мыши имеют необязательный параметр в виде указателя на определяемые пользователем данные.
  • Перемещено строковое имя контроллера из структуры информации об устройстве, теперь доступ к нему осуществляется через функцию Paddleboat_getControllerName

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой контроллер, который изначально не сообщал о себе как о контроллере, но позже сообщал об этом через сообщение onInputDeviceChanged, некорректно определялся как соединение с контроллером.

Версия 1.0.0-alpha01

16 июня 2021 г.

Выпущена версия androidx.games:games-controller:1.0.0-alpha01 .

Новые функции

  • Games-Controller — это новая библиотека, предоставляющая C API для обнаружения, чтения входных данных и взаимодействия с игровыми контроллерами.

Games-Text-Input 2.1

Версия 2.1.0-alpha01

26 июля 2023 г.

Выпущена версия androidx.games:games-text-input:2.1.0-alpha01 . Версия 2.1.0-alpha01 содержит следующие коммиты.

Новые функции

  • Добавлена ​​поддержка многострочного и однострочного режимов.

Изменения в API

  • Добавить функцию isSoftwareKeyboardVisible
  • Добавить определения битовых полей для GameActivity_setImeEditorInfo
  • Добавить функцию обратного вызова onEditorAction

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой аппаратная и программная клавиатуры не синхронизировались.
  • Четкая фокусировка при скрытой экранной клавиатуре.

Games-Text-Input 2.0

Версия 2.0.0

8 марта 2023 г.

Выпущена версия androidx.games:games-text-input:2.0.0 . Версия 2.0.0 содержит следующие изменения.

Важные изменения с версии 1.1.1

  • В связи с изменениями в системе сборки, обновление основной версии не производится.

Games-Text-Input Version 1.1

Версия 1.1.2-alpha01

9 ноября 2022 г.

Выпущена версия androidx.games:games-text-input:1.1.2-alpha01 . Версия 1.1.2-alpha01 содержит следующие коммиты.

Новые функции

  • Никаких новых изменений.

Версия 1.1.1

13 июля 2022 г.

Выпущена версия androidx.games:games-text-input:1.1.1 . Версия 1.1.1 содержит следующие изменения.

Исправлены ошибки

  • Исправлены проблемы с отсутствующим файлом .aar в предыдущей версии.

Версия 1.1.0

9 февраля 2022 г.

Выпущена версия androidx.games:games-text-input:1.1.0 . Версия 1.1.0 содержит следующие изменения.

Важные изменения по сравнению с версией 1.0.0: - Добавлена ​​функциональность прослушивания и запроса WindowInsets для GameTextInput; - Добавлен отсутствующий заголовочный файл gamecommon.h

Версия 1.1.0-rc01

26 января 2022 г.

Выпущена версия androidx.games:games-text-input:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты.

Версия 1.1.0-beta01

15 декабря 2021 г.

Выпущена версия androidx.games:games-text-input:1.1.0-beta01 . Версия 1.1.0-beta01 содержит следующие коммиты.

Исправлены ошибки

  • Исправлены вставки в водопаде и IME.
  • Добавить отсутствующий заголовок gamecommon.h

Версия 1.1.0-alpha01

13 октября 2021 г.

Выпущена версия androidx.games:games-text-input:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Добавлена ​​функция добавления отступов IME в GameTextInput.

Games-Text-Input Version 1.0

Версия 1.0.0

4 августа 2021 г.

Выпущены модификации androidx.games:games-activity:1.0.0 , androidx.games:games-controller:1.0.0 и androidx.games:games-text-input:1.0.0 . Версия 1.0.0 содержит эти изменения.

Основные особенности версии 1.0.0

This is the initial release to stable of Games-Activity, Games-Controller and Games-Text-Input. See the AGDK Home Page for more information.

Version 1.0.0-rc01

July 12, 2021

androidx.games:games-text-input:1.0.0-rc01 is released with no changes. Version 1.0.0-rc01 contains these commits.

Version 1.0.0-beta01

30 июня 2021 г.

androidx.games:games-text-input:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

API Changes

  • Improved ownership model of GameTextInputState objects.
  • Tidying of types to be consistent with NDK.

Version 1.0.0-alpha01

16 июня 2021 г.

androidx.games:games-text-input:1.0.0-alpha01 is released.

Новые функции

  • Games-Text-Input is a new library to help game developers use Android soft keyboard input from C/C++.

Games Frame Pacing Version 2.3

Version 2.3.0-alpha01

26 марта 2025 г.

androidx.games:games-frame-pacing:2.3.0-alpha01 is released. Version 2.3.0-alpha01 contains these commits .

Новые функции

Исправлены ошибки

Games Frame Pacing Version 2.1

Version 2.1.3

2 июля 2025 г.

androidx.games:games-frame-pacing:2.1.3 is released. Version 2.1.3 contains these commits .

Исправлены ошибки

  • Enables support for 16KB page size.

Version 2.1.2

24 июля 2024 г.

androidx.games:games-frame-pacing:2.1.2 is released. Version 2.1.2 contains these commits .

Исправлены ошибки

  • Swappy now uses AChoreographer_postVsyncCallback from API 33 to calculate the presentation time more accurately. This fixes a bug on 120hz devices where frames are dropped.

Version 2.1.1

10 июля 2024 г.

androidx.games:games-frame-pacing:2.1.1 is released. Version 2.1.1 contains these commits .

Исправлены ошибки

  • Properly unregister display listener from swappy to avoid a hang.
  • Fix a crash in ChoreographerFilter::onSettingsChanged using destroyed mutex.

Версия 2.1.0

15 ноября 2023 г.

androidx.games:games-frame-pacing:2.1.0 is released. Version 2.1.0 contains these commits.

Version 2.1.0-rc01

20 сентября 2023 г.

androidx.games:games-frame-pacing:2.1.0-rc01 is released. Version 2.1.0-rc01 contains these commits.

Version 2.1.0-beta01

24 мая 2023 г.

androidx.games:games-frame-pacing:2.1.0-beta01 is released. Version 2.1.0-beta01 contains these commits.

Исправлены ошибки

  • Timeout in case NDKChoreographer initialization fails ( ef466d )
  • When using SwappyGL_getSupportedRefreshPeriodsNS query refresh rates explicitly from the system ( c85235 )

Version 2.1.0-alpha01

5 апреля 2023 г.

androidx.games:games-frame-pacing:2.1.0-alpha01 is released. Version 2.1.0-alpha01 contains these commits.

Новые функции

  • New API to reset the frame-pacing state.
  • New API to disable swappy's frame-pacing impact while still observing the CPU & GPU times.

API Changes

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing can now be used to reset the internal frame-pacing state. The frame pacing will now only consider data from the point when the reset API is called.
  • SwappyGL_enableFramePacing/SwappyVk_enableFramePacing can now be used to enable/disable swappy's frame pacing. When disabled,
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait can be used to control whether a blocking wait of the last frame's GPU work happens when frame-pacing is disabled.

Исправлены ошибки

  • Performance improvements are made for GPU bound cases when using Swappy GL API.

Games Frame Pacing Version 2.0

Версия 2.0.0

8 марта 2023 г.

androidx.games:games-frame-pacing:2.0.0 is released. Version 2.0.0 contains these commits.

Important changes since 1.10.1

  • The build system went through major changes leading to only one library generated instead of multiple per SDK/NDK version.
  • Vulkan Frame Statistics are added.
  • A new API for clearing frame statistics is added.
  • The logs are all silent in release mode, they can be enabled in debug mode.

Version 2.0.0-rc01

22 февраля 2023 г.

androidx.games:games-frame-pacing:2.0.0-rc01 is released. Version 2.0.0-rc01 contains these commits.

Новые функции

  • Logging is now hidden behind a compile flag. By default release build of the library has no logging, and debug release of the library has all the logging turned on.

Version 2.0.0-beta01

8 февраля 2023 г.

androidx.games:games-frame-pacing:2.0.0-beta01 is released. Version 2.0.0-beta01 contains these commits.

Новые функции

  • New API introduced to clear frame statistics.

API Changes

  • Added SwappyGL_clearStats and SwappyGL_clearStats APIs.

Version 2.0.0-alpha01

11 января 2023 г.

androidx.games:games-frame-pacing:2.0.0-alpha01 is released. Version 2.0.0-alpha01 contains these commits.

Новые функции

  • Added vulkan frame statistics

API Changes

  • Major version increase due to build files refactoring
  • Added 3 new APIs : SwappyVk_enableStats , SwappyVk_recordFrameStart , and SwappyVk_getStats

Исправлены ошибки

  • Apply threshold only in auto swap mode ( Ic0786 )

Games Frame Pacing 1.10

Version 1.10.2-alpha01

9 ноября 2022 г.

androidx.games:games-frame-pacing:1.10.2-alpha01 is released. Version 1.10.2-alpha01 contains these commits.

Новые функции

  • No new changes

Version 1.10.1

15 июня 2022 г.

androidx.games:games-frame-pacing:1.10.1 is released. Version 1.10.1 contains these commits.

Исправлены ошибки

  • Fix for swappy not building with ndk <23 and >17.
  • Exposed API to retrieve the refresh rates supported by the display.

Версия 1.10.0

February 23, 2022

androidx.games:games-frame-pacing:1.10.0 is released. Version 1.10.0 contains these commits.

Important changes since 1.9.0

  • Ignore polluting choreographer filter inputs and smooth more to prevent freezes on emulator
  • Add *_uninjectTracer functions.

Version 1.10.0-rc01

9 февраля 2022 г.

androidx.games:games-frame-pacing:1.10.0-rc01 is released. Version 1.10.0-rc01 contains these commits.

Version 1.10.0-beta01

26 января 2022 г.

androidx.games:games-frame-pacing:1.10.0-beta01 is released. Version 1.10.0-beta01 contains these commits.

Version 1.10.0-alpha01

15 декабря 2021 г.

androidx.games:games-frame-pacing:1.10.0-alpha01 is released. Version 1.10.0-alpha01 contains these commits.

Новые функции

  • Addition of SwappyGL_uninjectTracer function.

API Changes

  • Remove callbacks that were previously added using SwappyGL_injectTracer by using SwappyGL_uninjectTracer(const SwappyTracer *t) API.

Games Frame Pacing 1.9

Version 1.9.1

13 октября 2021 г.

androidx.games:games-frame-pacing:1.9.1 is released. Version 1.9.1 contains these commits.

Исправлены ошибки

Version 1.9.0

July 12, 2021

androidx.games:games-frame-pacing:1.9.0 is released. Version 1.9.0 contains these commits.

Important changes since 1.7.0

  • Updated to match internal versioning scheme.

Games Frame Pacing 1.7.0

Версия 1.7.0

30 июня 2021 г.

androidx.games:games-frame-pacing:1.7.0 is released. Version 1.7.0 contains these commits.

Version 1.7.0-rc01

2 июня 2021 г.

androidx.games:games-frame-pacing:1.7.0-rc01 is released. Version 1.7.0-rc01 contains these commits.

Version 1.7.0-beta02

24 февраля 2021 г.

androidx.games:games-frame-pacing:1.7.0-beta02 is released.

Version 1.7.0-beta01

16 декабря 2020 г.

androidx.games:games-frame-pacing:1.7.0-beta01 is released.

Games Performance Tuner 1.4.3

Version 2.0.0-rc01

24 июля 2024 г.

androidx.games:games-performance-tuner:2.0.0-rc01 is released. Version 2.0.0-rc01 contains these commits .

Version 1.4.3

July 12, 2021

androidx.games:games-performance-tuner:1.4.3 is released. Version 1.4.3 contains these commits.

Important changes since 1.1.0

  • Updated to match internal versioning scheme.

Games Performance Tuner 1.1.0

Version 1.1.0

30 июня 2021 г.

androidx.games:games-performance-tuner:1.1.0 is released. Version 1.1.0 contains these commits.

Version 1.1.0-rc01

2 июня 2021 г.

androidx.games:games-performance-tuner:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Version 1.1.0-beta03

21 апреля 2021 г.

androidx.games:games-performance-tuner:1.1.0-beta03 is released.

Version 1.1.0-beta02

24 февраля 2021 г.

androidx.games:games-performance-tuner:1.1.0-beta02 is released.

Version 1.1.0-beta01

16 декабря 2020 г.

androidx.games:games-performance-tuner:1.1.0-beta01 is released.

Version 1.1.0-alpha01

androidx.games:games-performance-tuner:1.1.0-alpha01 is released.

Версия 1.0.0

Version 1.0.0-alpha02

12 августа 2020 г.

The Android Gaming library was renamed to the Android Games library.

androidx.gaming -> androidx.games

Version 1.0.0-alpha01

10 июня 2020 г.

androidx.games:1.0.0-alpha01 is released.