HarmonyOS 鸿蒙Next和安卓的关联到同一个项目
HarmonyOS 鸿蒙Next和安卓的关联到同一个项目
- 鸿蒙和安卓不是同一个项目,同一个主体,后续怎么关联到同一个项目
- 鸿蒙和安卓不是同一个项目,不是同一个主体,后续怎么关联到同一个项目(可以进行迁移)
开发者您好,针对您的两个问题:
一、同主体、分属不同 AGC 项目(安卓、鸿蒙账号主体一致)
登录AppGallery Connect,选择“用户与访问”,左侧菜单选择“应用规则 > 应用系列管理”,进入“应用系列管理”界面,把双端应用加入同一应用系列,实现应用市场替换、数据互通迁移,详细步骤参考文档:
https://developer.huawei.com/consumer/cn/doc/app/agc-help-manage-app-series-0000002352038686
二、不同主体、不同 AGC 项目(安卓、鸿蒙归属不同开发者)
- 先走官方应用跨账号转移:转出方在应用详情页提交应用转移申请,资质审核通过后,安卓或鸿蒙应用全部转入同一开发者账号(APPID、下载、评论数据保留),建议安卓应用转移到鸿蒙账号下,详细步骤参考文档:https://developer.huawei.com/consumer/cn/doc/app/agc-help-transfer-harmonyos-0000002138675041
- 转移完成后再根据第一种情况创建应用系列绑定双端应用。
更多关于HarmonyOS 鸿蒙Next和安卓的关联到同一个项目的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
第一个搜“应用系列”。第二个理论和现实都不可能。,
这个问题通常是在 AppGallery Connect(AGC)项目关联 场景下讨论的,即 Android 应用和 HarmonyOS 应用如何归属到同一个项目、共享运营数据、账号体系和服务配置。
情况一:鸿蒙和安卓不是同一个项目,但属于同一个开发者主体
例如:
企业A
├── Android应用(已上线)
└── HarmonyOS应用(新创建)
这种情况最容易处理。
方案
在 AGC 中:
我的项目
↓
选择已有项目
↓
添加应用
↓
Platform选择HarmonyOS
或者:
已有HarmonyOS项目
↓
添加Android应用
一个 AGC Project 本身支持多个平台应用。
最终结构类似:
项目A
├── Android App
├── HarmonyOS App
├── iOS App
└── Web App
这样可以共享:
- Analytics
- App Linking
- Cloud DB
- Cloud Storage
- Push Kit
- Auth Service
等 AGC 服务配置。
已经创建成两个项目怎么办?
可以向华为开发者支持提交工单申请项目调整。
但实际操作中很多团队直接:
保留原Android项目
↓
在原项目中新增HarmonyOS应用
↓
逐步迁移
成本最低。
情况二:鸿蒙和安卓不是同一个项目,也不是同一个主体
例如:
公司A
Android应用
公司B
HarmonyOS应用
或者:
个人开发者
↓
后续变成企业开发者
这种情况会涉及:
应用归属权
开发者主体
应用资产
问题。
是否可以迁移?
答案:
可以申请迁移
但不是开发者自己点一下就完成。
需要走:
应用转让
主体变更
应用迁移
流程。
通常需要提供:
- 双方营业执照
- 双方开发者账号
- 应用归属证明
- 商标或版权证明(部分场景)
由华为审核处理。
最终能否关联成同一个应用?
需要区分两种含义。
关联运营项目
例如:
同一个账号体系
同一个云数据库
同一个用户体系
同一个Push
这种:
可以
通过迁移后统一到同一个 AGC Project。
关联应用商店页面
例如用户看到:
XX商城
Android版
XX商城
HarmonyOS版
希望变成:
XX商城
统一展示。
这种需要:
- 相同应用名称
- 相同业务主体
- 华为审核确认属于同一产品
具体是否能合并展示,取决于当前 AppGallery 的运营规则。
实际企业迁移经验
大多数企业采用:
原Android应用
↓
在原AGC项目下新增HarmonyOS应用
↓
保持同包名风格
↓
共用后台
↓
共用账号体系
这样:
用户
Android登录
↓
HarmonyOS登录
↓
同一账号数据
体验最一致。
而如果已经创建成:
两个主体
两个AGC项目
则需要走官方应用迁移或主体变更流程,无法由开发者自行直接合并。
你需要弄一下应用转移,将App转移到同一个账号下:
应用转移是指将AppGallery Connect中的应用(含游戏)从一个账号转移到另一个账号进行维护。
应用转移后,该应用的应用层面信息不会发生改变,相关信息如下图标识的内容,包括:包名、APP ID、公钥指纹、OAuth 2.0客户端ID和之前配置的回调地址。
操作流程:

详细的开发文档:https://developer.huawei.com/consumer/cn/doc/app/agc-help-maintain-transfer-0000002236494390
我问下,公钥指纹都不变的话,迁移后需要重新备案吗
不需要
问题一:可以联系AGC支持进行调整
问题二:可以先进行应用转让,将两个项目转移到统一个主体,然后再按照问题一的方式进行操作
不可能的事,
HarmonyOS NEXT 无法直接运行安卓 APK,因此同一项目需通过多工程或共享模块实现关联。可采用 ArkTS 开发鸿蒙端,Kotlin 开发安卓端,共用资源文件或数据层。也可使用 Flutter(Dart 语言)等跨平台框架,一次编写多端部署,但需分别编译适配各自生态。
如果同一主体(如开发者或公司同一团队)同时维护项目,可通过模块化拆分共享 C/C++ 业务逻辑层(N-API)或用 Kotlin Multiplatform 共享数据模型、网络等,上层 UI 分别用 ArkUI 和 Android Jetpack 实现,再以多 target 工程组织。
如果主体不同且需迁移,关联本质是重新实现:HarmonyOS NEXT 基于 ArkTS/方舟运行时,与 Android 无运行时兼容,无法代码直接复用,需参照原有 Android 业务重新用 ArkUI 开发,再通过 App Linking 或统一服务端关联至同一项目。


