“Maven官方用户入门指南”翻译之二
如何构建第一maven工程？
? ? ? ? 我们现在开始创建第一个自己的maven工程！我们将使用maven的创建向导，构建第一个maven工程。原型定义为：一组事物所表现出来的共性。在maven中，原型是一个满足客户需求创建的maven工程模板。我们现在开始去了解创建向导的工作机制，如果你想了解更多关于原型相关的信息，请参看"原型介绍"
? ? ? ? 继续创建第一个maven工程，执行如下命令将构建一个简单的maven工程：
?
mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=com.mycompany.app \ -DartifactId=my-app
一旦执行上述命令，将会出现如下结果：一个名字为my-app的目录将被创建同时这个目录中包含一个pom.xml文件，此文件的内容如下：
?
?
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany.app</groupId> <artifactId>my-app</artifactId> <packaging>jar</packaging> <version>1.0-SNAPSHOT</version> <name>Maven Quick Start Archetype</name> <url>http://maven.apache.org</url> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies></project>
pom.xml中包括了此项目的POM(项目对象模型)。POM是maven中的基本工作单元，这个很重要，因为maven所有过程的理解都依赖于此概念,总之POM包括工程中的一切重要信息，同时其他信息也都与之有关。POM很重要，初学者鼓励参看POM介绍。
?
? ? 这是一个非常简单的POM，但是他展示了POM包括的关键元素，我们一一讲述他们从而掌握POM要领：
? ? project：maven的pom.xml文件的根元素。
? ? modelVersion:POM采用的对象模型版本。
? ? groupId：项目组唯一标示,是项目的一个组分类。例如：?org.apache.maven.plugins是maven的所有的plugin组id
? ? artifactId:此工程的唯一标示，首先工程最终将是一个jar文件，其次最终文件的名称中将包括artifactId，maven打包生成的最终文件名称格式为：<artifactId>-<version>.<extension> (如： myapp-1.0.jar).
? ? packaging：工程打包生成格式(如：jar,war,ear等等)。这不仅仅意味着一个jar,war或ear，同时他的特殊生命周期是作为构建过程中的一个部分出现的(生命周期的话题后面还会阐述，你现在只需要了解到他是整个构建周期中的一个部分就可以了)。packaging默认值为jar，因此有些工程可以不显示指定。
? ? version：工程生成文件的版本号，maven提供版本管理，你常常看到版本号中出现SNAPSHOT，他标示项目在开发阶段。后面我们还会讨论SNAPSHOT。
? ? name：项目工程名称。通常会在maven生成的api文档中出现。
? ? url：项目工程url地址。通常会在maven生成的api文档中出现。
? ? description：项目工程的基本描述。通常会在maven生成的api文档中出现。
?
? ? POM中的完整元素请参看POM参考，让我们回到项目中来，基于创建向导构建的工程生成的目录结构如下所示：
my-app|-- pom.xml`-- src |-- main | `-- java | `-- com | `-- mycompany | `-- app | `-- App.java `-- test `-- java `-- com `-- mycompany `-- app `-- AppTest.java
包括了一个pom文件，一个树形结构的应用源文件和测试源文件，这是一个标准的maven工程(应用源文件路径为： ${basedir}/src/main/java ，测试源文件路径为： ${basedir}/src/test/java, pom.xml路径为${basedir}?)。
? ? ? ? ? 手动创建的maven工程我们推荐此目录结构，这是maven的习惯，如果打算了解更多请参考"标准目录结构介绍"
? ? ? ? ? 现在我们已经有了pom文件，应用源文件，单元测试源文件，有可能你又要问......
?
