如何从AetherRepository迁移至MavenBndRepository？

我之前也碰到过类似的情况，升级BndTools后原有的AetherRepository确实会因为API变更失效，换成MavenBndRepository是官方推荐的适配方案。针对你的Nexus仓库生成所需索引文件，这里有几个实用的方法，而且能适配大量构件的场景：

方法一：使用Bnd Indexer Maven插件本地扫描生成 #

如果你的服务器能直接访问Nexus的本地存储目录（比如Nexus挂载的Maven仓库磁盘路径），这是最直接高效的方式：

1. 创建一个临时Maven项目（或者在现有项目的pom.xml中添加插件配置），引入Bnd Indexer插件：

<build>
    <plugins>
        <plugin>
            <groupId>biz.aQute.bnd</groupId>
            <artifactId>bnd-indexer-maven-plugin</artifactId>
            <version>6.4.0</version> <!-- 版本尽量和你的BndTools版本匹配 -->
            <executions>
                <execution>
                    <id>generate-index</id>
                    <goals>
                        <goal>index</goal>
                    </goals>
                    <configuration>
                        <!-- 指定Nexus仓库的本地存储根目录 -->
                        <inputDir>/path/to/nexus/repositories/maven-public</inputDir>
                        <!-- 生成的索引文件输出路径，后续需上传到Nexus仓库根目录 -->
                        <outputFile>${project.build.directory}/bnd-index.xml</outputFile>
                        <!-- 可选：开启增量索引，仅更新新增/变更构件，适合大仓库 -->
                        <incremental>true</incremental>
                        <!-- 可选：排除非OSGi构件，缩小索引体积 -->
                        <excludePattern>**/*.pom</excludePattern>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 运行命令生成索引：

mvn clean bnd-indexer:index

3. 将生成的bnd-index.xml上传到Nexus仓库的根目录（可以通过Nexus UI上传，或者用mvn deploy:deploy-file命令），确保能通过https://your-nexus-url/repository/maven-public/bnd-index.xml访问到。

方法二：通过Nexus REST API批量获取构件信息生成索引 #

如果无法直接访问Nexus本地存储，可以通过Nexus的REST API获取所有构件坐标，再用Bnd Indexer工具生成索引：

1. 调用Nexus搜索API获取仓库内所有OSGi构件（过滤非OSGi包可减少数据量）：

curl -u username:password "https://your-nexus-url/service/rest/v1/search/assets?repository=your-repo-id&maven.extension=jar&maven.classifier=osgi" > components.json

（若不需要过滤，去掉&maven.classifier=osgi即可）

2. 编写简单脚本（比如Groovy或Python），解析components.json中的构件坐标（groupId、artifactId、version、Jar下载URL），生成符合Bnd Indexer要求的输入列表，每行格式为groupId:artifactId:version:jar-url。

3. 使用Bnd Indexer命令行工具生成索引：

java -jar bnd-indexer-6.4.0.jar -f input-components.txt -o bnd-index.xml

配置MavenBndRepository #

生成索引后，在BndTools项目的.bnd文件中配置仓库：

-repositories: MavenBndRepository; \
    name="Internal Nexus Repo"; \
    url="https://your-nexus-url/repository/maven-public/"; \
    index="https://your-nexus-url/repository/maven-public/bnd-index.xml"; \
    snapshotsEnabled=true

大仓库优化建议 #

• 开启增量索引：Bnd Indexer会记录上次索引状态，仅处理新增或变更构件，大幅缩短生成时间。
• 定期自动生成：在服务器设置定时任务（比如Cron），每周/每月自动运行索引生成脚本并上传到Nexus，保持索引更新。
• 过滤非OSGi构件：若仓库内有大量非OSGi Jar包，生成索引时排除它们，可缩小索引体积，提升BndTools加载速度。

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