SuperMap iDesktop Cross 配置指南(Windows 篇).md · 流浪的刘永/SuperMap iDesktop Cross

# JDK #

SuperMap iDesktop Cross 产品所使用的 JDK 版本为 **JDK 1.7.0_80** 即 **Java SE Development Kit 7u80**，请前往 [Java 官方网站](http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html "Java 官方网站") 获取指定 JDK。

# 开发工具 #

SuperMap iDesktop Cross 产品是基于 Java 语言的桌面 GIS 平台，产品源代码使用 **Maven** 进行项目管理，同时支持 **IntelliJ IDEA**、**eclipse** 等多种主流 Java 开发平台。

## IntelliJ IDEA（推荐） ##

IntelliJ IDEA 拥有极其丰富且人性化的开发调试工具，并自带 **Maven** 项目管理工具，推荐使用 IntelliJ IDEA 作为项目开发工具。请前往 [IntelliJ IDEA 官方网站](https://www.jetbrains.com/idea/ "IntelliJ IDEA 官方网站") 获取 **IntelliJ IDEA**，然后安装至任意目录。
> 注意：
>
>     最新版本 IntelliJ IDEA 需要 JDK 1.8 及以上版本支持。如果需要最新版本 IntelliJ IDEA，请同时安装 JDK 1.8 及以上版本。

## Eclipse ##

请前往 [Eclipse 官方网站](http://www.eclipse.org/downloads/packages/ "Eclipse 官方网站") 获取 Eclipse，然后解压至任意目录。建议使用 **Eclipse for RCP and RAP Developers** 进行开发。
> 注意：
>
>     最新版本 Eclipse 需要 JDK 1.8 及以上版本支持。如果需要最新版本 Eclipse，请同时安装 JDK 1.8 及以上版本。

# SuperMap iObjects Java #

## 获取 ##

SuperMap iDesktop Cross 产品是基于 SuperMap iObejcts Java 的二次开发产品，开发以及运行本产品的基本前提是购买并配置了 SuperMap iObjects Java 的许可。
> 注意：
>
> 1. SuperMap iDesktop Cross 开源并免费，SuperMap iObjects Java 是收费产品，该产品可以配置一定时间的免费试用，之后如有需要请前往 [SuperMap 官方网站](http://www.supermap.com/ "SuperMap 官方网站") 咨询购买；
> 2. 外部用户扩展开发，请使用 Tag 以及与之版本相对应的 SuperMap iObjects Java 产品。否则程序可能无法运行。

请前往 [SuperMap 官方网站](http://www.supermap.com/ "SuperMap 官方网站") 获取需要的 SuperMap iObjects Java 组件产品，并安装至任意目录。这里下载 SuperMap iObjects Java 8C SP1 Rumtime for Windows。

后文以 **OBJECTS_HOME** 代指组件产品根目录，请根据您机器操作系统是 32位还是 64位来选择对应的 Java 组件。

## 许可配置 ##

如需完整部署 SuperMap iObjects Java 产品，或需要许可配置的更多详细信息，请参阅 OBJECTS_HOME 目录下的 InstallationGuide.pdf 文件。

初次使用 SuperMap 产品，需要进行许可的配置安装。SuperMap 许可中心（SuperMap License Center）用来管理 SuperMap 相关产品的许可使用情况。SuperMap 许可中心以 zip包的形式提供，请前往 [SuperMap 技术资源中心](http://support.supermap.com.cn/DownloadCenter/ProductPlatform.aspx "SuperMap 许可中心下载") 获取许可中心。

- 将下载的许可中心解压至任意目录，双击运行 **许可中心根目录/Tools/Setup.bat** 批处理文件，安装许可服务。
- 等待许可服务部署成功之后，即可运行 **许可中心根目录** 下的 **SuperMapLicenseCenter.exe** 启动许可中心，首次启动许可中心，默认安装一个90天的试用许可。

# 获取代码 #

请使用 [Git](https://git-scm.com/download/ "Git") 获取代码，源代码地址如下：

- [OSChina 项目地址: http://git.oschina.net/supermap/SuperMap-iDesktop-Cross](http://git.oschina.net/supermap/SuperMap-iDesktop-Cross "OSChina 项目地址")
- [CSDN 项目地址: https://code.csdn.net/SuperMapDesktop/supermap-idesktop-cross/](https://code.csdn.net/SuperMapDesktop/supermap-idesktop-cross/ "CSDN 项目地址")

SuperMap iDesktop Cross 分支说明：

- develop：项目团队开发用分支，使用了未发布的 iObjects Java 组件产品，外部用户无法基于此版本进行扩展开发。该分支为项目默认分支；
- master：主分支，维护最近一次正式发布版本的代码；
- tag：master 分支上各历史发布版本。

在任意目录下，右键打开 **Git Bash**，使用以下命令抓取代码（以 OSChina 远程仓库为例），进入抓取的 SuperMap-iDesktop-Cross 目录，即可浏览整个项目的相关内容。

$ git clone https://git.oschina.net/supermap/SuperMap-iDesktop-Cross.git

使用此命令将会抓取整个远程仓库，默认为 develop 分支，而外部用户扩展开发需要使用 tag版本，因此请参照以下步骤切换为您想要的 tag版本。

1. 进入抓取的 SuperMap-iDesktop-Cross 目录，右键打开 Git Bash；
	2. 查看仓库的所有 tag版本，命令：$ git tag -l;
	3. 选择想要的 tag版本，命令：git checkout tags/<tag_name>
	
	注意：tag版本是当前仓库的快照版本，无法做修改提交，因此如果需要提交到当前仓库，请执行以下命令替代步骤3。
		 命令：$ git checkout tags/<tag_name> -b <branch_name>
	
	后文以 **CROSS_HOME** 代指项目根目录。

# 运行程序 #

## IntelliJ IDEA ##

1. 拷贝 `OBJECTS_HOME/Bin/` 或者 `OBJECTS_HOME/Bin_x64/` 下所有文件至 `CROSS_HOME/Bin/` 目录下，如果 `CROSS_HOME` 目录不存在，自行新建。
2. 进入 `CROSS_HOME` 目录，双击 **SuperMap iDesktop Cross.ipr** 启动 IntelliJ IDEA，加载项目；
3. 查看 IntelliJ IDEA 右边侧边栏，打开 Maven Projects 管理面板，展开 **iDesktop.cross - Lifecycle**，双击 **install** 安装依赖，等待完成；
4. 查看 IntelliJ IDEA 顶部工具条，选中 **iDesktop Startup** 启动项，点击其后的 **Run（Shift + F10）/Debug（Shift + F9**）即可运行 SuperMap iDesktop Cross。

## Eclipse ##

1. 拷贝 `OBJECTS_HOME/Bin/` 或者 `OBJECTS_HOME/Bin_x64/` 下所有文件至 `CROSS_HOME/Bin/` 目录下，如果 `CROSS_HOME` 目录不存在，自行新建。
2. 打开 Eclipse，选择一个新的 Eclipse 工作环境；
3. 导入项目。依次选择 **File - Import - Maven - Exitsting Maven Projects Next - Browse**，在弹出的文件窗口选中 **CROSS_HOME**， 点击 **Finish** 导入项目；
4. 配置 Installed JREs。依次选择 **Window - Preferences - Java - Installed JREs**，点击界面右侧 **Add**，弹出向导界面，依次点击 **Standard VM - Next - Directory**，选中 `JDK 1.7.0_80` 安装目录根目录，点击 **Finish**，勾选刚添加的 **JDK 1.7.0_80**，点击 OK 完成配置。
5. 右键选中 `idesktop.cross`并单击打开右键菜单，依次选择 **Run As - Maven install** 安装依赖，等待完成；
6. 展开 `idesktop.cross`，右键选中并单击 `Startup-Eclipse.launch` 打开右键菜单，依次选择 **Run As - Startup-Eclipse** 即可运行 SuperMap iDesktop Cross。

> 注意：
>
> 如果出现许可不可用等相关问题，请参见前文 **SuperMap iObjects Java - 许可配置** 部分内容。

# 扩展开发 #

> 本部分内容以 IntelliJ IDEA 为例，eclipse 等其他 IDE 除新建项目等操作略有不同之外，项目组织和 pom 文件配置等均一致。

## 新建项目 ##

- 选中 `SuperMap-iDesktop-Cross` 根节点并右键单击打开右键菜单，依次选择 **New - Module** 打开新建向导界面；
- 选中左边栏 **Maven**，点击 **Next** 进入下一步；
- 输入任意 ArtifactId，此处输入 MyPlugin，其他参数默认即可，点击 **Next** 进入下一步；
- 在 **Content root** 后添加 **"\MyPlugin"**,点击 **Finish** 完成创建。

## 插件注册 ##

新建的工程 `MyPlugin` 的初始化状态需要注册为 SuperMap iDesktop Cross 的插件，才能正确运行。查看工程代码，找到并打开 **Activator.java** 文件，进行以下修改。

public void start(BundleContext bundleContext) throws Exception {
    	Activator.context = bundleContext;
    
    	// 注册 SuperMap iDesktop Cross 插件
    	Application.getActiveApplication().getPluginManager().addPlugin("MyPlugin", bundleContext.getBundle());
    
    	// 插件注册成功
    	System.out.println("MyPlugin Start.");
    }
注册成功！接下来就可以随心所欲的进行开发了！

## 工程配置 ##

- 展开 `SuperMap-iDesktop-Cross` 根节点；
- 打开文件 `module-pom-template.xml`，这是扩展开发插件的 pom 配置模板文件，其中由 `**` 包围的配置项为必填自定义配置；
- 展开 `MyPlugin` 工程，打开 `pom.xml` 文件，参照模板文件进行配置；
- 查看 IntelliJ IDEA 右边侧边栏，打开 Maven Projects 管理面板，依次展开 **MyPlugin - Plugins - bundle**，双击 **bundle:manifest** 生成 manifest 文件，等待完成。

>注意：
>
>模板提供 pom 配置信息只是最小核心配置，为必备配置。其余更为详细丰富的 pom 工程配置按需求自行完成。
>
>manifest 文件内有 OSGI 插件运行所需的元数据信息，如有 OSGI 依赖的变动，需在运行前执行最后一步重新生成。

## 依赖说明 ##

### 工程依赖 ###

`Core` 和 `Controls` 作为项目的核心库，是所有插件的必填依赖。

Core 和 Controls 工程是整个项目的核心工程。
    Core 依赖并导出 SuperMap iObjects Java 以及其他第三方库的类库。
    Controls 依赖 Core，这两个工程共同构建了整个 Cross 项目的核心架构。
    扩展开发自己的插件，必须依赖 Core 和 Controls 工程。

### OSGI 依赖 ###

本项目基于 OSGI R4 规范的框架 Felix 进行实现，不同的 Bundle 间相互依赖有独特的规则。
	本程序已在工程的 Maven 配置中做了详尽的配置。详情请参见互联网相关资料。

流浪的刘永/SuperMap iDesktop Cross

简介

发行版

贡献者

近期动态

流浪的刘永/SuperMap iDesktop Cross .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

流浪的刘永/SuperMap iDesktop Cross