先给HarmonyOS比个心心
随着HarmonyOS2.0发布,HarmonyOS更加地进入大众视野,也越来越多的开发者涉足HarmonyOS领域,HarmonyOS的生态建设也在逐渐扩大、深入。
虽然HarmonyOS有着强大的分布式场景、AI等高级能力,但是毕竟还处于新生面世阶段,对于一些开发组件、生态市场等还有着一定的不成熟。最近想用HarmonyOS开发一款智慧场景的应用,深入了解后,无奈发现HarmonyOS对于相应的场景支持并不给力,所以就打算用Android开发并融合HarmonyOS的智慧能力。这就需要HarmonyOS-Android混合开发,所以也就有了这篇文章。
HarmonyOS-Android混合开发教程分为两个章节,都是干货满满:
第一节:Android混入HarmonyOS工程
第二节:HarmonyOS与Android交互
当前为第一章节,最后罗列了项目源码的git地址,以及混入过程中可能存在的一系列问题的整理文档,我踩过的坑,我也搭上了桥,希望能够帮助大家顺利通行,头发帮你们掉了。
需要注意的是,混合开发配置HarmonyOS应用证书时,需要绑定HarmonyOS真机,所以有真机的大吉大利,没有的赶快入手一台吧
1、新建工程
新建Android、HarmonyOS工程;
两个工程报名必须一致!!!
-
Android工程:
-
HarmonyOS工程·:
-
HarmonyOS - Android工程
启动两个工程,确保运行OK。
2、Android工程改造
以适配HarmonyOS
- 引入abilityshell_ide_java.jar到libs中,并在app module的gradle中引入依赖(别忘了 sync now)
compileOnly files('libs/abilityshell_ide_java.jar')
该jar包就在HarmonyOS工程的SDK中,打开文件管理器即可获得:
-
创建Application,继承HarmonyApplication:
修改AndroidManifest.xml文件:
// 根结点添加:
// application节点中添加:
3、生成应用签名,打包apk
- Build -> Generate Signed Bundle/APK... -> APK -> NEXT:
- 生成当前应用的签名文件:
配置的密码规则要满足如下DevECO生成签名时配置的密码规则:
- 验证密码
- 打包成APK:
-
将生成的apk文件命名为android-entry(因为HarmonyOS要求引入的apk文件必须以entry.apk结尾)
为了不每次手动修改名称,在app module -> build.gradle -> android下添加:
applicationVariants.all { variant ->
variant.outputs.all {
//文件名格式要求 xxx-entry.apk
outputFileName = "android-entry.apk"
}
}
注:Android工程必须是64位
5、HarmonyOS工程改造
-
迁入Android工程生成的jks和apk文件:
entry module -> build.gradle -> ohs下,添加混入配置:
legacyApkOptions{
legacyApk rootProject.file('android/android-entry.apk').absolutePath //混入apk的存放路径
signConfig{
storeFile rootProject.file('android/sign.jks') //混入apk所用签名文件
}
}
-
更改entry module -> src -> main -> config.json -> app-> version参数和Android工程version保持一致:
-
更改entry module -> src -> main -> config.json -> module -> distro -> installationFree值为false:
-
新建sign文件夹,存放所需的签名文件证书
生成HarmonyOS应用的签名文件,必须和创建Android签名时参数保持一致。Build -> Generate Key and CSR
-
新建p12文件:
p12文件也可以根据Android项目的签名文件sign.jsk生成:
keytool -importkeystore -srckeystore sign.jks -srcstoretype JKS -deststoretype PKCS12 -destkeystore sign.p12
这里我们在DevECO中生成也是一样的,密码保持一致就行。
-
创建csr证书,注意和创建sign.jks时配置参数保持一样:
-
创建成功:
6、创建cer证书
文档地址:https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404
-
进入AppGallery Connect:
-
进入【用户与访问】-> 【证书管理】:
新建证书,上传刚才创建的csr证书,如下:
-
下载cer证书:
7、创建p7b证书
-
回到AppGallery Connect首页,进入【我的项目 】-> 【添加项目】:
-
不要立即在项目页面添加应用,虽然流程相似,但配置参数不一样(会出现异常)。下滑左侧菜单栏,进入HarmonyOS应用,添加HarmonyOS应用:
-
并根据提示设置SDK:
第二步:
注意去掉上面箭头的空格,不然sync时会报错:
classpath 'com.huawei.agconnect:agcp-harmony:1.0.0.300'
implementation 'com.huawei.agconnect:agconnect-core-harmony:1.0.0.300'
-
然后再进入HarmonyOS应用菜单下,添加Profile文件:
需要添加设备,自行百度设备添加方式吧(需要有HarmonyOS系统的真机哦)。
下载p7b证书,至此所有证书已集齐完毕,准备召唤神龙:
8、添加业务module
默认入口entry作为引入apk的加壳,我们需要创建新的module来作为HarmonyOS应用的入口。
-
创建module:
注:要保证module的version也保持一致。
9、配置签名证书
-
进入Project Structure:
-
配置Project -> Signing Configs:
-
配置Modules -> Signing Configs,把module都配置上(只配置entry也行)
10、配置启动类型
由于我们新的入口变为myentry,所以我们在启动myentry时需要把entry部署进去,如下:
10、启动myentry
[图片上传失败...(image-d40ea-1631029456962)]
至此Android apk已成功混入HarmonyOS工程。
11、验证Android混入成功
怎么检测Android工程被引入进来了呢,
- 判断当前运行环境
* 判断当前运行平台还是否是HarmonyOS平台
* @return
*/
public boolean isHarmonyOS() {
Class> aClass = null;
try {
Class clz = Class.forName("com.huawei.system.BuildEx");
Method method = clz.getMethod("getOsBrand");
return "harmony".equals(method.invoke(clz));
} catch (Exception e) {
return false;
- 验证从Ability跳转到Activity页面。
Intent androidIntent = new Intent();
Operation operation = new Intent.OperationBuilder()
.withDeviceId("")
.withBundleName(getBundleName())
.withAbilityName("com.jt.mix.SecondActivity")
.withFlags(Intent.FLAG_NOT_OHOS_COMPONENT)
.build();
androidIntent.setOperation(operation);
// 传递参数
androidIntent.setParam("ohosMsg", "I'm HarmonyOS!");
startAbility(androidIntent);
12、相关链接
- 项目地址:戳我->
- HarmonyOS与Android交互:戳我->
- 问题集锦:戳我->