React Native Android应用含变音符号的应用名致崩溃求助

云上老周

2026-8-19

解决React Native Android应用带变音符号应用名崩溃问题

确保strings.xml文件编码为UTF-8
打开android/app/src/main/res/values/strings.xml时，确认编辑器使用UTF-8编码保存文件（比如Android Studio右下角可查看/切换编码）。错误的编码会导致系统无法正确解析变音符号，引发资源加载崩溃。
直接使用原生字符，无需转义
直接写入带变音符号的名称：
```
<string name="app_name">Parkovací zóny Brno</string>
```
之前尝试的Unicode转义、HTML实体反而可能引入解析问题，原生UTF-8字符是Android资源文件的标准写法。
验证AndroidManifest.xml的引用正确性
检查android/app/src/main/AndroidManifest.xml中，应用标签是否正确引用了app_name：
```
<application
    android:name=".MainApplication"
    android:label="@string/app_name"
    ...>
```
确保@string/app_name拼写无误，没有引用错误的资源名称。
清理编译缓存并重建项目
执行以下命令清除旧的编译缓存，避免缓存的错误资源影响运行：
```
cd android
./gradlew clean
cd ..
npx react-native run-android
```

强制Gradle使用UTF-8处理资源
在android/build.gradle的android块中添加编码配置，确保Gradle编译时以UTF-8解析资源文件：

android {
    compileOptions {
        encoding "UTF-8"
    }

    applicationVariants.all { variant ->
        variant.mergeResources.doLast {
            def resDir = file("${buildDir}/intermediates/merged_resources/${variant.dirName}/values/")
            if (resDir.exists()) {
                resDir.eachFile { file ->
                    if (file.name == "strings.xml") {
                        def content = file.getText("UTF-8")
                        file.write(content, "UTF-8")
                    }
                }
            }
        }
    }
}