GameActivity   Входит в Android Game Development Kit.

GameActivity – это библиотека Jetpack, которая помогает играм для Android обрабатывать команды жизненного цикла приложения, события ввода и ввод текста в коде C/C++ приложения. GameActivity – прямой потомок NativeActivity с похожей архитектурой.

alt_text

Как показано на схеме выше, GameActivity выполняет следующие функции:

  • Взаимодействие с фреймворком Android через компонент на стороне Java.
  • Передача команд цикла приложения, событий ввода и текста ввода на нативную сторону.
  • Моделирование исходного кода C/C++ в виде трех логических компонентов:
    • JNI-функции GameActivity, которые напрямую поддерживают Java-функциональность GameActivity и ставят события в очередь в native_app_glue.
    • native_app_glue, который в основном выполняется в собственном нативном потоке (отличном от основного потока приложения) и выполняет задачи с помощью своего цикла.
    • Код игры, который опрашивает и обрабатывает события, поставленные в очередь внутри native_app_glue, и выполняет код игры в потоке native_app_glue.

С GameActivity вы можете сосредоточиться на разработке игры и не тратить время на работу с кодом JNI.

Если вы уже знакомы с NativeActivity, то основные различия между GameActivity и NativeActivity заключаются в следующем:

  • GameActivity преобразуется в SurfaceView, что значительно упрощает взаимодействие игр с другими компонентами интерфейса.
  • Для событий касания и нажатия клавиш в GameActivity используется совершенно новая реализация с интерфейсом android_input_buffer, отдельным от InputQueue, который используется в NativeActivity.
  • GameActivity – это производный класс AppCompatActivity, который позволяет без проблем использовать другие компоненты Jetpack. ActionBar, Fragment и другие.
  • GameActivity добавляет функцию ввода текста за счет интеграции библиотеки GameTextInput.
  • Приложения, созданные на основе GameActivity, должны компилировать все три части кода C/C++ в одну библиотеку. С другой стороны, функции JNI в NativeActivity являются частью фреймворка (всегда загружаются ОС). Поэтому в одну библиотеку должны быть встроены только native_app_glue и код приложения на C/C++.
  • NativeActivity – это часть фреймворка Android, и ее обновления выходят вместе с ним (обычно раз в год). GameActivity входит в библиотеку Jetpack, которая обновляется гораздо чаще (обычно раз в две недели). Это позволяет быстрее добавлять новые функции и исправления ошибок.

Освобождение переговорных комнат

Библиотека GameActivity доступна в следующих каналах:

Код C/C++ предоставляется в виде исходного кода во всех каналах обновления в формате Prefab. В GameActivity версии 1.2.2 добавлена статическая библиотека. Начиная с этой версии мы рекомендуем использовать статическую библиотеку вместо исходного кода.

Содержимое библиотеки Jetpack

В библиотеке Jetpack GameActivity выпускается с AAR. В этом отчете содержатся следующие основные компоненты:

  • JAR-файл для кода Java;
  • Статическая библиотека C/C++ game-activity_static включена в GameActivity версии 1.2.2 и более поздних.
  • исходный код C/C++ (в папке /prefab);

Инструкции по интеграции, ссылки на которые приведены на этой странице, предполагают, что вы можете использовать Prefab в своей системе сборки. В противном случае вы можете скопировать исходный код, упакованный в папку prefab/modules/game-activity/include, в свою систему сборки и выполнить необходимые шаги интеграции. Аналогичная структура файлов существует для выпусков в androidx для библиотеки Android Jetpack. По умолчанию gradle распаковывает AAR в свой каталог кеша (~/.gradle/caches/...). Чтобы найти исходный код C/C++, введите в поиске prefab/modules/game-activity/include и выберите нужную версию.

Инструкции по интеграции с помощью библиотеки Jetpack можно найти в статье Начало работы с GameActivity.

Контент исходного кода AOSP

В AOSP всегда содержится самый актуальный исходный код. Чтобы создать собственные выпуски или интегрировать исходный код непосредственно в среду сборки, следуйте инструкциям по сборке. Исходный код C/C++ сохраняется в структуре файлов, аналогичной библиотеке Jetpack.

Руководства по интеграции

Чтобы интегрировать GameActivity в свои приложения, следуйте этим руководствам:

Дополнительные ресурсы

Дополнительную информацию о GameActivity можно найти в следующих статьях:

Отзыв

Чтобы сообщить об ошибке или запросить новую функцию для GameActivity, используйте систему отслеживания ошибок GameActivity.