构建Orekit

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

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

下面的说明适用于希望修改Orekit库的人。例如，在将其用于应用程序之前，可以在库中包含自己的模型或修改。它们不适用于只是尝试使用或将Orekit包含在其项目中的人。

使用 Maven 3 构建

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

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

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

mvn package

上述命令将为您执行所有依赖项检索、编译、测试和打包工作。最后，它将创建几个名为 target/orekit-x.y.jar 的文件，其中 x.y 是版本号。

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

[ERROR] Failed to execute goal on project orekit: Could not resolve dependencies for project org.orekit:orekit:jar:8.0-SNAPSHOT: Could not find artifact org.hipparchus:hipparchus-core:jar:1.0-SNAPSHOT

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

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

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

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

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

mvn install

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

使用Eclipse构建

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

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

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

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

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

  • 在应该出现的向导中，选择“Maven -> Existing Maven Projects”

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

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

现在您在工作区内有一个orekit-x.y项目，您可以创建自己的应用程序项目，这些项目将依赖于Orekit项目。

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

如果您想进一步运行教程，则需要检查姊妹项目Orekit教程。

使用Ant构建

Ant是一个用于Java应用程序的构建工具。

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

如果您在代理后面（这是企业环境中的传统设置），则需要配置Ant以使用它。这在Ant的文档中有解释。

要么从Hipparchus项目下载Hipparchus的jar文件并将其放在顶级orekit目录下的lib目录中，要么编辑ant build.xml文件以编辑可以自动下载Hipparchus的get-hipparchus目标。

要创建一个名为build/orekit-x.y.jar的文件，其中x.y是版本号，请使用以下命令：

ant jar

有关其他命令，请参阅Ant命令行的文档