更多内容：XiaoJ的知识星球
SDL2：Android APP编译使用
-
- [3. SDL2：Android APP编译使用](#3. SDL2：Android APP编译使用)
-
- [3.1 Android Studio环境准备：](#3.1 Android Studio环境准备：)
- [3.2 构建Android APP](#3.2 构建Android APP)
- [3.3 android-project 项目文件说明](#3.3 android-project 项目文件说明)
SDL2（Simple DirectMedia Layer 2）是一个开源的跨平台多媒体开发库，它提供了一套简洁高效的API，用于处理图形渲染、音频播放、输入设备管理等功能，帮助开发者轻松创建出能在多种操作系统上运行的多媒体应用程序。
3. SDL2：Android APP编译使用
参考：https://github.com/mayzelf/SDL2/blob/release-2.28.4/docs/README-android.md
3.1 Android Studio环境准备：
（1）安装JDK、Android Studio
（2）安装Android SDK、Android NDK
shell
export AS_DIR=$MY_ENV_HOME/App/Android_Studio/android-studio-2022.1.1.19
export ANDROID_HOME=$MY_ENV_HOME/App/Android_Studio/Android-2022.1.1.19
export ANDROID_NDK_HOME=$ANDROID_HOME/Sdk/ndk/28.0.12674087
export PATH=$PATH:$AS_DIR3.2 构建Android APP
先下载SDL2源代码，SDL2官方网站下载或以下方式：
shell
wget https://www.libsdl.org/release/SDL2-2.28.4.tar.gz
tar -zxvf SDL2-2.28.4.tar.gz
mv SDL2-2.28.4 /home/SDL有以下方式，构建不同程度需求的APK：
（1）方式一：快速构建APK工程
shell
cd /home/SDL
cd build-scripts
./androidbuild.sh org.libsdl.testgles ../test/testgles.c
# 或
# ./androidbuild.sh org.libsdl.audio ../test/*audio*
# 输出
To build and install to a device for testing, run the following:
cd /home/SDL/build/org.libsdl.testgles
./gradlew installDebug（2）方式二：自定义APK工程
1.将 SDL/android-project 目录复制并重命名，如YOURPROJECT。
2.将 SDL 目录移动或符号链接到 YOURPROJECT/app/jni目录。
3.编辑YOURPROJECT/app/jni/src/Android.mk以包含您的源文件：
- 它们应该在
LOCAL_SRC_FILES ：=声明后用空格分隔
4a.如想用 Android Studio，只需打开您的YOURPROJECT目录并开始构建。
4b. 如要手动构建，在项目目录运行 ./gradlew installDebug。
- 它将在任何连接的 Android 设备上构建和安装您的 .apk
实际操作如下：
shell
# 构建工程目录
cp -rf SDL/android-project/ YOURPROJECT
cp -rf SDL YOURPROJECT/app/jni/SDL
# APK工程相应修改
# (1) 替换源和gradle版本：
# 打开YOURPROJECT/gradle/wrapper/gradle-wrapper.properties
#distributionUrl=https\://services.gradle.org/distributions/gradle-8.1.1-bin.zip
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5-bin.zip
# 打开YOURPROJECT/build.gradle
// classpath 'com.android.tools.build:gradle:8.1.1'
classpath 'com.android.tools.build:gradle:7.4.0'
# (2) 添加音频权限声明: 在AndroidManifest.xml中添加
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
# (3) 生成源文件：YOURPROJECT/app/jni/src/*.cpp（例如testSDL2.cpp, 代码详情附在下面）
# 在YOURPROJECT/app/jni/src/Android.mk中，"LOCAL_SRC_FILES ：= " 声明*.cpp后用空格分隔
# 编译运行apk
# 方式一：用 Android Studio构建
# 方式二：运行 ./gradlew installDebug
cpp
#include "SDL.h"
#include <stdlib.h>
#include <stdio.h>
static SDL_AudioSpec spec;
static SDL_AudioDeviceID devid_in = 0;
static SDL_AudioDeviceID devid_out = 0;
static void
audio_callback(void *userdata, Uint8 *stream, int len)
{
// 这里可以添加音频处理逻辑
SDL_Log("标志：音频回调函数被调用，数据长度 = %d\n", len);
}
int main(int argc, char **argv)
{
SDL_AudioSpec wanted;
int devcount;
int i;
/* 启用标准应用程序日志 */
SDL_LogSetPriority(SDL_LOG_CATEGORY_APPLICATION, SDL_LOG_PRIORITY_INFO);
/* 加载SDL库 */
if (SDL_Init(SDL_INIT_AUDIO) < 0) {
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "标志：无法初始化SDL: %s\n", SDL_GetError());
return 1;
}
SDL_Log("标志：使用的音频驱动: %s\n", SDL_GetCurrentAudioDriver());
devcount = SDL_GetNumAudioDevices(SDL_TRUE);
for (i = 0; i < devcount; i++) {
SDL_Log("标志：捕获设备 #%d: '%s'\n", i, SDL_GetAudioDeviceName(i, SDL_TRUE));
}
SDL_zero(wanted);
wanted.freq = 44100; // 采样率
wanted.format = AUDIO_S16SYS; // 格式
wanted.channels = 1; // 通道数
wanted.samples = 1024; // 样本数
wanted.callback = audio_callback;
SDL_zero(spec);
/* 打开默认播放设备 */
SDL_Log("标志：打开默认播放设备...\n");
devid_out = SDL_OpenAudioDevice(NULL, SDL_FALSE, &wanted, &spec, SDL_AUDIO_ALLOW_ANY_CHANGE);
if (!devid_out) {
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "标志：无法打开音频播放设备: %s!\n", SDL_GetError());
SDL_Quit();
exit(1);
}
/* 打开默认捕获设备 */
SDL_Log("标志：打开默认捕获设备...\n");
// devid_in = SDL_OpenAudioDevice(NULL, SDL_TRUE, &spec, &spec, 0);
devid_in = SDL_OpenAudioDevice(SDL_GetAudioDeviceName(0, SDL_TRUE), SDL_TRUE, &spec, &spec, 0);
if (!devid_in) {
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "标志：无法打开音频捕获设备: %s!\n", SDL_GetError());
SDL_Quit();
exit(1);
}
SDL_Log("标志：音频设备成功打开！\n");
/* 启动音频播放和捕获 */
SDL_PauseAudioDevice(devid_out, 0);
SDL_PauseAudioDevice(devid_in, 0);
SDL_Log("标志：音频播放和捕获已启动。按回车键停止。\n");
/* 等待用户输入停止 */
getchar();
/* 停止音频播放和捕获 */
SDL_PauseAudioDevice(devid_out, 1);
SDL_PauseAudioDevice(devid_in, 1);
SDL_Log("标志：关闭音频设备。\n");
/* 关闭音频设备 */
SDL_CloseAudioDevice(devid_out);
SDL_CloseAudioDevice(devid_in);
/* 退出SDL库 */
SDL_Quit();
return 0;
}（3）方式三：CMake构建APK工程
1.将 SDL/android-project 目录复制并重命名，如YOURPROJECT。
2.将 SDL 目录移动或符号链接到 YOURPROJECT/app/jni目录。
3.编辑YOURPROJECT/app/build.gradle：注掉 ndk-build 的部分，取消注释 cmake 部分。向CMake调用添加参数。
4.编辑YOURPROJECT/app/jni/CMakeLists.txt以包含您的项目（默认添加src子目录）：
-
请注意，您的项目中将
SDL2、SDL2main 和 SDL2-static作为目标，因此您的 CMakeLists.txt 文件中应该有target_link_libraries(yourgame SDL2 SDL2main)。 -
另请注意，对包含
main函数的目标，应使用add_library()而不是add_executable()。
5a. 如想用 Android Studio，只需打开您的YOURPROJECT目录并开始构建。
6b. 如要手动构建，在项目目录运行 ./gradlew installDebug。
- 它将在任何连接的 Android 设备上构建和安装您的 .apk
3.3 android-project 项目文件说明
bash
android-project/app
build.gradle - 构建信息，包括应用程序版本和SDK
src/main/AndroidManifest.xml - 包清单。其中包含主Activity的类名和应用程序的包名等信息。
jni/ - 存放原生代码的目录
jni/Application.mk - 应用程序JNI设置，包括目标平台和STL库
jni/Android.mk - 可递归调用所有子目录中Android.mk文件的Android makefile
jni/CMakeLists.txt - 顶级CMake项目，将SDL作为子项目添加
jni/SDL/ - （指向）存放SDL库文件的目录
jni/SDL/Android.mk - 创建SDL共享库的Android makefile
jni/src/ - 存放C/C++源代码的目录
jni/src/Android.mk - 你应该定制的Android makefile，用于包含源代码和任何库引用
jni/src/CMakeLists.txt - 你可以定制的CMake文件，用于包含源代码和任何库引用
src/main/assets/ - 存放应用程序资产文件的目录
src/main/res/ - 存放应用程序资源的目录
src/main/res/mipmap-* - 存放不同手机硬件图标文件的目录
src/main/res/values/strings.xml - 应用程序中使用的字符串，包括应用程序名称
src/main/java/org/libsdl/app/SDLActivity.java - 处理SDL初始化和绑定的Java类。要非常小心地修改这个类，因为SDL库依赖于这个实现。你应该为你的应用程序继承这个类。.
声明：资源可能存在第三方来源，若有侵权请联系删除！