mobileTopic.html 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
  6. <meta name="apple-mobile-web-app-capable" content="yes"/>
  7. <title>离线缓存与 APP 专题</title>
  8. <link href='./css/bootstrap.min.css' rel='stylesheet'/>
  9. <link href='./css/bootstrap-responsive.min.css' rel='stylesheet'/>
  10. <link href='./css/sm-extend.css' rel='stylesheet'/>
  11. <link href='./css/sm-doc.css' rel='stylesheet'/>
  12. </head>
  13. <body data-spy="scroll" data-target=".subnav" data-offset="50">
  14. <!--导航条-->
  15. <div class="navbar navbar-fixed-top" id="navbar">
  16. </div>
  17. <div id='container' class='container'>
  18. <div class='page-header'>
  19. <h1>离线缓存与APP专题</h1>
  20. <hr/>
  21. <h2>一、SuperMap iClient for JavaScript 移动应用简介</h2>
  22. <div class="pageImage"><img src="./images/android.PNG"/></div>
  23. <p>
  24. SuperMap iClient 8C(2017) for JavaScript 是一款在服务式 GIS 架构体系中,面向 HTML5 的应用开发,支持多终端,跨浏览器的客户端开发平台。
  25. 通过 SuperMap iClient 8C(2017) for JavaScript,无需任何插件,便可以在浏览器上实现美观的地图展现,内容丰富的地图应用。
  26. </p>
  27. <p>
  28. 近些年来随着智能终端的迅速发展,LBS 应用的大众化普及,手机地图已经在日常生活中扮演着不可或缺的作用。
  29. 相比传统的 PC 端地图应用,手机地图的应用具有便于携带、
  30. 便于操作、不受空间约束等优势,移动终端这些全新的用户体验是也是传统 PC 所无法媲美。正是在这种背景下,
  31. SuperMap iClient 8C(2017) for JavaScript 提供了对手机平台的扩展支持。
  32. </p>
  33. <p>
  34. SuperMap iClient 8C(2017) for JavaScript 提供的 APP 应用插件,
  35. 在技术上采用 PhoneGap 开源开发框架,针对 PhoneGap 进行了代码兼容和优化,
  36. 并实现了地图离线缓存的插件化支持。通过 SuperMap iClient 8C(2017) for JavaScript 开发平台,
  37. 你可以通过 HTML,CSS 和 JavaScript 技术构建出基于浏览器的地图应用;通过 PhoneGap 开发框架,你可以将已有的地图应用直接打包生成支持 Android 的应用程序,
  38. 并且可以调用系统级别的功能来丰富应用;通过 SuperMap iClient 8C(2017) for JavaScript 提供的 APP 应用插件,地图应用具备离线缓存的功能,满足用户在离线状态下的地图应用。 这样,
  39. Web 开发人员利用已有的技术储备,不需要太多的额外学习成本就可以快速的开发出自己的地图 APP 应用。
  40. 该开发模式具有如下一些特点:
  41. </p>
  42. <p>
  43. <ul style="list-style-type:disc;">
  44. <li>APP应用摆脱浏览器的束缚,提供定制化的地图应用,具有较好的用户体验</li>
  45. <li>利用已有的Web技术,不需要考虑繁杂的底层技术</li>
  46. <li>支持多种手机平台</li>
  47. <li>支持通过 js 调用系统级接口,比如摄像头,GPS 等</li>
  48. <li>支持地图离线缓存</li>
  49. </ul>
  50. </p>
  51. <h2>二、SuperMap JavaScript for Android APP 入门简介</h2>
  52. <p>
  53. 该文档介绍了基于SuperMap iClient 8C(2017) for JavaScript 开发平台生成的的地图应用,如何生成 Android 的应用程序的完整教程,
  54. 该地图应用具备地图浏览,缩放,离线缓存等基本功能,用户可以在此基础上增加自己的业务需求,
  55. 丰富地图应用。该示例在开发包范例中可以获取。
  56. </p>
  57. <ol>
  58. <li>安装 SDK,安装开发环境
  59. <ul style="list-style-type:disc;">
  60. <li>下载并解压 <a target="new" href="http://www.supermap.com.cn/sup/download_view.asp?id=578&bid=1">SuperMap
  61. iClient 8C(2017) for JavaScript</a></li>
  62. <li>下载并安装 <a target="new" href="http://www.eclipse.org/downloads/">Eclipse Classic</a></li>
  63. <li>下载并安装 <a target="new" href="http://developer.android.com/sdk/index.html">Android SDK</a></li>
  64. <li>下载并安装 <a target="new" href="http://developer.android.com/sdk/eclipse-adt.html#installing">ADT Plugin</a>
  65. </li>
  66. </ul>
  67. </li>
  68. <li>Android工程创建
  69. <ul style="list-style-type:disc;">
  70. <li>打开Eclipse,新建Android工程,如下图(Application Name: SuperPhone、Package Name: com.supermap.javascript、Create
  71. Activity: SuperPhoneActivity),点击Finish完成(备注:因为Eclipse版本不同,新建工程的布局可能会略有不同)<br/>
  72. <div class="pageImage"><img src="./images/new project.png"/></div>
  73. </li>
  74. <li>Android 工程下新建文件夹: /assets/www 及 /libs</li>
  75. <li>将 SuperMap iClient 8C(2017) for JavaScript 开发包中的 resource/PhoneGap/clouddemo文件夹中的内容拷贝至 Android 工程下的
  76. /assets/www 位置
  77. </li>
  78. <li>将 SuperMap iClient 8C(2017) for JavaScript 开发包中 resource/PhoneGap/libs 文件夹中的armeabi文件夹以及
  79. cordova-2.5.0.jar、locSDK_3.1.jar、SMCore.jar 和 SMPlugins.jar 拷贝至 Android 工程下的 /libs 位置
  80. </li>
  81. <li>添加 jar 包(cordova-2.5.0.jar、locSDK_3.1.jar、SMCore 和 SMPlugins)到 Android 工程中<br/>
  82. <div class="pageImage"><img src="./images/buildPath.png"/></div>
  83. </li>
  84. <li>将 SuperMap iClient 8C(2017) for JavaScript 开发包中 resource/PhoneGap/res 文件夹中的 xml 文件夹拷贝至 Android 工程下的 /res 位置
  85. </li>
  86. <li>将 SuperMap iClient 8C(2017) for JavaScript 开发包中的 resource/PhoneGap/res 文件夹中的 splash.png 拷贝至 Android 工程下的
  87. /res/drawable-hdpi 位置
  88. </li>
  89. <li>修改 AndroidManifest.xml在Activity中加入<strong> android:windowSoftInputMode="adjustPan"
  90. android:configChanges="orientation|keyboardHidden"</strong>属性
  91. </li>
  92. <li>修改 AndroidManifest.xml在application中加入<strong> android:name="com.supermap.plugins.Location"</strong></li>
  93. <li>在application节点下增加代码
  94. <div style="border-bottom: silver 1px solid; text-align: left; border-left: silver 1px solid; padding-bottom: 4px; line-height: 12pt; background-color: #f4f4f4; margin: 20px 0px 10px; padding-left: 4px; width: 97.5%; padding-right: 4px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; max-height: 400px; font-size: 8pt; overflow: auto; border-top: silver 1px solid; cursor: text; border-right: silver 1px solid; padding-top: 4px">
  95. <div style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px">
  96. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  97. style="color: #606060"> </span>&lt;service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote" &gt;</pre>
  98. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  99. style="color: #606060"> </span>&lt;/service&gt;</pre>
  100. </div>
  101. </div>
  102. </li>
  103. <li>修改 AndroidManifest.xml 权限,添加如下内容,修改代码访问权限
  104. <br/>
  105. <div style="border-bottom: silver 1px solid; text-align: left; border-left: silver 1px solid; padding-bottom: 4px; line-height: 12pt; background-color: #f4f4f4; margin: 20px 0px 10px; padding-left: 4px; width: 97.5%; padding-right: 4px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; max-height: 400px; font-size: 8pt; overflow: auto; border-top: silver 1px solid; cursor: text; border-right: silver 1px solid; padding-top: 4px"
  106. id="codeSnippetWrapper">
  107. <div style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"
  108. id="codeSnippet">
  109. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  110. style="color: #606060" id="lnum1"> </span> &lt;supports-screens</pre>
  111. <!--CRLF-->
  112. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  113. style="color: #606060" id="lnum2"> </span> android:largeScreens=<span
  114. style="color: #006080">&quot;true&quot;</span></pre>
  115. <!--CRLF-->
  116. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  117. style="color: #606060" id="lnum3"> </span> android:normalScreens=<span
  118. style="color: #006080">&quot;true&quot;</span></pre>
  119. <!--CRLF-->
  120. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  121. style="color: #606060" id="lnum4"> </span> android:smallScreens=<span
  122. style="color: #006080">&quot;true&quot;</span></pre>
  123. <!--CRLF-->
  124. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  125. style="color: #606060" id="lnum5"> </span> android:resizeable=<span
  126. style="color: #006080">&quot;true&quot;</span></pre>
  127. <!--CRLF-->
  128. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  129. style="color: #606060" id="lnum6"> </span> android:anyDensity=<span
  130. style="color: #006080">&quot;true&quot;</span></pre>
  131. <!--CRLF-->
  132. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  133. style="color: #606060" id="lnum7"> </span> /&gt;</pre>
  134. <!--CRLF-->
  135. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  136. style="color: #606060" id="lnum8"> </span> &lt;uses-permission android:name=<span
  137. style="color: #006080">&quot;android.permission.CAMERA&quot;</span> /&gt;</pre>
  138. <!--CRLF-->
  139. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  140. style="color: #606060" id="lnum9"> </span> &lt;uses-permission android:name=<span
  141. style="color: #006080">&quot;android.permission.VIBRATE&quot;</span> /&gt;</pre>
  142. <!--CRLF-->
  143. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  144. style="color: #606060" id="lnum10"> </span> &lt;uses-permission android:name=<span
  145. style="color: #006080">&quot;android.permission.ACCESS_COARSE_LOCATION&quot;</span> /&gt;</pre>
  146. <!--CRLF-->
  147. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  148. style="color: #606060" id="lnum11"> </span> &lt;uses-permission android:name=<span
  149. style="color: #006080">&quot;android.permission.ACCESS_FINE_LOCATION&quot;</span> /&gt;</pre>
  150. <!--CRLF-->
  151. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  152. style="color: #606060" id="lnum12"> </span> &lt;uses-permission android:name=<span
  153. style="color: #006080">&quot;android.permission.ACCESS_LOCATION_EXTRA_COMMANDS&quot;</span> /&gt;</pre>
  154. <!--CRLF-->
  155. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  156. style="color: #606060" id="lnum13"> </span> &lt;uses-permission android:name=<span
  157. style="color: #006080">&quot;android.permission.READ_PHONE_STATE&quot;</span> /&gt;</pre>
  158. <!--CRLF-->
  159. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  160. style="color: #606060" id="lnum14"> </span> &lt;uses-permission android:name=<span
  161. style="color: #006080">&quot;android.permission.INTERNET&quot;</span> /&gt;</pre>
  162. <!--CRLF-->
  163. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  164. style="color: #606060" id="lnum15"> </span> &lt;uses-permission android:name=<span
  165. style="color: #006080">&quot;android.permission.RECEIVE_SMS&quot;</span> /&gt;</pre>
  166. <!--CRLF-->
  167. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  168. style="color: #606060" id="lnum16"> </span> &lt;uses-permission android:name=<span
  169. style="color: #006080">&quot;android.permission.RECORD_AUDIO&quot;</span> /&gt;</pre>
  170. <!--CRLF-->
  171. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  172. style="color: #606060" id="lnum17"> </span> &lt;uses-permission android:name=<span
  173. style="color: #006080">&quot;android.permission.MODIFY_AUDIO_SETTINGS&quot;</span> /&gt;</pre>
  174. <!--CRLF-->
  175. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  176. style="color: #606060" id="lnum18"> </span> &lt;uses-permission android:name=<span
  177. style="color: #006080">&quot;android.permission.READ_CONTACTS&quot;</span> /&gt;</pre>
  178. <!--CRLF-->
  179. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  180. style="color: #606060" id="lnum19"> </span> &lt;uses-permission android:name=<span
  181. style="color: #006080">&quot;android.permission.WRITE_CONTACTS&quot;</span> /&gt;</pre>
  182. <!--CRLF-->
  183. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  184. style="color: #606060" id="lnum20"> </span> &lt;uses-permission android:name=<span
  185. style="color: #006080">&quot;android.permission.WRITE_EXTERNAL_STORAGE&quot;</span> /&gt;</pre>
  186. <!--CRLF-->
  187. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  188. style="color: #606060" id="lnum21"> </span> &lt;uses-permission android:name=<span
  189. style="color: #006080">&quot;android.permission.ACCESS_NETWORK_STATE&quot;</span> /&gt;</pre>
  190. <!--CRLF-->
  191. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: #f4f4f4; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  192. style="color: #606060" id="lnum22"> </span> &lt;uses-permission android:name=<span
  193. style="color: #006080">&quot;android.permission.KILL_BACKGROUND_PROCESSES&quot;</span>/&gt;</pre>
  194. <!--CRLF--></div>
  195. <pre style="border-bottom-style: none; text-align: left; padding-bottom: 0px; line-height: 12pt; border-right-style: none; background-color: white; margin: 0em; padding-left: 0px; width: 100%; padding-right: 0px; font-family: &#39;Courier New&#39;, courier, monospace; direction: ltr; border-top-style: none; color: black; font-size: 8pt; border-left-style: none; overflow: visible; padding-top: 0px"><span
  196. style="color: #606060" id="lnum23"> </span> &lt;uses-permission android:name=<span
  197. style="color: #006080">&quot;android.permission.ACCESS_WIFI_STATE&quot;</span> /&gt;</pre>
  198. <!--CRLF-->
  199. </div>
  200. <p>AndroidManifest.xml 文件内容最后效果如下图,注意红色框选区域的内容为我们所添加</p>
  201. <div class="pageImage"><img src="./images/androidmanifest.png"/></div>
  202. </li>
  203. </ul>
  204. </li>
  205. <li>代码说明
  206. <ul style="list-style-type:disc;">
  207. <li>拷贝如下代码替换 SuperPhoneActivity.java 代码,可参考代码注释
  208. <pre>
  209. package com.supermap.javascript;
  210. import org.apache.cordova.DroidGap;
  211. import org.json.JSONException;
  212. import android.app.ActivityManager;
  213. import android.os.Bundle;
  214. import com.supermap.RequestControl;
  215. // 继承自PhoneGap的DroidGap类,实现WebView和WebKit的相互通信
  216. public class SuperPhoneActivity extends DroidGap {
  217. /** Called when the activity is first created. */
  218. @Override
  219. public void onCreate(Bundle savedInstanceState) {
  220. super.onCreate(savedInstanceState);
  221. super.setIntegerProperty("splashscreen", R.drawable.splash);
  222. // 加载clouddemo文件夹下的index页面
  223. super.loadUrl("file:///android_asset/www/index.html", 5000);
  224. try {
  225. RequestControl.init(this);
  226. } catch (JSONException e) {
  227. e.printStackTrace();
  228. }
  229. }
  230. // PhoneGap缺陷,需要再次强制退出,释放内存
  231. public void onDestroy() {
  232. finish();
  233. super.onDestroy();
  234. ActivityManager activityManger = (ActivityManager) this
  235. .getSystemService(ACTIVITY_SERVICE);
  236. try {
  237. activityManger.restartPackage("com.supermap.javascript");
  238. activityManger.restartPackage("com.supermap");
  239. activityManger.restartPackage("com.supermap.plugins");
  240. } catch (Exception e) {
  241. System.out.println(e.getMessage());
  242. }
  243. System.exit(0);
  244. }
  245. }
  246. </pre>
  247. </li>
  248. <li>index.html 代码说明,可参考代码注释
  249. <pre>
  250. // 等待加载PhoneGap,增加监听事件onDeviceReady
  251. document.addEventListener("deviceready", onDeviceReady, false);
  252. // PhoneGap加载完毕后会调用此事件,用户在此进行初始化设置
  253. function onDeviceReady() {
  254. init();
  255. }
  256. function init() {
  257. SuperMap.Util.setApp(true);
  258. map = new SuperMap.Map("map", { controls: [
  259. new SuperMap.Control.ScaleLine(),
  260. new SuperMap.Control.PanZoomBar(),
  261. new SuperMap.Control.Navigation({
  262. dragPanOptions: {
  263. enableKinetic: true
  264. }
  265. })], units: "m"
  266. });
  267. layer = new SuperMap.Layer.CloudLayer();
  268. markerLayer = new SuperMap.Layer.Markers("Markers");
  269. map.addLayers([layer,markerLayer]);
  270. map.setCenter(new SuperMap.LonLat(12957031.21685,4861858.2410885), 10);
  271. }
  272. </pre>
  273. </li>
  274. </ul>
  275. </li>
  276. <li>右键单击项目节点选择 Run As,然后点击 Android Application,bin 目录下生成 APK 文件并在指定模拟器上运行</li>
  277. </ol>
  278. <h2>三、离线缓存简介</h2>
  279. <p>
  280. SuperMap iClient 8C(2017) for JavaScript 支持 APP 应用离线缓存功能,提供离线图片缓存和离线MBTile缓存两种方式,默认状态下为离线图片缓存方式。
  281. </p>
  282. <p>
  283. 离线图片缓存主要由两部分组成,config 文件用来记录地图服务的配置属性,缓存数据则保存在移动设备中SDCard\SuperMap下以地图名命名的文件夹中。
  284. </p>
  285. <div class="pageImage"><img src="./images/localstorage.PNG"/></div>
  286. <p>
  287. 如上图,逻辑部分仍然由 JavaScript 层面处理,Java 层面只负责下载图片的功能部分。当需要创建新的瓦块图片时,JS 已异步的方式向 Java 通信,
  288. Java 将网络 Url 的图片以多线程的方式保存到本地,然后再以异步方式返回本地的 Image 路径,然后如下的逻辑不变,仍然由 JavaScript 来实现。
  289. 整个离线缓存采用边浏览边下载的策略,通过异步的方式在Java层下载缓存数据,不会影响用户体验。
  290. </p>
  291. <p>
  292. 离线MBTile缓存也由两部分组成,index文件用来记录地图服务的配置属性,MBTile缓存数据则直接放在移动设备中SDCard\SuperMap下即可。其中MBTile文件可通过iserver的预缓存功能获取,index文件下的服务配置如下图所示:
  293. </p>
  294. <pre>
  295. /*
  296. * 服务的名称"world"必须和MBTile文件的名称相同;
  297. * 实例化服务的时候必须增加"storageType"属性,并将该属性的值设为"db"(若将该值设为"File"则表示使用离线图片缓存方式)。
  298. */
  299. layer = new SuperMap.Layer.TiledDynamicRESTLayer(<span style="color:red">"world"</span>,
  300. url,
  301. {transparent:true,cacheEnabled:true},
  302. {maxResolution:"auto",<span style="color:red">"storageType":"db"</span>});
  303. </pre>
  304. <h2>四、示例效果图的展示</h2>
  305. <p>
  306. 通过上面的示例,我们就可以快捷的基于已有的 Web 技术,快速生成带有离线缓存功能的地图应用,
  307. 在这基础上,你可以通过 SuperMap iClient 8C(2017) for JavaScript 提供的脚本,实现查询,绘制等地图展现,
  308. 通过 SuperMap iServer 的 REST 服务进行地图网络分析,叠加分析等地图分析,也可以通过调用系统接口来实现 GPS 定位,天气查询等地图服务,
  309. 这样,你就可以定制化的实现你期望的丰富的移动地图应用。
  310. <div class="pageImage"><img src="./images/demo.png"/></div>
  311. </p>
  312. </div>
  313. <div class='footer'>
  314. <p>版权所有&nbsp;&copy; 2000-2016 &nbsp;北京超图软件股份有限公司</p>
  315. </div>
  316. </div>
  317. <script src='./js/jquery.js'></script>
  318. <script src='./js/bootstrap.js'></script>
  319. <script src="./js/navbar.js"></script>
  320. <script src="./js/GoTop.js" id="js_gotop"></script>
  321. </body>
  322. </html>