更新检查和升级指南

首先感谢您选择使用 SuperMap 系列产品！

为了带给用户更加优越的体验，SuperMap iClient3D for Plugin 提供了自动更新检查功能，以确保用户使用的是最新版本的插件。本节内容主要介绍如何实现更新检查和升级SuperMap iClient3D for Plugin 插件的推荐方法。

更新检查可以自动检查客户机器上的SuperMap iClient3D for Plugin 的插件版本是否与服务器端发布的版本保持一致，然后提示用户是否需要进行插件升级，确保用户使用的SuperMap iClient3D for Plugin 是最新版本，带给用户最优越的体验。

升级指南可以让用户了解升级的最佳实践及升级过程中的注意事项，以确保用户成功升级 SuperMap iClient3D for Plugin 产品。

更新检查

在SuperMap iClient3D for Plugin SceneControl 类提供了 checkPluginUpdate 方法。通过调用此方法可以判断插件版本是否为最新。若不是最新版本，则返回最新版本的下载地址。

checkPluginUpdate 方法使用步骤为：

pluginversion.xml 文件介绍：

在SuperMap iClient3D for Plugin 安装包中提供了 pluginversion.xml 文件，此文件记录了SuperMap iClient3D for Plugin 插件的版本信息。该文件为 XML 格式，其主要节点信息描述如下：

XML 拷贝代码

XML	拷贝代码
`<?xml version="1.0" encoding="GB2312"?> <SuperMap iClient3D for Plugin xmlns:sml="http://www.supermap.com/SuperMapRealspace/"> <sml:Version>8.0.0.12929</sml:Version> <sml:PackageVersion>12929</sml:PackageVersion> <sml:UpdateUrl>http://IP_Address:port/iserver/iClient/for3D/Setup.exe</sml:UpdateUrl> </SuperMap iClient3D for Plugin >`

        
        <?xml version="1.0" encoding="GB2312"?>
        <SuperMap iClient3D for Plugin  xmlns:sml="http://www.supermap.com/SuperMapRealspace/">
                <sml:Version>8.0.0.12929</sml:Version>
                <sml:PackageVersion>12929</sml:PackageVersion>
                <sml:UpdateUrl>http://IP_Address:port/iserver/iClient/for3D/Setup.exe</sml:UpdateUrl>
        </SuperMap iClient3D for Plugin >

<sml:Version>节点元素：记录 SuperMap iClient3D for Plugin 插件的版本信息。
<sml:UpdateUrl>节点元素：记录获取此版本插件的地址信息。

发布文件：
要实现在客户端对 pluginversion.xml 文件的访问和新版本的下载，需要您把 pluginversion.xml 和 setup.exe 文件通过服务器发布。

用户可以在【SuperMap iServer Java 安装路径】/webapps 下新建一个名为 “Update”的文件夹，然后将 pluginversion.xml 文件和新版本的 setup.exe 文件拷贝到此文件夹下。然后再启动 SuperMap iServer Java 就会默认把此文件夹下的内容发布出来。
修改 pluginversion.xml文件：
根据实际情况修改 pluginversion.xml 文件，将节点元素 <sml:Version> 的值修改为发布的新版本的版本信息，将节点元素 <sml:UpdateUrl> 的值修改为 "http://IP_Address:port/Update/setup.exe"。

代码实现：

经过上述步骤后，用户即可使用 SceneControl 中的 checkPluginUpdate 的方法实现版本的更新检查了。在使用此方法时需要传入 pluginversion.xml 文件在服务器端的地址，然后会将此文件里的版本与本地版本进行对比，若有新版本时则返回新插件的下载地址即 pluginversion.xml 文件中的 <sml:UpdateUrl>元素的值，否则不提示任何操作。

JavaScript 拷贝代码

JavaScript	拷贝代码
function CheckPluginUpdate() { var sceneControl = new SuperMap.Web.UI.Controls.SceneControl(document.getElementById("sceneControlDiv")); //已通过服务器端发布的 pluginversion.xml 文件地址 var pluginVersionFileUrl = "http://IP_Address:port/Update/pluginversion.xml"; //解析 pluginversion.xml 文件与本地版本进行对比，判断是否有新的插件 var sPluginUpdate = sceneControl.checkPluginUpdate(pluginVersionFileUrl); //当检测到有新版本时返回插件的下载地址并且您可以决定是否下载 if(sCheckPluginUpdate != "当前无可用版本" && sCheckPluginUpdate ！="当前无可用的更新") { if(confirm("已检测到新版本，是否下载？")) { window.location.href = sPluginUpdate; return; } } }


function CheckPluginUpdate()
{
        var sceneControl = new SuperMap.Web.UI.Controls.SceneControl(document.getElementById("sceneControlDiv"));
        //已通过服务器端发布的 pluginversion.xml 文件地址
        var pluginVersionFileUrl = "http://IP_Address:port/Update/pluginversion.xml";
        //解析 pluginversion.xml 文件与本地版本进行对比，判断是否有新的插件 
        var sPluginUpdate = sceneControl.checkPluginUpdate(pluginVersionFileUrl);
        //当检测到有新版本时返回插件的下载地址并且您可以决定是否下载
        if(sCheckPluginUpdate != "当前无可用版本" && sCheckPluginUpdate ！="当前无可用的更新")
        {
                if(confirm("已检测到新版本，是否下载？"))
                {
                        window.location.href = sPluginUpdate;
                        return;
                }
        }
}

升级指南

升级过程的推荐步骤为：

首先通过[控制面板] -> [添加或删除程序] 卸载 SuperMap iClient3D for Plugin 。
其次确认默认的安装路径（C:/SuperMap）是否清理干净，如果没有清理干净，请手动进行删除。
然后请手动清理SuperMap iClient3D for Plugin 用于存放缓存数据的文件夹。缓存数据的默认存储路径为：在Windows XP下 %USERPROFILE%\Local Settings\SuperMap ，在Windows 7下为 %USERPROFILE%\AppData\LocalLow\SuperMap 。
最后您可以通过双击 Setup.exe 放心的进行 SuperMap iClient3D for Plugin产品的升级了，在升级过程无需进行任何选择。