cordova-plugin-ionic-webview

为 Apache Cordova / Ionic 应用提供

高性能、现代化

的 WebView 解决方案，替代原生 Cordova WebView，优化加载速度、本地资源访问和跨域兼容性，本文档主要说明在OHOS系统中的应用。

🌟 核心特性

• 性能优化：基于 Chrome 内核，加载速度提升 30%+，支持硬件加速

• 本地资源访问：通过 http(s):// 协议高效访问本地文件（HTML/CSS/JS/ 图片等），支持离线缓存

• 跨域友好：内置 CORS 支持，无需额外配置即可实现跨域请求

• 现代化特性：支持 ES6+ 语法、WebGL、Service Worker、WebRTC 等现代 Web 特性

• 安全增强：支持 HTTPS 强制模式、内容安全策略（CSP）、防止混合内容警告

• Ionic 兼容：与 Ionic Framework 深度集成，完美支持 Ionic 应用的路由、动画和组件

• 调试便捷：支持 Chrome DevTools（Android）/ Safari 开发者工具（iOS）远程调试

📦 安装方式

基础安装（推荐）

# 安装hcordova
npm install -g hcordova

# 安装最新稳定版
hcordova plugin add cordova-plugin-ionic-webview

指定版本安装

# 安装特定版本（例如 1.0.0）

hcordova plugin add [email protected] --platform ohos

从 GitCode 安装（开发版）

# 安装主分支最新代码

hcordova plugin add https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-ionic-webview.git --platform ohos

卸载插件

#全平台卸载
hcordova plugin rm cordova-plugin-ionic-webview 
#指定平台卸载
hcordova plugin rm cordova-plugin-ionic-webview --platform ohos

⚙️ 配置说明

1. 基础配置(选配)

默认是使用https://www.example.com加载Rawfile/www/index.html文件

config.cml 配置

<!--配置加载scheme,支持http|https,默认推荐https -->
<preference name="Scheme" value="https" />

<!--配置自定义加载域名 -->
<preference name="Hostname" value="app" />

许可证

本插件基于 Apache License 开源，可自由用于商业和非商业项目。

参考资源

• Android和iOS：cordova-plugin-ionic-webview 官方指南

• GitCode 仓库：OpenHarmony-Cordova/cordova-plugin-ionic-webview