Gradle升级后生成的Fragment Directions文件报R包不存在错误如何解决？

问题根源 #

将Android Gradle Plugin（AGP）升级到7.2.0并迁移package属性到构建文件的namespace后，旧版本的Navigation Safe Args（2.4.x）对AGP新引入的namespace特性支持不完善，导致生成的OverviewFragmentDirections.java代码无法正确引用R类。

解决方案 #

1. 统一Navigation依赖版本

当前Safe Args插件版本（2.4.1）与导航库版本（2.4.2）不一致，这可能引发兼容性问题。将插件版本同步为2.4.2：

项目级build.gradle（或build.gradle.kts）：

plugins {
    id 'com.android.application' version '7.2.0' apply false
    id 'androidx.navigation.safeargs' version '2.4.2' apply false
    // 其他插件配置...
}

模块级build.gradle：

plugins {
    id 'com.android.application'
    id 'androidx.navigation.safeargs'
    // 其他插件配置...
}

android {
    namespace "你的项目命名空间" // 确保此处设置正确的命名空间
    // 其他Android配置...
}

dependencies {
    implementation 'androidx.navigation:navigation-fragment-ktx:2.4.2'
    implementation 'androidx.navigation:navigation-ui-ktx:2.4.2'
    // 其他依赖配置...
}

2. 确认AndroidManifest配置

确保AndroidManifest.xml中已移除package属性（AGP 7.2+优先使用build.gradle中的namespace，保留package仅用于兼容旧代码场景）：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 移除package属性 -->
    <application ...>
        <!-- 组件配置内容 -->
    </application>
</manifest>

3. 清理并重建项目

执行以下操作彻底刷新生成的代码：

• 点击Android Studio工具栏的Build > Clean Project
• 随后点击Build > Rebuild Project
• 若仍有问题，尝试File > Invalidate Caches...并重启Android Studio

4. 升级Navigation到兼容AGP 7.2+的版本

如果上述步骤无效，建议将Navigation升级到2.5.0及以上版本，这些版本专门优化了对AGP 7.2+ namespace特性的支持：

项目级build.gradle：

plugins {
    id 'androidx.navigation.safeargs' version '2.5.3' apply false
    // 其他插件配置...
}

模块级build.gradle依赖：

dependencies {
    implementation 'androidx.navigation:navigation-fragment-ktx:2.5.3'
    implementation 'androidx.navigation:navigation-ui-ktx:2.5.3'
}

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