Visual Studio跨平台OpenGL C++项目链接SOIL2静态库报错求解
问题根因
- 你当前编译得到的
soil2-debug.lib是Windows平台MSVC编译器的产物,MSVC默认对C函数会添加前导下划线作为符号修饰,因此库内导出符号为_SOIL_load_OGL_texture - 你的跨平台项目使用的是Android/iOS对应的Clang/GCC工具链,这类编译器不会给C函数添加前导下划线,头文件声明的
SOIL_load_OGL_texture在编译后会去查找不带下划线的同名符号,和现有库的导出符号不匹配,因此出现链接错误 - 补充:你代码里用的Windows绝对路径在Android/iOS平台运行时也无法识别,后续需要替换为对应平台的资源读取路径
解决方案
步骤1:重新编译对应平台的SOIL2库
不要使用VS2019编译的Windows版本库,根据目标平台选择对应编译方式:
- Android平台:
- 把SOIL2源码纳入你的Android项目的JNI编译链,在
Android.mk中添加SOIL2的源码编译规则,或者用NDK工具链单独交叉编译出Android可用的静态库/动态库 - 编译时确保SOIL2的编译选项和你的主项目编译选项一致,包括运行时库、架构(armeabi-v7a/arm64-v8a/x86等)
- 把SOIL2源码纳入你的Android项目的JNI编译链,在
- iOS平台:
- 用Xcode创建静态库目标,引入SOIL2源码编译,或者使用xcodebuild命令行交叉编译出对应架构(arm64/x86_64模拟器)的静态库
- 确保编译时的C/C++标准、调用约定和主项目完全一致
- 如果你是在Windows上做本地开发调试,要跑Windows版本的项目,需要确认你的主项目用的也是MSVC编译器,且架构和SOIL2库的架构一致(同为x86或同为x64)
步骤2:修正项目配置
- 附加包含目录要指向SOIL2源码的
include文件夹,不要直接指向根目录,确保头文件引入路径正确 - 链接器的附加依赖项替换为对应平台、对应架构编译出来的SOIL2库文件
- 调用
SOIL_load_OGL_texture时不需要手动加前导下划线,直接用头文件声明的SOIL_load_OGL_texture即可
步骤3:修正资源路径
不要用Windows绝对路径加载图片,跨平台项目应该把资源放到对应平台的资源目录:
- Android放到assets目录,通过AAssetManager读取资源数据,再传给SOIL2的内存加载接口
SOIL_load_OGL_texture_from_memory - iOS放到项目的资源bundle里,通过NSBundle获取资源路径再传入,或者读取内存后用内存加载接口
内容的提问来源于stack exchange,提问作者Adrian Wheeler
相关产品推荐
相关产品推荐

