Gradle构建SDL2安卓项目报错找不到SDL2/SDL.h头文件问题问询

问题复现 #

参照SDL官方Android构建指南执行以下操作：

• 执行脚本生成Gradle项目

  ./androidbuild.sh org.libsdl.testgles ../test/testgles.c
  

• 执行构建安装命令

  ./gradlew installDebug
  

构建失败抛出核心错误：

fatal error: 'SDL2/SDL.h' file not found   
#include <SDL2/SDL.h>   
         ^~~~~~~~~~~~

当前app/jni/src/Android.mk配置如下：

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := main

SDL_PATH := ../SDL

LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include

# Add your application source files here...
LOCAL_SRC_FILES :=  main.cpp

LOCAL_SHARED_LIBRARIES := SDL2

LOCAL_LDLIBS := -lGLESv1_CM -lGLESv2 -lOpenSLES -llog -landroid

include $(BUILD_SHARED_LIBRARY)

核心排查步骤 #

按以下顺序逐一检查，可覆盖绝大多数同类报错场景：

• 校验SDL目录有效性
  进入app/jni目录执行ls -l，查看SDL条目状态：
  • 如果是失效软链接（文件名标红），说明执行androidbuild.sh时没有正确关联SDL源码路径，直接删除失效链接，手动创建指向本地SDL2源码根目录的软链接，或者直接拷贝完整SDL2源码到app/jni/SDL路径下即可。
  • 如果是正常目录，进入app/jni/SDL/include路径核对文件结构：如果该目录下直接存放SDL.h、没有SDL2子文件夹，说明头文件引用规则和包含路径不匹配。
• 检查jni根目录编译配置
  打开app/jni/Android.mk文件，必须优先引入SDL2自身的编译脚本，否则ndk-build无法正确识别SDL2模块的头文件和依赖，正确的根目录配置参考：

  LOCAL_PATH := $(call my-dir)
  
  # 引入SDL2核心库编译规则
  include $(CLEAR_VARS)
  SDL_DIR := SDL
  include $(LOCAL_PATH)/$(SDL_DIR)/Android.mk
  
  # 引入自有业务代码编译规则
  include $(LOCAL_PATH)/src/Android.mk
  

• 修正头文件包含匹配问题
  以下两种修正方案二选一即可，不要同时修改：
  1. 调整代码引用（SDL官方Android示例默认方案）：把代码里的#include <SDL2/SDL.h>改成#include <SDL.h>，现有src目录下的Android.mk不需要调整。
  2. 调整编译包含路径（保留原有代码写法）：把app/jni/src/Android.mk里的LOCAL_C_INCLUDES配置修改为：

     LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include \
                         $(LOCAL_PATH)/$(SDL_PATH)
     

     该配置会把SDL源码根目录加入头文件搜索路径，编译器即可正常定位SDL2/SDL.h头文件。

额外注意事项 #

• 当前使用的NDK 21.4.7075529版本和SDL2完全兼容，不需要更换NDK版本。
• 如果修改配置后仍报错，先执行./gradlew clean清空所有构建缓存，再重新执行构建命令，避免旧缓存干扰构建结果。

内容的提问来源于stack exchange，提问作者YoloWex