先给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工程：
image-20210905023640237 -
HarmonyOS工程·：
image-20210905023502405 -
HarmonyOS - Android工程
image-20210905024114498 启动两个工程，确保运行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：
image-20210905040847676 修改AndroidManifest.xml文件：
// 根结点添加：
<uses-feature android:name="zidane.software.ability" android:required="false" />
// application节点中添加：
<meta-data android:name="permZA" android:value="true" />
<meta-data android:name="multiFrameworkBundle" android:value="true" /></pre>
3、生成应用签名，打包apk
- Build -> Generate Signed Bundle/APK... -> APK -> NEXT:
- 生成当前应用的签名文件：
配置的密码规则要满足如下DevECO生成签名时配置的密码规则：
- 验证密码
- 打包成APK：
-
将生成的apk文件命名为android-entry（因为HarmonyOS要求引入的apk文件必须以entry.apk结尾）
image-20210905000750766为了不每次手动修改名称，在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文件：
image-20210905001408102 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保持一致：
image-20210905030535675 -
更改entry module -> src -> main -> config.json -> module -> distro -> installationFree值为false：
image-20210905003217651 -
新建sign文件夹，存放所需的签名文件证书
image-20210905030224497 生成HarmonyOS应用的签名文件，必须和创建Android签名时参数保持一致。Build -> Generate Key and CSR
-
新建p12文件：
image-20210905001919050image-20210905002618632p12文件也可以根据Android项目的签名文件sign.jsk生成:
keytool -importkeystore -srckeystore sign.jks -srcstoretype JKS -deststoretype PKCS12 -destkeystore sign.p12
这里我们在DevECO中生成也是一样的，密码保持一致就行。
-
创建csr证书，注意和创建sign.jks时配置参数保持一样：
image-20210905002719009
-
创建成功：
image-20210905002846718image-20210905002933321
6、创建cer证书
文档地址：https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404
-
image-20210905031215371
-
进入【用户与访问】-> 【证书管理】：
新建证书，上传刚才创建的csr证书，如下：
image-20210905004620314 -
下载cer证书：
image-20210905004714927
7、创建p7b证书
-
回到AppGallery Connect首页，进入【我的项目 】-> 【添加项目】：
image-20210905005026716 -
不要立即在项目页面添加应用，虽然流程相似，但配置参数不一样（会出现异常）。下滑左侧菜单栏，进入HarmonyOS应用，添加HarmonyOS应用：
image-20210905005347715 -
并根据提示设置SDK：
image-20210905005423495第二步：
image-20210905005910893注意去掉上面箭头的空格，不然sync时会报错：
image-20210905005723333
classpath 'com.huawei.agconnect:agcp-harmony:1.0.0.300'
implementation 'com.huawei.agconnect:agconnect-core-harmony:1.0.0.300'
-
然后再进入HarmonyOS应用菜单下，添加Profile文件：
image-20210905010053325image-20210905010325262需要添加设备，自行百度设备添加方式吧（需要有HarmonyOS系统的真机哦）。
image-20210905035040681 下载p7b证书，至此所有证书已集齐完毕，准备召唤神龙：
8、添加业务module
默认入口entry作为引入apk的加壳，我们需要创建新的module来作为HarmonyOS应用的入口。
-
创建module:
myentry
注：要保证module的version也保持一致。
9、配置签名证书
-
进入Project Structure：
image-20210905010605487 -
配置Project -> Signing Configs：
image-20210905035230336 -
配置Modules -> Signing Configs，把module都配置上（只配置entry也行）
image-20210905045159600
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);
