乐于分享
好东西不私藏

在安卓应用上扩展鸿蒙特性

本文最后更新于2025-12-31,某些文章具有时效性,若有错误或已失效,请在下方留言或联系老夜

在安卓应用上扩展鸿蒙特性

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

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

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

开发步骤

①准备 Android 工程

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

②Android 工程改造

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

  • abilityshell_ide_java.jar 在这里,自行 copy 到安卓工程中。

  • 注意 apk 文件名必须是 xxx-entry.apk 这种格式。

③准备鸿蒙工程

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

④配置鸿蒙工程

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

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

  • 鸿蒙的 version 和 apk 的 version 要一致。

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

config.json 里都支持哪些字段,没必要看文档,只要按住 ctrl 点击相应的字段,就可以看到,比如点击 app 字段。

⑤卡片

本示例中,我用 DevEco Studio 建了一个名为 mycard 的 module,并且勾选”show in service center”,这样这个卡片就可以显示在”服务中心”了。

有几点需要说明:

必须签名(我的验证结果是这样的),所以要有真机。我提交的签名文件是绑定我的机器,所以你要更新自己的签名文件。

卡片的 config.json 的 app 字段要和 entry 的 app 字段完全一致(relatedBundleName 字段只在 entry 里有就可以,卡片里不写也行)。

多 module 的工程,运行的时候要勾选 Deploy Multi Hap Packages。

为什么把卡片放在独立的 module 里?因为混合打包下,entry 只是一个壳,我们可以把 entry 当作 apk 的占位,所以 entry 里的内容都不会打到 appj 里,鸿蒙相关的功能代码我们只能放在独立的 module 中。(当然,这也是我的验证结果,最终要等华为官方更明确的文档解释)

⑥鸿蒙打开 apk 中的 activity

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

⑦鸿蒙打开 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");
鸿蒙 Uri 对应安卓 Uri,鸿蒙 Entity 对应安卓 Category,相应的 api:
//ohos put:
Set<String> entities = new HashSet<>();
entities.add("entity.user.c1");

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();

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

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" />

👇点击关注鸿蒙技术社区👇

了解鸿蒙一手资讯

“阅读原文”了解更多

本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » 在安卓应用上扩展鸿蒙特性
×
订阅图标按钮