Building Box2D Shared Library for Android (NDK & CMake) Сборка динамической библиотеки Box2D для Android (NDK и CMake)

A guide to compiling Box2D source code into a shared library (libbox2d.so) for Android using CMake and NDK. Руководство по компиляции исходного кода Box2D в динамическую библиотеку (libbox2d.so) для Android с помощью CMake и NDK.

If you haven't set up MinGW and CMake on your machine, follow the Если вы еще не настроили MinGW и CMake на своем компьютере, следуйте инструкции: MinGW & CMake Setup Guide Руководство по настройке MinGW и CMake

If you haven't set up your environment (Android SDK, NDK, JDK), follow the Если вы еще не настроили окружение (Android SDK, NDK, JDK), следуйте инструкции: Environment Setup Guide Руководство по настройке окружения

Step 1: Download Box2D Source Code Шаг 1: Скачивание исходного кода Box2D

Check and download the latest release (v3.2.0) directly from the official Box2D repository on GitHub: Проверьте и скачайте последнюю версию (v3.2.0) напрямую со страницы релизов Box2D на GitHub:

Open Box2D Releases (GitHub) Открыть релизы Box2D (GitHub) Direct Download v3.2.0 (.zip) Прямое скачивание v3.2.0 (.zip)

Extract the downloaded archive to a convenient directory on your machine. Распакуйте скачанный архив в удобную директорию на вашем компьютере.

Step 2: Create the Build Script Шаг 2: Создание скрипта сборки

In the root directory of the extracted Box2D source folder, create an empty file named build-android-64-bit.bat and paste the following content into it: В корневой директории распакованного исходного кода Box2D создайте пустой файл build-android-64-bit.bat и вставьте в него следующее содержимое:

@echo off
set NDK=H:/AndroidSDK/ndk/28.2.13676358

set BUILD_DIR=build-android-64

if exist %BUILD_DIR% rmdir /s /q %BUILD_DIR%
mkdir %BUILD_DIR%
cd %BUILD_DIR%

cmake .. ^
  -DCMAKE_TOOLCHAIN_FILE=%NDK%/build/cmake/android.toolchain.cmake ^
  -DANDROID_ABI=arm64-v8a ^
  -DANDROID_PLATFORM=android-21 ^
  -DBUILD_SHARED_LIBS=ON ^
  -DBOX2D_UNIT_TESTS=OFF ^
  -DBOX2D_SAMPLES=OFF ^
  -DBOX2D_BENCHMARKS=OFF ^
  -DBOX2D_DOCS=OFF ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DCMAKE_INSTALL_PREFIX=C:/libs/box2d-3.2.0-android/arm64-v8a ^
  -G "MinGW Makefiles"

cmake --build . --config Release --parallel --target install

Note: Примечание: Make sure to adjust the NDK path and CMAKE_INSTALL_PREFIX according to your local environment paths. Set -DBUILD_SHARED_LIBS=ON to output a .so dynamic library instead of a static .a archive. Убедитесь, что пути к NDK и CMAKE_INSTALL_PREFIX соответствуют вашему локальному окружению. Установите -DBUILD_SHARED_LIBS=ON для получения динамической библиотеки .so вместо статической .a.

Step 3: Run and Compile Шаг 3: Запуск и сборка

Run build-android-64-bit.bat via Command Prompt (CMD) so you can catch any potential compilation errors in the console. Once completed, your compiled shared library (libbox2d.so) along with headers will be installed in the output path set by CMAKE_INSTALL_PREFIX. Запустите build-android-64-bit.bat через командную строку (CMD), чтобы вы могли увидеть возможные ошибки сборки прямо в консоли. После завершения собранная динамическая библиотека (libbox2d.so) вместе с заголовочными файлами будет установлена по пути, указанному в CMAKE_INSTALL_PREFIX.

Support My Work Поддержать проект

If these tutorials helped you, consider buying me a coffee! Если эти туториалы вам помогли, вы можете поддержать автора.

Sberbank (Russia only) Сбербанк (только для РФ)

Direct transfer via phone number (Russia only) Перевод по номеру телефона (только для РФ)

+7 (917) 212-29-59

USDT TRC20

Support via Cryptocurrency Поддержка криптовалютой

TMtY1YifNf6FKvgeFmqKGQR4NStKr3csGp

← Back to Tutorials ← Назад к туториалам