鸿蒙星空的太白星 | WebView给元服务调用JS API指明方向
元服务是华为提供的一种面向未来的服务形态，具有免安装、支持多端运行等特性。在万物互联时代，提供了更丰富的入口、更智能的分发、更高效的转化，助力开发者快速抢占流量入口。
景区类型的元服务，基于用户授权，能准确定位用户地理位置、识别用户停留时长，并可以按照时间维度推荐符合当前场景的信息，为游客带来了服务“找”人的智慧旅游新体验。例如“梦里水乡”元服务，通过HarmonyOS软硬结合的文旅解决方案，利用万能卡片外显景区导览信息，真正做到了个性化游玩。
开发此类元服务过程中通常需要用到地图功能，例如在元服务 的卡片中显示我的位置信息，通过推荐路线选择景区最佳游览路线。通常思路是PageAbility打开自定义地图，查询地图信息（POI）点，做路径规划、路径推荐等。通过卡片中内置导航功能，在景区内帮用户贴心的避开“人从众”。
目前各大厂商的地图能力对HarmonyOS系统的支持参差不齐，都没有提供HarmonyOS直接可用的SDK。商用APP的主体页面通常都是JS类的WEB页面，于是我们一直琢磨如何使用JS API的方式实现元服务的导览功能。最初的思路被局限在通过HarmonyOS的JS集成地图的JS API，但是最终被各种报错折磨得痛苦不堪。秉着“只要思想不滑坡，方法总比问题多”的信念，冥冥中看到了HarmonyOS漆黑星空中那颗最亮的星，Java UI组件之太白星WebView。
WebView组件灯塔般的星光一闪，解决问题的思路灵感乍现。立刻想到了JS类WEB页面通过startAbility跳转到mapAbility，来实现JS页面跳转到Java页面的逻辑。在mapAbility中开发地图页面，妙用Java UI框架中的Webview组件来加载本地Html文件，即可使用Html调用地图JS API接口。
敲黑板，画重点，关键几步听我娓娓道来。
1.准备地图的key。
参考地图厂商的JS API开发指导，申请地图的key，这里以高德地图为例说明。
2.完成WebView组件的初始化。
请认真参考WebView组件文档完成，千万不要跳过。
其中最关键的就是配置应用的网络权限，如果网络权限不对，还想调通JS API，那就等于是奢望。
打开“entry > src > main > config.json”文件，添加如下配置。
"module": {
"reqPermissions": [
{
"name": "ohos.permission.INTERNET"
}]
}
3.新建资源文件。
“资源类型”请选择“Layout”。
布局文件内容中定义地图组件。
示例代码如下：
<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
xmlns:ohos="http://schemas.huawei.com/res/ohos"
ohos:height="match_parent"
ohos:width="match_parent"
ohos:orientation="vertical">
<ohos.agp.components.webengine.WebView
ohos:id="$+id:ability_main_webview"
ohos:height="600vp"
ohos:width="match_parent"
ohos:weight="1"/>
<Text
ohos:height="150vp"
ohos:width="match_parent"
ohos:text="hello map">
</Text>
</DirectionalLayout>4.针对JS类Web开发范式开发的主体页面，使用startAbility跳转到mapAbility，实现从JS页面跳转到Java页面。
说明：开发UI的程序员习惯用JS，所以主体页面通常都是JS的。WebView组件是Java的，所以需要从JS页面跳转到Java页面。
新建mapAbility
示例代码如下：
Intent intent = new Intent();
Operation operation = new Intent.OperationBuilder()
.withBundleName("com.huawei.testjsmap.hmservice")
.withAbilityName("com.huawei.testjsmap.mapAbility")
.build();
intent.setOperation(operation);
startAbility(intent);5.在mapAbility中开发地图页面，Webview加载本地Html文件来调用地图JS API接口。
说明：Java代码开发请参考Java UI框架文档。
在资源文件“resources/rawfile”目录下增加map.html文件，参考地图JS开发指导编写Html文件。
示例代码如下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>创建地图</title>
</head>
<script charset="utf-8" src="https://map.qq.com/api/gljs?v=1.exp&key=准备工作中申请的地图KEY"></script>
<style type="text/css">
html,
body {
height: 100%;
margin: 0px;
padding: 0px;
}
#container {
width: 100%;
height: 100%;
}
</style>
<body onload="initMap()">
<div id="container"></div>
<script type="text/javascript">
function initMap() {
var center = new TMap.LatLng(39.984104, 116.307503);
//初始化地图
var map = new TMap.Map("container", {
rotation: 20,//设置地图旋转角度
pitch:30, //设置俯仰角度（0~45）
zoom:12,//设置地图缩放级别
center: center//设置地图中心点坐标
});
}
</script>
</body>
</html>在mapAbility的onstart方法中直接通过mapview.load打开一个拼装的URI地址： webView.load("https://example.com/rawfile/map.html");
至此问题的迷雾已破开，薄云消散，原本有些阴霾的苍穹，星光璀璨。鸿蒙星空恍若一个巨大的舞台，星有多大，舞台就有多大。剩下的要在元服务中实现哪些业务就看对应地图厂商JS API能力了。
一颗“彩蛋”流星划破天空。
“彩蛋”流星之本地调试技巧：
在webAgent中通过复写processResourceRequest的方式实现本地文件加载，这种方式可以直接通过IDE工具打开Html页面进行调试，调试JS API的效率大大提升。
示例代码如下：
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_map_main);
WebView webView = (WebView) findComponentById(ResourceTable.Id_ability_main_webview);
webView.getWebConfig().setJavaScriptPermit(true);
webView.setWebAgent(new WebAgent() {
@Override
public ResourceResponse processResourceRequest(WebView webview, ResourceRequest request) {
final String authority = "example.com";
final String rawFile = "/rawfile/";
Uri requestUri = request.getRequestUrl();
if (authority.equals(requestUri.getDecodedAuthority())) {
String path = requestUri.getDecodedPath();
if (TextTool.isNullOrEmpty(path)) {
return super.processResourceRequest(webview, request);
}
if (path.startsWith(rawFile)) {
// 根据自定义规则访问资源文件
String rawFilePath = "entry/resources/rawfile/" + path.replace(rawFile, "");
String mimeType = URLConnection.guessContentTypeFromName(rawFilePath);
try {
Resource resource = getResourceManager().getRawFileEntry(rawFilePath).openRawFile();
ResourceResponse response = new ResourceResponse(mimeType, resource, null);
return response;
} catch (IOException e) {
HiLog.info(TAG, "open raw file failed");
}
}
}
return super.processResourceRequest(webview, request);
}
});
webView.load("https://example.com/rawfile/map.html");
}