切换应用图标时触发“Unable to find explicit activity class”错误求助

你遇到的ActivityNotFoundException是因为切换图标时代码把SplashActivity本身禁用了，之后从HomeFragment直接启动这个已被禁用的组件，系统自然无法找到它。以下是针对性的修复方案：

核心修复思路 #

不要禁用SplashActivity本身（它作为两个activity-alias的目标Activity，必须始终保持启用），仅通过切换两个别名的启用/禁用状态实现图标切换。

1. 修正AndroidManifest.xml配置 #

移除原SplashActivity的LAUNCHER意图过滤器，让它仅作为目标Activity存在；两个activity-alias分别承担普通用户和黄金用户的启动入口：

<!-- 原SplashActivity：保持启用，移除LAUNCHER过滤器 -->
<activity
    android:name=".ui.SplashActivity"
    android:exported="true"
    android:enabled="true"
    android:screenOrientation="locked"
    android:theme="@style/Theme.Gros">
    <!-- 移除<intent-filter>的MAIN和LAUNCHER配置 -->
</activity>

<!-- 普通用户图标入口：默认启用 -->
<activity-alias
    android:name=".ui.SplashActivityNormal"
    android:icon="@drawable/ic_normal_app_icon"
    android:roundIcon="@drawable/ic_normal_app_icon"
    android:enabled="true"
    android:exported="true"
    android:screenOrientation="locked"
    android:theme="@style/Theme.Gros"
    android:targetActivity=".ui.SplashActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity-alias>

<!-- 黄金用户图标入口：默认禁用 -->
<activity-alias
    android:name=".ui.SplashActivityGold"
    android:icon="@drawable/ic_gros_money_gold_app"
    android:roundIcon="@drawable/ic_gros_money_gold_app"
    android:enabled="false"
    android:exported="true"
    android:screenOrientation="locked"
    android:theme="@style/Theme.Gros"
    android:targetActivity=".ui.SplashActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity-alias>

2. 修改SplashActivity的切换逻辑 #

仅操作两个别名的启用状态，不再修改原SplashActivity的状态：

val manager = packageManager
val normalAlias = ComponentName(this, "com.grosmagazam.ui.SplashActivityNormal")
val goldAlias = ComponentName(this, "com.grosmagazam.ui.SplashActivityGold")

if (clientPreferences.getIconType()) {
    // 切换为黄金用户图标：禁用普通别名，启用黄金别名
    manager.setComponentEnabledSetting(
        normalAlias,
        PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
        PackageManager.DONT_KILL_APP
    )
    manager.setComponentEnabledSetting(
        goldAlias,
        PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
        PackageManager.DONT_KILL_APP
    )
} else {
    // 切换为普通用户图标：启用普通别名，禁用黄金别名
    manager.setComponentEnabledSetting(
        normalAlias,
        PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
        PackageManager.DONT_KILL_APP
    )
    manager.setComponentEnabledSetting(
        goldAlias,
        PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
        PackageManager.DONT_KILL_APP
    )
}

3. 修复HomeFragment的启动逻辑 #

原SplashActivity始终保持启用，可安全启动；建议添加栈清除标记，避免用户返回旧页面：

if (clientPreferences.getIconType() != moneyCardType){
    clientPreferences.setIsMoneyGold(moneyCardType)
    clientPreferences.setIconType(moneyCardType)
    val i = Intent(requireContext(), SplashActivity::class.java)
    // 清除栈，避免返回原页面
    i.flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
    startActivity(i)
    // 关闭当前Fragment所在的Activity
    requireActivity().finish()
}

额外说明 #

• 图标切换后，桌面图标更新可能存在延迟（取决于系统），属于Android系统正常行为，无法完全避免。
• 禁止直接禁用目标Activity，否则不仅启动会报错，activity-alias也会因依赖组件失效而无法工作。

内容的提问来源于stack exchange，提问作者Ahmet Yılmaz