React Native手动修改Android包名后启动报MainActivity不存在问题咨询

在已完成常规校验（MainActivity源码包声明、Gradle构建配置、AndroidManifest标识完全匹配，settings.gradle已正确引入:app模块）仍无法解决问题时，按以下高概率触发点逐一核验：

• 清除全链路构建缓存，终止残留构建进程
  增量构建会保留旧包名对应的编译产物、类映射关系，不会自动同步路径变更。手动删除android/build、android/app/build、android目录下的.gradle缓存文件夹，执行cd android && ./gradlew --stop杀掉所有后台运行的Gradle守护进程——守护进程会在内存中持久化旧的包名映射规则，不终止的话即使删除了缓存，也会沿用旧规则完成构建，之后再重新执行构建安装命令。
• 校验编译生成的中间Manifest产物，排查合并冲突
  不要仅手动核对自己编写的主AndroidManifest配置，直接打开编译流程生成的合并后清单文件：android/app/build/intermediates/manifests/debug/AndroidManifest.xml，找到启动Activity的声明，确认其完整类名（applicationId + .MainActivity）和实际源码的包路径完全一致。
  这里最容易漏的是android/app/build.gradle里的namespace配置：新版Gradle插件会把这个值作为组件路径的拼接前缀，如果改包名时只修改了applicationId、源码包路径，没有同步更新namespace为新的包名，就会导致合并后的Manifest里Activity的包名和实际APK内的类路径错位，直接触发找不到类的报错。
• 清除设备端旧应用的组件缓存
  完全卸载设备上所有同项目的历史安装包，不要依赖adb的覆盖安装逻辑。Android系统的PackageManager会缓存已安装应用的组件列表，旧版本应用未完全卸载时，新APK的Activity组件不会被系统正确注册，即使APK本身打包无误也会触发类不存在的报错。卸载命令：adb uninstall <历史版本的applicationId>，卸载完成后重新发起安装。
• 修正启动流程的路径拼接错误
  报错里花括号包裹的<appName>部分，很多时候是IDE、RN CLI从android/settings.gradle里读取的rootProject.name值生成的，而非APK实际的包名。
  多数人核对settings.gradle时只确认了include ":app"的存在，完全忽略同文件内的rootProject.name配置——这个值虽然不影响APK的打包内容，但是运行脚本会读取它作为启动命令的包名参数，如果还是旧的项目名，就会向系统发起启动旧包名下MainActivity的Intent，和新APK内的实际类路径完全不匹配，直接出现“源码文件存在、所有配置正确但启动报类不存在”的问题。只需要把settings.gradle里的rootProject.name修改为和新applicationId一致的内容即可解决。
• 校验源码路径的构建映射规则
  如果项目自定义过build.gradle里的sourceSets配置，确认源码目录的映射没有残留旧路径：比如手动移动MainActivity到新的包路径目录后，sourceSets仍指定从旧的物理目录加载Java源码，会导致新路径下的MainActivity根本没有被编译进APK，自然出现类不存在的报错。

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