Android <activity-alias> 的用法研究

最新推荐文章于 2025-05-30 13:57:35 发布

原创最新推荐文章于 2025-05-30 13:57:35 发布 · 4.7k 阅读

CC 4.0 BY-SA版权

本文详细介绍了在Android应用开发中遇到的问题：在更新App版本时，由于某些手机的Launcher缓存了旧版App的HomeActivity信息，导致点击桌面图标时直接崩溃。文中提供了解决方案，通过使用<activity-alias>标签实现HomeActivity的重定向，确保用户在App升级后可以正常启动。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 问题

最近在开发公司App的过程中有一个需求：需要改变HomeActivity (launcher 的入口) 的名称为StartupActivity，先不要问为什么会有这么脑残的需求，反正就是要改名称。好吧，那就改吧，按理说也没有什么大碍。可是往往是我们把事情想得太简单—— App 发布后在某些手机上版本升级后，点击桌面icon 竟然无法启动App直接崩溃。

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

2. 解决办法

用<activity-alias>重定向HomeActivity

        <activity android:name="com.mytest.StartupActivity"
            android:exported="true">
        </activity>

        <!-- Solution for upgrading issue -->
        <activity-alias android:name="com.mytest.HomeActivity"
            android:targetActivity="com.mytest.StartupActivity"
            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. (手动安装，手动点击icon是可以启动的)