HarmonyOS-Android混合开发之APK混入 原创 精华

先给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

至此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交互：戳我->
  • 问题集锦：戳我->