Android配置Debug构建类型后安装应用显示异常名称是什么原因？

问题原因 #

核心原因为Android资源合并时出现了同名资源冲突：你删除了主项目strings.xml中的app_name定义后，构建脚本通过resValue生成的app_name资源优先级低于你引入的第三方依赖（根据显示名称判断为ViewPager圆点指示器相关依赖）自带的app_name字符串资源，最终合并后的资源生效的是第三方库的定义值，导致应用名称不符合预期。

排查步骤 #

• 执行构建资源生成命令，验证你配置的resValue是否正常生成：运行./gradlew app:generateDebugResValues（Windows系统替换为gradlew.bat app:generateDebugResValues），打开生成目录下的app/build/generated/res/resValues/debug/values/gradleResValues.xml文件，确认是否存在值为Name Debug的app_name条目，如果存在说明你的构建配置无问题。
• 查看资源合并结果：打开app/build/intermediates/incremental/mergeDebugResources/merged.dir/values/values.xml文件，搜索app_name字段，确认最终合并后的值是否为第三方库的View Pager Dots indicator，如果匹配则确认是资源冲突问题。
• 排查依赖列表：执行./gradlew app:dependencies命令，找到名称包含viewpager、dots、indicator的依赖项，确认冲突来源。

解决方法 #

推荐优先使用方案1或方案2，可彻底避免同类资源冲突问题：

• 方案1：修改自定义资源名称，避开通用命名
  将你自定义的应用名称资源名修改为不会和第三方库冲突的唯一值，比如my_custom_app_name：

  1. 修改build.gradle中对应配置：

  buildTypes {
        getByName("debug") {
            applicationIdSuffix = ".debug"
            isDebuggable = true
            versionNameSuffix = " Debug"
            resValue("string", "my_custom_app_name", "Name Debug")
        }
        getByName("release") {
            isMinifyEnabled = true
            resValue("string", "my_custom_app_name", "Name")
            proguardFiles(getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro")
        }
    }
  

  2. 修改AndroidManifest.xml中application节点的label属性：

  android:label="@string/my_custom_app_name"
  

• 方案2：使用Manifest占位符直接注入应用名，绕过字符串资源合并
  不需要通过字符串资源定义应用名，直接在构建脚本中配置manifest占位符：

  1. 修改build.gradle配置：

  buildTypes {
        getByName("debug") {
            applicationIdSuffix = ".debug"
            isDebuggable = true
            versionNameSuffix = " Debug"
            manifestPlaceholders["appLabel"] = "Name Debug"
        }
        getByName("release") {
            isMinifyEnabled = true
            proguardFiles(getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro")
            manifestPlaceholders["appLabel"] = "Name"
        }
    }
  

  2. 修改AndroidManifest.xml中application节点的label属性：

  android:label="${appLabel}"
  

• 方案3：强制提升构建生成资源的优先级（不推荐，可能影响其他资源合并）
  在build.gradle的android节点下添加配置，指定生成资源的优先级高于第三方依赖：

  android {
      sourceSets {
          main {
              res.srcDirs += 'build/generated/res/resValues/debug'
              res.srcDirs += 'build/generated/res/resValues/release'
          }
      }
  }
  

内容的提问来源于stack exchange，提问作者Wafi_ck