构建Orekit教程

使用Maven 3构建

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

对于没有提供maven作为软件包的系统，可以从Apache Software Foundation的网站上下载maven，并按照该网站上的安装过程进行安装。

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

mvn compile

这个命令对于已发布的Orekit教程版本应该总是有效的，因为它们只依赖于已发布的Orekit和Hipparchus版本。Maven知道如何下载已发布的Hipparchus版本的预构建二进制文件。对于开发中的Orekit教程版本，这个命令可能不起作用，因为它们可能依赖于未发布的Orekit或Hipparchus版本。由于未发布的Orekit或Hipparchus版本没有公开可用的预构建二进制文件，因此在这种情况下，上述命令将以以下错误消息结束：

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

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

• Orekit: git clone https://gitlab.orekit.org/orekit/orekit.git git branch develop cd orekit mvn install

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

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

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

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

使用Eclipse构建

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

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

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

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

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

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

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

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

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

您还可以通过运行其中一个示例教程来检查一切是否正常工作。