Встраивание в Android-приложение

Встраивание нужно, когда движок — часть существующего Android-приложения. Для обычной игры проще штатный экспорт.

Подготовка host

1. Подключите совместимый AAR движка и нативные библиотеки нужных ABI. Добавьте данные проекта так, чтобы движок нашёл их через выбранную конфигурацию запуска.
2. Используйте ReckfellFragment и контракт ReckfellHost. Реализация fragment передаёт onPause, onResume и onDestroy движку; не создавайте параллельный ручной цикл поверх него.
3. Передайте параметры запуска через host и обработайте callbacks готовности. Создание fragment не означает, что renderer и проект уже инициализированы.
4. Проверьте навигацию назад, выдачу разрешений, поворот/пересоздание Activity и возврат из фона. Не храните старую Activity в статическом поле.
5. Свяжите Android UI и игру через небольшой явный интерфейс. Android View обслуживайте на UI-потоке, работу с Entity — на потоке движка.

Результат и диагностика

Успешная интеграция запускает уровень и восстанавливает ввод/рендер после pause/resume. Чёрный экран ещё не доказывает проблему renderer: сначала проверьте лог инициализации, путь проекта, создание surface и нативные библиотеки.

Не предполагайте поддержку нескольких независимых экземпляров движка в одном процессе без отдельной проверки жизненного цикла и глобальных сервисов. Эта инструкция сверена с host/fragment API; приложение-host и сценарии пересоздания Activity здесь не запускались.