GeoTools入门（一）-- 源码构建

- 日理万妓 2022-10-10 14:53 32阅读 0赞

## 1. GeoTools源码构建 ##

首先我们要明白为什么要进行源码构建？有人说为了学习优秀的代码，并于调试，做笔记。也有人会说为了满足项目的需求进行对源码的修改。我想，对于第一点还是很多人的想法，但是第二点，不仅需要身后的代码功能，但是一般也不建议这么做，因为如果要升级版本，这也算是灾难级别的影响。那有没有其他办法吗？根据代码的特性，合理的运用java的封装、继承和多态的特性进行改造，说白了就是要学会使用匿名内部类。

今天我们不是去研究怎么改造代码，而是要搭建源码环境。构建不同版本的GeoTools工具类。免于忍受由于下载geotools的龟速。

## 2. 下载源码 ##

构建源码的前提是要先下载源码。当前许多流行框架的源码基本都被github托管。当然，如果你会科学上网，一切不是问题。但是如对于不会科学上网的那就非常痛苦了，卸载的速度简直比龟速还慢。那有没有一种方法解决这个问题吗？答案肯定是有的。好了，那我们就先开始下载代码。

#### 2.1 查找代码库 ####

GeoTools在GitHub的代码位置为[GeoTools][]。此时我们复制https地址`https://github.com/geotools/geotools.git`

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center]

#### 2.2 代码块迁移 ####

打开自己的Gitee账号，没有的可以申请一个。依次点击±> 从 GitHub / GitLab 导入仓库

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 1]

在弹出的页面输入相关属性，Git仓库URL输入刚才复制的地址，其他的属性也自行补充一下。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 2]

稍等片刻，我们就把代码迁移到gitee上了。然后我们就可以愉快的clone代码了。那速度不是一般的快啊。

## 3. 源码构建 ##

### 3.1 切换指定版本 ###

切换到我们需要的版本，一般我们构建是通过tag版本构建。所以我们执行如下命令查看tag标签：`git tag`。这里，我们选择19.1的版作为检出版本。我们需要执行如下命令：

git checkout -b 19.1_dev 19.1

**需要注意的是(很重要，不然后期会很麻烦)：我们在检出的本地版本号千万不要和tag标签的号一致，否则会严重影响后期push代码的步骤。**

查看是否切换版本:

git branch -a

当然这是git的基本操作，我就不做详细说明了。

### 3.2 打包 ###

我们打开当前文件夹下，有一个README.md的文件。里面有一段构建项目的方法：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 3]

然而，我们为了快速构建项目，这里我们需要跳过项目的测试，所以我们执行命令:

mvn -Dmaven.test.skip=true clean install

### 3.3 查看构建结果 ###

我们在maven的中心仓库中查看我们打的jar包是否存在。如果存在，则表明打包成功。

## 4. 常见问题 ##

在实际源码构建中，有可能会存在如下几个问题：

### 4.1 找不到依赖包 ###

Geotools上的部分依赖包在maven中央仓库并没有存在，他是放到了`https://repo.boundlessgeo.com/`等其他关于地理信息系统的仓库。这是国外的仓库，如果不通过科学上网是没办法获取到的。解决的办法就是需要科学上网。当然，我也把geoTools需要的依赖上传到CSDN上了，需要的可以自行下载一下，[GeoTools依赖包][GeoTools 1]。

### 4.2 找不到Geotools下类似test的jar包。 ###

在源码构建过程中，有些模块还依赖了其他模块的test的jar包。为了快速构建，我们当时执行的命令是跳过test，即`-Dmaven.test.skip=true`，所以此时需要找到相对应的依赖包，在当前路径下执行`mvn install`命令，此时会在本地maven仓库中多出一个test的jar包。

### 4.3 在构建test报错 ###

在构建test过程中，由于各种原因导致测试并不通过。我们可以通过错误日志找出报错的测试用例，直接把方法里的代码注释掉即可。

[GeoTools]: https://github.com/geotools/geotools
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center]: /images/20221005/02174933db0e40b3bae1ccf100140e71.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221005/f090652d072c4bb0b6e9cbaa2c3d6c6a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221005/ede4c212c92447fd8f8508e2425d5f09.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29ZaW5IZVpoaUd1YW5n_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221005/ae986727fa574a8a806a1f1e689b11f2.png
[GeoTools 1]: https://download.csdn.net/download/oYinHeZhiGuang/19823910?spm=1001.2014.3001.5501