iObjects java 环境部署篇

作者：zhangL

背景
许多用户反馈在初学使用iObjects java（组件）时会遇到各种入门级问题，比如：环境部署、许可、依赖检测等种种问题，其中有许多坑都是容易踩中的。这里我为大家整理一个比较全面的部署指南，方便大家入门使用。

一、环境变量部署

iObjects java 是依赖java的环境变量的，推荐使用jdk1.8，并且需要分别保持iObjects java、java jdk的编译环境和运行环境版本一致。java环境变量部署不再赘述，下面讲一下iObjects java的环境变量配置，这里推荐手动配置。

1、Windows

（1）将组件解压后的bin目录 添加到系统环境变量path 中，并且将其移动至最顶层（jdk之前）；
（2）eclipse开发：将组件jar引到工程path中即可；
（3）ideal开发：还需要在项目Run configuration里面的Environment variables里面设置path=Java组件的bin路径；
（4）spring boot配置参考https://blog.csdn.net/supermapsupport/article/details/111475754

2、Linux

根据CPU架构在 官网地址下载对应的组件包，然后上传到Linux环境中用命令解压

tar -zxvf  组件tart包

（1）以 root 用户 登录，vim /etc/profile 编辑环境变量，添加

export  PATH=$PATH:组件bin目录路径   
export  LD_LIBRARY_PATH=组件bin目录路径 : $LD_LIBRARY_PATH
export  SUPERMAP_ROOT= 组件bin目录路径

添加完后执行

source /etc/profile

使环境变量生效 ；
PS：通常配置PATH和LD_LIBRARY_PATH就能保证功能正常运行，SUPERMAP_ROOT是为了让组件自带的字体库等资源生效，如果没有配置，可能会遇到在map.outPutToPng()输出带汉字或者数字的标签的图片时，标签内容为空；
（2）编辑在 /etc/profile的环境变量，在机器重启或重新另起一个终端时可能不会生效，就需要重新source /etc/profile，但是把环境变量配置在 ~/.bashrc 下可以保证重启机器或者另开终端也能正常使用；

vim  ~/.bashrc
source   ~/.bashrc

（3）当组件版本需要更换时，因为（1）中写法是对已有的PATH进行追加的环境变量，老版本的并未删掉，又同时只能存在一个组件环境变量。所以在vim /etc/profile 编辑好新的环境变量之后，需要将环境变量重置一下

#分别执行，顺序不分先后
unset PATH
unset LD_LIBRARY_PATH

重置过后，关掉当前终端，重新起一个，然后 再source /etc/profile

二、许可、依赖检查

1、许可

许可申请和配置可以参考帮助文档 开发指南——许可配置说明

2、许可和依赖检查

（1）Windows：检查许可和环境只需要建个工程，在代码中执行 new Workspace(); 就能判断许可和环境是否通过。许可异常：可以在错误日志中找到License报错的关键词，环境变量异常：会有loadlibrary关键词报错，具体情况具体分析。
（2）Linux:可以把（1）的工程打包成runnable jar，然后上传到Linux上运行检测。

java -jar  你的测试jar

Linux中许可报错与Windows一致，但是环境的报错的原因有多个：
a：环境变量未生效或者配置错误；
b：依赖冲突或者不全；
c：特殊依赖缺失；
排查方案
a：用命令输出环境变量值，检查是否和预期一致,存在问题按照上述部署步骤再来一遍。

echo $PATH
echo $LD_LIBRARY_PATH

b：切到组件的bin路径下，执行命令检查核心依赖并手动补全。

ldd libWrapjCore.so |grep not

c：b的命令只能检测核心依赖是否缺少，可能会出现基础功能可以运行，但是特殊功能运行失败的情况；比如：将地图输出成png图片这个功能，这个需要libpng12相关的依赖。用如下命令检测特殊依赖缺失情况（不影响基础功能使用）

ldd libWrapj*.so |grep not

PS:额外需要注意的是。数据库对接的相关依赖要用单独的so库进行检测，比如：

#检查postgis所需依赖是否缺少
ldd libSuEnginePGis.so |grep not

依赖补充
X86_64架构的环境可以从一个正常运行的环境中拷贝到组件bin目录下，前提是CPU架构一致。也可以百度下载；
arm架构的组件包将所需的大部分依赖打在了产品包内，自行解压使用。如果仍然不全，还可以在jre的lib下找。

这里列举一些X86_64常缺的依赖：
链接：https://pan.baidu.com/s/1vP3g70lf4wP8OEN-VlutQA
提取码：z7i6