Android14下work-runtime的SystemForegroundService适配及setExpedited异常咨询
问题描述
我按照官方文档调用setExpedited()将WorkRequest设为加急任务模式，要求对应的ListenableWorker必须实现getForegroundInfo方法。我使用的是CoroutineWorker，因此在doWork()方法内调用setForeground()传入ForegroundInfo，但遇到了两种异常情况：
- 若在ForegroundInfo中指定
foregroundServiceType，会抛出异常：java.lang.IllegalArgumentException: foregroundServiceType 0x00000001 is not a subset of foregroundServiceType attribute 0x00000000 in service element of manifest file
- 若不指定该类型，会抛出异常：
android.app.InvalidForegroundServiceTypeException: Starting FGS with type none callerApp=ProcessRecord{7014511 11425:com.tuya.smartlife/u0a282} targetSDK=34
目前work-runtime组件的清单文件中已声明SystemForegroundService，请问我是否需要在应用中重新声明该Service并指定foregroundServiceType，以合并到最终的清单文件中？
解决方案
是的，你必须在应用的AndroidManifest.xml中重新声明WorkManager的SystemForegroundService，并明确指定符合业务场景的foregroundServiceType。
原因分析
work-runtime组件自带的清单声明里，SystemForegroundService的foregroundServiceType属性值为0（未指定类型）。而Target SDK 34及以上版本强制要求启动前台服务必须明确指定合法的类型：
- 指定类型时，系统会校验Service声明的类型是否包含你传入的类型，原声明无类型所以抛出第一个异常；
- 不指定类型时，系统因Target SDK限制直接抛出第二个异常。
具体实现
- 在应用的
AndroidManifest.xml中添加以下Service声明：
<service android:name="androidx.work.impl.foreground.SystemForegroundService" android:foregroundServiceType="dataSync" <!-- 根据你的业务替换为对应类型 --> android:exported="false" />
- 替换
dataSync为匹配你任务场景的合法类型，常见可选值包括：dataSync：数据同步类任务mediaPlayback：媒体播放类任务location：位置追踪类任务remoteMessaging：远程消息推送类任务- 若需要多个类型，可使用
|分隔（如dataSync|remoteMessaging）
- 确保ForegroundInfo中指定的
foregroundServiceType与清单声明的类型一致，或是其子集。
这样合并后的最终清单文件中，SystemForegroundService会带有你指定的类型，即可解决两种异常问题。
内容的提问来源于stack exchange，提问作者Black小明
