鸿蒙版cordova介绍
鸿蒙版cordova或PhoneGap，这里统称为鸿蒙版Cordova，遵守cordova官方，不再使用鸿蒙版PhoneGap了。
cordova移动端跨平台研发的重要框架之一，支持Android和Ios，官方并不支持鸿蒙系统，harmony-cordova是鸿蒙的cordova，这里主要介绍鸿蒙版corddova，安卓和Ios请查看cordova官方文档，cordova除了cordova sdk外，还有很多的插件，开发者根据自己的APP的需要可以选择使用相关的插件，
鸿蒙版cordova sdk地址
鸿蒙版cordova已经上架鸿蒙三方库中心，开发者可以直接在DevEco studio中直接使用。cordova sdk 三方库地址：
https://ohpm.openharmony.cn/#/cn/detail/harmony-cordova
鸿蒙版cordova支持的插件
Android移植鸿蒙步骤
1，打开DevEco创建项目，选择Empty Ability进入下一步，填写必要信息，这里要注意，bundle name 先填写com.example.myapplication，也就是保持默认不变，因为在没有cordova.crt证书的情况下，cordova鸿蒙版要求bundle name必须为com.example.myapplication，主要用于研发测试，如果开发测试完成要修改bundle name上架鸿蒙应用市场，请联系开发者申请cordova.ert证书，或者事先联系开发者提供技术服务。
2，项目创建成功后，复制原有Android studio的工程assests/www目录下面的所有文件到鸿蒙工程entry/src/main/resources/目录下，注意直接复制原andriod工程www目录下的文件，不包含www。
3，复制原android工程res/xml目录下的config.xml文件到鸿蒙工程entry/src/main/resources/目录下。
4，打开DevEco studio的Terminal终端，进入工程目录，执行 ohpm install harmony-cordova 安装本插件。
5，打开鸿蒙工程文件entry/src/main/etx/pages/Index.ets文件，修改代码如下：
import { MainPage, pageBackPress, pageHideEvent, pageShowEvent } from 'harmony-cordova/Index';
@Entry
@Component
struct Index {
onPageShow(){
pageShowEvent(); //页面显示通知cordova
}
onBackPress() {
pageBackPress(); //拦截返回键由cordova处理
return true;
}
onPageHide() {
pageHideEvent(); //页面隐藏通知cordova
}
build() {
RelativeContainer() {
MainPage(); //webview首页index.html
}
.height('100%')
.width('100%')
}
}6，打开鸿蒙工程文件/entry/src/main/ets/entryAbility/EntryAbility.ets文件,修改onCreate函数如下
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
import { webview } from '@kit.ArkWeb';
import { setSchemeHandler } from 'harmony-cordova/Index';
...
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
webview.WebviewController.initializeWebEngine();//webview引擎初始化
setSchemeHandler();//设置webview
schemehilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
}7，鸿蒙混合研发，也许您会增加其他page页面，不一定应用的首页为cordova webview（index.html)的首页，例如应用增加了鸿蒙的原生的启动页面，包含首页弹窗，同意隐私政策后，然后再从启动页面进入cordova的页面，这样避免在用户没有同意隐私政策的情况下，初始化cordova sdk，因为初始化cordova sdk，系统读取了设备的网络状态，因为国内相关法律规定，在用户没有同意隐私政策的情况下，不允许读取设备的网络标识。
8，做以上代码修改后，鸿蒙的移植已经完毕，可以使用模拟器或者真机进行编译和测试了。
Ios移植鸿蒙步骤
如果您的项目有android和Ios的工程，请参考android项目移植项目的鸿蒙下，如果您的项目没有andriod工程，只有Ios工程，请使用如下方法移植，移植时大部分内容和安卓一样，只是复制的文件的路径不一致，以下只介绍不同部分，相同部分请参考android移植步骤。
1，复制Xcode的Ios工程目录下的Staging/www目录下的所有文件到鸿蒙工程entry/src/main/resources/目录下。 2，Xcode工程的config.xml文件在Staging目录下，Xcode工程的该文件不能直接被鸿蒙版cordova使用，需要进行转换，该文件主要记录的是插件的名称和初始化的类，因为鸿蒙版是根据android的config.xml进行插件初始化的，因此需要将Xcode工程config.xml转为安卓的config.xml，请将Xcode工程使用node加入安卓平台，系统会自动生成android版的config.xml。然后将文件复制到鸿蒙版工程的entry/src/main/resources/下。
附加说明：本人认为使用cordoca跨平台研发，一般至少都会包含android和ios两大平台，很少只有ios平台，没有android平台的，所以大部分移植鸿蒙参考android移植步骤，后续升级SDK会兼容Ios工程的config.xml，无需转换就可以使用。
新项目，一次开发适用于andriod、Ios和Harmony三大平台
由于cordova官方当前并不支持HarmonyOS平台，使用node无法直接将HarmonyOS加入到cordova，也无法直接安装插件到HarmonyOS，因此对于新项目要一次开发满足三大平台的话，建议先通过node加入Android和Ios平台和安装插件，后续研发可以使用Android studio研发和调试，待研发成功后，然后再在Xcode和DevEco做跨平台适配。Xcode适配请参考cordova的官方文档，HarmonyOS适配请参考以上Android的移植步骤。
特别说明
当前版本不支持使用者自定义插件研发，如果该版本没有包含您要使用的插件，或者您的项目中有Android或Ios的自定义插件，需要移植到HarmonyOS平台，请您和本开发者联系，获取技术支持。
使用鸿蒙版cordova sdk在开发测试阶段务必将bundle name修改为com.example.myapplication，如果将bunlde name改为正式的Id，鸿蒙版cordova sdk会读取entry/src/main/resources/目录的cordova.crt证书文件，用于验签，如果该文件不存在，启动应用后，应用会闪退。如果应用的bundle name为com.example.myapplication，鸿蒙版 cordova sdk会跳过验签，不检测cordova.crt文件。但是上架鸿蒙应用市场，必须将bundle name改为正式的id，所以请联系开发者申请cordova.ert证书，另外由于操作系统之间的差异，虽然保持了cordova的插件接口不变，但是返回值会有所调整，后续文档会逐步完善，在使用本插件跨平台研发时请联系开发者提供技术服务。
扫一扫
404
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
