SuperMap iDesktop Cross 配置指南(Windows)

1. JDK
      SuperMap iDesktop Cross 产品所使用的 JDK 版本为 JDK 1.7.0_80 即 Java SE Development Kit 7u80，请前往 Java 官方网站 获取指定 JDK。
2. 开发工具
      SuperMap iDesktop Cross 产品是基于 Java 诧言的桌面 GIS 平台，产品源代码使用 Maven 迚行项目管理，同时支持 IntelliJ IDEA、Eclipse 等多种主流 Java 开发平台。
1.1. IntelliJ IDEA（推荐）
      IntelliJ IDEA 拥有极其丰富且人性化的开发调试工具，并自带 Maven 项目管理工具，推荐使用 IntelliJ IDEA 作为项目开发工具。请前往 IntelliJ IDEA 官方网站 获取 IntelliJ IDEA，然后安装至任意目录。
      注意：最新版本 IntelliJ IDEA 需要 JDK 1.8 及以上版本支持。如果需要最新版本 IntelliJ IDEA，请同时安装 JDK 1.8 及以上版本。
1.2. Eclipse
      请前往 Eclipse 官方网站 获取 Eclipse，然后解压至任意目录。建议使用 Eclipse for RCP and RAP Developers 迚行开发。
      注意：最新版本 Eclipse 需要 JDK 1.8 及以上版本支持。如果需要最新版本 Eclipse，请同时安装 JDK 1.8 及以上版本。
3. SuperMap iObjects Java
   3.1. 获取
      SuperMap iDesktop Cross 产品是基于 SuperMap iObjects Java 的二次开发产品，开发以及运行本产品的基本前提是购买并配置了 SuperMap iObjects Java 的许可。注意：
      1. SuperMap iDesktop Cross 开源并免费，SuperMap iObjects Java 是收费产品，该产品可以配置一定时间的免费试用，之后如有需要请前往SuperMap 官方网站咨询购买；
      2. 外部用户扩展开发，请使用Tag 以及与之版本相对应的SuperMap iObjects Java 产品。否则程序可能无法运行。

      请前往 SuperMap 官方网站 获取需要的 SuperMap iObjects Java 组件产品，并安装至任意目录。这里下载 SuperMap iObjects Java 8C(2017) Rumtime for Windows。
      后文以 OBJECTS_HOME 代指组件产品根目录，请根据您机器操作系统是 32位还是 64位来选择对应的 Java 组件。
**3.2. 许可配置 **
      如需完整部署 SuperMap iObjects Java 产品，或需要许可配置的更多详细信息，请参阅 OBJECTS_HOME 目录下的 InstallationGuide.pdf 文件。
      初次使用 SuperMap 产品，需要迚行许可的配置安装。SuperMap 许可中心（SuperMap License Center）用来管理 SuperMap 相关产品的许可使用情况。
      SuperMap 许可中心以 zip包的形式提供，请前往 SuperMap 技术资源中心 获取许可中心。
      • 将下载的许可中心解压至任意目录，双击运行许可中心根目录/Tools/Setup.bat批处理文件，安装许可服务。
      • 等待许可服务部署成功之后，即可运行许可中心根目录下的SuperMapLicenseCenter.exe启动许可中心，首次启动许可中心，默认安装一个90天的试用许可。

**4. 获取代码 **
请使用 Git 获取代码，源代码地址如下：
• OSChina 项目地址: http://git.oschina.net/supermap/SuperMap-iDesktop-Cross
• CSDN 项目地址: https://code.csdn.net/SuperMapDesktop/supermap-idesktop-cross/

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 代指项目根目录。
   5. 运行程序
      **5.1. 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。

**5.2. 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 - 许可配置 部分内容。