构建Rugged

Rugged可以使用多种不同的工具从源代码构建。

所有这些工具都是基于Java的，可以在许多不同的操作系统上运行，包括Unix、GNU/Linux、Windows和Mac OS X。一些GNU/Linux发行版在其软件包仓库中提供这些工具。

使用Maven 3构建

Maven是一个构建工具，不仅仅可以编译和打包产品，还可以解决依赖关系（包括从公共仓库下载适当版本），运行自动化测试，启动各种检查工具，并为项目创建网站。它可以在支持Java的任何平台上运行。

对于没有提供maven作为软件包的系统，可以从Apache Software Foundation的网站上下载maven。该网站还解释了安装过程。

与所有使用maven的项目一样，构建Rugged的官方发布版本非常简单（有关开发版本的特殊情况，请参见下文），只需运行：

mvn package

上述命令将为您执行所有的依赖项检索、编译、测试和打包工作。最后，它将在目标目录中创建几个文件，其中包括一个名为rugged-x.y.jar的文件，其中x.y是版本号。这是您可以在使用Rugged的项目中使用的jar文件。

对于已发布的Rugged版本，此命令应始终有效，因为它们仅依赖于已发布的Orekit版本。Maven知道如何下载已发布的Orekit版本的预构建二进制文件。对于开发中的Rugged版本，该命令可能无法工作，因为它们可能依赖于未发布的Orekit版本。由于未发布的Orekit版本没有公开可用的预构建二进制文件，因此Maven无法下载。在这种情况下，上述命令将以以下错误消息结束：

[ERROR] Failed to execute goal on project rugged: Could not resolve dependencies for project org.orekit:rugged:jar:X.x-SNAPSHOT: Could not find artifact org.orekit:orekit:jar:Y.y-SNAPSHOT

在这种情况下，您应该先构建缺失的Orekit构件并将其安装到本地maven仓库中。这可以通过在某个临时文件夹中从Orekit git存储库的Gitlab克隆Orekit源代码并使用maven进行安装来完成。通过运行以下命令（使用Linux命令语法）来完成（使用Linux命令语法）：

git clone -b develop https://gitlab.orekit.org/orekit/orekit.git
cd orekit
mvn install

如果以类似的方式，上述命令以以下错误消息结束：

[ERROR] Failed to execute goal on project orekit: Could not resolve dependencies for project org.orekit:orekit:jar:Y.y-SNAPSHOT: 
        The following artifacts could not be resolved: org.hipparchus:hipparchus-core:jar:Z.z-SNAPSHOT, org.hipparchus:hipparchus-geometry:jar:Z.z-SNAPSHOT,   
        ... 
        Could not find artifact org.hipparchus:hipparchus-core:jar:Z.Z-SNAPSHOT

在构建Orekit构件之前，您应该首先构建缺失的Hipparchus构件，并将其安装在本地的maven存储库中，方法与Orekit相同，通过从Hipparchus的GitHub git存储库克隆Hipparchus源代码开始：

git clone https://github.com/Hipparchus-Math/hipparchus.git
cd hipparchus
mvn install

一旦使用上述命令在本地安装了Orekit（可能还有Hipparchus）的开发版本，您可以删除克隆的文件夹（如果需要的话）。然后，您可以再次尝试Rugged级别的mvn命令，这次应该成功，因为必要的构件现在在本地可用。

如果您需要为依赖项检索配置代理服务器，请参阅maven网站上的使用代理的指南页面。

如果您已经在自己的项目中使用maven（或者仅仅是eclipse，请参见下文），您可能希望将rugged安装在本地的maven存储库中。可以使用以下命令完成：

mvn install

对于其他命令，如生成网站或生成checkstyle、spotbugs或jacoco报告，请参阅maven插件文档，网址为maven site。

使用Eclipse构建

Eclipse是一个非常强大的集成开发环境（IDE）。它是一个庞大的产品，而不仅仅是一个简单的构建工具。

对于没有将Eclipse作为软件包提供的系统，可以从Eclipse Foundation的网站上下载。

使用Eclipse与Rugged一起的最简单方法是按照以下步骤进行：

  • 使用操作系统工具，在Eclipse工作区直接解压源代码分发包。源代码分发包的文件名形式为rugged-x.y-sources.zip，其中x.y是版本号。解压缩此zip文件应在您的工作区中创建一个名为rugged-x.y的文件夹。

  • 使用Eclipse，在顶级“文件”菜单中选择“导入…”

  • 在应该出现的向导中，选择“Maven -> 存在的Maven项目”

  • 通过选择刚刚在您的工作区中创建的文件夹来解压源代码分发包。将自动选择描述项目的“pom.xml”文件。点击完成

Rugged库应该会自动配置，包括对底层Orekit库的依赖。

现在您在工作区中有一个rugged-x.y项目，您可以创建依赖于Rugged项目的自己的应用程序项目。

您还可以通过运行junit测试来检查一切是否正常。

返回页首