Android子包/外部包类无法解析R符号 无需手动导入的配置方法

前置说明 #

Android的R类包路径由AGP（Android Gradle Plugin）的namespace配置决定，AGP 7.0及以上版本已废弃AndroidManifest.xml中的package属性作为R类包路径的配置入口，统一迁移到Gradle中配置。

方案1：单模块子包场景（最常用） #

直接在模块级build.gradle（Groovy语法）中配置统一namespace即可，所有主包下的子包类会自动识别R类，无需导入：

android {
    // 替换为你的应用基础包名，和原manifest中package值保持一致
    namespace "com.example.myapp"
    compileSdk 33

    defaultConfig {
        // 应用唯一标识，可与namespace不同
        applicationId "com.example.myapp"
        // 其余原有配置保持不变
    }
    // 其余原有配置保持不变
}

如果使用Kotlin DSL（build.gradle.kts），配置如下：

android {
    namespace = "com.example.myapp"
    compileSdk = 33

    defaultConfig {
        applicationId = "com.example.myapp"
        // 其余原有配置保持不变
    }
    // 其余原有配置保持不变
}

配置完成后同步Gradle即可生效，如果仍无法识别，可执行File > Invalidate Caches...清理IDE缓存后重启。

方案2：类放在主包根路径外部场景 #

如果你的类不属于主namespace的子包（例如主namespace为com.example.myapp，类存放在com.example.common路径下），可以通过新增源码集配置实现免导入：

android {
    namespace "com.example.myapp"
    sourceSets {
        main {
            // 新增外部代码路径到源码集，按你的实际路径修改
            java.srcDirs += ["src/main/java/com/example/common"]
            // 若为Kotlin代码新增以下配置
            kotlin.srcDirs += ["src/main/java/com/example/common"]
        }
    }
}

方案3：多模块开发场景 #

如果需要跨模块免导入主模块R类，可将主模块依赖方式改为api实现R类传递（按需开启，会增加编译耗时）：

// 子模块的build.gradle配置
dependencies {
    // 原来的implementation改为api
    api project(":app")
}

注意事项 #

• 不要在代码中创建和R类同名的自定义类，会导致引用冲突
• namespace修改后必须同步Gradle，否则会出现R类找不到的问题

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