App Manifest

Манифест приложения используется для исключения возможностей движка или управления тем, какие функции должны быть включены в движок. Исключение неиспользуемых возможностей движка является рекомендуемой практикой, поскольку это уменьшает итоговый размер бинарного файла вашей игры. Кроме того, манифест приложения содержит ряд параметров для управления компиляцией кода для платформы HTML5, например минимально поддерживаемые версии браузеров и настройки памяти, что также может влиять на итоговый размер бинарного файла.

Применение манифеста

В game.project назначьте манифест в разделе Native Extensions -> App Manifest.

Physics

Позволяет выбрать, какой физический движок использовать, либо выбрать None, чтобы полностью исключить физику.

Physics 2d

Позволяет выбрать, какую версию Box2D использовать.

Rig + Model

Позволяет управлять функциональностью rig и model, либо выбрать None, чтобы полностью исключить модели и риги. См. документацию по Model.

Exclude Record

Исключает из движка возможность записи видео. См. документацию по сообщению start_record.

Exclude Profiler

Исключает профилировщик из движка. Профилировщик используется для сбора счётчиков производительности и использования ресурсов. Подробнее см. в руководстве по профилированию.

Exclude Sound

Исключает из движка всю функциональность воспроизведения звука.

Exclude Input

Исключает из движка всю обработку ввода.

Exclude Live Update

Исключает из движка функциональность Live Update.

Exclude Image

Исключает из движка скриптовый модуль image: документация.

Exclude Types

Исключает из движка скриптовый модуль types: документация.

Exclude Basis Universal

Исключает из движка библиотеку сжатия текстур Basis Universal. Подробнее см. в руководстве по профилям текстур.

Use Android Support Lib

Использует устаревшую Android Support Library вместо Android X. Подробнее.

Graphics

Позволяет выбрать, какой графический backend использовать.

• OpenGL - включать только OpenGL.
• Vulkan - включать только Vulkan.
• OpenGL and Vulkan - включать одновременно OpenGL и Vulkan. Vulkan будет использоваться по умолчанию, а при его недоступности произойдёт откат на OpenGL.

Use full text layout system

Если включено (true), это позволит использовать генерацию во время выполнения для шрифтов типа SDF при использовании в проекте шрифтов True Type (.ttf). Подробнее см. в руководстве по шрифтам.

Minimum Safari version (только для js-web и wasm-web)

Имя поля в YAML: minSafariVersion Значение по умолчанию: 90000

Минимально поддерживаемая версия Safari. Не может быть меньше 90000. Подробнее см. в параметрах компилятора Emscripten: ссылка.

Minimum Firefox version (только для js-web и wasm-web)

Имя поля в YAML: minFirefoxVersion Значение по умолчанию: 34

Минимально поддерживаемая версия Firefox. Не может быть меньше 34. Подробнее см. в параметрах компилятора Emscripten: ссылка.

Minimum Chrome version (только для js-web и wasm-web)

Имя поля в YAML: minChromeVersion Значение по умолчанию: 32

Минимально поддерживаемая версия Chrome. Не может быть меньше 32. Подробнее см. в параметрах компилятора Emscripten: ссылка.

Initial memory (только для js-web и wasm-web)

Имя поля в YAML: initialMemory Значение по умолчанию: 33554432

Размер памяти, выделяемой для веб-приложения. Если ALLOW_MEMORY_GROWTH=0 (js-web), это общий объём памяти, который может использовать веб-приложение. Подробнее см. здесь. Значение задаётся в байтах. Обратите внимание, что оно должно быть кратно размеру страницы WebAssembly (64KiB).

Этот параметр связан с html5.heap_size в game.project: ссылка. Значение, настроенное через манифест приложения, задаётся во время компиляции и используется как значение по умолчанию для параметра INITIAL_MEMORY. Значение из game.project переопределяет значение из манифеста приложения и используется во время выполнения.

Stack size (только для js-web и wasm-web)

Имя поля в YAML: stackSize Значение по умолчанию: 5242880

Размер стека приложения. Подробнее см. здесь. Значение задаётся в байтах.