Android 动态替换桌面 Logo 实践记录(`activity-alias`)

背景

项目中需要支持"动态替换 App 桌面图标"(活动图标、节日图标等)。

本次主要实践的是 方案1:activity-alias ,并补充评估了 方案2:双启动入口


方案对比

方案1:activity-alias(本次落地)

参考:https://27house.cn/archives/1342

核心思路:

  • 保留真实启动 Activity
  • 通过多个 activity-alias 配置不同图标
  • 运行时通过 PackageManager#setComponentEnabledSetting 启停 alias,实现动态图标切换

方案2:两个启动入口

参考:https://github.com/windfone/DynamicIcon/blob/main/app/src/main/AndroidManifest.xml

特点:

  • 配置两个 launcher 入口
  • 冷启动后,出出现两个App进程

实践中遇到的问题与结论

1. 新图标由代码控制后,发版不要轻易删除 alias 列表(高风险)

参考:

现象

覆盖安装后,如果当前桌面展示的图标对应 alias 在新版本被删除,可能出现:

  • 点击桌面图标无法打开
  • 系统提示找不到入口
  • 直接崩溃

原因

系统 Launcher 可能仍保留旧组件引用;新版本删除 alias 后,该组件失效。

结论

  • 历史上线过的 alias 不要直接删除
  • 可"保留但禁用",不要"彻底移除"
  • alias 应按兼容协议管理(只增不减,谨慎清理)

2. 开发工具编译安装时报错:找不到启动页面

报错示例:

text 复制代码
Activity class {com.imaginer.xxx/com.imaginer.xxx.activity.welcome.ACT_SplashScreen} does not exist
相关推荐
海天鹰1 小时前
字符串数组保存到Map使用避免超出范围崩溃
android
su_ym81102 小时前
Android 与 Linux 对比
android·linux·framework
默|笙2 小时前
【Linux】线程同步与互斥_日志与线程池
android·linux·运维
fengci.2 小时前
蜀道山2024上半部分
android
撩得Android一次心动2 小时前
Android DataBinding 全面解析【源码篇1】
android·android jetpack·databinding
aq55356002 小时前
Laravel 1.x:现代PHP框架的雏形
android
XiaoLeisj3 小时前
Android 短视频播放详情页实战:从播放器模块拆分、Media3 与 FlowHelper 接入,到 ViewPager 高度适配和详情数据联动
android·okhttp·音视频·架构设计·flowhelper
努力努力再努力wz3 小时前
【MySQL入门系列】:不只是建表:MySQL 表约束与 DDL 执行机制全解析
android·linux·服务器·数据结构·数据库·c++·mysql
陆业聪3 小时前
Prompt、Rule、Skill:被混用了一年的三个词,今天说清楚
android·人工智能·aigc