Windows下EarthSci编译教程

相关链接

1、Git下载地址
2、JDK8下载地址
3、Maven下载地址
4、EarthSci源码地址
5、EarthSci官网

一、安装Git

1.1 我选择的版本是Git-2.25.0-64-bit，已安装的可跳过本步骤，安装流程很简单，不再介绍
1.2 测试Git是否安装成功：在cmd中输入 git --version（注意是两个-），能看到版本号就说明安装成功

二、安装JDK

2.1 因为源码使用Java写的，所以需要JDK
2.2 对于JDK的版本，由于源码比较老，官网推荐使用8的版本，我之前使用11的版本编译出错，所以还是建议使用8
2.3 我使用的版本是 jdk-8u241-windows-x64，已安装的可跳过本步骤，安装过程比较简单，不再赘述
2.4 配置环境变量：
（1） 增加JAVA_HOME变量，变量路径为JDK的安装目录，如下图所示

（2）增加CLASSPATH变量，路径如下图所示

（3） 在Path变量下增加路径，如下图所示

（4）测试是否安装成功：在cmd中输入 java -version，能看到版本号就说明安装成功

三、安装Maven

3.1 源码需要使用maven进行编译，所以需要安装
3.2 我选择的版本是 apache-maven-3.6.3-bin
3.3 下载后解压缩，然后直接将解压后的文件夹拷贝到C:\Program Files目录下
3.4 配置环境变量：在Path变量下增加路径，如下图所示

3.5 测试是否安装成功：在cmd中输入 mvn -version，能看到版本号就说明安装成功

四、编译源码

4.1 在本地硬盘创建用于存放EarthSci源码的目录
4.2 下载源码：在cmd中输入 git clone https://github.com/GeoscienceAustralia/earthsci xxx(上述目录的完整路径)，此时程序会将源码下载到上述目录
4.3 特别说明：之所以用git进行拷贝下载是因为源码在编译过程中会使用到git的repository路径，如果使用svn checkout或者直接压缩包下载的方式，程序就获取不到git路径而报错，笔者之前就是遇到了此问题，换成git问题解决，这就是需要提前安装git的原因
4.4 下载完成后，进入到上述目录\plugins，打开pom.xml文件，将au.gov.ga.earthsci.worldwind.tests这一行删除，保存并关闭文件；同时将当前文件夹下对应的au.gov.ga.earthsci.worldwind.tests文件夹删除，如下图所示


4.5 特别说明：之所以作上述两个改动，是因为此项目是au.gov.ga.earthsci.worldwind项目的测试程序，程序在测试过程时会报错（报错原因是有些网站无法访问），而整个程序是按顺序编译的，一旦有某项目出错，后续的项目都会停止，导致整个项目编译不成功。不过删除的只是一个测试项目，对整个程序并无影响，所以大家不用担心
4.6 做完上述所有准备之后，终于可以开始编译了，在cmd中进入到源码的根目录，然后输入 mvn clean install，回车即可进行所有项目的编译，程序首先会下载很多项目编译依赖的包并保存在maven仓库中，下载过程时间比较长（我这边大概下了5个小时左右。。），可以先休息一段时间，依赖包下载后才进入真正的代码编译，此部分时间较短，大概15分钟左右。依赖包下载之后，以后程序如果重新编译就不用再重新下载了，所以就第一次比较费时间

五、程序使用

1、程序编译成功后，在xxx\features\au.gov.ga.earthsci.product\target\products\au.gov.ga.earthsci.product\win32\win32\x86_64目录下会生成最终的程序版本，earthsci.exe就是主程序

2、 启动程序如下图所示，此时还是存在一些依赖库未加载的问题以及一些网站无法访问的问题，这些问题我暂时还无法解决，后续会更新解决方法