Gradle 4.4/Java插件中api方法为何不可用，而implementation可用？

嘿，针对你在Android Studio 3.1里遇到的这个问题——想替换过时的compile关键字，同时让FrameManager里的特定jar把Guava暴露给CloudServerApplication，但换用api后构建失败——我整理了几个针对性的排查和解决步骤：

1. 先确认依赖声明的正确方式 #

首先，你得保证那个需要暴露Guava的特定jar是用api关键字声明的，因为只有api会把依赖的传递性内容（比如Guava）暴露给上层模块，implementation会隐藏这些：

• 如果是maven仓库的依赖：

  api 'com.yourgroup:your-specific-jar:your-version'
  

• 如果是本地libs目录下的jar：

  api files('libs/your-specific.jar')
  

2. 检查特定jar的Guava依赖是否是传递性的 #

如果这个jar是你自己打包的，可能存在Guava被直接打进jar里，而不是作为传递依赖的情况——这种情况下哪怕用api声明，上层模块也拿不到Guava的引用。这时候你可以：

• 要是jar是maven打包的，检查它的pom.xml里有没有正确声明Guava的依赖，并且<scope>是默认的compile（不需要特意修改）
• 要是是本地无pom的jar，直接在FrameManager的build.gradle里额外显式用api声明Guava：

  // 显式把Guava暴露给上层模块
  api 'com.google.guava:guava:28.1-android' // 换成你实际使用的版本
  // 你的特定jar用implementation就行，因为Guava已经单独暴露了
  implementation files('libs/your-specific.jar')
  

  这样既解决了暴露问题，还能避免jar里的Guava和全局依赖版本冲突。

3. 确认模块间的依赖关系没搞错 #

别忘了检查CloudServerApplication的build.gradle里是不是正确依赖了FrameManager，用implementation就行（因为FrameManager里的api依赖会自动传递过来）：

implementation project(':FrameManager')

4. 排查Gradle版本兼容性 #

Android Studio 3.1对应的Gradle插件版本应该是3.1.x，Gradle版本是4.4（从你报错里看到的4.4是匹配的），不过还是建议确认项目根目录的build.gradle里的插件版本：

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.4' // 3.1系列的稳定版，避免版本bug
    }
}

5. 清理缓存后重试 #

有时候Gradle的旧缓存会搞出奇怪的问题，先执行清理命令再构建：

gradlew clean
gradlew FrameManager:build

如果有具体报错信息的话 #

要是构建失败有更明确的错误（比如“找不到Guava的某个类”“依赖版本冲突”），可以针对性处理：

• 类找不到：确认Guava的版本正确，且用api声明了
• 版本冲突：用gradlew FrameManager:dependencies查看依赖树，找到Guava的多个版本，然后用resolutionStrategy强制统一版本：

  configurations.all {
      resolutionStrategy.force 'com.google.guava:guava:28.1-android'
  }
  

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