### 超图（SuperMap）安装与二次开发详解
#### 一、超图简介及安装步骤
**超图(SuperMap)**是一款先进的地理信息系统(GIS)软件平台，支持多种开发语言，其中Java是最常用的一种。本文档主要针对初次接触SuperMap的开发者，详细介绍其安装流程、Eclipse集成及常见问题解决方法。
##### **1.1 安装过程**
- **下载官方ZIP包**：从SuperMap官方网站下载最新版本的Java开发包。
- **解压安装包**：解压下载好的ZIP文件至指定位置，例如`D:\SuperMap`。
- **运行安装脚本**：以管理员身份运行解压目录下的`Install_x64.bat`文件，该脚本能够自动完成SuperMap的安装，包括环境配置和许可文件的安装。
##### **1.2 环境配置**
- **添加环境变量**：将`Bin`目录（例如`D:\SuperMap\Bin`）的路径添加到系统的`PATH`环境变量中，确保在任何位置都能访问到SuperMap提供的工具和库。
- **许可文件配置**：
- 使用提供的邮箱向SuperMap官网申请许可文件。
- 将收到的`.lic9D`文件放置于`C:\Program Files\Common Files\SuperMap\License`文件夹下。
- 可以下载许可中心程序`SuperMap.LicenseCenter.exe`来管理许可文件。
#### 二、SuperMap与Eclipse集成
##### **2.1 设置编码方式**
- **单个项目编码设置**：在Eclipse中，选中项目后，依次点击`Project > Properties > Resource > Other`，设置正确的编码格式。
- **全局编码设置**：通过`Window > Preferences > General > Content Types > Text > Java Source File`，统一设置工作空间内的编码方式。
##### **2.2 导入项目**
- **导入项目至Eclipse**：通过`File > Open Projects From File System > Directory`，选择SuperMap的项目目录（如`D:\SuperMap\GettingStarted\Eclipse\GettingStarted`）。
- **修改项目属性**：右键点击项目，选择`Properties`，在`Build Path`选项卡中，将`Source attachment`设置为`Bin`路径。
- **配置运行环境**：右键项目中的Java文件，选择`Run As > Java Application`，并在弹出的窗口中选择合适的运行环境。
##### **2.3 添加API文档支持**
- **解压Javadoc文档**：解压SuperMap提供的`SuperMap iObjects Java Javadoc.zip`。
- **添加至Eclipse**：在项目引用的jar包上右键选择`Properties`，在弹出的窗口中选择`JavaDoc Location`选项卡，添加刚解压的文档文件夹路径。
#### 三、常见问题及解决方案
##### **3.1 Java.lang.UnsatisfiedLinkError**
**问题描述**：出现`no WrapjGeo in java.library.path`的错误提示。
**解决方法**：
- 检查环境变量`PATH`是否正确包含了SuperMap的`Bin`目录路径。
- 确认项目构建路径中的库路径是否正确。
##### **3.2 failded to created self-pipe**
**问题描述**：系统未激活或缺少某些组件。
**解决方法**：
- 确保操作系统已激活。
- 安装所需的系统组件，如.NET Framework等。
##### **3.3 SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder"**
**问题描述**：日志框架配置问题。
**解决方法**：
- 下载并添加`SLF4J-nop`的jar包至项目依赖中。
##### **3.4 Exception in thread "AWT-EventQueue-0" java.lang.IndexOutOfBoundsException**
**问题描述**：运行时出现索引越界异常。
**解决方法**：
- 检查地图打开语句是否正确，确保地图名称与实际存在的一致。
- 示例代码中使用`mapControl.getMap().open(workspace.getMaps().get(0))`来避免因名称不匹配导致的错误。
通过以上步骤，可以顺利完成SuperMap的安装和配置，并解决常见的开发问题。对于更复杂的开发需求和高级功能，请参考官方文档和社区资源。
