yeskery

Maven 仓库简介与导入本地 jar 包的几种方式

仓库介绍

仓库

Maven中的仓库用来存放生成的构建和各种依赖。严格说来只有两种仓库:本地和远程。本地仓库指本机的一份拷贝,用来缓存远程下载、包含你尚未发布的临时构件。

远程仓库指通过各种协议如 file:// 和 http:// 访问的其它类型的仓库。这些仓库可能是第三方搭建的真实的远程仓库,用来提供他们的构件下载(例如repo.maven.apache.orguk.maven.org是Maven的中央仓库)。其它“远程”仓库可能是你的公司拥有的建立在文件或HTTP服务器上的内部仓库,用来在开发团队间共享私有构件和管理发布。

本地和远程仓库有着相同的结构,所以脚本可以很容易地在两边运行,或同步仓库供离线使用。不过,一般情况下,仓库内部的布局对Maven用户是完全透明的。

为什么不把 JAR 存在 CVS ?

不推荐将jar存储到CVS。Maven强调用户本地仓库的概念,在本地仓库中jar或其它任何工程构件可以被存储和任意构建使用。许多工程依赖共同的组件如XML解析器和标准实用工具等,典型的构建中这些会重复复制,使用Maven这些标准组件可以在本机存储并被任意构建共享使用。

这样做有以下优点:

  • 更少的存储 – 当一个仓库非常大的时候,由于每个JAR只存储一份它实际上节省了空间,尽管看起来不是这样。
  • 检出工程更快 – 如果CVS中没有大的二进制文件,对工程的初次检出或微小更新会更快。尽管这些是不得不下载的,但只需要一次,如果某些常用的JAR包已存在就不需要再次下载。
  • 不需要版本 – CVS和其它源码控制系统为版本管理而设计,而外部依赖一般不会改变,或在改变时会同时改变文件名表示版本变化。在CVS中存储这些比起在本地存储并无额外的好处。

使用仓库

一般来说,对本地仓库什么都不用做,除非磁盘空间不足而删除它(或完全清除以重新下载全部)。

远程仓库用来下载或上传(如果有权限)。

从远程仓库下载

工程声明了一个本地仓库中没有的依赖时会触发下载(或者对SNAPSHOT,如果远程仓库包含新版本时)。Maven默认从中央仓库下载依赖。

要覆盖这一设置,你需要指定镜像,参见Using Mirrors for Repositories

可以在settings.xml中设置全局镜像,但要注意在工程的pom.xml中指定仓库也是普遍的,settings.xml的设置会优先生效。如果找不到依赖,检查是否覆盖了远程仓库。

更多关于依赖的信息,参考Dependency Mechanism

使用中央仓库的镜像

官方仓库有数个位于不同地理位置的分布。可以修改settings.xml使用一个或多个镜像。操作指南参见 Using Mirrors for Repositories

离线构建

如果你暂时从互联网断开了,仍需要构建工程,可以在命令行中使用离线开关:

  1. mvn -o package

许多插件会判断离线设置而不去连接互联网,比如解析Javadoc链接和网站的链接检查。

上传到远程仓库

可能所有的远程仓库都要求必须有权限才能上传。若要上传到中央仓库,参考 Repository Center

内部仓库

使用Maven,尤其是在一家公司内,出于安全、速度或带宽的原因,连接到互联网来下载依赖可能是不能接受的。此时,建立一个内部仓库来存放构件的拷贝和发布私有构件是明智的。

从内部仓库下载可以使用HTTP或文件系统(使用 file:// ),上传可以使用scp, ftp或文件拷贝。

注意只要是在Maven中,内部仓库没有任何特殊之处:它是另一种远程仓库,包含可下载到用户本地存储的构件,同时是构件发布的目的地。

此外,你可能想将生成的工程站点共享到仓库,更多创建和部署站点的信息,参考 Creating a Site

搭建内部仓库

搭建内部仓库只需要找一台服务器存放它,然后拷贝需要的构件,使用与远程仓库如 repo.maven.apache.org同样的目录结构。

不推荐抓取或用rsync获取整个中央仓库的完整拷贝,数据量太大,而且这样做会被禁。你可以使用 Repository Management 中介绍的程序来运行内部仓库服务,从互联网按需下载并保存构件来提供更快的内部下载。

另一种选择是手动下载和检查发布包,拷贝到内部仓库,或通过Maven下载之后手动上传确认过的构件到用作发布的内部仓库。这一操作对禁止自动分发的构件是唯一可行的方式,如Sun提供的J2EE jar包。查看 Guide to coping with SUN JARs了解更多。

值得一提的是,Maven未来计划包含对这些特性的增强支持,包括下载时自动点击许可和签名验证。

使用内部仓库

使用内部仓库很简单,增加一个repositories元素:

  1. <code>
  2. <project>
  3. ...
  4. <repositories>
  5. <repository>
  6. <id>my-internal-site</id>
  7. <url>http://myserver/repo</url>
  8. </repository>
  9. </repositories>
  10. ...
  11. </project>
  12. </code>

如果你的内部仓库需要认证,在settings文件中使用id元素指定登录信息。

部署到内部仓库

使用内部仓库的最重要原因之一是将自己的私有包发布出来共享。

要发布到仓库,你需要通过SCP,SFTP,FTP,WebDAV或文件系统之一访问仓库。连接通过各种wagons实现,有些wagon可能需要在构建中加入扩展

关于 修改本地仓库、中央仓库地址可以参考:https://blog.yeskery.com/articles/328793403#Maven 的基本配置

添加本地 Jar 包

使用命令添加

  1. # Dfile jar:文件的路径
  2. # DgroupId:组织名
  3. # DartifactId:模块名
  4. # Dversion:版本号
  5. # Dpackaging 打包方式
  6. mvn install:install-file -Dfile=xxx.jar -DgroupId=xxx -DartifactId=xxx -Dversion=1.0.0 -Dpackaging=jar

pom.xml 直接添加依赖

  1. <dependency>
  2. <groupId>组织名</groupId>
  3. <artifactId>模块名</artifactId>
  4. <version>版本号</version>
  5. <scope>system</scope>
  6. <systemPath>jar包路径</systemPath>
  7. </dependency>

这种方式加入的jar包,默认情况下打包不会加入该jar包。

修改 pom.xml

  • maven 版本低于 3.1
    1. <plugin>
    2. <groupId>org.apache.maven.plugins</groupId>
    3. <artifactId>maven-compiler-plugin</artifactId>
    4. <configuration>
    5. <source>1.8</source>
    6. <target>1.8</target>
    7. <encoding>UTF-8</encoding>
    8. <compilerArguments>
    9. <extdirs>${project.basedir}/src/lib</extdirs>
    10. </compilerArguments>
    11. </configuration>
    12. </plugin>
  • maven 版本高于 3.1
    1. <plugin>
    2. <groupId>org.apache.maven.plugins</groupId>
    3. <artifactId>maven-compiler-plugin</artifactId>
    4. <configuration>
    5. <source>1.8</source>
    6. <target>1.8</target>
    7. <encoding>UTF-8</encoding>
    8. <compilerArgs>
    9. <arg>-extdirs</arg>
    10. <arg>${project.basedir}/src/lib</arg>
    11. </compilerArgs>
    12. </configuration>
    13. </plugin>
    需要注意的是最好添加${project.basedir}以便有更好的兼容性。

修改上述编译插件后,打包正常,不再报错,但是有一个新的问题产生。生成的zip包并不包含依赖的本地jar。

修改maven-assembly-plugin插件的配置文件,增加如下配置:

  1. <fileSet>
  2. <directory>src\lib</directory>
  3. <outputDirectory>lib</outputDirectory>
  4. </fileSet>

意思是把src\lib下的jar输出到target根目录lib下。

至此,使用maven的package命令,已能正常运行,并成功把本地jar包打入zip压缩包的lib目录下。

推荐直接使用 mvn 命令将 jar 包安装到本地仓库中。

部分内容参考以下网址:

  1. https://www.cnblogs.com/lixuwu/p/5855031.html
  2. http://ifeve.com/maven-introduction-to-repositories/
  3. https://www.cnblogs.com/dreamowneryong/p/7307908.html

评论

发表评论 点击刷新验证码

提示

该功能暂未开放