{"_id":"@cordova-ohos/cordova-plugin-ionic-webview","_rev":"3-2d96c8dae6faaf9c844093c75926cb0e","name":"@cordova-ohos/cordova-plugin-ionic-webview","dist-tags":{"latest":"5.0.2"},"versions":{"5.0.1":{"name":"@cordova-ohos/cordova-plugin-ionic-webview","version":"5.0.1","keywords":["cordova","ionic-webview","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-ionic-webview@5.0.1","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-ionic-webview/issues"},"dist":{"shasum":"ba5f77bc0ee7cbf3283df0ec3cece1e64a24bded","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-ionic-webview/-/cordova-plugin-ionic-webview-5.0.1.tgz","fileCount":10,"integrity":"sha512-Bn2BDzsf7zbL4gphwqfQIGqKfdYO1ntwvKdyuEMLckj+YIagcH68UbbG6lHiRK3Y7M4EDI1qwE2FjbMG3BfbDA==","signatures":[{"sig":"MEQCIFBh3i6O8MZQE0FX327JFFh/CZ6rSox4FscVgVD0bw8KAiA1hupIFWbRqbRasblWx3Mz6bL8T1bIJ0S9XW50ZKDTug==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57517},"cordova":{"id":"cordova-plugin-ionic-webview","platforms":["ohos"]},"engines":{"cordovaDependencies":{"5.0.1":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"50d27428aa0bc9cc9662c8be46ae4d4fb8674055","_npmUser":{"name":"wanpengsz","email":"wanpengsz@163.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-ionic-webview","type":"git"},"_npmVersion":"9.6.2","description":"Cordova Ionic Webview Plugin","directories":{},"_nodeVersion":"20.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-ionic-webview_5.0.1_1773996674746_0.4412268942276911","host":"s3://npm-registry-packages-npm-production"}},"5.0.2":{"name":"@cordova-ohos/cordova-plugin-ionic-webview","version":"5.0.2","description":"Cordova Ionic Webview Plugin","cordova":{"id":"cordova-plugin-ionic-webview","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-ionic-webview"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview/issues"},"keywords":["cordova","ionic-webview","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"5.0.2":{"@cordova-ohos/ohos":">=2.0.0","hcordova":">=1.0.0"}}},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-ionic-webview@5.0.2","gitHead":"b07d2856bb7f7f12dc9678514718d6ba3712c37e","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-iuCduA8nKICIz34s67BDXtzy8FIkWjmioxkJsLpNM1P4v6zmU8iCZh5oPi0xusjPBKeDdcJ/J75CM0Ii5Sef/g==","shasum":"8d8a11be9b2a968885442cba4647e245d5113e17","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-ionic-webview/-/cordova-plugin-ionic-webview-5.0.2.tgz","fileCount":11,"unpackedSize":73653,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICI7+Hbsoc3qT6ASzG/XT2iA8MBcsV0rwM6CkcTuL397AiAvzcAmqxSPU+fKYG4p2sDWHqnuIHAUtPHn3xv1cv6R0Q=="}]},"_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"directories":{},"maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cordova-plugin-ionic-webview_5.0.2_1785148622395_0.5490183326467133"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T08:51:14.599Z","modified":"2026-07-27T10:37:02.779Z","5.0.1":"2026-03-20T08:51:14.923Z","5.0.2":"2026-07-27T10:37:02.539Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","ionic-webview","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-ionic-webview"},"description":"Cordova Ionic Webview Plugin","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"readme":"# <center>cordova-plugin-ionic-webview</center>\r\n\r\n[![zh-CN](https://img.shields.io/badge/lang-中文-blue.svg)](README.md)\r\n[![en](https://img.shields.io/badge/lang-English-blue.svg)](README.en.md)\r\n\r\n本项目基于 [cordova-plugin-ionic-webview@5.0.1](https://www.npmjs.com/package/cordova-plugin-ionic-webview/v/5.0.1) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-ionic-webview](#cordova-plugin-ionic-webview)\r\n  - [简介](#简介)\r\n    - [核心特性](#核心特性)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [基础安装（推荐）](#基础安装推荐)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用说明](#使用说明)\r\n    - [配置说明](#配置说明)\r\n      - [1. 基础配置（选配）](#1-基础配置选配)\r\n        - [config.cml 配置](#configcml-配置)\r\n    - [使用注意](#使用注意)\r\n  - [新增特性](#新增特性)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-ionic-webview` 是 Harmony Cordova 生态系统中一款核心插件，为 Apache Cordova / Ionic 应用提供高性能、现代化的 WebView 解决方案，替代原生 Cordova WebView，优化加载速度、本地资源访问和跨域兼容性，本文档主要说明在 OHOS 系统中的应用。\r\n\r\n### 核心特性\r\n\r\n- **性能优化**：基于 Chrome 内核，加载速度提升 30%+，支持硬件加速\r\n\r\n- **本地资源访问**：通过 `http(s)://` 协议高效访问本地文件（HTML/CSS/JS/图片等），支持离线缓存\r\n\r\n- **跨域友好**：内置 CORS 支持，无需额外配置即可实现跨域请求\r\n\r\n- **现代化特性**：支持 ES6+ 语法、WebGL、Service Worker、WebRTC 等现代 Web 特性\r\n\r\n- **安全增强**：支持 HTTPS 强制模式、内容安全策略（CSP）、防止混合内容警告\r\n\r\n- **Ionic 兼容**：与 Ionic Framework 深度集成，完美支持 Ionic 应用的路由、动画和组件\r\n\r\n- **调试便捷**：支持 WEB 调试工具远程调试\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 19 及以上（Android 4.4+）\r\n\r\n- **iOS**：10.0 及以上\r\n\r\n- **OHOS**：5.0 及以上\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持从 npm 仓库或 GitCode 仓库获取，可根据需求选择稳定版、指定版本或开发版。\r\n\r\n### 基础安装（推荐）\r\n\r\n```bash\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n# 安装最新稳定版插件\r\nhcordova plugin add cordova-plugin-ionic-webview\r\n```\r\n\r\n### 指定平台安装 ohos\r\n\r\n仅为 OHOS 平台安装插件，可选择指定版本：\r\n\r\n```bash\r\n# 安装特定版本（例如 1.0.0）并指定 OHOS 平台\r\nhcordova plugin add cordova-plugin-ionic-webview@1.0.0 --platform ohos\r\n```\r\n\r\n### 从 GitCode 仓库安装\r\n\r\n仅为 OHOS 平台安装插件（开发版，获取主分支最新代码）：\r\n\r\n```bash\r\n# 安装主分支最新开发版并指定 OHOS 平台\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-ionic-webview）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-ionic-webview --platform ohos\r\n```\r\n\r\n### 安装后验证\r\n\r\n安装完成后，可通过以下命令验证插件是否成功添加到项目中：\r\n\r\n```bash\r\n# 查看已安装的插件列表，若包含本插件 ID 则表示插件已成功安装\r\nhcordova plugin list\r\n```\r\n\r\n### 卸载\r\n\r\n```bash\r\n# Cordova CLI 全平台卸载\r\nhcordova plugin rm cordova-plugin-ionic-webview \r\n# 指定 OHOS 平台卸载\r\nhcordova plugin rm cordova-plugin-ionic-webview --platform ohos\r\n```\r\n\r\n## 约束与限制\r\n\r\n1. 插件替代原生 Cordova WebView，安装后将覆盖原生 WebView 相关配置，建议安装前备份项目配置；\r\n2. OHOS 平台下，默认使用 https://www.example.com 加载 Rawfile/www/index.html 文件，可通过 config.cml 配置自定义 scheme 和域名；\r\n3. 加载页面在 OHOS 系统中，已有 @cordova-ohos/ohos 框架实现；\r\n4. 需确保项目兼容 Chrome 内核相关特性，部分老旧 Web 语法可能需要适配调整；\r\n5. 开启 HTTPS 强制模式后，需确保所有资源访问均使用 HTTPS 协议，避免混合内容警告。\r\n\r\n### 兼容性\r\n\r\n支持：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| SDK | API12+ |\r\n| IDE | DevEco Studio: 5.0+ |\r\n| ROM | 5.1+ |\r\n| Emulator | OpenHarmony 6.0+ |\r\n\r\n在以下版本中已测试通过：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| @cordova-ohos/ohos | 14.0.1-ohos-14.0.1 |\r\n| SDK | 5.0.0(12) |\r\n| IDE | DevEco Studio: 6.0.13.200 |\r\n| ROM | 5.1.0.120 SP3 |\r\n| Emulator | OpenHarmony 6.0.1(21) |\r\n\r\n## 使用说明\r\n\r\n### 配置说明\r\n\r\n#### 1. 基础配置（选配）\r\n\r\n默认是使用 https://www.example.com 加载 Rawfile/www/index.html 文件，可通过 config.cml 配置自定义 scheme 和域名。\r\n\r\n##### config.cml 配置\r\n\r\n```xml\r\n<!-- 配置加载 scheme，支持 http|https，默认推荐 https -->\r\n<preference name=\"Scheme\" value=\"https\" />\r\n\r\n<!-- 配置自定义加载域名 -->\r\n<preference name=\"Hostname\" value=\"app\" />\r\n```\r\n\r\n### 使用注意\r\n\r\n1. 配置 scheme 时仅支持 http 和 https，推荐使用 https 以提升安全性；\r\n2. 自定义 hostname 需符合域名规范，避免特殊字符；\r\n3. 调试时可通过 WEB 调试工具远程调试，提升开发效率；\r\n4. 若需使用离线缓存功能，需确保本地资源路径配置正确，支持通过 http(s):// 协议访问。\r\n\r\n## 新增特性\r\n\r\n1. 适配 OHOS 5.0+ 系统，严格遵循 OpenHarmony 开发规范，替代原生 Cordova WebView；\r\n2. 保留插件核心功能，优化 OHOS 平台本地资源访问效率，支持 http(s):// 协议访问本地文件；\r\n3. 完善 OHOS 平台配置说明，明确 config.cml 配置方式及参数含义；\r\n4. 兼容 Cordova 14.0.1-ohos 版本，与 Ionic Framework 深度集成，保障应用流畅运行。\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-ionic-webview/\r\n├── src/                          # 源代码目录\r\n│   └── main/                     # 主要源代码\r\n│       └── cpp/                  # C++ 原生代码\r\n│           ├── IonicWebView/     # Ionic WebView 模块\r\n│           │   ├── IonicWebView.cpp  # Ionic WebView 功能的 C++ 实现\r\n│           │   └── IonicWebView.h    # Ionic WebView 功能的头文件\r\n│           └── NativeStorage/    # 原生存储模块\r\n│               ├── NativeStorage.cpp  # 原生存储功能的 C++ 实现\r\n│               └── NativeStorage.h    # 原生存储功能的头文件\r\n├── www/                          # Web 资源目录\r\n│   └── util.js                   # JavaScript 工具函数接口（Cordova 桥接层）\r\n├── .gitignore                    # Git 忽略文件配置\r\n├── LICENSE                       # 项目开源许可证\r\n├── OAT.xml                       # OpenHarmony 审核配置文件\r\n├── package.json                  # Node.js 包配置\r\n├── plugin.xml                    # Cordova 插件描述文件（核心配置）\r\n└── README.md                     # 项目说明文档\r\n```\r\n\r\n## 贡献代码\r\n\r\n使用过程中发现任何问题都可以提 [Issue](https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源，可自由用于商业和非商业项目，详见 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\n1. Android 和 iOS：[cordova-plugin-ionic-webview 官方指南](https://www.npmjs.com/package/cordova-plugin-ionic-webview)\r\n\r\n2. GitCode 仓库：[CPF-Cordova/cordova-plugin-ionic-webview](https://gitcode.com/CPF-Cordova/cordova-plugin-ionic-webview)\r\n","readmeFilename":"README.md"}