Android 14 前台服务的更新与兼容性问题解决方案

在Android开发中，随着新版本的发布，开发者们总是需要面对新的API变化和兼容性问题。最近，许多开发者在升级到Android 14时，遇到了在低版本上运行良好的代码在新版本中出现问题的现象。本文将详细讨论如何解决在Android 14上启动前台服务时的常见错误，以及提供一个实际的代码实例来展示如何进行修改。

问题描述

在Android 13或更低版本上运行的代码，当升级到Android 14时，可能会出现以下错误：

android.app.MissingForegroundServiceTypeException: Starting FGS without a type callerApp=ProcessRecord{8eb0601 12195:com.hicalc.soundrecorder/u0a190} targetSDK=34

这个错误提示开发者需要为前台服务指定一个类型。

解决方案

从Android 14开始，启动前台服务时必须指定服务类型。解决这个问题的步骤如下：

1. 检查SDK版本：在尝试启动前台服务之前，检查当前的Android版本。

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
    startForeground(SERVICE_ID, notification);
} else {
    startForeground(SERVICE_ID, notification, FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK);
}

需要注意的是，TIRAMISU代表Android 13（SDK 33），所以条件判断应改为：

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) { // Android 14
    startForeground(SERVICE_ID, notification);
} else {
    startForeground(SERVICE_ID, notification, FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK);
}

2. 更新Manifest文件：
   在AndroidManifest.xml中添加相应的权限和服务声明：

<uses-permission
    android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"
    android:minSdkVersion="34" />

<application ...>
    <service
        android:name=".feature.exerciseplayer.data.service.YourService"
        android:exported="true"
        android:foregroundServiceType="mediaPlayback" />
</application>

实例代码

以下是一个更新后的startForegroundService()方法示例，展示了如何根据Android版本启动前台服务：

private fun startForegroundService() {
    val builder = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {            
        val mChannelName = getString(R.string.app_name)
        val notificationManager = this.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        val notificationChannel = NotificationChannel(
            CHANNEL_ID,
            mChannelName,
            NotificationManager.IMPORTANCE_LOW 
        )
        notificationManager.createNotificationChannel(notificationChannel)
        NotificationCompat.Builder(this, notificationChannel.id)
    } else {
        NotificationCompat.Builder(this)
    }

    val myIntent = Intent(this, ActivityMain::class.java)        
    myIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP)
    val pendingIntent = PendingIntent.getActivity(
        this,
        0,
        myIntent,
        PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )

    builder.setSmallIcon(R.drawable.notify_icon)            
        .setContentTitle(getString(R.string.notificationTitle))
        .setTicker(getString(R.string.notificationTicker))      
        .setContentText(getString(R.string.notificationContent))
        .setContentIntent(pendingIntent)

    val notification = builder.build()       
    notification.flags = notification.flags or NotificationCompat.FLAG_ONGOING_EVENT or NotificationCompat.FLAG_NO_CLEAR

    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        startForeground(125, notification)
    } else {
        startForeground(125, notification, FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK)
    }
}

通过以上步骤和代码示例，开发者可以确保在Android 14上启动前台服务时不会遇到MissingForegroundServiceTypeException错误，同时保持在低版本Android上的兼容性。希望这篇博客对你有所帮助，祝你在Android开发中一帆风顺！