鸿蒙混合打包(支持安卓、鸿蒙相互调用) 原创 精华

发布于 2021-6-28 19:56
浏览
22收藏

最新消息:此方案打出的包已$\color{#ff0000}{不能上架}$,请大家知悉

签名相关的问题,就不要在下面问了!
如果遇到问题,建议重复阅读2.1、5.1、5.3、5.4!
如果还有问题,也欢迎勇跃提问!

高效提问的最基础前提就是先排除自身的问题。


先放代码:
-----> 喵叔catuncle / 鸿蒙混合打包 <-----

介绍

鸿蒙混合打包。在现有安卓应用的基础上扩展鸿蒙的特性,以最快的速度布局鸿蒙生态!

参考:京东APP鸿蒙版上架实践本项目只是这篇文章的一个验证,让更多的兄弟们可以少走弯路。

我尽可能把每一步的改动作为一个commit,这样方便大家看代码。

开发步骤

  1. 准备Android工程

    本示例中,我用AS建了一个Hello World工程。

  2. Android工程改造

    请参考京东APP鸿蒙版上架实践

    这一步,有两点要注意的:

    1. abilityshell_ide_java.jar在鸿蒙sdk目录(---->你自己电脑里!<----) ,自行copy到安卓工程中 鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区
    2. 注意apk文件名必须是 xxx-entry.apk这种格式
  3. 准备鸿蒙工程

    本示例中,我用DevEco Studio建了一个Hello World工程。 鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区

  4. 配置鸿蒙工程

    请参考京东APP鸿蒙版上架实践

    这一步,有三点要注意的:

    1. 签名就不要转了,直接重新创建,只要秘钥和别名和Android的保持不变。(如果在模拟器上运行,不配置签名也能跑起来)

    2. 鸿蒙的version 和apk的version要一致

    3. config.json的app节点下,增加relatedBundleName而不是originalName

      config.json里都支持哪些字段,没必要看文档,只要按住ctrl点击相应的字段,就可以看到,比如点击app字段。 鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区

  5. 卡片

    本示例中,我用DevEco Studio建了一个名为mycard的module ,并且勾选"show in service center",这样这个卡片就可以显示在"服务中心"了。鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区

    有几点需要说明:

    1. 必须签名(我的验证结果是这样的),所以要有真机。我提交的签名文件是绑定我的机器,所以你要更新自己的签名文件。
    2. 卡片的config.json的app字段要和entry的app字段完全一致relatedBundleName字段只在entry里有就可以,卡片里不写也行)
    3. 多module的工程,运行的时候要勾选Deploy Multi Hap Packages鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区
    4. 为什么把卡片放在独立的module里?因为混合打包下,entry只是一个壳,我们可以把entry当作apk的占位,所以entry里的内容都不会打到app里,鸿蒙相关的功能代码我们只能放在独立的module中。(当然,这也是我的验证结果,最终要等华为官方更明确的文档解释)
  6. 鸿蒙打开apk中的activity

    请参考京东APP鸿蒙版上架实践

  7. 鸿蒙打开apk中的activity,并传递参数

    • 鸿蒙IntentParams对应安卓Bundle,相应的api
      //ohos put:
      IntentParams params = new IntentParams();
      params.setParam("androidFile1","androidFile1----");
      intent.setParams(params);
      
      //android put:
      Intent intent = new Intent();
      intent.putExtra("androidFile1","androidFile1----");
      
      //get:
      intent.getStringExtra("androidFile1");
      //ohos put:
      Set<String> entities = new HashSet<>();
      entities.add("entity.user.c1");
      
    • 鸿蒙Uri对应安卓Uri,鸿蒙Entity对应安卓Category,相应的api
      //ohos put:
      Operation operation = new Intent.OperationBuilder()
              .withUri(Uri.parse("https://www.baidu.com"))
              .withEntities(entities)
              .build();
      
      //android put:
      Intent intent = new Intent();
      intent.setData(Uri.parse("https://www.baidu.com"));
      intent.addCategory("entity.user.c1");
      
      //get:
      intent.getData();
      intent.getCategories();
      
  8. 安卓打开鸿蒙中的ability,并传递参数

    • 核心代码:

      Intent intent = new Intent();
      //CardAbility有对应的代理类CardAbilityShellActivity,我们可以这样理解。
      ComponentName componentName = new ComponentName("wang.unclecat.hello","wang.unclecat.mycard.CardAbilityShellActivity");
      intent.putExtra("msg","鸿蒙哥哥,我是安卓");
      intent.setComponent(componentName);
      startActivity(intent);
      
    • 原理:鸿蒙工程在编译期,Ability会生成相应的代理类XXXShellActivity。如下图所示。我们只要访问这个代理Activity,就可以在apk中访问相应的Ability了。

      以上都只是猜测,试过之后,还真的可行。

      鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区
      鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区

    最终效果

    鸿蒙混合打包(支持安卓、鸿蒙相互调用)-开源基础软件社区

常见问题(欢迎评论区补充)

  • Failure[INSTALL_FAILED_INCONSISTENT_BUNDLE_VERSION]
    混合打合时要和apk 的version一致
  • Failure[INSTALL_FAILED_RESTRICTED_PERMISSIONS_NOT_GRANTED]
    没有继承HarmonyApplication或者没有配置到AndroidManifest.xml中
  • Failure[INSTALL_FAILED_INTERNAL_ERROR]
    确认一下:
    在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" />
    

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