Step 1: Download Base Template and Rename Project Шаг 1: Скачивание базового шаблона и переименование проекта

First, download the base starter project template depending on your language preference: Сначала скачайте базовый шаблон проекта в зависимости от используемого языка:

Rename your project folder to integrate-box2d-android-c (or integrate-box2d-android-cpp). Переименуйте папку проекта в integrate-box2d-android-c (или integrate-box2d-android-cpp).

Step 2: Update CMakeLists.txt Шаг 2: Обновление CMakeLists.txt

Open CMakeLists.txt in the root directory and update it to link both SDL3 and box2d libraries: Откройте CMakeLists.txt в корне проекта и обновите его для связывания обоих библиотек (SDL3 и box2d):

Step 3: Configure Gradle Build Settings Шаг 3: Настройка параметров сборки Gradle

Open android-project/app/build.gradle and configure the external native build path inside the android { ... } block: Откройте android-project/app/build.gradle и настройте путь к нативной сборке внутри блока android { ... }:

android {
    namespace "com.example.myapp"
    compileSdkVersion 35

    defaultConfig {
        // ...
    }

    externalNativeBuild {
        cmake {
            path '../../CMakeLists.txt'
        }
    }
}

Step 4: Write the C Source Code Шаг 4: Написание исходного кода на C

Replace the contents of src/main.c with the following code to initialize physics world and test rigid body simulation using Box2D: Замените содержимое файла src/main.c следующим кодом для инициализации физического мира и проверки работы симуляции твердых тел с помощью Box2D:

Step 5: Build and Run on Android Шаг 5: Сборка и запуск на Android

Run the provided helper scripts in your command prompt to compile the app and push it directly to your connected device: Запустите готовые батч-скрипты в командной строке для сборки и автоматической установки на подключенное устройство:

build-apk
install-apk

Once installed, tap the application icon on your smartphone to launch it and view the falling physics boxes interact with the static ground. После завершения установки нажмите на иконку приложения на смартфоне, чтобы запустить его и увидеть падающие блоки с физикой, взаимодействующие со статической платформой.

Source Code Исходный код

You can explore the source code and download the complete project directly from the GitHub repositories: Вы можете изучить исходный код и скачать готовый проект напрямую из репозиториев на GitHub: