华为HarmonyOS部署microG:安装、权限与自检的完整指南
【免费下载链接】GmsCoreFree implementation of Play Services项目地址: https://gitcode.com/GitHub_Trending/gm/GmsCore
华为 HarmonyOS 设备上应用一直提示「Google Play 服务不可用」,开源的 Play 服务替代实现 microG 能让这些应用重新跑起来。本文以一台装不了 GMS 的华为手机为例,把 microG 华为部署的选型、配置和自检一次讲透。
安装前先确认三件事:该不该装、装哪个、怎么配套
先判断、后动手,对照下面三条标准再下载 APK:
- 该不该装:华为设备拿不到 GMS,根源是系统里缺少 Google 官方签名,不少应用启动时会校验「Google Play 服务环境是否正规」(这就是签名校验,即应用偷偷问系统:你是真 GMS 吗)。microG 正是来补这一环,让校验结果与官方环境一致。如果你的设备本来就带 GMS,无需折腾。
- 装哪个:版本号必须带
-hw后缀,如0.3.3.1.240913-hw。⚠️ 没有这个后缀的普通构建没有做华为系统适配,装上大概率卡在签名校验上。偏好源码构建的话,git clone https://gitcode.com/GitHub_Trending/gm/GmsCore之后,play-services-core/ 中已预置 huawei 渠道的 flavor,构建对应变体即可。 - 怎么配套:Core 与 Companion 必须同批次;FakeGapps 可选,仅当应用依赖 Google 应用入口时才加装。
通过标志:能明确指出版本字符串里的-hw后缀,且手里 Companion 与 Core 是同一批次。
第 1 步:按顺序装好三个组件
动作:先装 Core,再装 Companion,最后视需要装 FakeGapps。顺序不能颠倒——只有 Core 装进系统后,microG 的服务入口才会注册出来,Companion 才认得并接管后续配置。
完成标志:应用列表里出现「microG 服务」,且 Companion 的配对页面显示的版本号与 Core 一致。
第 2 步:位置与通知权限一步到位
位置服务跑在后台,而 HarmonyOS 对后台定位管控很严,位置权限要直接给到最高档。路径是:
设置 → 应用 → 应用管理 → microG 服务 → 权限 → 位置信息 → 始终允许
进入位置权限页后有四个档位:「每次使用询问」「仅使用期间允许」撑不住后台定位场景,选「禁止」则定位直接失效,勾住「始终允许」:
顺手把另外两项处理掉:通知权限保持开启——推送通道靠系统在后台经通知通道送达消息,关了通知权限推送就收不到;「媒体和文件」按应用需求放开,默认禁止一般够用。这套华为侧的权限交互逻辑就写在 play-services-location/core/src/huawei/ 目录中。
完成标志:应用信息页里「位置信息」标注为「始终允许」,通知权限开关处于开启状态。
第 3 步:后台保活三件套,别让系统杀掉 microG
权限给对只完成一半,另一半是阻止系统把 microG 当普通后台应用回收:
设置 → 电池 → 应用启动管理,找到 microG 服务,改为手动管理并勾满三项- 多任务界面下拉 microG 服务卡片,给它上锁
- 自启动权限里放行 microG 服务
完成标志:最近任务里 microG 的卡片出现锁形标识。
第 4 步:跑一遍 Companion 自检 ✅
动作:打开 microG Companion,进入 Status 自检页,按项核对:签名验证结果、服务组件状态、已授权权限列表。
完成标志:各条目全绿。出现红项时先对照下一节的排障分组定位原因,别急着重装。
出问题先查这里:按根因分组速查
第一组:版本/构建不对(症状:应用提示「Google Play 服务不可用」、签名校验失败)
- 版本号缺
-hw后缀,或 Core 与 Companion 不同批次 → 卸载,换华为专用构建并统一批次重装。
第二组:权限没给到位(症状:定位不工作、推送收不到)
- 位置信息改「始终允许」,通知权限保持开启;「每次询问」和「仅使用期间」不足以支撑后台场景。
第三组:后台进程被杀(症状:服务反复被杀、定位时好时坏)
- 电池优化豁免、自启动、多任务锁三者补齐,再观察一段时间确认不再被回收。
长期维护:三个习惯
- 系统升级后:HarmonyOS 的后台策略随版本收紧,升级完重新核一遍电池优化豁免、自启动与多任务锁这几项。
- 日志里出现 microG 相关异常时:先看 logcat 里 microG 的日志定位,比重复卸载重装有效得多。
- 项目发布新的
-hw构建时:及时升级;Google 接口偶发超时的话,在 Companion 设置里配置代理,并把 DNS 换成稳定的公共解析。
最终原则与代码位置
一句话原则:版本先选对(-hw后缀、Core 与 Companion 同批次),再把权限和保活做对,microG 在华为设备上才跑得稳。
代码位置索引:
- 华为渠道位置适配:play-services-location/core/src/huawei/
- 签名伪造模块:fake-signature/
- 商店(vending)相关实现:vending-app/
【免费下载链接】GmsCoreFree implementation of Play Services项目地址: https://gitcode.com/GitHub_Trending/gm/GmsCore
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考