Gradle构建报错：无法获取项目':app'的'appcompat'属性

前阵子我在构建从网上找到的代码时，碰到了这个Gradle构建错误：

ERROR: 无法获取类型为org.gradle.api.Project的项目':app'的未知属性'appcompat'

当时我的依赖配置是这样的：

implement "com.android.support:appcompat-v7:$project.appcompat"
implement "com.android.support:cardview-v7:$project.appcompat"
implement "com.android.support:recyclerview-v7:$project.appcompat"
implement "android.arch.lifecycle:runtime:$project.arch"
implement "android.arch.lifecycle:extensions:$project.arch"
implement "com.squareup.retrofit2:retrofit:$project.retrofit"
implement "com.squareup.retrofit2:converter-gson:$project.retrofit"
annotationProcessor "android.arch.lifecycle:compiler:$project.arch"
implement "com.android.support.constraint:constraint-layout:$project.constraintLayout"
implement "com.android.support:support-v4:$project.appcompat"

后来我搞懂了问题根源，也顺利解决了——其实就是Gradle里用到的$project.appcompat、$project.arch这些变量没有被提前定义，Gradle找不到它们，自然就抛出了未知属性的错误。

两种可行的解决方法： #

方法一：统一定义版本变量（推荐）

在项目根目录的build.gradle文件中，添加ext代码块来集中定义这些版本变量，这样所有模块都能共用，后续维护升级也更方便：

buildscript {
    // ... 保留原有配置
}

allprojects {
    repositories {
        // ... 保留原有仓库配置
    }
}

// 在这里统一定义版本变量
ext {
    appcompat = '28.0.0' // 可根据实际需求调整为合适的版本号
    arch = '1.1.1'
    retrofit = '2.9.0'
    constraintLayout = '1.1.3'
}

定义完成后，原来的依赖配置就能正常使用变量引用了。

方法二：直接替换为具体版本号

如果不需要统一管理版本，也可以直接把依赖里的$project.xxx替换成对应的具体版本号，比如：

implement "com.android.support:appcompat-v7:28.0.0"
implement "com.android.support:cardview-v7:28.0.0"
implement "com.android.support:recyclerview-v7:28.0.0"
implement "android.arch.lifecycle:runtime:1.1.1"
// 其他依赖同理替换版本号即可

这种方式更直接，适合小型项目或者不需要频繁升级版本的场景。

核心逻辑就是让Gradle能识别到你用到的属性变量，要么提前定义好，要么直接使用具体值就行。

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