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
- <activity android:name="com.example.FirstActivity"
- android:exported="true">
- </activity>
- <!-- Solution for upgrading issue -->
- <activity-alias android:name="com.example.HomeActivity"
- android:targetActivity="com.example.FirstActivity"
- android:exported="true"
- android:enabled="true">
- <intent-filter>
- <action android:name="android.intent.action.MAIN" />
- <category android:name="android.intent.category.LAUNCHER" />
- </intent-filter>
- </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是可以正常启动,修改完成!