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工程:

    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中,打开文件管理器即可获得:

image-20210905025215595
  • 创建Application,继承HarmonyApplication:

    image-20210905040847676
  • 修改AndroidManifest.xml文件:

// 根结点添加:
    
    // application节点中添加:
    
    
image-20210905052001220

3、生成应用签名,打包apk

  • Build -> Generate Signed Bundle/APK... -> APK -> NEXT:
image-20210904235857693
  • 生成当前应用的签名文件:
image-20210905000105494

配置的密码规则要满足如下DevECO生成签名时配置的密码规则:

image
  • 验证密码
image-20210905000010248
  • 打包成APK:
image-20210905000202846
  • 将生成的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-20210905001919050
    image-20210905002618632

    p12文件也可以根据Android项目的签名文件sign.jsk生成:

keytool -importkeystore -srckeystore sign.jks -srcstoretype JKS -deststoretype PKCS12 -destkeystore sign.p12

这里我们在DevECO中生成也是一样的,密码保持一致就行。

  • 创建csr证书,注意和创建sign.jks时配置参数保持一样:

    image-20210905002719009
image-20210905002821947
  • 创建成功:

    image-20210905002846718
    image-20210905002933321

6、创建cer证书

文档地址:https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404

  • 进入AppGallery Connect:

    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-20210905010053325
    image-20210905010325262

    需要添加设备,自行百度设备添加方式吧(需要有HarmonyOS系统的真机哦)。

    image-20210905035040681
  • 下载p7b证书,至此所有证书已集齐完毕,准备召唤神龙:

image-20210905010531498

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部署进去,如下:

image

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

你可能感兴趣的:(HarmonyOS-Android混合开发之APK混入)