Step 1: Project Setup Шаг 1: Настройка структуры проекта

Create a new empty directory on your machine for your project (e.g., android-app-sdl3-c). Создайте новую пустую директорию на вашем компьютере для проекта (например, android-app-sdl3-c).

Copy the android-project directory from the official SDL3 repository into your new folder: Скопируйте директорию android-project из официального репозитория SDL3 в созданную папку:

SDL3 android-project Source Исходники android-project SDL3

Next, delete the unneeded native source template folder: Затем удалите ненужную папку с шаблоном нативных исходников:

• android-project\app\jni

Step 2: Create CMakeLists.txt Шаг 2: Создание CMakeLists.txt

In the root of your created project folder (outside android-project), create a CMakeLists.txt file: В корне созданной папки проекта (рядом с android-project) создайте файл CMakeLists.txt:

Step 3: Create the C Source File Шаг 3: Создание исходного файла C

In the root directory, create a folder named src, and inside it, create a file named main.c: В корневой директории создайте папку src, а внутри нее — файл main.c:

Step 4: Configure Gradle and Android Settings Шаг 4: Настройка Gradle и параметров Android

1. Replace the content of android-project/app/build.gradle with: 1. Замените содержимое файла android-project/app/build.gradle следующим кодом:

2. Create a custom Java activity at path android-project\app\src\main\java\com\example\myapp\MyActivity.java: 2. Создайте пользовательский Java-класс по пути android-project\app\src\main\java\com\example\myapp\MyActivity.java:

3. In android-project\app\src\main\AndroidManifest.xml, update the activity tag to point to your new package name: 3. В файле android-project\app\src\main\AndroidManifest.xml измените строку объявления activity:

<activity android:name="com.example.myapp.MyActivity"

4. Open android-project\gradle.properties and append this line: 4. Откройте android-project\gradle.properties и добавьте следующую строку:

android.useAndroidX=true

Step 5: Create Build and Install Scripts Шаг 5: Создание скриптов сборки и установки

In the root folder of your project, create two helper batch files to compile and install the application automatically. В корневой папке проекта создайте два вспомогательных bat-файла для автоматической сборки и установки приложения.

build-apk.bat

install-apk.bat

Step 6: Build, Deploy, and Debug Шаг 6: Сборка, развертывание и отладка

Enable Developer Options and USB Debugging on your Android device, then connect it to your computer via USB. Включите Режим разработчика и Отладку по USB на вашем Android-устройстве, после чего подключите его к компьютеру через USB-кабель.

Execute the batch scripts in your Command Prompt (CMD): Выполните батч-скрипты в командной строке (CMD):

build-apk
install-apk

adb uninstall com.example.myapp

adb logcat -c
adb shell 'logcat --pid=$(pidof -s com.example.myapp)'

adb logcat -c
for /f %i in ('adb shell pidof -s com.example.myapp') do set APP_PID=%i
adb logcat --pid=%APP_PID%

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

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