maven打包上传到私有仓库的步骤

た入场券 2023-10-04 12:46 34阅读 0赞

#### 1. 背景 ####

最近有些自己制作的工具包，需要单独抽取出来之后，`在打包的时候，同时上传到自己的maven私服仓库，供别人引用，并且还能够引用的时候看到源码`。但是，在上传的过程中总是失败不成功，特别上火。最后总算成功，记录下步骤，希望能够帮助到需要的人。

#### 2. 步骤 ####

先说下我的要求：

1.  本地打包能够自动上传maven私服仓库。
2.  别人引用后，能够看到源码及注释。

##### 2.1 修改pom.xml #####

###### 2.1.1 指定上传仓库地址 ######

首先需要到自己项目里的`pom.xml`里添加下边一段

<distributionManagement>
      
            <repository>
                <id>releases</id>
                <url>http://maven.aaaaaa.com/nexus/content/repositories/thirdparty</url>
            </repository>
            
            <snapshotRepository>
                <id>nexus-snapshots</id>
                <url>http://maven.aaaaaa.com/nexus/content/repositories/snapshots</url>
            </snapshotRepository>
        </distributionManagement>

对于我们平时的项目版本号是类似`XX-SNAPSHOT`这种的，这类就是数据开发版本，这种上传私服后会以`版本号+时间戳`的形式递增，它上传必须要指定`<snapshotRepository>`地址,。  
  上图中，`id`后边会说，这里的`url`的地址，是对应你仓库地址，你可以在浏览器里访问下类似`http://maven.aaaaaa.com/nexus`的地址，输入账号密码，登录后，如下图`4`对应的地址，就是：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center]  
  需要注意的是，因为上图中，我们仓库有好几个，我是上传到了`3`对应的仓库，你可以根据你们实际的仓库地址来就行。  
  另外`id`对应的`releases`其实是与指定的`maven`配置文件`conf/setttings.xml`中对应，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 1]  
  如果对应的`settings.xml`里没有配置`<servers>`对应的标签，那也需要添加一下。如下示例：

<servers>
        <server>
        	
            <id>releases</id>
            
            <username>admin</username>
            <password>znxd</password>
        </server>
      </servers>

还有，注意仓库的账号密码需要正确。

###### 2.1.2 添加源码插件 ######

上边的配置仅仅是指定仓库的地址，因为还需要让下载依赖的人，能够看到源码，因此还需要有一个插件，`maven-source-plugin`。再找到项目的`pom.xml`，添加如下插件：

<plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-source-plugin</artifactId>
            <version>3.0.1</version>
            <configuration>
                <attach>true</attach>
            </configuration>
            <executions>
                <execution>
                    <phase>compile</phase>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

最后，总结一下现在`pom.xml`新增的这俩东西的位置：

<project>
    	
    	<build>
            <plugins>
             
             
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-source-plugin</artifactId>
                    <version>3.0.1</version>
                    <configuration>
                        <attach>true</attach>
                    </configuration>
                    <executions>
                        <execution>
                            <phase>compile</phase>
                            <goals>
                                <goal>jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
        <distributionManagement>
            <repository>
                <id>releases</id>
                <url>http://maven.aaaaa.com/nexus/content/repositories/thirdparty</url>
            </repository>
        </distributionManagement>
    </project>

注意：不能引用`spring-boot-maven-plugin`插件，这个插件一旦引入生效，就表示你当前做的jar包是一个可运行的包，而不是我们往私服上传的工具包了

##### 2.2 命令执行 #####

配置完成了之后，就可以执行命令了，这里可以通过两种命令实现，一种是开发工具`idea`里执行，另一种是通过环境变量的`mvn`命令。  
  注意，不管用下边哪种命令，都需要先注意版本号，如果私服里存在你这个版本的包，那肯定会打包上传不成功，可能会报错：`Return code is: 400, ReasonPhrase: Bad Request`。  
  因此，别忘了改下版本。如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 2]

##### 2.2.1 idea中执行 #####

如果你的开发工具是`idea`，其实`eclipse`也一样，建议用这种方式。  
  在开发工具中，找到右侧的`maven project`,如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 3]  
  最终的命令，其实是执行了`clean deploy`。如果执行完后出现大概下边的日志，说明成功了。

[INFO] Building jar:*******
    [INFO] Installing ****  to  *****
    [INFO] --- ****   Uploading:
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------

当然，也可以通过浏览器去访问下，找下是否仓库里有对应jar包。

##### 2.2.2 mvn命令执行 #####

如果想使用`mvn`命令，那就需要注意maven环境变量配置，这里不说咋配置mvn命令了，这里说下步骤和注意的地方。  
  首先，打开项目所在目录，通过\`cmd打开当前目录，如下图所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 4]

执行命令如下：

mvn -s "C:\Program Files\apache-maven-3.5.011\conf\settings-154waiwang.xml" deploy

其中 `-s`是`--settings`的缩写。  
   这里我也是被坑惨了，我一直以为，因为我在配置`maven`环境变量的时候，指定了`maven_home`/`m2_home`，我觉得，当我使用`mvn`命令时，会自动使用对应的`settings.xml`文件进行打包，然后并不是，所以为什么上边需要通过`-s`来指定下`settings.xml`才可以。  
   如果不指定的话，会报错`Return code is: 401, ReasonPhrase: Unauthorized. -> [Help 1]` ,大概是无权限的意思。看来应该是不指定的话，会走一个默认的文件，因为那个文件里没有对应的账号密码，因此会报错。

##### 2.3 成功后的依赖 #####

上传成功后，可以通过地址找一下，如下图即表示成功：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 5]

#### 3. 扩展 ####

比如你做这个依赖包，可能后边还会有更新的时候，但是如果以前的依赖包已经被别人使用，那不可能一个个的通知使用者，maven本身提供这种自动下载高版本的功能，只需要对`version`标签的值改一下。如下：

<dependency>
         <groupId>com.agri</groupId>
         <artifactId>znxd-framework</artifactId>
         <version>[1.0,)</version>
     </dependency>

其中`[1.0,)`表示更新从`1.0`版本开始的最新包。这样有个好处就是，当你的扩展包更新成大于`1.0`的包时，使用人的工程里，会自动变更为最新的包。这样你就可以在写错代码的时候，偷偷的自己更新成最新的包，避免尴尬。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20210508130830855.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20210508131507412.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20210508133734982.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20210508133351475.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20210508134505555.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp_size_16_color_FFFFFF_t_70_pic_center 5]: https://img-blog.csdnimg.cn/2021050813513417.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dvaGFxaXlp,size_16,color_FFFFFF,t_70#pic_center