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
相关推荐
AIsoft_86893 小时前
职场音频文件怎么整理?录音APP有哪些用法
android·音视频
booboosui3 小时前
第一批个人 Agent 用户正在卸载,问题不在模型,在它住在哪儿
android
洞见前行3 小时前
点击图标到内容出现,你的 App 在这几秒里做了什么:Android 冷启动全链路优化实战
android·性能优化·android studio
凯基迪科技3 小时前
芯片UID绑定修改 加密与逆向修改思路分析
android
Liben4 小时前
Weex开发踩坑记录
android·前端·ios
救救孩子把6 小时前
结构化输出为何“格式正确、答案错误”?JSON Schema 的能力边界
android·java·json·agent·agent服务
张小姐的猫7 小时前
【MySQL】事务
android·mysql·adb
你看我名字7 小时前
数眼智能 Search + Reader 实战:联网问答怎样避免“搜到了,却引用错了”
android·java·开发语言
恋猫de小郭8 小时前
最近 Android 有什么更新:Android Dev Summit 2026 技术解读
android·前端·flutter
Kapaseker8 小时前
删掉 1.1 万行 C 代码,Rust 正式接手 Android Binder
android·rust