Android如何编程修改Manifest实现动态更换应用图标

先说核心前提：activity-alias在AndroidManifest里硬编码的icon属性没有公开的直接修改接口，所有动态换图标方案的核心逻辑都是「预注册多个指向启动页的别名组件 + 运行时控制组件启停状态」，要支持用户上传自定义图标，只需要在切换组件时额外给目标别名设置运行时图标即可，具体落地步骤如下：

1. 清单文件预配置别名组件 #

首先把真实的主启动Activity设为不被Launcher识别，再提前注册两个activity-alias，一个对应默认图标，一个预留为自定义图标专用，两个alias都指向真实的启动页。注意：所有带LAUNCHER分类的组件，同一时间只能启用一个，否则桌面会出现多个应用入口。

<!-- 真实主启动Activity，禁止Launcher直接识别 -->
<activity
    android:name=".MainActivity"
    android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<!-- 默认图标别名，初始状态启用 -->
<activity-alias
    android:name=".alias.DefaultIconAlias"
    android:enabled="true"
    android:exported="true"
    android:icon="@mipmap/ic_launcher_default"
    android:targetActivity=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity-alias>

<!-- 自定义图标专用别名，初始状态禁用，icon用占位图即可 -->
<activity-alias
    android:name=".alias.CustomIconAlias"
    android:enabled="false"
    android:exported="true"
    android:icon="@mipmap/ic_launcher_placeholder"
    android:targetActivity=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity-alias>

2. 处理用户上传的自定义图标 #

用户上传图片后，先做预处理：

• 把图片裁剪为正方形，建议输出尺寸256*256以上，避免图标模糊
• Android 8.0（API26）及以上系统必须适配自适应图标规则，把上传的图作为前景层，搭配纯色/透明背景层构造AdaptiveIconDrawable，否则图标会被系统Launcher强行裁剪，出现白边、显示不全问题
• 处理后的图标存在应用内部私有目录即可，不需要存公共存储。

3. 运行时切换图标逻辑 #

核心是用PackageManager控制两个别名的启停状态，反射调用系统隐藏API给自定义别名设置上传的图标，最后通知Launcher刷新。直接复用下面的工具方法即可：

fun switchAppIcon(context: Context, useCustom: Boolean, customBitmap: Bitmap? = null) {
    val pm = context.packageManager
    val defaultComponent = ComponentName(context, "你的应用包名.alias.DefaultIconAlias")
    val customComponent = ComponentName(context, "你的应用包名.alias.CustomIconAlias")

    // 自定义图标场景：给别名设置运行时图标
    if (useCustom && customBitmap != null) {
        val scaledBitmap = Bitmap.createScaledBitmap(customBitmap, 256, 256, true)
        val iconDrawable = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            AdaptiveIconDrawable(
                ColorDrawable(Color.TRANSPARENT),
                BitmapDrawable(context.resources, scaledBitmap)
            )
        } else {
            BitmapDrawable(context.resources, scaledBitmap)
        }
        // 反射调用系统多参数的setComponentEnabledSetting方法，传入自定义drawable
        runCatching {
            val method = PackageManager::class.java.getMethod(
                "setComponentEnabledSetting",
                ComponentName::class.java,
                Int::class.javaPrimitiveType,
                Int::class.javaPrimitiveType,
                Drawable::class.java
            )
            method.invoke(
                pm,
                customComponent,
                PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
                PackageManager.DONT_KILL_APP,
                iconDrawable
            )
        }.onFailure {
            // 部分高版本ROM限制隐藏API调用，降级使用清单里的占位图标，等待Launcher自动刷新即可
            it.printStackTrace()
        }
    }

    // 切换组件状态：永远只启用一个Launcher组件
    pm.setComponentEnabledSetting(
        if (useCustom) defaultComponent else customComponent,
        PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
        PackageManager.DONT_KILL_APP
    )
    pm.setComponentEnabledSetting(
        if (useCustom) customComponent else defaultComponent,
        PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
        PackageManager.DONT_KILL_APP
    )

    // 发送广播通知Launcher刷新，大部分机型会立刻生效
    val refreshIntent = Intent(Intent.ACTION_MAIN).apply {
        addCategory(Intent.CATEGORY_HOME)
        flags = Intent.FLAG_ACTIVITY_NEW_TASK
    }
    context.sendBroadcast(refreshIntent)
}

必看避坑点 #

• 应用覆盖安装时，组件启用状态会被重置为Manifest里的默认值，需要在Application启动时读取本地存储的用户图标配置，重新执行一次切换逻辑
• 不要同时启用多个带LAUNCHER分类的组件，否则桌面会出现多个重复的应用入口
• 别名的name字段一旦发版不要随意修改，否则升级后会出现图标丢失、配置失效问题
• 部分定制ROM（MIUI、ColorOS等）存在Launcher图标缓存，切换后可能延迟5-10秒生效，不要重复触发切换逻辑
• Android 12+对隐藏API限制较严，如果反射调用失败，自定义图标会暂时显示预置的占位图，一般重启Launcher或者等系统自动刷新后就会正常，也可以提前给用户做提示
• 不要尝试直接修改安装包里的Manifest文件，APK安装后是只读的，运行时没有修改权限。

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