双11快到了，不给你的APP加上自动换图标的功能吗？
前言
也许你也注意到了，在临近双11之际，手机上电商类APP的应用图标已经悄无声息换成了双11专属图标，比如某宝和某东：
8efea43731cdf2579eb4fb031c774737.jpg
可能你会说，这有什么奇怪的，应用市场开启自动更新不就可以了么？
真的是这样吗？
为此，我特意查看了我手机上的某宝APP的当前版本，并对比了历史版本上的图标，发现并不对应。
281048112ddef4486bc48c6abac63bb5.jpg
41bdaa904abf3655fb81193789d5e3cc.jpg
默认是88会员节专属图标，而现在显示的是双11图标。
那么，作为开发者的嗅觉，让你自然而然想要从技术角度揣测是怎么实现的，而这便是这篇文章想要与你分享的。
知识储备
<activity-alias>
某一个Activity 的别名，用于实例化该目标Activity。目标必须与别名在同一应用中，并且在清单中必须在别名之前进行声明。
介绍下几个重要的属性：
android:enabled：必须设为“true”，系统才能通过别名实例化目标 Activity
android:icon：通过别名呈现给用户时目标 Activity 的图标。
android:name：别名的唯一名称。与目标 Activity 的名称不同，别名名称是任意的，它不引用实际类。
android:targetActivity：可通过别名激活的 Activity 的名称。
PackageManager#setComponentEnabledSetting
可以利用 PackageManager 在清单文件中所定义的任何组件上切换启用状态，包括您想启用或停用的任何一个Activity。
有了以上知识储备后，下面就该剖析一下这个需求的具体场景了。
场景剖析
以电商类APP双11活动为例，在双11活动开始前的某个时间点（比如10天前）就要开始对活动的预热，此时就要实现图标的自动更换，而在活动结束之后，也必须要能更换回正常图标，并且要求过程尽量对用户无感知，更不能影响用户对APP的正常使用。
具体拆分成要实现的功能点便是：图标更换、自动操作、用户无感知。
方案实现
1.图标更换：禁用Launcher组件，启用Alias组件，并将targetActivity指向原先的Launcher组件。
2.自动操作：指定日期转换为时间戳，并与当前时间戳对比，超过预设时间则执行替换操作。
3.用户无感知：尽量选择APP不活跃的阶段的，比如切换应用/回到桌面时。
代码实践
首先，我们需要在AndroidManifest清单文件中添加<activity-alias>元素，默认为禁用状态，name属性作为我们找到此组件的唯一标志，而icon属性即是我们要替换的图标资源，并通过targetActivity属性将作为LANCHUER的SplashActivity作为实例化的目标 Activity：
<activity android:name=".SplashActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!--88会员节专属Activity别名-->
<activity-alias
android:name=".SplashAliasActivity"
android:enabled="false"
android:icon="@mipmap/ic_launcher_88"
android:targetActivity=".SplashActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity-alias>
<!--双11专属Activity别名-->
<activity-alias
android:name=".SplashAlias2Activity"
android:enabled="false"
android:icon="@mipmap/ic_launcher_11_11"
android:targetActivity=".SplashActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity-alias>
随后，我们图标替换的工作视作一项任务，定义一个数据类：
/**
* 切换图标任务
*/
data class SwitchIconTask (val launcherComponentClassName: String, // 启动器组件类名
val aliasComponentClassName: String, // 别名组件类名
val presetTime: Long, // 预设时间
val outDateTime: Long) // 过期时间
定义一个LauncherIconManager单例，负责图标更换相关的工作。开放添加图标切换任务的接口，做好参数合法性的校验：
/**
* 启动器图标管理器
*/
object LauncherIconManager {
/** 切换图标任务Map */
private val taskMap: LinkedHashMap<String, SwitchIconTask> = LinkedHashMap()
/**
* 添加图标切换任务
* @param newTasks 新任务，可以传多个
*/
fun addNewTask(vararg newTasks: SwitchIconTask) {
for (newTask in newTasks) {
// 防止重复添加任务
if (taskMap.containsKey(newTask.aliasComponentClassName)) return
// 校验任务的预设时间和过期时间
for (queuedTask in taskMap.values) {
if (newTask.presetTime > newTask.outDateTime) throw IllegalArgumentException("非法的任务预设时间${newTask.presetTime}, 不能晚于过期时间")
if (newTask.presetTime <= queuedTask.outDateTime) throw IllegalArgumentException("非法的任务预设时间${newTask.presetTime}, 不能早于已添加任务的过期时间")
}
taskMap[newTask.aliasComponentClassName] = newTask
}
}
...
}
LauncherIconManager.addNewTask(
SwitchIconTask(
SplashActivity::class.java.name,
"$packageName.SplashAliasActivity",
format.parse("2020-08-02").time,
format.parse("2020-08-09").time
),
SwitchIconTask(
SplashActivity::class.java.name,
"$packageName.SplashAlias2Activity",
format.parse("2020-11-05").time,
format.parse("2020-11-12").time
)
)
通过Application#registerActivityLifecycleCallbacks方法注册了对应用内Activity生命周期的监听，通过是否有活跃状态的Activity判断应用是否进入了后台：
/**
* 应用运行状态注册器
*/
object RunningStateRegister {
fun register(application: Application, callback: StateCallback) {
application.registerActivityLifecycleCallbacks(object : SimpleActivityLifecycleCallbacks() {
private var startedActivityCount = 0
override fun onActivityStarted(activity: Activity) {
if (startedActivityCount == 0) {
callback.onForeground()
}
startedActivityCount++
}
override fun onActivityStopped(activity: Activity) {
startedActivityCount--
if (startedActivityCount == 0) {
callback.onBackground()
}
}
})
}
}
class BaseApplication : Application() {
override fun onCreate() {
super.onCreate()
LauncherIconManager.register(this)
}
}
判断应用进入后台后，就可以开始对图标的更换工作了：
/**
* 启动器图标管理器
*/
object LauncherIconManager {
...
/**
* 注册以监听应用运行状态
*/
fun register(application: Application) {
RunningStateRegister.register(application, object: RunningStateRegister.StateCallback{
override fun onForeground() {
}
override fun onBackground() {
proofreadingInOrder(application)
}
})
}
/**
* 依次校对预设时间
* @param context 上下文
*/
fun proofreadingInOrder(context: Context) {
for (task in taskMap.values) {
if (proofreading(context, task)) break
}
}
/**
* 校对预设时间/过期时间
* @param context 上下文
* @return true 已过预设时间 false 未达预设时间或已过期
*/
private fun proofreading(context: Context, task: SwitchIconTask) =
when {
isPassedOutDateTime(task) -> {
disableComponent(context, ActivityUtil.getLauncherActivityName(context)!!)
enableComponent(context, task.launcherComponentClassName)
false
}
isPassedPresetTime(task) -> {
disableComponent(context, ActivityUtil.getLauncherActivityName(context)!!)
enableComponent(context, task.aliasComponentClassName)
true
}
else -> false
}
/**
* 是否已超过预设时间
* @param task 任务
*/
private fun isPassedPresetTime(task: SwitchIconTask) =
System.currentTimeMillis() > task.presetTime
/**
* 是否已超过过期时间
* @param task 任务
*
*/
private fun isPassedOutDateTime(task: SwitchIconTask) =
System.currentTimeMillis() > task.outDateTime
...
}
以上代码均已上传到GitHub。核心的类都封装到Library模块了，并提供Demo模块演示如何使用。
如果觉得项目不错的话点个Star吧~
https://github.com/madchan/LauncherIconLib
效果预览
1604935350118.gif
总结
通过以上构建的方案，便可让我们的APP在预设的时间点实现对应用图标的自动替换，缺点是只能加载随APK打包的图片资源，适用于运营活动时间相对固定的的场景。
参考文章
<activity-alias>
https://developer.android.google.cn/guide/topics/manifest/activity-alias-element
