Android 混合原生开发 android混合开发框架

先给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文件：

// 根结点添加：
<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" />

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-OQaPfi6p-1630873581296)(https://gitee.com/harmony-os-jt/harmony-os-android-mix/raw/master/doc/Pictures/run.gif)]

至此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);