Android透明Activity在最近任务视图中异常变灰问题求助

针对你遇到的应用正常运行时透明，但最近任务视图中背景变灰的问题，结合你使用的API 34（Android 14）和测试的Android 15环境，可通过以下步骤解决：

1. 修复TaskDescription崩溃并正确配置 #

你之前的setTaskDescriptionSafely崩溃源于API版本兼容问题，以及传入null标签/图标导致的空指针。修改后的兼容版本如下：

private fun setTaskDescriptionSafely() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) { // API 33+ 使用Builder
        try {
            val taskDescription = ActivityManager.TaskDescription.Builder()
                .setLabel(getString(R.string.app_name))
                .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))
                .setBackgroundColor(Color.TRANSPARENT)
                .build()
            setTaskDescription(taskDescription)
        } catch (e: Exception) {
            e.printStackTrace()
        }
    } else { // 低版本直接构造TaskDescription
        val taskDescription = ActivityManager.TaskDescription(
            getString(R.string.app_name),
            R.mipmap.ic_launcher,
            Color.TRANSPARENT
        )
        setTaskDescription(taskDescription)
    }
}

2. 完善Activity窗口配置 #

除了设置透明背景，还需添加窗口FLAG确保布局不受限制，同时适配Android 12+的模糊效果：

override fun onCreate(savedInstanceState: Bundle?) {
    setTheme(R.style.Theme_Calculator)
    super.onCreate(savedInstanceState)

    window.apply {
        setBackgroundDrawableResource(android.R.color.transparent)
        // 添加FLAG让窗口布局延伸到屏幕边缘
        addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
        addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN)
        // Android 12+ 启用背景模糊
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            setBackgroundBlurRadius(169)
        }
    }

    enableEdgeToEdge()
    setContent {
        CalculatorTheme {
            TransparentBackgroundContent()
        }
    }

    setTaskDescriptionSafely()
}

3. 确保主题配置正确 #

在res/values/styles.xml中，你的Theme.Calculator主题需添加透明相关属性：

<style name="Theme.Calculator" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@android:style/Animation</item>
</style>

4. 检查Compose背景设置 #

如果你的需求是完全透明，需确认TransparentBackgroundContent中的背景设置：

@Composable
fun TransparentBackgroundContent() {
    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(color = Color.Transparent) // 直接用完全透明，或按需设置alpha
    ) {
        // 你的UI元素
    }
}

额外说明 #

Android 15部分设备可能存在系统级限制，强制对最近任务快照添加不透明背景。如果上述配置仍无效，可尝试禁用系统自动快照，通过setTaskDescription传入自定义Bitmap快照：

// 生成自定义透明快照
val bitmap = Bitmap.createBitmap(window.decorView.width, window.decorView.height, Bitmap.Config.ARGB_8888)
val canvas = Canvas(bitmap)
window.decorView.draw(canvas)
// 传入TaskDescription
val taskDescription = ActivityManager.TaskDescription(
    getString(R.string.app_name),
    bitmap,
    Color.TRANSPARENT
)
setTaskDescription(taskDescription)

内容的提问来源于stack exchange，提问作者itsbppradhan