GameActivity Часть комплекта для разработки игр для Android .

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 Framework и следует его циклу выпуска (обычно ежегодно). GameActivity является частью библиотеки Jetpack, которая имеет гораздо более частый цикл выпуска (обычно раз в две недели); новые функции и исправления ошибок могут появляться гораздо быстрее.

Места выпуска

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

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

Содержимое библиотеки Jetpack и zip-пакета AGDK

С библиотекой Jetpack и каналами пакетов AGDK zip GameActivity выпускается с AAR. Этот 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 и zip-пакета AGDK.

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

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

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

Чтобы узнать больше о GameActivity , см. следующее:

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

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