Android <activity-alias> 的用法解析

1. 问题

    最近在公司业务应用开发中有这样一个需求：需要改变HomeActivity (launcher 的入口) 的名称为FirstActivity，这么改一下很简单，那就改吧，按理说也没有什么大碍。可是在App 发布后在某些手机上版本升级后，点击桌面icon 竟然无法启动App直接崩溃。

后来追述Log才搞清楚原因：某些手机安装的launcher 会cache App 的历史信息，例如HomeActivity的名称等。所以当App升级到新版本后，点击桌面icon 仍然会启动老的HomeActivity，然而新App 的HomeActivity已经更改名称FirstActivity，因此无法启动直接崩溃。（如果用户关机重新启动，点击桌面icon App是能够正常启动的，因为launcher cache 的信息已经清除了）

2. 解决办法

用<activity-alias>重定向HomeActivity

1. <activity android:name="com.example.FirstActivity"  
2.     android:exported="true">  
3. </activity>  
4.   
5. <!-- Solution for upgrading issue -->  
6. <activity-alias android:name="com.example.HomeActivity"  
7.     android:targetActivity="com.example.FirstActivity"  
8.     android:exported="true"  
9.     android:enabled="true">  
10.     <intent-filter>  
11.         <action android:name="android.intent.action.MAIN" />  
12.         <category android:name="android.intent.category.LAUNCHER" />  
13.     </intent-filter>  
14. </activity-alias>  

3. 注意

（1）在AndroidManifest.xml 文件中，新的 <activity> 必须放在 <activity-alias>之前定义，否则重定向可能会失败.

（2）如果你的App引用了其它工程，请务必将 <activity-alias>的定义声明放在App的AndroidManifest.xml 文件中，不要放在被引用的工程的AndroidManifest.xml 文件中，否则用Eclipse "project -> Run As -> Android Application" 无法启动你的App.

4. 验证

   手动安装，手动点击icon是可以正常启动，修改完成！