iPortal 升级代码合并注意事项

• iPortal 前端代码合并的注意事项
  • 使用 WinMerge 同步代码
• iPortal 后端代码合并的注意事项

iPortal 前端代码合并的注意事项

以下介绍前端代码合并的过程仅适用于 iPortal 9D(2019) SP2 及以下版本，iPortal 10i 及以上版本不适用。

iPortal 的 js 文件位于：Custom_Portal\WebContent\WEB-INF\classes\staticFiles\js 目录下，ftl 文件位于 Custom_Portal\WebContent\WEB-INF\classes\templates 目录下。

基于 iPortal 前端代码定制开发时，在 %SuperMap iPortal_Home%\webapps\iportal\WEB-INF 目录下创建文件夹 classes，可将 Custom_Portal 工程的所在目录即 %SuperMap iPortal_Home%\samples\code\CustomPortal\Custom_Portal\classes 目录下的所有静态资源文件复制到 %SuperMap iPortal_Home%\webapps\iportal\WEB-INF\classes 目录下。

在升级 iPortal 进行代码合并之前建议使用 WinMerge 来对比文件夹，对比增加或减少的文件，同时对已修改的 iPortal 源代码和升级后的 iPortal 源代码进行比较，改动不大可以将修改同步到升级后的 iPortal 源代码中，如果改动很大，不建议升级。

使用 WinMerge 同步代码

1. 安装好 WinMerge 后，选中要比较的一个文件夹右键点击 WinMerge。

2. 在弹出的对话框中填写另外一个要比较的目录，并点击确定。

3. 确定后 WinMerge 会列出比较的结果，一般会包含三种图标，如下图中标注所示：

其中，

• 图标1：表示该文件或目录只存在于进行比较的两个文件夹中的一个
• 图标2：表示该文件的内容在比较的两个文件夹中是完全一致的（无需同步）
• 图标3：表示比较的两个文件夹中都有该文件，但是该文件的具体内容不一致

4. 如果文件或文件夹只存在于比较的两个文件夹中的一个，可以在该文件上右键进行同步。

5. 如果比较的两个文件夹中的某个文件内容不一致，可以双击该文件查看不一致的内容，进行修改和同步。

注意：在定制开发的时候建议如果改动很小可以修改 iPortal 的 ftl 和 js 源代码；改动大最好创建新的文件夹，写独立的 ftl 和 js 文件放入其中，然后在 iPortal 源代码中引入（ftl 文件使用<#include>引入，js 文件使用<script>引入），这样可以一定程度上方便 iPortal 日后进行升级和维护。

iPortal 后端代码合并的注意事项

基于 iPortal 定制开发时，在 %SuperMap iPortal_Home%\webapps\iportal\WEB-INF 目录下创建文件夹 classes，可将 Custom_Portal 工程的所在目录即%SuperMap iPortal_HOME%\samples\code\CustomPortal\Custom_Portal\classes 目录下的所有文件复制到%SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\classes 目录下。

基于 jersey 自定义的定制开发时，在 tomcat 安装目录中的/webapps 目录下建一个新的文件夹名称为 custom，可将%SuperMap iPortal_HOME%\samples\code\ExtendPortal\Custom_App_Sample\WebContent 目录下的所有文件复制到 tomcat 安装目录中的 webapps 目录下，然后把%SuperMap iPortal_HOME%\webapps\iportal\WEB-INF\lib 目录下的如下图所示的这些包引入到%apache-tomcat%\webapps\custom\WEB-INF\lib 目录下。