鸿蒙harmony-cordova(V1.2.9 支持自定义插件研发)

Cordova HarmonyOS

遵守Cordova（https://cordova.apache.org）官方插件接口规范

优势

Cordova HarmonyOS 所有插件遵守cordova（https://cordova.apache.org）官方接口规范，原android和Ios项目在几分钟内就可以生成原生纯血鸿蒙APP，无需做任何研发，节省大量时间和人力成本。

支持框架

支持移动端跨平台框架：

• （1）vue.js
• （2）ionic+angular.js
• （3）ionic React
• （4）jquery.js框架

开发说明

cordova，包含sdk和插件，并支持自定义插件研发，只有cordova sdk没有插件无法使用，因此cordova（https://cordova.apache.org）官方，除了提供sdk外，同时提供了大量的官方插件，并且开源，同样cordova HarmonyOS遵守官方标准，除了提供鸿蒙版cordova sdk外，也提供了大量的插件，并且仍在持续新增插件，同时支持自定义插件研发，所有插件遵守cordova官方接口规范，因此开发者可以参考cordova官方插件的开发文档开发鸿蒙版app。

开发背景

cordova是Apache基金会的开源项目，官方网站：https://cordova.apache.org，是移动端跨平台框架，地位不可撼动，大量厂商直接或间接采用此框架开发APP；但是目前不支持HarmonyOS Next版本，开发者将原Android和Ios项目移植到HarmonyOS Next版，无法适配，为此我们公司研发了cordova HarmonyOS，遵守cordova官方标准，使适配纯血鸿蒙在几分钟内就可以完成，无需投入任何研发，新开发的项目，一次研发就适用于Android、Ios和HarmonyOS三大平台，也节省了大量的时间和人力成本。

升级预告

下一版本升级cordova sdk、自带插件、自定义插件的demo程序，敬请期待。

---

自带插件

插件ID	接口说明
cordova-plugin-device	名称：设备信息 文档地址：https://github.com/apache/cordova-plugin-device 所有接口遵守官方文档，uuid和serial读取是鸿蒙系统的ODID,鸿蒙只允许系统应用读取uuid和serial，普通应用无权读取，具体文档参考华为官方文档：文档中心
cordova-plugin-whitelist	名称：网络访问白名单 文档地址：https://github.com/apache/cordova-plugin-whitelist 使用cordova HarmonyOS不存在跨域访问问题，任何域名都可以访问网络，因此为了安全性，需要配置网络访问白名单，使用方法保持和原接口一致外，做了一些修改如下: （1）自动识别http和https，http是80端口，https是443端口,支持自定义端口，但无需在config.xml里面配置 （2）不支持目录配置，就是直接配置域名就可以了，域名支持二级域名通配符 （3）举例1：在config.xml里面添加< allow-intent href="*.magongshou.com" />支持maongshou.com的所有二级域名 （4）举例2：在config.xml里面添加< allow-intent href="*" /> 支持所有域名>
cordova-hot-code-push-plugin	名称：热更新插件 文档地址:https://github.com/nordnet/cordova-hot-code-push 热更新部分js和css文件，无需升级整个app，主要是解决紧急情况下的bug，升级app还是建议上架应用市场。调用方法如下： （1）修改插件两处bug，在rawfile/plugins/cordova-hot-code-push-plugin/www/chcp.js文件 第60行: var resultObj = JSON.parse(msg); 改为:var resultObj = msg; 第83行:callback(resultObj.error, resultObj.data); 改为:callback(resultObj.action, resultObj.error, resultObj.data); （2）js调用接口initPlugin初始化插件,插件自动调用，无需手动调用 （3）js调用接口chcp.fetchUpdate检查是否有更新,调用此函数可以传入新的升级url地址，如果有更新回调action返回chcp_updateIsReadyToInstall,没有更新返回chcp_nothingToUpdate （4）js调用接口chcp.installUpdate立即启用更新，然后app会自动重启 （5）如果不调用步骤3，下次app重启也会自动启用更新
cordova-plugin-network-information	名称：网络管理 文档地址：https://github.com/apache/cordova-plugin-network-information cordova网络管理，查看网络连接状态，wifi,4G和5G等连接类型,需申请网络权限，才可以正常使用，见声明权限部分
cordova-plugin-bd-geolocation	名称：百度地理位置定位 文档地址:https://github.com/laixiangran/cordova-plugin-bd-geolocation 百度地理位置定位，支持wgs84、gcj02和bd09ll坐标,需申请位置权限，才可以正常使用，见声明权限部分
cordova-plugin-geolocation	名称：cordova地理位置定位官方插件 文档地址:https://github.com/apache/cordova-plugin-geolocation cordova官方地理位置定位插件，支持wgs84、gcj02和bd09ll坐标,需申请位置权限，才可以正常使用，见声明权限部分
cordova-plugin-inappbrowser	名称：内置浏览器 文档地址:https://github.com/apache/cordova-plugin-inappbrowser cordova的app的内置浏览器，实现app加载服务器网页
cordova-sqlite-storage	名称：数据库插件 文档地址:https://github.com/storesafe/cordova-sqlite-storage cordova官方数据库插件，缓存本地数据，支持sql语句
cordova-plugin-camera	名称：相机功能 文档地址:https://github.com/apache/cordova-plugin-camera cordova相机功能，调用相机拍摄照片，无需权限申请
cordova-plugin-file	名称：本地文件管理 文档地址:https://github.com/apach