在 Java Gradle 项目中引用带 classifier 的本地库需显式指定 classifier，如 implementation 'com.example:native-lib:1.0.0:linux-x86_64'；本地 jar 文件须通过模拟 Maven 仓库方式支持 classifier 元数据，再配合运行时按 os.arch 动态加载。

在 Java Gradle 项目中，若需引用带 classifier 的本地库（例如针对特定 CPU 架构的 native 库，如 linux-x86_64 或 win-x64），不能仅靠 `groupId:artifactId:version`，必须显式指定 classifier，并确保 Gradle 能正确解析和使用该变体。

明确依赖坐标并指定 classifier

Gradle 中添加带 classifier 的依赖，语法为：

implementation 'groupId:artifactId:version:classifier'

例如，引用一个 Linux x86_64 架构的本地 JNI 库：

implementation 'com.example:native-lib:1.0.0:linux-x86_64'

注意：该写法仅在 Maven 坐标形式下有效，且要求对应 artifact 在仓库中存在 native-lib-1.0.0-linux-x86_64.jar（或 .so/.dll 等，但通常打包为 jar）。

立即学习“Java免费学习笔记（深入）”；

从本地文件系统引入带 classifier 的 jar

若库是本地文件（如 lib/native-lib-1.0.0-linux-x86_64.jar），不能直接用 `files()`，因为 `files()` 不支持 classifier 元数据。正确做法是：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 将 jar 放入项目目录（如 libs/）
• 在 build.gradle 中声明自定义配置（configuration），并手动设置 artifact 和 classifier
• 通过 dependencies { ... } 添加到 compile/runtime classpath

示例：

configurations {
  linuxX64Native
}

dependencies {
  linuxX64Native files('libs/native-lib-1.0.0-linux-x86_64.jar')
  implementation files('libs/native-lib-1.0.0-linux-x86_64.jar')
}

但上述方式仍缺失 classifier 元数据 —— 若需在运行时由 JNI 加载器识别架构，更稳妥的是用 ArtifactRepository 模拟本地 Maven 仓库：

repositories {
  maven {
    url = file("${project.projectDir}/maven-repo")
  }
}

然后按 Maven 规范组织文件：
maven-repo/com/example/native-lib/1.0.0/native-lib-1.0.0-linux-x86_64.jar
再用标准坐标引用即可。

配合 native 插件或运行时动态加载

Classifier 本身不改变 JVM 行为；它只是 Maven/Gradle 的分类标识。真正加载架构相关 native 库，还需：

• 确保 JAR 内含对应平台的 .so/.dll/.dylib，且路径符合 System.loadLibrary() 查找逻辑
• 或在代码中根据 os.name 和 os.arch 手动选择 classifier 并加载（如用 System.load(new File(...).getAbsolutePath())）
• 若使用 org.gradle.nativeplatform（已弃用）或 cpp 插件，应改用 java-library + jni 方案或现代替代如 JNIWrapper、JNR

验证 classifier 是否生效

执行 ./gradlew dependencies --configuration runtimeClasspath，检查输出中是否出现带 classifier 的条目，如：

+--- com.example:native-lib:1.0.0:linux-x86_64

也可在构建后查看 build/libs/*.jar!/META-INF/MANIFEST.MF 或解压确认 native 文件是否存在及命名是否匹配。