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

最新消息：此方案打出的包已$\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" />