Notifee库在Android 14上的前台服务适配指南

背景概述

随着Android 14的发布，Google对前台服务(Foreground Service)的行为进行了重要调整。这些变更主要涉及前台服务类型的强制声明和新增的权限要求，这对使用Notifee库进行通知开发的开发者产生了直接影响。

核心变更点

Android 14引入了两项关键变更：

1. 前台服务类型强制声明：所有前台服务必须明确声明其服务类型(foregroundServiceType)
2. 新增权限要求：特定类型的服务需要声明对应的权限

具体适配方案

1. AndroidManifest配置

开发者需要在AndroidManifest.xml中进行两项必要配置：

<manifest>
    <!-- 根据服务类型添加对应权限 -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
    
    <application>
        <!-- 声明Notifee的前台服务及类型 -->
        <service 
            android:name="app.notifee.core.ForegroundService" 
            android:foregroundServiceType="dataSync|camera|microphone|location"
        />
    </application>
</manifest>

2. 服务类型与权限对应关系

不同服务类型需要声明对应的权限：

• 数据同步(dataSync)：FOREGROUND_SERVICE_DATA_SYNC
• 媒体播放(mediaPlayback)：FOREGROUND_SERVICE_MEDIA_PLAYBACK
• 位置(location)：FOREGROUND_SERVICE_LOCATION
• 摄像头(camera)：FOREGROUND_SERVICE_CAMERA
• 麦克风(microphone)：FOREGROUND_SERVICE_MICROPHONE

3. 动态服务类型调整

根据Android官方建议，如果应用运行时需要变更服务类型，应该重新调用startForeground()并传递新的服务类型组合。例如：

1. 初始仅需要位置跟踪：传递location类型
2. 用户开始播放音频后：传递location|mediaPlayback组合类型

全屏意图权限变更

针对API级别34(Android U)及以上的应用，全屏意图(USE_FULL_SCREEN_INTENT)权限策略有所调整：

• 该权限现在被归类为特殊应用权限
• 只有核心功能需要全屏通知的应用才会被自动授予此权限
• 非核心功能(如普通通知)需要用户明确授权

最佳实践建议

1. 最小权限原则：只声明应用实际需要的服务类型和对应权限
2. 运行时检查：在代码中添加权限检查逻辑，处理权限被拒绝的情况
3. 渐进式功能：设计应用功能时考虑权限可能被拒绝的情况，提供降级方案
4. 用户引导：对于需要特殊权限的功能，提前向用户解释用途

常见问题解决

崩溃场景：当在Android 14上使用notifee.displayNotification并设置asForegroundService: true时出现崩溃

解决方案：

1. 确保已正确配置AndroidManifest.xml
2. 检查是否声明了所有需要的服务类型和权限
3. 验证应用是否实际获得了所需权限

通过遵循上述指南，开发者可以确保Notifee库在Android 14及更高版本上正常运行，同时符合最新的平台要求。