Gradle Native C项目：相对路径头文件无法被其他头文件包含

我来帮你搞定这个头文件找不到的麻烦！之前用Eclipse能正常编译，换Gradle就卡壳，本质是Eclipse会自动扫描项目内的目录来处理相对路径引用，但Gradle需要你明确配置头文件的搜索路径——毕竟它的构建逻辑更严谨，不会自动猜你要包含哪些目录。

下面是一步步的解决方案：

1. 明确配置SDK头文件的搜索路径 #

首先找到你的模块build.gradle（Groovy DSL）或build.gradle.kts（Kotlin DSL），定位到Native组件的配置块，把SDK的头文件根目录（以及所有嵌套子目录）添加到includeDirs中。

示例（Groovy DSL） #

假设SDK放在父项目的third-party/sdk/include目录下：

model {
    components {
        main(NativeExecutableSpec) {
            sources {
                c {
                    source {
                        srcDirs "src/main/c"
                    }
                    includeDirs {
                        // 先添加SDK的根头文件目录
                        includeDir "${rootProject.projectDir}/third-party/sdk/include"
                        // 遍历并添加所有子目录，解决深层相对引用问题
                        includeDirs fileTree(dir: "${rootProject.projectDir}/third-party/sdk/include", include: "**/").dirs
                    }
                }
            }
        }
    }
}

示例（Kotlin DSL） #

model {
    components {
        "main"(NativeExecutableSpec::class) {
            sources {
                c {
                    source.srcDirs("src/main/c")
                    includeDirs(
                        rootProject.projectDir.resolve("third-party/sdk/include"),
                        // 自动扫描所有子目录作为include路径
                        fileTree(rootProject.projectDir.resolve("third-party/sdk/include")) { include("**/") }.dirs
                    )
                }
            }
        }
    }
}

2. 验证配置是否生效 #

执行带日志的编译命令，检查编译器参数里是否包含了你配置的目录：

./gradlew compileMainC --info

在输出里找类似-I/path/to/third-party/sdk/include、-I/path/to/third-party/sdk/include/core的参数，如果能看到这些路径，说明配置已经生效。

3. 适配父项目构建的特殊场景 #

因为是父项目统一构建，要确保子项目引用的SDK路径是基于父项目根目录的：

• 用rootProject.projectDir代替projectDir，保证路径不会因为子项目的位置变化而失效
• 如果多个子项目都需要用这个SDK，可以把配置抽离到父项目的build.gradle里，通过subprojects块统一配置：

subprojects {
    model {
        components {
            all {
                sources {
                    c {
                        includeDirs "${rootProject.projectDir}/third-party/sdk/include"
                        includeDirs fileTree(dir: "${rootProject.projectDir}/third-party/sdk/include", include: "**/").dirs
                    }
                }
            }
        }
    }
}

4. 排查特殊引用情况 #

如果还是有个别头文件找不到，检查SDK里的引用语法：

• 如果是#include <xxx.h>，编译器只会在系统路径和你配置的includeDirs里找，确保对应的目录已经添加
• 如果是#include "xxx.h"，编译器会先从当前头文件所在目录查找，再去includeDirs里找，这时候确保当前头文件的父目录已经被加入搜索路径

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