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

发布于 2021-9-6 19:24
浏览
5收藏

先给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-Android混合开发之APK混入-开源基础软件社区

  • HarmonyOS工程·:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • HarmonyOS - Android工程

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 启动两个工程,确保运行OK。

2、Android工程改造

以适配HarmonyOS

  • 引入abilityshell_ide_java.jar到libs中,并在app module的gradle中引入依赖(别忘了 sync now)

     compileOnly files('libs/abilityshell_ide_java.jar')
    

    该jar包就在HarmonyOS工程的SDK中,打开文件管理器即可获得:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 创建Application,继承HarmonyApplication:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 修改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" />
    

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

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

  • Build -> Generate Signed Bundle/APK… -> APK -> NEXT:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 生成当前应用的签名文件:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

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

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 验证密码

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 打包成APK:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 将生成的apk文件命名为android-entry(因为HarmonyOS要求引入的apk文件必须以entry.apk结尾)

    HarmonyOS-Android混合开发之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文件:

    HarmonyOS-Android混合开发之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保持一致:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 更改entry module -> src -> main -> config.json -> module -> distro -> installationFree值为false:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 新建sign文件夹,存放所需的签名文件证书

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 生成HarmonyOS应用的签名文件,必须和创建Android签名时参数保持一致。Build -> Generate Key and CSR

  • 新建p12文件:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

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

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

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

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

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 创建成功:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

6、创建cer证书

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

  • 进入AppGallery Connect

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 进入【用户与访问】-> 【证书管理】:

    新建证书,上传刚才创建的csr证书,如下:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 下载cer证书:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

7、下载p7b证书

  • 回到AppGallery Connect首页,进入【我的项目 】-> 【添加项目】:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 不要立即在项目页面添加应用,虽然流程相似,但配置参数不一样(会出现异常)。下滑左侧菜单栏,进入HarmonyOS应用,添加HarmonyOS应用:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 并根据提示设置SDK:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    第二步:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    注意去掉上面箭头的空格,不然sync时会报错:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    classpath 'com.huawei.agconnect:agcp-harmony:1.0.0.300'
    implementation 'com.huawei.agconnect:agconnect-core-harmony:1.0.0.300'
    
  • 然后再进入HarmonyOS应用菜单下,添加Profile文件:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

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

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 下载p7b证书,至此所有证书已集齐完毕:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

8、添加业务module

默认入口entry作为引入apk的加壳,我们需要创建新的module来作为HarmonyOS应用的入口。

  • 创建module:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

**注:**要保证module的version也保持一致。

9、配置签名证书

  • 进入Project Structure:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 配置Project -> Signing Configs:

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

  • 配置Modules -> Signing Configs,把module都配置上(只配置entry也行)

    HarmonyOS-Android混合开发之APK混入-开源基础软件社区

10、配置启动类型

由于我们新的入口变为myentry,所以我们在启动myentry时需要把entry部署进去,如下:

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

10、启动myentry

HarmonyOS-Android混合开发之APK混入-开源基础软件社区

至此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、相关链接

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
标签
已于2021-9-7 10:26:12修改
7
收藏 5
回复
举报
回复
添加资源
添加资源将有机会获得更多曝光,你也可以直接关联已上传资源 去关联
    相关推荐