在《优酷鸿蒙开发实践|鸿蒙卡片开发》一文中已经提到,要实现“在优酷主客ICON向上滑动,呼出优酷鸿蒙卡片”,需要卡片的实现代码与优酷主客做混合打包。下面的小节简单介绍了如何实现Android/鸿蒙混合打包的流程。
当前,将大型Android应用(下图图1)全部使用鸿蒙API改写是不现实的,所以华为设计了上述的演进路线。希望将App中的功能由Android模块逐步替换为鸿蒙FA/PA, 并混合打包在一起进行分发(下图图2),最终抵达100% Pure 鸿蒙的最终形态(下图图3)。
目前,我们将优酷Android主客和鸿蒙HAP混合打包为一个产物,也就是图中 “安卓App平滑演进及互操作”的中间态。
刚才已经提到,当前的优酷鸿蒙专版包含Android APK主体,以及桌面Widget HAP, 多屏互动HAP。
因此,鸿蒙版优酷不仅拥有Android版优酷的的所有功能, 还拥有Android版不具备的一些特殊功能。
优酷鸿蒙版是在早期吃螃蟹,和华为一起合作开发鸿蒙版App先行者之一,解决了大量实际工程难题,并且与华为共同解决了大量开发环境和运行时的Bug,最终顺利地让优酷鸿蒙混合包上架华为应用商店。
将原Android Apk应用和Harmony Hap(Hap为Harmony应用编译产物,跟Apk角色一致)应用分别上架应用市场。
将原Android Apk和Harmony Hap混合打包成App上架应用市场。
对比下,分包方案需要安装2次才可以完成整体功能体验,这显然是硬伤,合包方案虽然在开发生产侧麻烦一些,但可以给用户带来较好的体验,所以选择了混合包方案。
Android的产物是Apk,Harmony的产物是Hap,将Apk和Hap混合打成一个总产物包称作为混合包(APP)。
场景1:当Harmony版应用并不是一个完整的功能,而只是作为原有Android应用的能力补充和增强时,需要将apk和hap打包成一个整应用。
场景2:Android应用短时间内无法全部迁移成Harmony版,分节奏迁移过程中可采用此方案进行混合打包作为一个供Harmony系统可运行的应用。
名词解释:
混合包要求及限制
名词解释:
限制:
要求:
为了干预原Apk的启动流程,增加鸿蒙应用的启动入口,需要干预Android的application。鸿蒙侧提供了工程侧打包编译的plugin,但由于优酷是组件化开发模式,application作为一个单独的aar模块存在,所以混合编译plugin并不是适用。
方案:通过了解混合编译plugin的职责,直接在application模块手动修改父类为AceHarmonyApplication(ohos.ace.ability.AceHarmonyApplication,此类在鸿蒙提供abilityshell.jar中),并手动在manifest中添加用于鸿蒙兼容性属性如下:
<!--鸿蒙兼容性属性--> <uses-feature android:name="zidane.software.ability" android:required="false" /> <meta-data android:name="permZA" android:value="true" /> <meta-data android:name="multiFrameworkBundle" android:value="true" />
将application模块集成进Android工程,编译后得到产物legacyApk。
1、配置工程参数
build.gradle:entry和所有feature中的build.gradle的compileSdkVersion、compatibleSdkVersion改成5(混合包最小支持版本要求为5);
config.json:
entry和所有feature中的config.json的apiVersion中的compatible和target改成5;
entry和所有feature中添加originalName属性并保持跟bundleName一致;
entry和所有feature中添加version,并保持子属性code等于Apk中的versionCode,子属性等于Apk中的versionName;
entry和所有feature中的vendor保持一致,config.json中的code和name有要求,name推荐为三段式"a.b.c" Code值为a1000000+b1000+c。如Name为1.001.003,Code值为1001003。
{ “app”:{ "bundleName”:”包名”, //这是鸿蒙应用包名,混合包要求必须与Apk包名一致 "vendor”:”xxx”,//entry和feature中要一致 "version":{ "code":xxx,//对应Android VersionCode要求高于apk版本,并且根据name拼接而成 "name”:”xxx” //对应Android VersionName }, "apiVersion":{ "compatible":5,//5才支持混合包 "target":5, "releaseType":"Release" } } }
2、在entry模块添加legacyApkOptions配置
apply plugin: 'com.huawei.ohos.hap' ohos { ... legacyApkOptions { legacyApk"..\..\legacy_entry.apk" //指向legecyApk文件,并且必须以entry.apk结尾 legacyVersionCode "499" // 与 legacyApk 的 AndroidManifest.xml 中配置的android:versionCode 保持一致 legacyVersionName "9.15.2" // 与 legacyApk 的 AndroidManifest.xml 中配置的android:versionName 保持一致 } }
3、entry修改
将entry中的所有代码和资源移到feature中(鸿蒙工程允许有一个entry,可以有多个feature);添加一个空的Ability页面,并修改icon和label与原Android应用一致。
签名是混合打包中最麻烦的一步,这也是鸿蒙开发最特殊的一步,需要拿原签名文件(jks或者p12)用DevEco Studio生成csr,然后去华为应用市场申请签名的证书(cer)文件和Profile(p7b)文件,更多详情也参考华为帮助文档(https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-debugapp-0000001058642113)
由于混合包要求APP的签名信息要与原Android的签名信息一致,所以正常情况下用原Android的签名文件(jks)就可以了,但鸿蒙为了安全性,提升了签名的安全性要求:
如果签名文件构建的时间比较早,这两个要求都不符合的话,华为侧提供了如下解决方案:
1、可以使用原Android签名文件单独配置shell Apk签名
apply plugin: 'com.huawei.ohos.hap' ohos { ... legacyApkOptions { ... signConfig { storeFile file("..\legacyApkJks.jks") // 单独配置的 shell apk 签名材料 } ... } }
2、使用keytool命令行生成p12文件和csr文件,但要求别名和秘钥跟原Android签名保持一致,并且使用EC算法
//生成p12 keytool -genkey -alias [keyname] -keystore [p12.file] -storetype pkcs12 -keyalg EC -keypass [password] -storepass [password] //生成csr keytool -certreq -alias [keyname] -keystore [p12.file] -storetype pkcs12 -file [csr.file]
申请下来cer和p7b文件(需要单独申请调试和发布证书)后,就可以在开发工具中配置签名文件了(更多配置详情也阅览华为配置签名帮助文档 https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#ZH-CN_TOPIC_0000001058015911__section9752152162813)。
然后通过开发工具DevEco Studio中build -> Build Apps编译得到产物APP。
工程结构概述:
经过上面的一系列流程,就可以生成一个供鸿蒙运行的混合包了。
由于是发布证书签名,这个混合包实际上是不能直接手动安装到Harmony OS上,还需要经过华为平台侧(需要联系华为侧接口人)签名,提供转换之后的安装包供优酷方面测试使用。
测试完毕之后,可以直接拿这个混合包上架到华为的鸿蒙应用市场。
最后,下周《优酷鸿蒙开发实践》系列第三篇技术文章,我们将以优酷播放中心的技术储备为切入点,结合鸿蒙系统的镜像和流转特性,详细介绍普通流转、自由视角和zoom 等核心能力在鸿蒙上的实践之路。
感谢关注【阿里巴巴移动技术】,我们下篇技术实践再见。
关注我们,每周 3 篇移动技术实践&干货给你思考!
|