OpenDaylight Nitrogen（基于Karaf 4.0）：如何指定特性仓库路径？

我来帮你搞定这个问题——毕竟OpenDaylight Nitrogen（搭配Karaf 4.0）的特性管理和Maven深度绑定，有时候确实容易在仓库配置上卡壳。结合你的场景，我分两个核心层面给你梳理解决方案：

一、Maven构建阶段：让特性模块找到本地.m2的依赖 #

首先要明确：你提到的features/features-X下的pom.xml，确实是配置特性依赖的核心文件，但本地Maven仓库的路径其实不需要在这个pom里单独指定——Maven默认就会读取你~/.m2/repository里的内容，除非你的本地仓库是自定义路径。

关键步骤： #

1. 先确保本地项目已安装到.m2
   你要引用的另一个项目，必须先执行过mvn clean install，把它的特性jar、features.xml等文件都安装到本地Maven仓库里。你可以去~/.m2/repository/[你的项目groupId]/[artifactId]/[version]下检查，确认存在[artifactId]-[version]-features.xml这个文件。

2. 在特性模块pom.xml中引入依赖
   在features/features-X/pom.xml的<dependencies>节点里，添加本地项目的特性依赖：

   <dependencies>
     <dependency>
       <groupId>你的项目groupId</groupId>
       <artifactId>你的项目artifactId</artifactId>
       <version>你的项目版本号</version>
       <type>xml</type>
       <classifier>features</classifier>
     </dependency>
   </dependencies>
   

   这样Maven在生成features.xml的时候，就能识别到这个本地依赖了。

3. 如果是自定义本地仓库路径
   要是你的.m2不在默认的~/.m2/repository，那需要在Maven的settings文件里配置：

   • 全局settings：[Maven安装目录]/conf/settings.xml
   • 项目级settings：可以放在当前项目根目录下（需要在pom.xml里指定路径）
     配置内容如下：

   <settings>
     <localRepository>/你的自定义路径/.m2/repository</localRepository>
   </settings>
   

二、Karaf运行阶段：让Karaf能加载本地特性 #

搞定构建阶段后，还要确保Karaf运行时能找到这个本地特性，有两种常用方式：

方式1：修改Karaf配置文件（永久生效） #

编辑Karaf安装目录下的etc/org.apache.karaf.features.cfg，在featuresRepositories属性里添加你的本地特性仓库的Maven URL：

featuresRepositories = \
    mvn:org.opendaylight.odlparent/features/1.8.3/xml/features, \
    mvn:你的项目groupId/你的项目artifactId/你的项目版本/xml/features@id=local-custom-feature

这里的mvn:格式的URL，会让Karaf通过Maven的仓库（包括本地.m2）去拉取特性文件。

方式2：Karaf控制台临时添加（测试用） #

如果只是临时测试，直接在Karaf控制台执行命令：

feature:repo-add mvn:你的项目groupId/你的项目artifactId/你的项目版本/xml/features

这种方式重启Karaf后会失效，适合快速验证。

几个容易踩的坑 #

• 版本一致性：OpenDaylight Nitrogen对版本匹配要求严格，确保你本地项目依赖的ODL核心组件版本和当前项目完全一致，避免出现依赖冲突。
• Karaf的Maven配置：如果你的本地仓库是自定义路径，还要确保Karaf读取的是正确的Maven settings。可以编辑etc/org.ops4j.pax.url.mvn.cfg，设置org.ops4j.pax.url.mvn.settings属性指向你的settings文件路径。
• 特性文件正确性：检查本地项目的features.xml是否符合ODL的特性规范，有没有正确声明依赖和bundle。

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