我有一个小开源库的分支,我正在github上工作。我希望通过maven让其他开发人员可以使用它,但我不想运行自己的Nexus服务器,而且因为它是一个分支,所以我不能轻松地将它部署到oss.sonatype.org。

我想做的是将它部署到github,以便其他人可以使用maven访问它。最好的方法是什么?


当前回答

不要使用GitHub作为Maven资源库。

编辑:这个选项得到了很多反对票,但没有人评论为什么。不管在GitHub上实际托管的技术能力如何,这都是正确的选择。基于下面列出的所有原因,在GitHub上托管是错误的,没有评论,我无法改进答案来澄清您的问题。

最佳选择-与原项目合作

最好的选择是说服原始项目包含您的更改,并坚持使用原始项目。

选择-维护你自己的叉子

由于您已经创建了一个开源库,并且您的分支也是开源的,您可以通过给它一个新的groupId和一个新的artifactId来将您的分支上传到Maven Central(请阅读将工件上传到中央存储库的指南)。

只有当您愿意维护这个分支直到更改被合并到原始项目中时,才考虑这个选项,然后您应该放弃这个选项。

认真考虑分叉是否是正确的选择。阅读无数谷歌结果“为什么不分叉”

推理

用jar填充存储库会增加下载大小,没有任何好处

一个jar是你项目的输出,它可以在任何时候从它的输入重新生成,你的GitHub回购应该只包含输入。

不相信我?然后检查谷歌的结果“不要存储二进制文件在git”。

GitHub的帮助工作大文件会告诉你同样的事情。诚然,jar并不大,但它们比源代码大,一旦一个版本创建了一个jar,它们就没有理由进行版本控制——这就是新版本的目的。

在pom.xml中定义多个repo会降低构建速度,其速度是存储库数量乘以工件数量

Stephen Connolly说:

如果任何人添加了你的回购,他们会影响他们的构建性能 因为他们现在有另一个回购来检查文物…不是很大 如果你只需要添加一个回购…但问题越来越多 你知道的,你的专业版本是为每个工件检查50个回购 构建时间是一条狗。

这是正确的!Maven需要检查pom.xml中定义的每个工件(及其依赖项)与您定义的每个存储库之间的关系,因为这些存储库中的任何一个都可能有更新的版本。

亲自尝试一下,您会感受到缓慢构建的痛苦。

存放工件的最佳位置是Maven Central,因为它是存放jar的中心位置,这意味着您的构建只会检查一个地方。

您可以在Maven的文档“知识库介绍”中阅读更多关于知识库的信息

其他回答

不要使用GitHub作为Maven资源库。

编辑:这个选项得到了很多反对票,但没有人评论为什么。不管在GitHub上实际托管的技术能力如何,这都是正确的选择。基于下面列出的所有原因,在GitHub上托管是错误的,没有评论,我无法改进答案来澄清您的问题。

最佳选择-与原项目合作

最好的选择是说服原始项目包含您的更改,并坚持使用原始项目。

选择-维护你自己的叉子

由于您已经创建了一个开源库,并且您的分支也是开源的,您可以通过给它一个新的groupId和一个新的artifactId来将您的分支上传到Maven Central(请阅读将工件上传到中央存储库的指南)。

只有当您愿意维护这个分支直到更改被合并到原始项目中时,才考虑这个选项,然后您应该放弃这个选项。

认真考虑分叉是否是正确的选择。阅读无数谷歌结果“为什么不分叉”

推理

用jar填充存储库会增加下载大小,没有任何好处

一个jar是你项目的输出,它可以在任何时候从它的输入重新生成,你的GitHub回购应该只包含输入。

不相信我?然后检查谷歌的结果“不要存储二进制文件在git”。

GitHub的帮助工作大文件会告诉你同样的事情。诚然,jar并不大,但它们比源代码大,一旦一个版本创建了一个jar,它们就没有理由进行版本控制——这就是新版本的目的。

在pom.xml中定义多个repo会降低构建速度,其速度是存储库数量乘以工件数量

Stephen Connolly说:

如果任何人添加了你的回购,他们会影响他们的构建性能 因为他们现在有另一个回购来检查文物…不是很大 如果你只需要添加一个回购…但问题越来越多 你知道的,你的专业版本是为每个工件检查50个回购 构建时间是一条狗。

这是正确的!Maven需要检查pom.xml中定义的每个工件(及其依赖项)与您定义的每个存储库之间的关系,因为这些存储库中的任何一个都可能有更新的版本。

亲自尝试一下,您会感受到缓慢构建的痛苦。

存放工件的最佳位置是Maven Central,因为它是存放jar的中心位置,这意味着您的构建只会检查一个地方。

您可以在Maven的文档“知识库介绍”中阅读更多关于知识库的信息

另一种选择是使用任何支持webdav的虚拟主机。当然,你需要一些空间来放置它,但是它的设置很简单,是运行一个完整的nexus服务器的一个很好的替代方案。

将此添加到构建部分

     <extensions>
        <extension>
        <artifactId>wagon-webdav-jackrabbit</artifactId>
        <groupId>org.apache.maven.wagon</groupId>
        <version>2.2</version>
        </extension>
    </extensions>

向distributionManagement部分添加这样的内容

<repository>
    <id>release.repo</id>
    <url>dav:http://repo.jillesvangurp.com/releases/</url>
</repository>

最后,确保在settings.xml中设置了存储库访问

将此添加到服务器部分

    <server>
        <id>release.repo</id>
        <username>xxxx</username>
        <password>xxxx</password>
    </server>

以及存储库部分的定义

            <repository>
                <id>release.repo</id>
                <url>http://repo.jillesvangurp.com/releases</url>
                <releases>
                    <enabled>true</enabled>
                </releases>
                <snapshots>
                    <enabled>false</enabled>
                </snapshots>
            </repository>

最后,如果你有任何标准的php主机,你可以使用像sabredav这样的东西来添加webdav功能。

优点:您有自己的maven存储库 缺点:你在nexus中没有任何管理能力;你需要在某个地方安装一些webdav

我想添加另一个替代方案,一个我最近一直在做的Gradle插件:magik。

基本上,它允许直接在github存储库上发布,作为一个maven存储库。

如果你只有aar或jar文件本身,或者只是不想使用插件-我已经创建了一个简单的shell脚本。你可以用它来实现同样的目的——将你的工件发布到Github,并将其用作公共Maven repo。

您可以使用JitPack(公共Git存储库免费)将您的GitHub存储库公开为Maven工件。这很简单。你的用户需要把这个添加到他们的pom.xml:

添加存储库:

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

添加依赖关系:

<dependency>
    <groupId>com.github.User</groupId>
    <artifactId>Repo name</artifactId>
    <version>Release tag</version>
</dependency>

正如在其他地方回答的那样,这个想法是JitPack将构建你的GitHub回购,并将提供罐子。要求是你有一个构建文件和一个GitHub版本。

好处是您不必处理部署和上传。因为您不想维护自己的工件存储库,所以它很适合您的需求。