Maven 中os-maven-plugin插件的使用。这是一个非常实用的插件，专门用于解决跨平台构建时的依赖问题，尤其适用于需要根据操作系统（OS）、架构（Arch）等环境信息动态选择依赖的场景。
一、插件核心作用
os-maven-plugin的主要功能是：在 Maven 构建过程中检测当前运行的操作系统和硬件架构信息，并将这些信息设置为 Maven 属性。
这些属性随后可以被用来：
- 动态选择依赖：为不同的操作系统引入不同的依赖（如
netty-tcnative-boringssl-static的不同分类器）。 - 配置构建插件：根据平台配置不同的插件行为。
- 资源过滤：在资源文件中替换平台相关的变量。
- 激活/禁用 Maven Profile：根据检测到的操作系统自动激活特定的构建配置文件（Profile）。
二、基本配置与使用
1. 在pom.xml中引入插件
通常将插件配置在<build><plugins>部分。最常用的目标是detect，它会在initialize阶段执行，尽早设置好属性。
<build><plugins><plugin><groupId>org.xolstice.maven.plugins</groupId><artifactId>os-maven-plugin</artifactId><version>1.7.1</version><!-- 请检查并使用最新版本 --><executions><execution><goals><goal>detect</goal><!-- 核心目标：检测OS并设置属性 --></goals></execution></executions></plugin></plugins></build>2. 插件设置的常用属性
执行detect目标后，插件会设置一系列属性，你可以在pom.xml的其他地方通过${propertyName}来引用它们。最重要的属性包括：
| 属性名 | 描述 | 示例值 |
|---|---|---|
os.detected.name | 操作系统名称（小写） | linux,windows,macos |
os.detected.arch | 系统架构 | x86_64,aarch64,ppc64le |
os.detected.classifier | 组合分类器（非常有用！） | linux-x86_64,osx-x86_64,windows-x86_64 |
os.detected.version | 操作系统版本 | 10.0(Windows),5.15(Linux) |
os.detected.family | 操作系统家族 | unix,windows,mac |
其中，os.detected.classifier是最常用的属性，它直接拼接了os.detected.name和os.detected.arch，完美匹配 Maven 依赖的<classifier>标签。
三、实战案例：为 netty-tcnative 动态选择依赖
这是os-maven-plugin最经典的应用场景。假设你的项目需要引入netty-tcnative-boringssl-static，但不想在pom.xml中硬编码操作系统。
步骤 1：配置插件和依赖管理
<project>...<properties><!-- 可以提供一个默认值，防止在非标准环境下构建失败 --><netty.tcnative.classifier>linux-x86_64</netty.tcnative.classifier></properties><build><plugins><plugin><groupId>org.xolstice.maven.plugins</groupId><artifactId>os-maven-plugin</artifactId><version>1.7.1</version><executions><execution><goals><goal>detect</goal></goals></execution></executions></plugin></plugins></build><dependencies><dependency><groupId>io.netty</groupId><artifactId>netty-tcnative-boringssl-static</artifactId><version>2.0.65.Final</version><!-- 关键：使用插件检测到的属性作为分类器 --><classifier>${os.detected.classifier}</classifier><!-- 可选：如果某些平台不需要，可以设置scope --><!-- <scope>runtime</scope> --></dependency></dependencies>...</project>工作原理：
- 当执行
mvn compile或mvn package时，os-maven-plugin会在早期阶段运行。 - 它检测到当前构建机器的操作系统（例如 Windows 10 64位），并设置属性
os.detected.classifier的值为windows-x86_64。 - Maven 在解析依赖时，将
${os.detected.classifier}替换为windows-x86_64，从而下载正确的依赖包。
优点：
- 一份 POM，处处构建：同一份
pom.xml可以在 Linux、macOS、Windows 上直接使用，无需修改。 - CI/CD 友好：在 Jenkins、GitLab CI 等持续集成环境中，构建机可能是任意系统，插件能自动适配。
- 开发者体验好：新开发者克隆代码后，无需手动配置，直接构建即可。
四、高级用法
1. 结合 Maven Profile 使用
有时你可能需要为特定平台执行额外的构建步骤（例如，打包原生库）。可以结合 Profile 和插件属性来实现。
<profiles><profile><id>build-for-mac</id><activation><os><family>mac</family><!-- 原生的Maven OS激活 --></os></activation><build><plugins><!-- 在Mac上额外执行的插件 --><plugin>...</plugin></plugins></build></profile><profile><id>build-for-linux</id><activation><property><!-- 使用os-maven-plugin的属性来激活Profile --><name>os.detected.name</name><value>linux</value></property></activation><build>...</build></profile></profiles>2. 自定义属性映射
如果默认的属性名不符合你的要求，或者需要更复杂的逻辑，可以使用detect-classifier目标并配置映射关系。
<plugin><groupId>org.xolstice.maven.plugins</groupId><artifactId>os-maven-plugin</artifactId><version>1.7.1</version><executions><execution><goals><goal>detect-classifier</goal><!-- 另一个目标：专门生成分类器 --></goals><configuration><!-- 自定义分类器映射表 --><classifierMapping><mapping><os>Windows</os><classifier>win-${os.arch}</classifier></mapping><mapping><os>Linux</os><classifier>linux-${os.arch}</classifier></mapping><mapping><os>Mac</os><classifier>osx-${os.arch}</classifier></mapping></classifierMapping></configuration></execution></executions></plugin>然后通过${os.detected.customClassifier}来引用自定义的分类器。
五、常见问题与注意事项
在 IDE 中运行：在 IntelliJ IDEA 或 Eclipse 中直接运行/调试时，构建过程可能不会触发
os-maven-plugin。这可能导致 IDE 无法解析依赖。解决方案：- 在 IDE 中执行一次完整的 Maven 命令（如
mvn compile）来让插件运行并设置属性。 - 或者在 IDE 的 Maven 设置中启用“Delegate IDE build/run actions to Maven”。
- 在 IDE 中执行一次完整的 Maven 命令（如
属性未生效：确保插件的
detect目标绑定到了initialize阶段（默认就是），并且在你使用属性之前已经执行。可以通过mvn help:effective-pom命令查看最终生效的属性值。不支持的操作系统：如果插件无法识别你的操作系统，
os.detected.classifier可能为空或为unknown。建议在<properties>中提供一个合理的默认值作为回退。与原生 Maven OS 激活的区别：Maven 本身的 Profile 激活也支持
<os>条件，但功能较弱（只能判断 family、name、arch、version）。os-maven-plugin提供了更详细、更灵活的属性，并且可以在依赖的任何地方使用，而不仅仅是 Profile 激活。
总结
| 特性 | 描述 |
|---|---|
| 核心价值 | 实现跨平台 Maven 构建，根据运行环境动态配置依赖和插件。 |
| 关键目标 | detect：检测 OS 并设置属性。 |
| 关键属性 | os.detected.classifier：直接提供os-arch格式的分类器字符串。 |
| 最佳实践 | 用于管理带分类器的依赖（如netty-tcnative、lwjgl、sqlite-jdbc等），结合<classifier>${os.detected.classifier}</classifier>使用。 |
| 替代方案 | Maven 内置的 Profile<os>激活（功能较简单，仅用于激活 Profile）。 |
通过使用os-maven-plugin，你可以极大地提升项目的可移植性和构建自动化程度，是现代 Java 项目（尤其是涉及 JNI/原生库的项目）的必备工具之一。
