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

Download the latest Box2D source archive (.zip or .tar.gz) from the official GitHub releases page: Скачайте последний архив с исходным кодом Box2D (.zip или .tar.gz) с официальной страницы релизов GitHub:

Download Box2D Releases Скачать релизы Box2D

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

if not exist build-android-64 mkdir build-android-64
cd build-android-64

:: Clean old cache if it exists
if exist CMakeCache.txt del CMakeCache.txt

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.1.1-android/arm64-v8a ^
  -G "MinGW Makefiles"

cmake --build . --config Release --parallel 8 --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: Запуск и сборка

Double-click build-android-64-bit.bat or run it via Command Prompt. Once completed, your compiled libbox2d.so along with headers will be installed in the output path set by CMAKE_INSTALL_PREFIX. Дважды кликните по build-android-64-bit.bat или запустите его через командную строку. После завершения собранная библиотека 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 ← Назад к туториалам