使用Google Play服务及地图等能力的应用迁移至Huawei App Gallery相关咨询

整体迁移核心流程 #

• 第一步：注册华为开发者账号，完成对应主体的实名认证（个人/企业），获取应用上架的基础权限。
• 第二步：梳理原有应用集成的Google服务，和华为HMS Core能力做一一映射：Google Play基础服务对应HMS Core基础SDK、Google Maps对应Map Kit、Google Analytics对应Analytics Kit、Google Location Service对应Location Kit，你用到的所有能力均有对应的替换组件，功能覆盖和原有Google服务完全一致。
• 第三步：根据你的上架需求选择适配方案：如果仅上架华为渠道，可以直接替换原有Google相关依赖和代码；如果需要同时保留Google Play和华为两个上架渠道，无需移除原有Google相关实现，通过Gradle的productFlavors做渠道隔离，分别打对应渠道的安装包即可。
• 第四步：完成全量功能测试，重点验证地图、定位、数据统计等原Google服务承载的模块，确保功能、体验和原有版本完全一致。
• 第五步：按照华为AppGallery的上架要求准备应用介绍、截图、隐私协议、权限声明等材料，提交审核，审核通过后即可完成上架。

Google Map适配华为Map Kit实操说明 #

不需要强制移除原有Google Maps相关代码，仅单华为渠道上架时建议移除，可减少包体积，多渠道上架时做代码隔离即可，适配成本很低，核心步骤如下：

• 先在华为开发者后台为你的应用开通Map Kit服务，下载生成的agconnect-services.json配置文件，放到项目的模块根目录下。
• 在项目级build.gradle中添加华为的Maven仓库地址，在模块级build.gradle中添加Map Kit的依赖，示例：implementation 'com.huawei.hms:maps:6.11.0.301'，可直接选用当前最新的稳定版本。
• 代码层面替换成本极低，华为Map Kit的接口设计和Google Maps高度对齐：
  • 布局文件中直接将com.google.android.gms.maps.MapView/MapFragment替换为com.huawei.hms.maps.MapView/MapFragment即可，参数配置完全一致。
  • 代码中的导包从com.google.android.gms.maps.*替换为com.huawei.hms.maps.*，常用的OnMapReadyCallback、标记添加、折线绘制、地图缩放、定位图层展示等逻辑几乎不需要修改，仅替换包名就能正常运行。
  • 原有Google Maps的API密钥无需保留，华为Map Kit的鉴权通过agconnect-services.json自动完成，不需要额外在代码或Manifest中配置密钥。
• 多渠道适配时，分别在Google和华为两个产品风味下引入对应平台的地图依赖，将地图能力抽为公共接口，两个渠道分别实现对应逻辑，完全不会出现代码冲突。

适配完成后记得在proguard-rules.pro中添加华为官方提供的HMS Core各Kit的混淆规则，避免Release包出现功能异常。

其他配套服务适配注意事项 #

• 定位服务：华为Location Kit的接口设计和Google Fused Location Provider高度一致，仅替换导包和初始化逻辑即可，定位精度、功耗表现和Google定位服务相当。
• 统计服务：华为Analytics Kit支持事件上报、用户分群、转化分析等所有Google Analytics具备的功能，原有埋点的事件名、参数都可以直接复用，仅替换上报SDK即可。
• 其他扩展能力：如果你后续需要适配华为渠道的推送、支付等能力，也有对应的Push Kit、IAP Kit可以替换，适配逻辑和地图类同，接口对齐度很高。

内容的提问来源于stack exchange，提问作者adm