Getting Started

Getting Started

Руководство по сборке и запуску Mengine на различных платформах.

Проект использует CMake в качестве системы сборки.

---

Требования

Платформа	Инструменты
Windows	Visual Studio 2022 (MSVC 17), CMake 3.22+
Android	Android NDK 29+, CMake 3.31+, Gradle, JDK
macOS	Xcode, CMake
iOS	Xcode, CMake, ios-cmake
Web	Emscripten SDK, CMake
Linux	GCC/Clang, CMake

---

Windows (MSVC 17 / Visual Studio 2022)

1. Скачать зависимости

Mengine\build\downloads\downloads.bat

2. Собрать зависимости (Debug)

Mengine\build\msvc17\build_depends_msvc17_debug.bat

Для Release:

Mengine\build\msvc17\build_depends_msvc17_release.bat

3. Сгенерировать решение

Mengine\build\msvc17\make_solution_msvc17_debug.bat

4. Открыть решение

Mengine\solutions\solution_msvc17_debug\Mengine_WIN32.sln

Стартовый проект — Win32Application.

---

Windows x64

Mengine\build\msvc17_x64\build_depends_msvc17_x64_debug.bat
Mengine\build\msvc17_x64\make_solution_msvc17_x64_debug.bat

Решение: Mengine\solutions\solution_msvc17_x64_debug\Mengine_WIN64.sln

---

Windows DirectX 11

Mengine\build\msvc17_dx11\build_depends_msvc17_dx11_debug.bat
Mengine\build\msvc17_dx11\make_solution_msvc17_dx11_debug.bat

---

Windows SDL2 / SDL3

:: SDL2
Mengine\build\msvc17_sdl2\build_depends_msvc17_sdl2_debug.bat
Mengine\build\msvc17_sdl2\make_solution_msvc17_sdl2_debug.bat

:: SDL3
Mengine\build\msvc17_sdl3\build_depends_msvc17_sdl3_debug.bat
Mengine\build\msvc17_sdl3\make_solution_msvc17_sdl3_debug.bat

---

Windows MinGW

Mengine\build\mingw\build_depends_mingw_debug.bat
Mengine\build\mingw\make_solution_mingw_debug.bat

---

Android

1. Скачать зависимости

Mengine\build\downloads\downloads.bat

2. Собрать нативные зависимости

Mengine\build\android\build_depends_android_debug.bat

Собирает для всех ABI: x86, x86_64, armeabi-v7a, arm64-v8a.

3. Gradle сборка

cd Mengine\gradle
gradlew assembleDebug

Конфигурация: Mengine\gradle\build.gradle, settings.gradle.kts.

Требования:

• Android NDK 29.0.14206865
• CMake 3.31.6
• Android Platform API 23+
• C++ STL: c++_shared

---

macOS (Xcode)

cd Mengine/build/xcode_macos
./build_depends_xcode_macos_debug.sh
./make_solution_xcode_macos_debug.sh

---

iOS (Xcode)

cd Mengine/build/xcode_ios
./build_depends_xcode_ios_debug.sh
./make_solution_xcode_ios_debug.sh

Также доступны:

• xcode_ios_simulator/ — для iOS Simulator
• xcode_ios_appclip/ — для iOS App Clips

---

Emscripten (Web / WebAssembly)

cd Mengine/build/emscripten
./build_depends_emscripten_debug.sh
./make_solution_emscripten_debug.sh

Требуется установленный Emscripten SDK.

---

Linux / Unix

cd Mengine/build/unix
./build_depends_unix_debug.sh
./make_solution_unix_debug.sh

---

Xbox GDK

Mengine\build\msvc17_gdk\build_depends_msvc17_gdk_debug.bat
Mengine\build\msvc17_gdk\make_solution_msvc17_gdk_debug.bat

---

UWP (Universal Windows Platform)

Mengine\build\msvc17_uwp\build_depends_msvc17_uwp_debug.bat
Mengine\build\msvc17_uwp\make_solution_msvc17_uwp_debug.bat

---

Address Sanitizer (ASAN)

Для отладки проблем с памятью:

Mengine\build\msvc17_asan_address\build_depends_msvc17_asan_address_debug.bat
Mengine\build\msvc17_asan_address\make_solution_msvc17_asan_address_debug.bat

---

Структура директорий после сборки

Mengine/
├── bin/              ← Выходные бинарные файлы
│   ├── Mengine_WIN32/
│   ├── Mengine_WIN64_DX11/
│   ├── Tools_WIN32/
│   └── ...
├── outputs/          ← Промежуточные файлы сборки
└── solutions/        ← Сгенерированные решения / проекты
    ├── solution_msvc17_debug/
    ├── solution_msvc17_release/
    └── ...

---

Профили сборки

Профиль	Описание
Debug	Отладочная сборка с символами, assertions
Release	Оптимизированная сборка
RelWithDebInfo	Release с отладочной информацией

---

cppcheck

Для работы cppcheck добавьте в .git/config:

[include]
    path = ../.gitconfig

---

См. также

• Build System — детали системы сборки CMake
• Options — параметры командной строки
• Platforms — поддерживаемые платформы