Hello Maven

最近因为接触Android SDK类的项目，需要支持Maven构建APK的过程中进行代码植入，所以开始学习如何使用Maven管理Android工程。以下是百度百科关于Maven的介绍：

Maven是基于项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。

Maven 除了以程序构建能力为特色之外，还提供高级项目管理工具。由于 Maven 的缺省构建规则有较高的可重用性，所以常常用两三行 Maven 构建脚本就可以构建简单的项目。由于 Maven 的面向项目的方法，许多 Apache Jakarta 项目发文时使用 Maven，而且公司项目采用 Maven 的比例在持续增长。

Maven这个单词来自于意第绪语，意为知识的积累，最早在Jakata Turbine项目中它开始被用来试图简化构建过程。当时有很多项目，它们的Ant build文件仅有细微的差别，而JAR文件都由CVS来维护。于是Maven创始者开始了Maven这个项目，该项目的清晰定义包括，一种很方便的发布项目信息的方式，以及一种在多个项目中共享JAR的方式。

第一次看完，也没什么感觉，基本看完就忘，所以开始入手第一个Maven Project。

首先，是下载Maven，地址：http://maven.apache.org/download.cgi

然后设置环境变量：

MAVEN_HOME : D:\apache-maven-3.0.2 
MAVEN : %MAVEN_HOME%\bin 

(可选） MAVEN_OPTS : -Xms256m -Xmx512m

可选的暂时没管它。

虽然完全一脑袋浆糊，不过还是按照网上的操作步骤，入手第一个工程。

1、创建项目

mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app

使用上面的命令，结果悲剧：

经过一番搜索，把archetype:create改成archetype:generate再试：

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app

一番滚动后，提示：

Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 615:

本来只想搜这一句，没想到搜到个全面的（感谢：菩提树下的杨过，http://www.cnblogs.com/yjmyzz/p/3495762.html）

...

[INFO] Generating project in Interactive mode (这里会卡一会儿，因为要联网获取项目模板)
[INFO] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:maven-archetype-quickstart:1.0)
Choose archetype:
1: remote -> br.com.ingenieux:elasticbeanstalk-service-webapp-archetype (A Maven Archetype Encompassing RestAssured, Jetty, Jackson, Guice and Jersey for Publishing JAX-RS-based Services on AWS' Elastic Beanstalk Service)
... (这里会自动列出很多项目模板，每种模板前面会有一个数字序号)

336: remote -> org.apache.maven.archetypes:maven-archetype-quickstart (An archetype which contains a sample Maven project.)

...

Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 336: (这里根据每个人机器上安装的eclipse插件不同，可能默认的数字不是这个，先不管，直接回车)

Choose org.apache.maven.archetypes:maven-archetype-quickstart version: 
1: 1.0-alpha-1
2: 1.0-alpha-2
3: 1.0-alpha-3
4: 1.0-alpha-4
5: 1.0
6: 1.1
Choose a number: 6: (直接回车)
Define value for property 'groupId': : cnblogs （可暂时先理解成类似package或namespace的名称，通常我们填写组织机构名称缩写）
Define value for property 'artifactId': : maven-hello-world （组件名称，可暂时理解成项目名称）
Define value for property 'version':  1.0-SNAPSHOT: : （版本号，直接回车，默认1.0-SNAPSHOT）
Define value for property 'package':  cnblogs: : （打包后的jar文件名，相当于.net中项目最后生成的程序集dll名称）
Confirm properties configuration:
groupId: cnblogs
artifactId: maven-hello-world
version: 1.0-SNAPSHOT
package: cnblogs
 Y: :  (直接回车确认)
[INFO] ----------------------------------------------------------------------------
[INFO] Using following parameters for creating project from Old (1.x) Archetype: maven-archetype-quickstart:1.1
[INFO] ----------------------------------------------------------------------------
[INFO] Parameter: groupId, Value: cnblogs
[INFO] Parameter: packageName, Value: cnblogs
[INFO] Parameter: package, Value: cnblogs
[INFO] Parameter: artifactId, Value: maven-hello-world
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS (看到这个，表示项目创建成功！)
[INFO] ------------------------------------------------------------------------
...

2、项目结构

maven项目采用“约定优于配置”的原则，src/main/java约定用于存放源代码，src/main/test用于存放单元测试代码，src/target用于存放编译、打包后的输出文件。这是全世界maven项目的通用约定，请记住这些固定的目录结构。

3、编译

进入项目根目录，执行 mvn clean compile

编译后会自动在target目录中生成class文件，如果编译成功，会输出类似下面的信息

yangjunmingmatoMacBook-Pro-7:maven-hello-world jimmy$ mvn clean compile
[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building maven-hello-world 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ maven-hello-world ---
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ maven-hello-world ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory /Users/jimmy/Desktop/study/maven-hello-world/src/main/resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) @ maven-hello-world ---
[INFO] Compiling 1 source file to /Users/jimmy/Desktop/study/maven-hello-world/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.515s
[INFO] Finished at: Wed Jan 01 19:08:32 CST 2014
[INFO] Final Memory: 10M/156M
[INFO] ------------------------------------------------------------------------

4、单元测试

这部分暂时不关心，不过还是把命令记下：mvn clean test（每次看到google源码里齐齐整整的test代码，都心生憧憬，国内还是算了吧！）

5、项目打包

通常我们会把java项目打包成jar包或war包，maven中打包的命令为

mvn clean package

运行完后，会在target目录下生成jar包

注：从输出 可以发现，package前，会先执行compile，再执行test，最后才是package打包

6、项目运行

该项目中的App.java中有main方法，可以直接运行，常规方式下，我们如果想直接运行class文件，得敲一段很长的命令，maven中不必这么复杂，先用记事本打开项目根目录下的pom.xml文件，增加下面这节内容：

    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>exec-maven-plugin</artifactId>
                <version>1.2.1</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>exec</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <executable>java</executable>          
                    <arguments>                       
                        <argument>-classpath</argument>
                        <classpath>
                        </classpath>
                        <argument>t>com.mycompany.app.App</argument>
                    </arguments>
                </configuration>
            </plugin>
        </plugins>
    </build>

上述这段内容插入在</project>之前即可。

然后在命令行下，输入

mvn exec:exec

即可直接运行，下面是输出：

C:\test\maven-hello-world>mvn exec:exec
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building maven-hello-world 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- exec-maven-plugin:1.2.1:exec (default-cli) @ maven-hello-world ---
Hello World!
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.175s
[INFO] Finished at: Mon Jan 13 22:35:02 CST 2014
[INFO] Final Memory: 6M/111M
[INFO] ------------------------------------------------------------------------

另外：

有时候，我们的项目是一个类库，只是封装一些方法供其它项目引用，对于这种项目，我们可以用 mvn clean install 把生成的jar包，安装到“本地仓库”中，这样本机其它项目需要使用该jar包时，只要在pom里配置依赖项即可，不用把jar包复制到当前项目中。

至此，一个Hello Maven工程已经创建完毕，接下来就是Maven+Android了。