1. Download the AAR library 1. Загрузка библиотеки AAR

• Download the Android development binaries (AAR) - specifically SDL3-devel-3.4.12-android.zip - from the official SDL3 release page Скачайте бинарные файлы для разработки под Android (AAR) — а именно SDL3-devel-3.4.12-android.zip — с официальной страницы релизов SDL3.
• Move SDL3-devel-3.4.12-android.zip to the C:/libs folder (or your preferred directory) Переместите архив SDL3-devel-3.4.12-android.zip в папку C:/libs (или любой другой удобный каталог).
• Extract the ZIP file into a folder named SDL3-devel-3.4.12-android like this: Распакуйте ZIP-файл в папку с названием SDL3-devel-3.4.12-android вот так:
  

2. Download a Template 2. Загрузка шаблона

• Download the SDL3 Renderer Example (displays squares on touch). If the previous repository is unavailable, please use my fork: link Скачайте пример SDL3 Renderer (рисует квадраты при касании). Если репозиторий недоступен, используйте мой форк: ссылка.
• Extract it to a folder of your choice Распакуйте его в любую папку на ваш выбор.
• Open this folder in your preferred code editor (e.g., Sublime Text 4, Notepad++, etc.) Откройте эту папку в вашем любимом текстовом редакторе (например, Sublime Text 4, Notepad++ и т.д.).

3. Project Configuration in the "android-project/app/build.gradle" file 3. Конфигурация проекта в файле "android-project/app/build.gradle"

• Open the android-project/app/build.gradle file. It looks like this: Откройте файл android-project/app/build.gradle. Он выглядит следующим образом:

dependencies {
    implementation files('libs/SDL3-3.2.22.aar')
    implementation files('libs/SDL3_image-3.2.4.aar')

    /* Use [create-prefab-aar.py](https://gist.github.com/madebr/3563a41ec9d287b6754c5fe764f56a1c)
     * to creat a Android prefab archive for Box2D.
     */
    //implementation files('libs/box2d-3.2.0.aar')
    implementation 'androidx.appcompat:appcompat:1.5.1'
}

• Delete the implementation files('libs/SDL3_image-3.2.4.aar') because we will not load an image in this guide Удалите строку implementation files('libs/SDL3_image-3.2.4.aar'), так как в этом руководстве мы не будем загружать изображения.
• Set a path to the AAR file in this line implementation files('libs/SDL3-3.2.22.aar') (use / instead of \ in the path). Now we have this code: Укажите путь к AAR-файлу в строке implementation files('libs/SDL3-3.2.22.aar') (используйте / вместо \ в пути). Теперь код выглядит так:

dependencies {
    implementation files('C:/libs/SDL3-devel-3.4.4-android/SDL3-3.4.12.aar')

    /* Use [create-prefab-aar.py](https://gist.github.com/madebr/3563a41ec9d287b6754c5fe764f56a1c)
     * to creat a Android prefab archive for Box2D.
     */
    //implementation files('libs/box2d-3.2.0.aar')
    implementation 'androidx.appcompat:appcompat:1.5.1'
}

• You see this code: Найдите следующий блок кода:

          externalNativeBuild {
              cmake {
                  arguments '-DANDROID_STL=c++_shared', '-DWITH_IMAGE=ON', '-DWITH_MIXER=OFF', '-DWITH_NET=OFF', '-DWITH_BOX2D=OFF'
                  abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
                  // abiFilters 'arm64-v8a'
              }
          }

• Disable the image drawing by setting DWITH_IMAGE to OFF like this '-DWITH_IMAGE=OFF' Отключите поддержку изображений, установив DWITH_IMAGE в значение OFF: '-DWITH_IMAGE=OFF'.

          externalNativeBuild {
              cmake {
                  arguments '-DANDROID_STL=c++_shared', '-DWITH_IMAGE=OFF', '-DWITH_MIXER=OFF', '-DWITH_NET=OFF', '-DWITH_BOX2D=OFF'
                  abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
                  // abiFilters 'arm64-v8a'
              }
          }

• Disable building to all ABI (add a comment before abiFilters 'armeabi-v7a', ...) and enable arm64-v8a only (delete a comment before abiFilters 'arm64-v8a') Отключите сборку для всех ABI (закомментируйте строку abiFilters 'armeabi-v7a', ...) и включите только arm64-v8a (раскомментируйте соответствующую строку).

          externalNativeBuild {
              cmake {
                  arguments '-DANDROID_STL=c++_shared', '-DWITH_IMAGE=OFF', '-DWITH_MIXER=OFF', '-DWITH_NET=OFF', '-DWITH_BOX2D=OFF'
                  // abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
                  abiFilters 'arm64-v8a'
              }
          }

4. Build and Deploy 4. Сборка и установка

Open a terminal in the android-project and run the following commands: Откройте терминал в папке android-project и выполните следующие команды:

gradlew assembleDebug

cd app/build/outputs/apk/debug

adb install -r app-debug.apk

Changing a code and rebuild Изменение кода и пересборка

• You can change something in the src/main.c file (for example, a background color) Вы можете изменить что-нибудь в файле src/main.c (например, цвет фона).
• Switch to the first terminal and press the up arrow key to select the gradlew assembleDebug. Press Enter to build a project Переключитесь в первый терминал и нажмите клавишу "вверх", чтобы выбрать команду gradlew assembleDebug. Нажмите Enter для сборки проекта.
• Switch to the second terminal and press the up arrow key to select the adb install -r app-debug.apk. Press Enter to install the project Переключитесь во второй терминал и нажмите "вверх", чтобы выбрать adb install -r app-debug.apk. Нажмите Enter для установки приложения.

5. Useful Tips 5. Полезные советы

• Show a log: adb logcat -s SDL Показать лог: adb logcat -s SDL
• Clear a log: adb logcat -c Очистить лог: adb logcat -c
• Check connected devices: adb devices Проверка подключенных устройств: adb devices
• Use scrcpy to mirror your phone screen to your PC via USB. Используйте scrcpy для трансляции экрана телефона на ПК через USB.