鸿蒙-webview的使用和JS交互(附源码)

简介: 日常我们在开发项目时,为了项目快速的开发和迭代,难免会用到H5页面。使用鸿蒙进行项目开发时,也一样免不了要加载H5页面,在移动开发中打开H5页面需要使用WebView组件。同时,为了和H5页面进行数据交换,有时候还需要借助JSBridge来实现客户端与H5之间的通讯。那么鸿蒙之中用到的技术是什么呢?WebView在此之前,先看一个报错​ App Launch: The Huawei Lite Simulator supports only Lite projects.

日常我们在开发项目时,为了项目快速的开发和迭代,难免会用到H5页面。使用鸿蒙进行项目开发时,也一样免不了要加载H5页面,在移动开发中打开H5页面需要使用WebView组件。同时,为了和H5页面进行数据交换,有时候还需要借助JSBridge来实现客户端与H5之间的通讯。


那么鸿蒙之中用到的技术是什么呢?WebView


在此之前,先看一个报错

App Launch: The Huawei Lite Simulator supports only Lite projects.


image.png

image.png

这是什么原因呢,其实简单,就是你没有登陆


image.png


所以解决这个的问题就是你重新登录就好了。


image.png


汉化(V3.0 Beta2(2021-12-31)版本以上支持)

还有一个问题可能就是目前编辑器大家看着不太习惯,需要汉化一下,那么如何汉化呢,结合Androidstudio的经验,分为如下几步


第一步点击File-setting


image.png


第二步plugins里面选择如图所示的插件,并安装。


image.png


第三步,重启,汉化完成


image.png


第一步创建项目

image.png


点击next


image.png


第二步等依赖安装安装完成

第三步打开模拟器

image.png


点击登录,打开浏览器授权


image.png


选择p40


image.png


启动模拟器


image.png


第五步开始正文

接下来开始正文。


应用预览:

点击"打开网址"按钮会加载上方网址的Web页面,通过后退"和"前进"按钮实现Web页面间的导航。

点击"加载本地网页"按钮加载本地Web页面,点击"发送消息给本地html"或者Web页面中的"调用Java方法"按钮,实现应用与Web页面间的交互。

1.gif


这里是http访问方式,鸿蒙的默认是https访问模式,如果您的请求网址是http开头的,可以继续查看后面的教程。

image.png

1. 增加一个WebView组件

步骤 1 - 在"resources/base/layout/ability_main.xml"文件中创建WebView,示例代码如下:

<ohos.agp.components.webengine.WebView 
    ohos:id="$+id:webview" 
    ohos:height="match_parent" 
    ohos:width="match_parent"> 
</WebView>

步骤 2 - 在"slice/MainAbilitySlice.java"文件中通过如下方式获取WebView对象,示例代码如下:

WebView webview = (WebView) findComponentById(ResourceTable.Id_webview);

2. 通过WebView加载Web页面

WebView加载页面分为加载Web页面和加载本地Web页面两种情况,接下来我们将分别进行介绍。


1.WebView加载网络Web页面

跟Android类似,要访问网络,我们首先要配置网络访问权限,在config.json的"module"节点最后,添加上网络权限代码

module": { 
...... 
"reqPermissions": [ 
{ 
   "name": "ohos.permission.INTERNET" 
 } 
] 
}

2 设置访问模式

鸿蒙的默认是https访问模式,如果您的请求网址是http开头的,请在config.json文件中的deviceConfig下,添加如下设置

"deviceConfig": {
    "default": {
      "network": {
        "cleartextTraffic": true
      }
    }
  },

在"slice/MainAbilitySlice.java"文件中通过webview.load(String url)方法访问具体的Web页面,通过WebConfig类对WebView组件的行为进行配置,示例代码如下:

WebConfig webConfig = webview.getWebConfig(); 
// WebView加载URL,其中urlTextField为输入URL的TextField组件 
webview.load(urlTextField.getText());

在Web页面进行链接跳转时,WebView默认会打开目标网址,通过WebAgent对象可以定制该行为,示例代码如下:

webview.setWebAgent(new WebAgent() { 
            @Override 
            public boolean isNeedLoadUrl(WebView webView, ResourceRequest request) { 
                if (request == null || request.getRequestUrl() == null) { 
                    LogUtil.info(TAG,"WebAgent isNeedLoadUrl:request is null."); 
                    return false; 
                } 
                String url = request.getRequestUrl().toString(); 
                if (url.startsWith("http:") || url.startsWith("https:")) { 
                    webView.load(url); 
                    return false; 
                } else { 
                    return super.isNeedLoadUrl(webView, request); 
                } 
            } 
        });

除此之外,WebAgent对象还提供了相关的回调函数以观测页面状态的变更,如onLoadingPage、onPageLoaded、onError等方法。WebView提供Navigator类进行历史记录的浏览和处理,通过getNavigator()方法获取该类的对象,使用canGoBack()或canGoForward()方法检查是否可以向后或向前浏览,使用goBack()或goForward()方法向后或向前浏览,示例代码如下:

Navigator navigator = webView.getNavigator(); 
if (navigator.canGoBack()) { 
    navigator.goBack(); 
} 
if (navigator.canGoForward()) { 
    navigator.goForward(); 
}

3.WebView加载本地Web页面

将本地的HTML文件放在"resources/rawfile/"目录下,在本教程中命名为test.html。在HarmonyOS系统中,WebView要访问本地Web文件,需要通过DataAbility的方式进行访问,DataAbility的具体使用方法可以参考开发


DataAbility,关于DataAbility的相关知识,后面也会继续展示,谁让他是最重要的内容呢。


在"entry/src/main/config.json"中完成DataAbility的声明,示例代码如下:

module": { 
...... 
"abilities": [ 
{ 
  "name": "com.huawei.codelab.DataAbility", 
  "type": "data", 
  "uri": "dataability://com.example.harmonyosdemo.DataAbility" 
} 
] 
}

另外需要实现一个DataAbility,通过实现openRawFile(Uri uri, String mode)方法,完成WebView对本地Web页面的访问,示例代码如下:

public class DataAbility extends Ability { 
    ... 
    @Override 
    public RawFileDescriptor openRawFile(Uri uri, String mode) throws FileNotFoundException { 
        if (uri == null) {; 
            return super.openRawFile(uri, mode); 
        } 
        String path = uri.getEncodedPath(); 
        int splitIndex = path.indexOf('/', 1); 
        String providerName = Uri.decode(path.substring(1, splitIndex)); 
        String rawFilePath = Uri.decode(path.substring(splitIndex + 1)); 
        RawFileDescriptor rawFileDescriptor = null; 
        try { 
            rawFileDescriptor = getResourceManager().getRawFileEntry(rawFilePath).openRawFileDescriptor(); 
        } catch (IOException e) { 
            // 异常处理 
        } 
        return rawFileDescriptor; 
    } 
}

在"slice/MainAbilitySlice.java"中声明需要访问的文件路径,通过webview.load(String url)方法加载本地Web页面,可以通过WebConfig类的对象对WebView访问DataAbility的能力进行配置,示例代码如下:

private static final String URL_LOCAL = "dataability://com.huawei.codelab.DataAbility/resources/rawfile/test.html"; 
// 配置是否支持访问DataAbility资源,默认为true 
webConfig.setDataAbilityPermit(true); 
webview.load(URL_LOCAL);

4. 实现应用与WebView中的Web页面间的通信

本教程以本地Web页面"resources/rawfile/test.html"为例介绍如何实现应用与WebView中的Web页面间交互。

首先需要对WebConfig进行配置,使能WebView与Web页面JavaScript交互的能力,示例代码如下:

// 配置是否支持JavaScript,默认值为false 
webConfig.setJavaScriptPermit(true);

1.应用调用Web页面

在"resources/rawfile/test.html"中编写callJS方法,待应用调用,示例代码如下:

<script type="text/javascript"> 
// 应用调用Web页面 
function callJS(message) { 
    alert(message); 
} 
</script>

在"slice/MainAbilitySlice.java"中实现应用对JavaScript的调用,示例代码如下:

webview.executeJs("javascript:callJS('这是来自JavaSlice的消息')", msg -> { 
        // 在这里处理Js的方法的返回值 
    });

我们可以通过setBrowserAgent方法设置自定义BrowserAgent对象,以观测JavaScript事件及通知等,通过复写onJsMessageShow方法来接管Web页面弹出Alert对话框的事件,示例代码如下:

webview.setBrowserAgent(new BrowserAgent(this) { 
            @Override 
            public boolean onJsMessageShow(WebView webView, String url, String message, boolean isAlert, JsMessageResult result) { 
                LogUtil.info(TAG,"BrowserAgent onJsMessageShow : " + message); 
                if (isAlert) { 
                    // 将Web页面的alert对话框改为ToastDialog方式提示 
                    new ToastDialog(getApplicationContext()).setText(message).setAlignment(LayoutAlignment.CENTER).show(); 
                    // 对弹框进行确认处理 
                    result.confirm(); 
                    return true; 
                } else { 
                    return super.onJsMessageShow(webView, url, message, isAlert, result); 
                } 
            } 
        });

2.Web页面使用JavaScript调用应用

在"resources/rawfile/test.html"中编写按钮,当按钮被点击时实现JavaScript对应用的调用,示例代码如下:

<body> 
<button id="button" onclick="sendData()" style="background-color:#70DBDB;height:30px;">调用Java方法</button> 
<script type="text/javascript"> 
  function sendData() { 
    if (window.JsCallJava && window.JsCallJava.call) { 
        // Web页面调用应用 
        var rst = window.JsCallJava.call("这个是来自本地Web页面的消息"); 
    } else { 
        alert('发送消息给WebviewSlice失败'); 
    } 
  } 
</script> 
</body>

在"slice/MainAbilitySlice.java"中实现应用对JavaScript发起的调用的响应,示例代码如下:

private static final String JS_NAME = "JsCallJava"; 
webview.addJsCallback(JS_NAME, str -> { 
  // 处理接收到的JavaScript发送来的消息,本教程通过ToastDialog提示确认收到Web页面发来的消息 
  new ToastDialog(this).setText(str).setAlignment(LayoutAlignment.CENTER).show(); 
  // 返回给JavaScript 
  return "Js Call Java Success"; 
});

总结

通过上面的完整代码,我们已经完成了webbiew的基本使用


仓库地址:https://github.com/ITmxs/hm_webview


第二步删除默认代码

打开index.hml文件,里面有默认代码如下:


山茶

1

第三步,开始学习

首先将图片放到common文件夹下面的images里面,注意,我的图片文件名是flutter.png,


从上面布局效果图可以看到,界面主要由image组件和text组件组成,我们现在index.html中添加image组件和text组件,并添加对应的class,用于设置组件的显示效果,代码如下:

<div class="container">
    <image class="img img-translate" src="/common/images/flutter.png"></image>
    <text class="text">translate</text>
    <image class="img img-rotate" src="/common/images/flutter.png"></image>
    <text class="text">rotate</text>
    <image class="img img-rotateY" src="/common/images/flutter.png"></image>
    <text class="text">rotateY</text>
    <image class="img img-scale" src="/common/images/flutter.png"></image>
    <text class="text">scale</text>
    <image class="img img-opacity" src="/common/images/flutter.png"></image>
    <text class="text">opacity</text>
</div>

第四步,为页面设计样式

在这个任务中,我们将一起为任务二中写好的页面添加样式,上面所有的组件都定义了class属性,它对应的样式都定义在index.css中,有关css更多的知识可以参考css语法参考。

这部分定义了整个页面中各个组件的样式。在index.css中先添加如下代码:

.container { 
    background-color: #F8FCF5; 
    flex-direction: column; 
    justify-content: center; 
    align-items: center; 
} 
.img { 
    margin-top: 10px; 
    height: 100px; 
    width: 100px; 
    animation-timing-function: ease; 
    animation-duration: 2s; 
    animation-delay: 0s; 
    animation-fill-mode: forwards; 
    animation-iteration-count: infinite; 
} 
.text { 
    font-size: 20px; 
} 
.img-translate { 
    animation-name: translateAnim; 
} 
.img-rotate { 
    animation-name: rotateAnim; 
} 
.img-rotateY { 
    animation-name: rotateYAnim; 
} 
.img-scale { 
    animation-name: scaleAnim; 
} 
.img-mixes { 
    animation-name: mixesAnim; 
} 
.img-opacity { 
    animation-name: opacityAnim; 
} 
/*从-100px平移到100px*/ 
@keyframes translateAnim { 
    from { 
        transform: translate(-100px); 
    } 
    to { 
        transform: translate(100px); 
    } 
} 
/*从0°旋转到360°*/ 
@keyframes rotateAnim { 
    from { 
        transform: rotate(0deg); 
    } 
    to { 
        transform: rotate(360deg); 
    } 
} 
/*沿Y轴旋转,从0°旋转到360°*/ 
@keyframes rotateYAnim { 
    from { 
        transform: rotateY(0deg); 
    } 
    to { 
        transform: rotateY(360deg); 
    } 
} 
/*从0倍缩放到1.2倍大小*/ 
@keyframes scaleAnim { 
    from { 
        transform: scale(0); 
    } 
    to { 
        transform: scale(1.2); 
    } 
} 
/*透明度从0变化到1*/ 
@keyframes opacityAnim { 
    from { 
        opacity: 0; 
    } 
    to { 
        opacity: 1; 
    } 
}

通过一个代码示例,实现image组件的平移、缩放、旋转和透明度变化动效。希望通过本教程,各位开发者可以对JS通用动画样式具有更深刻的认识。


image.png


在实现过程过也遇到一些问题,顺便做个记录

使用标签引入的本地图片无法加载


使用标签引入本地图片,但图片无法加载的可能情况有三种:


没有给图片设置宽度和高度,需要在对应的“page”目录下的 css 样式文件中设置图 片的宽高。

使用标签的图片不会自动缩放,图片宽高超过组件的宽高会自动 截取。

图片引入路径错误。图片引入的路径必须是项目编译后的静态文件的路径。  在导入图片或添加/删除页面后没有重新编译。

参考

动画样式:


https://developer.huawei.com/consumer/cn/codelabsPortal/carddetails/HarmonyOS-WebView


https://flutter.cn/docs/cookbook/design/themes


目录
打赏
0
0
0
0
73
分享
相关文章
Midscene.js:AI 驱动的 UI 自动化测试框架,支持自然语言交互,生成可视化报告
Midscene.js 是一款基于 AI 技术的 UI 自动化测试框架,通过自然语言交互简化测试流程,支持动作执行、数据查询和页面断言,提供可视化报告,适用于多种应用场景。
738 1
Midscene.js:AI 驱动的 UI 自动化测试框架,支持自然语言交互,生成可视化报告
HarmonyOS NEXT 5.0鸿蒙开发一套影院APP(附带源码)
本项目基于HarmonyOS NEXT 5.0开发了一款影院应用程序,主要实现了电影和影院信息的展示功能。应用包括首页、电影列表、影院列表等模块。首页包含轮播图与正在热映及即将上映的电影切换显示;电影列表模块通过API获取电影数据并以网格形式展示,用户可以查看电影详情;影院列表则允许用户选择城市后查看对应影院信息,并支持城市选择弹窗。此外,项目中还集成了Axios用于网络请求,并进行了二次封装以简化接口调用流程,同时添加了请求和响应拦截器来处理通用逻辑。整体代码结构清晰,使用了组件化开发方式,便于维护和扩展。 该简介概括了提供的内容,但请注意实际开发中还需考虑UI优化、性能提升等方面的工作。
129 11
JavaScript 与 DOM 交互的基础及进阶技巧,涵盖 DOM 获取、修改、创建、删除元素的方法,事件处理,性能优化及与其他前端技术的结合,助你构建动态交互的网页应用
本文深入讲解了 JavaScript 与 DOM 交互的基础及进阶技巧,涵盖 DOM 获取、修改、创建、删除元素的方法,事件处理,性能优化及与其他前端技术的结合,助你构建动态交互的网页应用。
96 5
聊聊 Go 语言中的 JSON 序列化与 js 前端交互类型失真问题
在Web开发中,后端与前端的数据交换常使用JSON格式,但JavaScript的数字类型仅能安全处理-2^53到2^53间的整数,超出此范围会导致精度丢失。本文通过Go语言的`encoding/json`包,介绍如何通过将大整数以字符串形式序列化和反序列化,有效解决这一问题,确保前后端数据交换的准确性。
86 4
鸿蒙next版开发:分析JS Crash(进程崩溃)
在HarmonyOS 5.0中,JS Crash指未处理的JavaScript异常导致应用意外退出。本文详细介绍如何分析JS Crash,包括异常捕获、日志分析和典型案例,帮助开发者定位问题、修复错误,提升应用稳定性。通过DevEco Studio收集日志,结合HiChecker工具,有效解决JS Crash问题。
138 4
【JavaScript】网页交互的灵魂舞者
本文介绍了 JavaScript 的三种引入方式(行内、内部、外部)和基础语法,包括变量、数据类型、运算符、数组、函数和对象等内容。同时,文章还详细讲解了 jQuery 的基本语法和常用方法,如 `text()`、`html()`、`val()`、`attr()` 和 `css()` 等,以及如何插入和删除元素。通过示例代码和图解,帮助读者更好地理解和应用这些知识。
61 1
【JavaScript】网页交互的灵魂舞者
揭秘!前端大牛们如何巧妙利用JavaScript,打造智能交互体验!
【10月更文挑战第30天】前端开发领域充满了无限可能与创意,JavaScript作为核心语言,凭借强大的功能和灵活性,成为打造智能交互体验的重要工具。本文介绍前端大牛如何利用JavaScript实现平滑滚动、复杂动画、实时数据更新和智能表单验证等效果,展示了JavaScript的多样性和强大能力。
106 4
Flutter&鸿蒙next 中如何实现 WebView【跳、显、适、反】等一些基础问题
在 Flutter 项目中集成 WebView 可以展示网页或进行在线操作。本文介绍了如何添加依赖、配置平台权限、创建 WebView 页面、适配不同机型、处理页面间参数传递等详细步骤,帮助开发者高效实现 WebView 功能,提升用户体验。
252 4
鸿蒙Flutter实战:04-如何使用DevTools调试Webview
本文介绍如何在鸿蒙 Flutter 开发中调试 Webview,包括配置允许调试、找到 devtools 端口、开启端口转发、在 Chrome 中调试 Webview等。
119 0
鸿蒙Flutter实战:04-如何使用DevTools调试Webview
鸿蒙Flutter实战:03-鸿蒙Flutter开发中集成Webview
本文介绍了在OpenHarmony平台上集成WebView的两种方法:一是使用第三方库`flutter_inappwebview`,通过配置pubspec.lock文件实现;二是编写原生ArkTS代码,自定义PlatformView,涉及创建入口能力、注册视图工厂、处理方法调用及页面构建等步骤。
127 0

热门文章

最新文章

  • 1
    原生鸿蒙版小艺APP接入DeepSeek-R1,为HarmonyOS应用开发注入新活力
    21
  • 2
    【01】噩梦终结flutter配安卓android鸿蒙harmonyOS 以及next调试环境配鸿蒙和ios真机调试环境-flutter项目安卓环境配置-gradle-agp-ndkVersion模拟器运行真机测试环境-本地环境搭建-如何快速搭建android本地运行环境-优雅草卓伊凡-很多人在这步就被难倒了
    28
  • 3
    APP-国内主流安卓商店-应用市场-鸿蒙商店上架之必备前提·全国公安安全信息评估报告如何申请-需要安全评估报告的资料是哪些-优雅草卓伊凡全程操作
    14
  • 4
    EMAS 性能分析全面适配HarmonyOS NEXT,开启原生应用性能优化新纪元
    8
  • 5
    鸿蒙开发:了解@Builder装饰器
    7
  • 6
    【04】鸿蒙实战应用开发-华为鸿蒙纯血操作系统Harmony OS NEXT-正确安装鸿蒙SDK-结构目录介绍-路由介绍-帧动画(ohos.animator)书写介绍-能够正常使用依赖库等-ArkUI基础组件介绍-全过程实战项目分享-从零开发到上线-优雅草卓伊凡
    34
  • 7
    【01】鸿蒙实战应用开发-华为鸿蒙纯血操作系统Harmony OS NEXT-项目开发实战-优雅草卓伊凡拟开发一个一站式家政服务平台-前期筹备-暂定取名斑马家政软件系统-本项目前端开源-服务端采用优雅草蜻蜓Z系统-搭配ruoyi框架admin后台-全过程实战项目分享-从零开发到上线
    8
  • 8
    HarmonyOS使用系统图标
    6
  • 9
    鸿蒙原生应用再添新丁!北京广电、充电管家、有我帮 入局鸿蒙
    1
  • 10
    【03】鸿蒙实战应用开发-华为鸿蒙纯血操作系统Harmony OS NEXT-测试hello word效果-虚拟华为手机真机环境调试-为DevEco Studio编译器安装中文插件-测试写一个滑动块效果-介绍诸如ohos.ui等依赖库-全过程实战项目分享-从零开发到上线-优雅草卓伊凡
    5
  • AI助理

    你好,我是AI助理

    可以解答问题、推荐解决方案等