升级Gradle至7.3.0+后Android Studio出现链接器错误求助

问题背景 #

将项目Gradle从7.2.2升级至7.3.0及以上版本后，构建时出现链接器错误，提示无法找到SDL.lib、SDL_mixer.lib、SDLmain.lib等依赖库。项目未修改代码，此前可正常构建。错误日志如下：

C/C++: ld: error: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/objs-debug/main/glbasic/glb-full.o: unable to find library from dependent library specifier: SDL.lib
C/C++: ld: error: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/objs-debug/main/glbasic/glb-full.o: unable to find library from dependent library specifier: SDL_mixer.lib
C/C++: ld: error: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/objs-debug/main/glbasic/glb-full.o: unable to find library from dependent library specifier: SDLmain.lib
C/C++: ld: error: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/objs-debug/main/glbasic/glb-full.o: unable to find library from dependent library specifier: SDL_mixer.lib
C/C++: clang++: error: linker command failed with exit code 1 (use -v to see invocation)
C/C++: make: *** [C:/Users/gf/AppData/Local/Android/Sdk/ndk/23.1.7779620/build//../build/core/build-binary.mk:715: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/libmain.so] Error 1
C/C++: ld: error: C:\Users\gf\Downloads\android-project\app\build\intermediates\cxx\Debug\14s2b4rb/obj/local/arm64-v8a/objs-debug/main/glbasic/glb-full.o: unable to find library from dependent library specifier: SDL_mixer.lib

> Task :app:buildNdkBuildDebug[arm64-v8a] FAILED

解决方案 #

1. 修正NDK构建脚本中的库命名 #

Android平台本地库遵循lib{name}.so或lib{name}.a的命名规则，旧项目可能沿用了Windows平台的.lib命名方式。打开项目的Android.mk文件，将所有引用的.lib库名修改为Android格式：

• 将SDL.lib改为libSDL.so（或libSDL.a，根据实际库类型调整）
• 将SDL_mixer.lib改为libSDL_mixer.so
• 将SDLmain.lib改为libSDLmain.so

同时确保LOCAL_LDLIBS或LOCAL_STATIC_LIBRARIES中正确引用这些库，示例：

LOCAL_LDLIBS += -lSDL -lSDL_mixer -lSDLmain

2. 确认库文件路径配置 #

• 确保SDL相关库文件存放在app/src/main/jniLibs/{架构}/目录下（如arm64-v8a、armeabi-v7a等），Gradle会自动识别该目录下的本地库。
• 如果库文件存放在自定义路径，需在Android.mk中通过LOCAL_LDFLAGS指定库搜索路径：

  LOCAL_LDFLAGS += -L$(LOCAL_PATH)/libs/$(TARGET_ARCH_ABI)
  

3. 锁定NDK版本 #

Gradle 7.3+可能自动升级NDK版本，导致与旧项目构建脚本不兼容。在app/build.gradle中明确指定报错日志中使用的NDK版本：

android {
    ndkVersion "23.1.7779620"
    externalNativeBuild {
        ndkBuild {
            path "src/main/jni/Android.mk" // 指向你的Android.mk实际路径
        }
    }
}

4. 清理构建缓存并重新构建 #

执行以下命令清理旧构建缓存，避免缓存文件干扰：

./gradlew clean
./gradlew assembleDebug

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