Maven合并打包依赖的git项目

JD的云引擎可以提供一个网站搭建的Java编译发布环境。但是所有源码都要放在下面。我只是想把JD提供的环境作为一个门面，来展现内容。自己的东西自己管理。（网上解决是使用submodule，强烈推荐看看.戳）

我建了一个源码库flickrUpload在Github上，如果我想把它放到JD的云引擎上运行，需要复制代码然后再提交一次到jd-code。但不想源码版本库分支混乱，并且JD云上仅仅是为了展示，不进行修改。最终实现使用Maven来检出依赖项目，再进行编译打包实现在JD的展示功能。

本地环境使用scm和antrun插件，实现先更新依赖源码再打包

检出依赖源码库

由于对Maven不太熟悉，首先想到的是额外执行系统的命令。

<project>
    <profiles>
        <profile>
            <id>win</id>
            <activation>
                <activeByDefault>false</activeByDefault>
                <os>
                    <family>Windows</family>
                </os>
            </activation>
            <properties>
                <flickrUploader>uploader-git-clone.bat</flickrUploader>
            </properties>
        </profile>
        <profile>
            <id>linux</id>
            <activation>
                <activeByDefault>true</activeByDefault>
                <os>
                    <family>Linux</family>
                </os>
            </activation>
            <properties>
                <flickrUploader>uploader-git-clone.sh</flickrUploader>
            </properties>
        </profile>
    </profiles>

    <build>
        <finalName>product</finalName>

        <plugins>
            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <configuration>
                    <webResources>
                        <resource>
                            <directory>dist</directory>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>exec-maven-plugin</artifactId>
                <version>1.1.1</version>
                <executions>
                    <execution>
                        <id>some-execution</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>exec</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <executable>${basedir}/script/${flickrUploader}</executable>
                </configuration>
            </plugin>
        </plugins>
    </build>

根据profile来配置来判断环境，执行特定的命令（bat/sh）。

Windows脚本

# uploader-git-clone.bat
del /s /q /f dist\Hello-World
rmdir /s /q dist\Hello-World
"C:\Program Files\Git\bin\git.exe" clone https://github.com/octocat/Hello-World.git dist\Hello-World

Linux脚本

# uploader-git-clone.sh
rm -rf dist/Hello-World
git clone https://github.com/octocat/Hello-World.git dist/Hello-World

测试在本地window已经能实现自己的要求，能把checkout项目的内容放在了发布包的根目录下面。

执行mvn package后的target目录结构如下：

源码库路径重定位

发布时把源码库文件放置到war的根目录下面，有考虑过COPY：如Copy-maven-plugin，还有如下outputDirectory的形式（参考）：

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <artifactId>maven-resources-plugin</artifactId>
        <version>2.6</version>
        <executions>
          <execution>
            <id>copy-resources</id>
            <!-- here the phase you need -->
            <phase>validate</phase>
            <goals>
              <goal>copy-resources</goal>
            </goals>
            <configuration>
              <outputDirectory>${basedir}/target/extra-resources</outputDirectory>
              <resources>          
                <resource>
                  <directory>src/non-packaged-resources</directory>
                  <filtering>true</filtering>
                </resource>
              </resources>              
            </configuration>            
          </execution>
        </executions>
      </plugin>
    </plugins>
    ...
  </build>
  ...
</project>

最终实现

上面就要解决两个问题：源码检出和资源重定位。

后面发现war可以包含特定目录的资源，资源重定位实现就用war的webResources实现了。同时为了把检出源码的清理工作提取到clean任务下，添加使用antrun插件。同时发现scm插件就实现了检出源码的功能maven-scm-plugin。

使用antrun和scm完全使用Maven实现，最终的插件配置如下：

<project>
    <build>
        <finalName>product</finalName>

        <plugins>

            <plugin>
                <artifactId>maven-antrun-plugin</artifactId>
                <executions>
                    <execution>
                        <phase>clean</phase>
                        <configuration>
                            <tasks>
                                <delete includeEmptyDirs="true">
                                    <fileset dir="${scm-dist}" />
                                </delete>

                                <mkdir dir="${scm-dist}" />
                            </tasks>
                        </configuration>
                        <goals>
                            <goal>run</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

            <plugin>
                <artifactId>maven-scm-plugin</artifactId>
                <version>1.9</version>
                <configuration>
                    <skipCheckoutIfExists>true</skipCheckoutIfExists>
                    <checkoutDirectory>${scm-dist}/flikr</checkoutDirectory>
                    <connectionUrl>scm:git:https://github.com/octocat/Hello-World.git</connectionUrl>
                </configuration>
                <executions>
                    <execution>
                        <phase>clean</phase>
                        <goals>
                            <goal>checkout</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <configuration>
                    <webResources>
                        <resource>
                            <directory>${scm-dist}</directory>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>

        </plugins>
    </build>

    <properties>
        <!-- for scm -->
        <scm-dist>dist</scm-dist>
    </properties>

现在使用mvn clean package就可以实现先checkout项目再打包发布了。最终效果全部使用maven实现，无需额外考虑平台之间的差异处理。

JD的云引擎Maven编译不支持scm插件

不支持的插件：’maven-scm-plugin’ 在pom文件中被发现,编译将终止,请检查并更新代码!

然后部署到云引擎的时刻，发现antrun和scm的插件都不行，exec也不行！也尝试过submodule，但是邮件JD的回复说是云上引用内部的才有效！

发布到云引擎最终还是用最土的方法，先删除旧的版本库，然后检出，在提交到云引擎的版本库中。

# flickr-upload-commit.sh
rm -rf src/main/webapp/flickr
git clone git@github.com:winse/flickr-uploader.git src/main/webapp/flickr
rm -rf src/main/webapp/flickr/.git
git add -A && git commit -m "update uploader, please see https://github.com/winse/flickr-uploader" && git push

其他

子模块基本操作命令

$ git submodule add git@github.com:josephj/javascript-platform-yui.git static/platform
$ git add .gitmodules static/platform $ git submodule init

$ cd static/platform
$ git pull origin master
$ cd ../../
$ git add static/platform
$ git commit -m “static/platform submodule updated”

$ git submodule init
$ git submodule update

$ cd static/platform
$ vim README # 做些修改
$ git add README
$ git commit -m “Add comments”
$ git push
$ git add static/platform
$ git commit -m ‘Submodule updated
$ git push

$ git rm –cached [欲移除的目錄]
$ rm -rf [欲移除的目錄]
$ vim .gitmodules
$ vim .git/config
$ git add .gitmodules
$ git commit -m “Remove a submodule”
$ git submodule sync

参考

【原文地址】

–END

Winse Blog

走走停停都是风景, 熙熙攘攘都向最好, 忙忙碌碌都为明朝, 何畏之.