使用 iClient for Flash 入门

在按照 目标系统需求 安装完所需要的软件后，就可以使用 SuperMap iClient 8C for Flash 构建出界面丰富、高度互动、体验优越的地图应用。使用 SuperMap iClient 8C for Flash 开发流程如下图：

图1 SuperMap iClient 8C for Flash 开发流程

下面我们将介绍如何使用 SuperMap iClient 8C for Flash 来构建一个简单的地图应用。

第一步：下载并解压库文件

1. 下载 SuperMap iClient 8C for Flash 产品包文件，解压产品包文件于本地磁盘。

2. 产品包目录结构如下：
   

   

   图2 SuperMap iClient 8C for Flash 产品包结构

   • help 为帮助文档文件夹，其中包含：SuperMap iClient 8C for Flash Help_iServer8C.chm 。

   • libs 存放 SuperMap iClient 8C for Flash 库文件，库文件列表及作用见下表：

     SuperMap iClient 8C for Flash 库文件列表

     动态库文件	功能
     SuperMap.Web.swc	SuperMap iClient 8C for Flash 客户端核心库。地图控件及其他显示控件、客户端图层、地图操作、地理要素、服务基类等对象在该动态库中。它包含了7个包： com.supermap.web.actions com.supermap.web.clustering com.supermap.web.components com.supermap.web.core com.supermap.web.events com.supermap.web.mapping com.supermap.web.ogc com.supermap.web.rendering com.supermap.web.resources com.supermap.web.themes com.supermap.web.utils
     SuperMap.Web.iServerJava7C.swc	支持 SuperMap iServer 8C 服务的动态库，包含 2 个包： com.supermap.web.iServer7C com.supermap.web.mapping com.supermap.web.resources
     SuperMap.Web.iServerJava2.swc	支持 SuperMap iServer Java 2008 服务的动态库： com.supermap.web.iServerJava2 com.supermap.web.mapping(该包下包含专门对接 SuperMap iServer Java 2008 服务的图层：DynamicHighlightLayer、DynamicIServerLayer、TiledCachedIServerLayer、TiledDynamicIServerLayer) com.supermap.web.resources
     SuperMap.Web.Symbol.swc	行业符号库 com.supermap.web.symbol
     SuperMap.Web.Mobile.swc
     SueprMap.Web.Gear.swc	工具包

   • samplecode_iServer8C 存放 SuperMap iClient 8C for Flash 支持 SuperMap iServer 8C 服务功能的示范代码。打开此文件双击 samplecode.html ，便能够浏览示范代码。 有关 SampleCode 使用说明请参见《范例代码向导》文档。

   • crossdomain.xml 为跨域文件。当客户端应用程序与服务不在同一个域下时，需要使用跨域文件。不同的服务发布方式， crossdomain.xml 的存放地址不同。以 Tomcat 和 IIS 为例：

     • Tomcat： 例如 SuperMap iServer 8C 使用 Tomcat 发布服务，则将跨域文件放置在 <SuperMap_iServer_Install_Location>\webapps\ROOT 下。
     • IIS： 例如 SuperMap IS.NET 6 使用 IIS 发布服务，则将跨域文件放置在 C:\inetpub\wwwroot 中。
     • 其它服务: 如果使用其他方式发布服务，则将跨域文件放置在服务器的根目录中。

   • SuperMap_iClient_8C_for_Flash_Readme_CHS.pdf 为产品包的说明文件，主要介绍产品包中各个文件的功能 。建议在使用产品之前的详细阅读此文档，以便您更加灵活的使用 SuperMap iClient 8C for Flash 产品。

第二步：新建 Flex 工程

1. 在 Flash Builder4 中，选择 “文件 > 新建 >Flex 项目”，或在 “包资源管理器” 窗口中右键单击选择“新建 > Flex 项目”，弹出 “新建 Flex 项目” 对话框。在“ 项目名” 栏中输入项目名称：

   
   图3 新建工程

2. 单击 “下一步” 按钮，再单击 “下一步” 按钮，转到 “创建一个新的 Flex 工程” 页面。

3. 选择 “库路径” 复选项，加载产品库文件。单击 “添加 SWC” 按钮，弹出 “添加 SWC” 对话框，单击 “浏览” 按钮定位到库文件所在硬盘位置。 若使用客户端基本的地图功能等，需引用 SuperMap.Web.*.swc 库文件；如果需要使用 SuperMap iServer 8C 服务功能，则需引用 SuperMap.Web.iServer7C.*.swc 文件。例如，如果要在地图控件上显示 SuperMap iServer 8C 服务的地图，则需加载 SuperMap.Web.*.swc 和 SuperMap.Web.iServer7C.*.swc两个库文件。同时，可通过加载库文件所在文件夹（“添加 SWC 文件夹”） 加载产品的库文件。在“主应用程序文件(M)”一栏可更改主应用程序的文件名，本示例使用 GettingStarted.mxml。

   
   图4 加载库文件
4. 单击 “完成” 按钮完成创建 Flex 工程。可以见到左边 “包资源管理器” 窗口中新增了 "Flex" 工程，双击 src 文件夹下的 GettingStarted.mxml 在右边窗口打开该文件，此时就可以添加代码了。

   

   图5 Flex 工程

第三步：添加代码，实现访问地图服务：

        在 GettingStarted.mxml 中添加如下代码，实现访问 SuperMap iServer 8C 服务提供的分块动态图层。其中红色字体部分为添加的代码：

<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"                       
               xmlns:s="library://ns.adobe.com/flex/spark"                       
               xmlns:mx="library://ns.adobe.com/flex/mx"                          
               xmlns:ic="http://www.supermap.com/iclient/2010"                        
               xmlns:is="http://www.supermap.com/iserverjava/2010"                    
               width="100%" height="100%">  
    <!--添加地图-->   
    <!--scales:您的地图比例尺；url：您的 Web 服务地址；url：您的地图服务地址；-->   
    <ic:Map id="map" x="0" y="0" height="100%" width="100%"            
            scales="{[1.25e-9, 2.5e-9, 5e-9, 1e-8, 2e-8, 4e-8, 8e-8, 1.6e-7, 3.205e-7, 6.4e-7]}">          
        <is:TiledDynamicRESTLayer url="http://192.168.11.11:8090/iserver/services/maps/rest/maps/World Map"/>   
    </ic:Map>
</s:Application>

注意：代码中的地图服务地址（url）仅作为参考。该程序能够运行的前提是您已确定您的服务器上安装了 SuperMap iServer 8C 产品，并在 <SuperMap_iServer_Install_Location>\webapps\ROOT 中放置了跨域文件、地图服务地址输入正确，并启动了服务。

第四步：运行工程并浏览

按 Ctr+F11 运行程序，或右键单击 GettingStarted.mxml 应用程序 --> 运行应用程序就可以在浏览器就可以在浏览器（在“窗口 --> 首先参数 --> 常规 --> Web 浏览器”中可更改默认浏览器）中看到 SuperMap iServer 8C 服务发布的世界地图：

图8 访问 SuperMap iServer 8C 服务的世界地图