Xamarin.Android应用在应用列表显示启动器活动名，如何修正为正确标签？

这个问题我碰到过好几次，核心原因是启动器Activity的android:label优先级高于Application级别的label——虽然你在Application节点设置了正确的名称，但系统显示应用列表时，会优先读取带有MAIN和LAUNCHER过滤器的Activity的标签，而不是全局的Application标签。下面给你几个具体的解决步骤：

1. 检查并修正启动器Activity的Label配置 #

首先找到你应用中作为启动入口的Activity（就是带有IntentFilter包含MAIN和LAUNCHER的那个）：

• 如果是直接编辑AndroidManifest.xml，看看这个Activity是不是单独设置了android:label属性。如果有，它会覆盖Application的标签，导致应用列表显示Activity的名称。
  • 错误示例：

    <application android:label="AppName" ...>
        <activity android:name=".MainActivity" android:label="MainActivity" ...>
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    

  • 修正方式：要么删除Activity的android:label属性，让它继承Application的标签；要么把它的android:label也设置为AppName：

    <!-- 方式1：移除Activity的label，继承全局设置 -->
    <application android:label="AppName" ...>
        <activity android:name=".MainActivity" ...>
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    
    <!-- 方式2：直接给Activity设置正确的label -->
    <application android:label="AppName" ...>
        <activity android:name=".MainActivity" android:label="AppName" ...>
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    

2. 检查Xamarin Activity特性的Label参数 #

如果你是用Xamarin的C#特性来配置Activity的（而不是手动编辑Manifest），一定要注意Activity特性里的Label参数——这个参数会在编译时自动覆盖Manifest中的对应配置，哪怕你手动改了Manifest也没用。

• 错误示例：

  [Activity(Label = "MainActivity", MainLauncher = true, Theme = "@style/AppTheme")]
  public class MainActivity : AppCompatActivity
  {
      // ...
  }
  

• 修正方式：要么把Label改成你想要的AppName，要么直接移除这个参数，让它继承Application的Label：

  // 方式1：设置正确的Label
  [Activity(Label = "AppName", MainLauncher = true, Theme = "@style/AppTheme")]
  public class MainActivity : AppCompatActivity
  {
      // ...
  }
  
  // 方式2：移除Label参数，继承全局配置
  [Activity(MainLauncher = true, Theme = "@style/AppTheme")]
  public class MainActivity : AppCompatActivity
  {
      // ...
  }
  

3. 验证最终的Manifest文件（可选但推荐） #

修改后，你可以用aapt工具检查发布版APK的最终Manifest，确认启动器Activity的Label是否正确：

• 执行命令：

  aapt dump badging your-app-release.apk | grep "launchable-activity"
  

• 正常输出应该包含label='AppName'，而不是Activity的名称。

4. 清除缓存并重新安装 #

有时候系统会缓存应用的标签信息，所以修改后，先完全卸载旧的应用，最好清除设备的应用缓存，再重新安装新编译的APK，确保新的标签生效。

内容的提问来源于stack exchange，提问作者Mathias Rönnlund