文档开发者中心
我的
|

定位服务

HarmonyOS 5

定位长时任务,签名证书不一样,测试效果不一样。

20

我这边需要做了一个需要定位的长时任务。但是测试过程因为签名测试方式不同完全效果不一样。

测试一(调试证书):我用添加设备的id 后申请的调试证书,用DevEco studio测试。一整天都是正常的。

测试二(发布证书):然后我测试都正常后。用发布证书编译 上传到 平台,并发布邀请测试 版本。然后通过短信链接下载测试。发现 一息屏没多久就休眠了。完全无法实现后台定位

测试多次都是这样的结果。当前问题是哪出异常了?有大佬解答疑问吗?

点赞
1
收藏
回复
15
分享
举报
浏览139 发布于2026-09-23 01:39福建
全部评论
最多点赞
最新发布
最早发布
|
技术支持

应用以正式签名运行,系统会严格按照正式规格执行后台冻结策略。此时定位类型长时任务受以下系统规则约束:当应用基于定位的长时任务退至后台后,如果设备进入绝对静止状态超过3分钟(或应用退后台前已进入静止状态超过30秒),系统会主动冻结应用进程,冻结后,定位回调不再触发,进程被挂起。

解除冻结的条件是打破绝对静止状态:
亮屏情况下,手机动一下即可解除冻结
息屏情况下,需要持续运动200秒才能解除冻结

2
3楼编辑于2026-09-23 03:44 来自广东
  • 衣我以夜
    但是这样不现实啊。总不能要求用户一直保持运动。当前app就是为了防止公司员工的 出区检测。 有没有办法可以解决这个问题呢?现在的鸿蒙设备不支持 手动设置后台运行的权限。那鸿蒙设备是不是就是不支持这种场景的实现?
    2026-09-23 04:11 来自福建
  • 匿名用户匿名用户回复衣我以夜
    这种场景应该有豁免途径吧,提个工单问一下呢?
    2026-09-28 12:14 来自广东

你这两次测试同时换了调试环境、安装方式和包配置,仅凭这一个现象还不能确定是否为证书导致的。建议优先查发布版的定位长时任务是否真正生效。

建议按这个顺序排查:

  1. 排除调试环境影响:调试包退出调试、断开电脑,结束应用后从桌面重新打开,再息屏测试;与邀请测试包保持相同的定位授权、省电设置。
  2. 核对发布包配置:定位授权是否成功,是否声明 KEEP_BACKGROUND_RUNNING,对应 UIAbility 是否配置 "backgroundModes": ["location"];后台定位权限按官方指南和目标系统版本核对。
  3. 记录长时任务申请结果:确认申请的是 BackgroundMode.LOCATION,记录成功回调和失败的 code/message。不能只看“调用过接口”;同时检查长时任务通知是否出现、息屏后是否消失。
  4. 检查退后台时是否自己停了任务:重点查 onBackground、aboutToDisappear 中有没有取消长时任务或执行 off('locationChange')。持续定位建议用位置订阅,别只靠定时器反复获取单次位置。

如果确认任务申请成功,息屏后仍中断,就抓发布版的系统日志:区分是定位回调停止、任务被取消,还是进程被挂起/终止。

官方参考:后台定位完整流程、长时任务说明、位置权限申请。

4
2楼编辑于2026-09-23 02:11 来自广东
  • 匿名用户匿名用户
    学习了
    2026-09-23 02:49 来自广东
  • 衣我以夜

    您说的前面几点。已经确认是正常的了。

    然后按照您说的。我已经抓了系统日志。发现就是处于静止状态的时候。被冻结挂起了。亮屏后瞬间被唤醒继续工作。 然后同等情况下 调试证书是被豁免的。

    2026-09-23 05:53 来自福建
  • 蓝瘦的蜕变回复衣我以夜

    看了你补充的日志,这个现象其实符合定位长时任务的静止冻结策略,并不是长时任务申请没成功。 用正式签名包跑,应用退到后台之后规则是这样:

    • 如果设备保持绝对静止超过 3 分钟,或者退后台前就已经静止 30 秒以上,系统就会冻结应用进程,定位回调也跟着停掉。
    • 想要解冻,需要打破绝对静止:亮屏的时候动一下设备就行;息屏状态下则需要持续运动 200 秒。

    所以就算长时任务申请成功,应用也不是永远不会被冻结。你现在测试用的调试签名有策略豁免,它的运行效果跟正式签名的会存在差异。

    还是建议换成正式签名包,分别测试静止、持续运动、恢复运动这几种场景下的定位表现,同时做好定位中断后的业务恢复逻辑。 如果业务必须要息屏静止时也持续获取定位,只靠定位长时任务是做不到的。可以提交华为开发者工单,附上系统版本、冻结日志和你的业务场景,看看有没有其他可用方案。在线提单

    2026-09-23 06:27 来自广东
  • 展开剩余1条回复

可以尝试下使用地理围栏,地理围栏(GeoFence)是一种基于地理位置的技术,它允许开发者设定特定的地理区域,在用户进入、离开或驻留在这个特定区域的时候,可以把该地理围栏事件(进入/离开/驻留)通知应用,应用在接收到这些事件时完成后面的业务逻辑,以达到提醒用户的目的。这貌似符合你说的这个防止公司员工的出区检测这个场景。

地理围栏开发指导-Location Kit(位置服务)-应用服务 - 华为HarmonyOS开发者

6楼编辑于2026-09-23 09:44 来自广东

先别把差异直接归因于“调试证书有后台定位特权”。官方条件是后台定位权限已声明并获用户授权,同时启动 LOCATION 类型长时任务;发布包要在同一台设备上逐项核对这两项,以及任务启动是否成功、通知是否持续可见。

收起
自动换行
深色代码主题
复制
"requestPermissions": [
  { "name": "ohos.permission.LOCATION" },
  { "name": "ohos.permission.LOCATION_IN_BACKGROUND" }
]

这只是权限声明关键项,还需按版本要求申请授权并配置/启动 LOCATION 长时任务。两种包分别记录权限查询结果、长时任务接口返回码、息屏时间点的定位回调和系统日志;若发布包任务启动报错,优先查 backgroundModes 与对应错误码,而不是换证书碰运气。官方定位权限指南:https://developer.huawei.com/consumer/cn/doc/doccenter-capabilities/location-permission-guidelines

5楼回复于2026-09-23 09:15 来自四川
你这个现象不是定位长时任务本身的问题,而是签名体系切换后,系统对你的应用身份判定发生了变化,导致后台运行策略完全不同。调试证书能跑一整天,发布证书一息屏就休眠,这种“测试环境正常、发布环境直接被系统杀”的差异非常典型。
根因只有一个
调试证书默认带开发者权限,后台管控宽松;发布证书是正式身份,必须满足长时任务的所有校验,否则系统直接撤销任务并冻结进程。
你现在的现象说明:  
调试证书下长时任务实际是“放宽策略跑起来的”  
发布证书下长时任务“根本没有真正生效”
所以息屏后被系统休眠是必然结果。
长时任务在发布证书下会严格校验三件事
只要其中一条不满足,任务会被系统撤销,进程随后被冻结。
一 任务类型必须和业务完全匹配
定位必须用 LOCATION  
不能用其他类型  
不能混用  
不能写错大小写  
不能写在错误的 module.json5 层级
二 module.json5、代码申请、设备能力必须一致
三处必须完全对齐  
module.json5 的 backgroundModes  
startBackgroundRunning 的类型  
设备是否支持该类型  
任意一处不一致都会导致任务直接失败
三 任务必须在前台申请
后台申请一定失败  
调试证书下有时会被放宽  
发布证书下严格执行  
你如果是在页面切后台后才申请,发布环境必挂
---
你现在的现象说明任务实际是“未生效状态”
表现为:  
调试证书能跑  
发布证书息屏即休眠  
这正是系统判定你的长时任务无效后的默认行为
你可以直接验证:  
监听 continuousTaskCancel  
你会看到任务在息屏后被系统撤销  
原因码一般是任务类型不匹配、申请时机错误、配置不一致。
---
你需要检查的唯一关键点
下面这条是最常见的踩坑点,也是你现在最可能的问题:
module.json5 写了 LOCATION
代码里却传了 MULTIDEVICECONNECTION 或其他类型  
或者反过来  
或者设备不支持你写的类型  
调试证书下能跑  
发布证书下直接判定无效
你只要把这三处对齐,发布证书下就会和调试证书一致。
module.json5
`Json
收起
自动换行
深色代码主题
复制
"backgroundModes": ["LOCATION"]

申请

`ArkTS
收起
自动换行
深色代码主题
复制
backgroundTaskManager.startBackgroundRunning(backgroundTaskManager.BackgroundModeType.LOCATION)

时机
必须在前台页面里申请  
不能在后台  
不能在 Ability 切后台后申请
监听
`ArkTS
收起
自动换行
深色代码主题
复制
backgroundTaskManager.on('continuousTaskCancel', reason => {
    console.info('cancel', reason)
})
})

你会看到发布证书下的真实取消原因。
调试证书下的“正常”不具备参考价值  
发布证书才是系统真实策略  
你现在的行为是:长时任务在发布证书下没有通过校验 → 系统撤销任务 → 进程息屏冻结 → 定位停止
把 module.json5、申请类型、申请时机对齐后,发布证书下就会和调试证书一致。
展开全部
2
4楼回复于2026-09-23 04:53 来自陕西
  • 衣我以夜

    您说的这些。已经核对是正常的都已实现了。

    后面抓了系统日志。发现就是处于静止状态几分钟后的时候。被冻结挂起了。亮屏后瞬间被唤醒继续工作。 然后同等情况下 调试证书是被豁免的。

    2026-09-23 05:55 来自福建
  • 心系天下回复衣我以夜
    你现在已经把关键事实都验证出来了:  
    发布证书下长时任务是有效的,但设备进入静止态几分钟后被系统冻结,亮屏瞬间恢复;调试证书下同样场景却不会冻结。这个现象本身就已经把问题定死了,不需要再怀疑配置、权限、调用时机。
    真正的根因就是  
    调试证书默认豁免冻结  
    发布证书严格执行冻结  
    你抓到的系统日志已经说明一切:  
    发布证书 → 进入静止态 → 系统冻结 → 定位停止  
    亮屏 → 立即解冻 → 定位继续  
    调试证书 → 同样静止态 → 不冻结 → 定位持续  
    这不是你代码的问题,也不是长时任务的问题,而是系统策略本身的行为。长时任务只能保证后台运行,不保证后台永不冻结。静止冻结是系统级策略,发布证书下无法绕过,调试证书的表现没有参考价值。
    你现在的结论是正确的  
    发布证书下的冻结是系统正常行为  
    调试证书下的不冻结是系统豁免行为  
    如果业务必须息屏静止也持续定位,公开能力范围内没有任何办法做到。你能做的只有在业务上处理冻结后的恢复,或者走企业渠道询问是否有特殊策略可申请。
    你的实现是正确的,系统行为也是预期的,差异完全来自签名身份带来的策略差异。
    没有办法让发布证书的应用在“息屏且设备静止”状态下继续跑长时定位任务
    你能做的唯一路径只有一个  
    如果业务必须息屏静止也持续定位,只能走企业渠道或官方提单,询问是否有特殊策略可申请。公开能力里没有任何方式能做到你要的效果。
    2026-09-23 06:54 来自陕西
AI 生成内容,仅供参考

这是一个非常典型的问题,核心原因在于 HarmonyOS 系统对调试应用和发布应用的后台运行管理策略存在显著差异。调试证书安装的应用在系统中享有更宽松的后台运行策略(系统不会轻易对调试应用执行冻结/休眠操作),而发布证书签名的应用则完全受系统标准的后台管理策略约束,包括应用冻结、电池优化、后台限制等机制都会正常生效。因此,如果代码中长时任务的申请或配置存在不完善之处,在调试模式下可能被宽松策略"掩盖"了问题,但在发布模式下就会暴露出来。

以下是导致该问题的常见原因及排查方向:

1. module.json5 中 backgroundModes 配置不完整

长时任务需要在 module.json5 中声明 backgroundModes,必须包含 location 模式。如果配置缺失或不正确,发布应用在后台将无法持续定位。

收起
自动换行
深色代码主题
复制
{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "backgroundModes": ["location"]
      }
    ]
  }
}

请检查发布构建产物中的 module.json5 是否确实包含了该配置,有时构建变体(debug/release)的配置差异可能导致 release 包中该字段丢失。

2. 长时任务 API 调用时机或方式不正确

在进入后台前,必须通过 backgroundTaskManager.startBackgroundRunning() 正确申请长时任务,且 backgroundModeName 参数需要与 module.json5 中声明的模式对应。

收起
自动换行
深色代码主题
复制
import { backgroundTaskManager } from '@kit.BackgroundTasksKit';
import { common } from '@kit.AbilityKit';

// 申请长时任务(在 Ability/UIAbility 的 onWindowStageCreate 或合适时机调用)
async function startContinuousTask(context: common.UIAbilityContext): Promise<void> {
  try {
    await backgroundTaskManager.startBackgroundRunning(context, 'location');
    console.info('长时任务申请成功');
  } catch (err) {
    console.error(`长时任务申请失败: ${JSON.stringify(err)}`);
  }
}

// 停止长时任务
async function stopContinuousTask(context: common.UIAbilityContext): Promise<void> {
  try {
    await backgroundTaskManager.stopBackgroundRunning(context);
    console.info('长时任务已停止');
  } catch (err) {
    console.error(`停止长时任务失败: ${JSON.stringify(err)}`);
  }
}

关键排查点:确认在应用进入后台(如 onWindowStageDestroy 或页面 onPageHide)之前就已经成功调用了 startBackgroundRunning,而不是在进入后台之后才调用。

3. 后台定位权限未正确申请

后台定位需要单独的权限 ohos.permission.LOCATION_IN_BACKGROUND,这是一个 system_grant 类型的权限,需要在 module.json5 的 requestPermissions 中声明。

收起
自动换行
深色代码主题
复制
{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",
        "reason": "$string:location_reason",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.LOCATION",
        "reason": "$string:location_reason",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.LOCATION_IN_BACKGROUND",
        "reason": "$string:location_background_reason",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "always"
        }
      }
    ]
  }
}

注意 when 字段必须设置为 "always",表示在前台和后台均允许使用该权限。

4. 系统电池优化/应用冻结策略

发布应用安装后,系统默认可能对该应用启用电池优化策略。在息屏状态下,系统会按照冻结策略对后台应用进行限制。需要引导用户在系统设置中手动操作:

  • 进入 设置 → 电池 → 更多电池设置,找到该应用,将其设置为"无限制"或加入电池优化白名单
  • 确认系统省电模式未开启,省电模式下系统会强制限制后台任务

这是调试模式和发布模式最关键的区别:调试应用默认不受电池优化约束,而发布应用默认受约束。

5. 邀请测试版本的系统信任级别

通过平台分发的邀请测试版本,其系统信任级别与正式上架应用可能存在差异。建议确认:

  • 邀请测试版本的应用是否被系统正确识别为合法应用
  • 检查安装后系统是否有额外的权限弹窗未被处理(发布安装首次启动时可能有权限授予流程被跳过)

排查建议

按以下优先级逐步排查:

  1. 首先解包发布版本的 HAP/HSP,检查 module.json5 中 backgroundModes 和 requestPermissions 是否完整且正确
  2. 在发布版本中添加日志,确认 startBackgroundRunning 是否调用成功,是否有异常返回
  3. 在系统设置中手动关闭该应用的电池优化限制,观察后台定位是否恢复正常
  4. 如果关闭电池优化后正常,说明问题出在系统冻结策略,需要在应用中引导用户进行设置
  5. 如果关闭电池优化后仍然异常,需要进一步检查定位服务的调用方式和生命周期管理是否正确

总结来说,调试证书下一切正常而发布证书下异常,最大概率的原因是系统对发布应用执行了后台冻结/电池优化策略,而长时任务的配置或调用方式在调试模式下被宽松策略掩盖了潜在问题。建议重点检查 module.json5 配置的完整性、长时任务 API 的调用时机,以及系统电池优化设置。

展开全部
1
1楼回复于2026-09-23 01:49 来自广东
  • 匿名用户匿名用户
    纯血鸿蒙的设备。没有以下相关设置的入口:

    发布应用安装后,系统默认可能对该应用启用电池优化策略。在息屏状态下,系统会按照冻结策略对后台应用进行限制。需要引导用户在系统设置中手动操作:

    • 进入 设置 → 电池 → 更多电池设置,找到该应用,将其设置为"无限制"或加入电池优化白名单
    • 确认系统省电模式未开启,省电模式下系统会强制限制后台任务

    这是调试模式和发布模式最关键的区别:调试应用默认不受电池优化约束,而发布应用默认受约束。

    2026-09-23 02:14 来自福建
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。