145. Building

145.1 基本编译和测试

要构建源代码,您将需要安装 JDK 1.7.

Spring Cloud 使用 Maven 进行大多数与构建相关的Active,并且您应该能够通过克隆您感兴趣的项目并键入来快速启动

$ ./mvnw install

Note

您还可以自己安装 Maven(> = 3.3.3),并在下面的示例中运行mvn命令代替./mvnw。如果这样做,则您的本地 Maven 设置不包含 Spring 预发行项目的存储库声明,则可能还需要添加-P spring

Note

请注意,您可能需要通过将MAVEN_OPTS环境变量设置为类似-Xmx512m -XX:MaxPermSize=128m的值来增加 Maven 可用的内存量。我们尝试在.mvn配置中进行介绍,因此,如果您必须执行此操作才能使构建成功,请提出票证以将设置添加到源代码 Management 中。

有关如何构建项目的提示,请查看.travis.yml(如果有)。应该有一个“脚本”甚至“安装”命令。另外,请查看“服务”部分,以查看是否需要在本地运行任何服务(例如 mongo 或 Rabbit)。忽略您可能在“ before_install”中找到的与 git 相关的位,因为它们与设置 git 凭据有关,并且您已经有了这些。

需要中间件的项目通常包含docker-compose.yml,因此请考虑使用Docker Compose在 Docker 容器中运行中间件服务器。有关 mongo,rabbit 和 redis 常见情况的具体说明,请参见脚本演示存储库中的自述文件。

Note

如果所有其他方法均失败,请使用.travis.yml(通常是./mvnw install)中的命令进行构建。

145.2 Documentation

spring-cloud-build 模块有一个“ docs”配置文件,如果打开它,将尝试从src/main/asciidoc构建 asciidoc 源。作为该过程的一部分,它将查找README.adoc并通过加载所有包含项进行处理,但不进行解析或渲染,只需将其复制到${main.basedir}(默认为$../../../..,即项目的根目录)即可。如果自述文件有任何更改,它将在 Maven 构建后显示为正确位置的修改文件。只需提交并推动更改即可。

145.3 处理代码

如果您没有 IDE 偏好设置,我们建议您在使用代码时使用Spring 工具套件Eclipse。我们使用m2eclipse eclipse 插件来获得 maven 支持。只要其他 IDE 和工具使用 Maven 3.3.3 或更高版本,它们也应该可以正常工作。

145.3.1 使用 m2eclipse 导入 eclipse

我们建议在使用 Eclipse 时使用m2eclipse eclipse 插件。如果尚未安装 m2eclipse,则可以从“ eclipse 市场”中获得。

Note

较旧的 m2e 版本不支持 Maven 3.3,因此,一旦将项目导入 Eclipse,您还需要告诉 m2eclipse 为项目使用正确的配置文件。如果在项目中看到许多与 POM 相关的错误,请检查是否具有最新的安装。如果您无法升级 m2e,请将“ spring”配置文件添加到settings.xml。或者,您可以将存储库设置从父 pom 的“ spring”配置文件复制到settings.xml

145.3.2 不使用 m2eclipse 导入 eclipse

如果您不想使用 m2eclipse,则可以使用以下命令生成 eclipse 项目元数据:

$ ./mvnw eclipse:eclipse

可以通过从file菜单中选择import existing projects来导入生成的日食项目。