“前台服务”文档介绍了 Android 前台服务的当前行为。本文档针对大多数应用(无论其是否以最新版 Android 为目标平台)提供了最佳实践指南。
本页介绍了前台服务的一些最新重要变更,以及这些变更对未以最新版 Android 平台为目标平台的应用的影响。在许多情况下,对于以较低 API 级别为目标平台的应用,最佳实践是可选的;对于以较高 API 级别为目标平台的应用,则是强制性的。
Android 9(API 级别 28)
Android 9 引入了 FOREGROUND_SERVICE
权限。在 Android 9 上运行且使用前台服务的应用必须具有该权限。
如果面向 API 级别 28 或更高版本的应用尝试创建前台服务但未请求 FOREGROUND_SERVICE
权限,则系统会抛出 SecurityException
。
Android 10(API 级别 29)
以下要求适用于以 API 级别 29 或更高级别为目标平台的应用:
Android 11(API 级别 30)
以下要求适用于以 API 级别 30 或更高级别为目标平台的应用:
- 如果应用的前台服务使用相机或麦克风,则应用必须分别使用
camera
或microphone
服务类型声明该服务。
Android 12(API 级别 31)
以下要求适用于以 API 级别 31 或更高级别为目标平台的应用:
- 应用在后台运行时不得启动前台服务,但少数特定情况除外。如需了解详情以及此规则的例外情况,请参阅与从后台启动前台服务相关的限制。
Android 14(API 级别 34)
以下要求适用于以 API 级别 34 或更高级别为目标平台的应用:
- 您必须声明所有前台服务及其服务类型。
- 应用必须针对前台服务将要执行的工作类型请求适当的权限类型。每种前台服务类型都有对应的权限类型。例如,如果应用启动使用相机的前台服务,您必须同时请求
FOREGROUND_SERVICE
和FOREGROUND_SERVICE_CAMERA
权限。如果应用以 API 级别 34 或更高级别为目标平台,但未请求适当的特定权限,系统会抛出SecurityException
。
Android 15(API 级别 35)
以下要求适用于以 API 级别 35 或更高级别为目标平台的应用:
- 对
dataSync
前台服务的运行时长实施了新的限制。前台服务超时行为中介绍了这些限制。类似的限制也适用于mediaProcessing
前台服务类型(Android 15 中的新类型)。 BOOT_COMPLETED
前台服务不再允许启动某些前台服务。- 只有当具有
SYSTEM_ALERT_WINDOW
权限的应用当前具有可见的叠加窗口(或满足后台启动限制的其他豁免条件之一)时,才允许从后台启动前台服务。之前,这些应用的豁免范围更广。