Android透明桌面Launcher开发：旧Launcher界面残留问题求助

核心原因分析 #

当自定义Launcher设为默认时，系统通常会终止旧Launcher进程，但OneUI存在特殊的后台保留逻辑，再加上你的Activity使用了透明背景，导致旧Launcher的UI未被正确销毁或覆盖。

解决方案 #

1. 调整Manifest中的Activity配置 #

在MainActivity标签中添加以下属性，确保系统正确处理Launcher的启动逻辑：

• android:clearTaskOnLaunch="true"：每次从Home启动时清空任务栈，避免旧任务残留
• android:stateNotNeeded="true"：告知系统无需保存Activity状态，适配Launcher这类启动入口
• 保留已设置的singleTask启动模式（符合Launcher的最佳实践）

修改后的Manifest代码：

<activity
    android:launchMode="singleTask"
    android:name=".MainActivity"
    android:exported="true"
    android:clearTaskOnLaunch="true"
    android:stateNotNeeded="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.HOME" />
    </intent-filter>
</activity>

2. 在Activity启动时触发系统清理逻辑 #

无需特殊权限，可通过发送系统广播或调整任务栈，间接清理旧Launcher的残留UI：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    // 发送关闭系统对话框的广播，清理可能残留的旧界面
    sendBroadcast(Intent(Intent.ACTION_CLOSE_SYSTEM_DIALOGS))
    
    // 确保当前Activity是任务栈根，避免嵌套在旧任务中
    if (!isTaskRoot) {
        finish()
        return
    }
    
    setContentView(R.layout.activity_main)
    // 你的其他初始化代码
}

3. 检查透明背景主题的正确性 #

确保透明主题配置不会保留旧窗口内容：
在styles.xml中定义透明主题：

<style name="TransparentLauncherTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@null</item>
</style>

然后在Manifest的Activity标签中绑定该主题：android:theme="@style/TransparentLauncherTheme"

4. 针对OneUI的特殊适配 #

OneUI的Launcher可能存在后台缓存，可在Launcher启动时确认自身为默认Home后，触发系统重新绑定Launcher服务：

private fun isCurrentDefaultLauncher(): Boolean {
    val resolver = packageManager
    val intent = Intent(Intent.ACTION_MAIN).addCategory(Intent.CATEGORY_HOME)
    val resolveInfo = resolver.resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY)
    return resolveInfo?.activityInfo?.packageName == packageName
}

override fun onResume() {
    super.onResume()
    if (isCurrentDefaultLauncher()) {
        // 重新请求系统聚焦当前Launcher，触发旧Launcher销毁
        val intent = Intent(Intent.ACTION_MAIN).addCategory(Intent.CATEGORY_HOME)
        startActivity(intent)
    }
}

关键注意事项 #

• 不要尝试使用killBackgroundProcesses，该方法需要android.permission.KILL_BACKGROUND_PROCESSES权限，且对系统应用（如OneUI Launcher）无效
• 必须确保IntentFilter中包含ACTION_MAIN和CATEGORY_HOME，这是系统识别Launcher的核心标识

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