Gradle 会将依赖项添加到编译类路径和构建输出。当一个模块包含 api 依赖项时，会让 Gradle 了解该模块要以传递方式将该依赖项导出到其他模块，以便这些模块在运行时和编译时都可以使用该依赖项。此配置的行为类似于 compile（现已弃用），但使用它时应格外小心，只能对您需要以传递方式导出到其他上游消费者的依赖项使用它。这是因为，如果 api 依赖项更改了其外部 API，Gradle 会在编译时重新编译所有有权访问该依赖项的模块。因此，拥有大量的 api 依赖项会显著增加构建时间。除非要将依赖项的 API 公开给单独的模块，否则库模块应改用 implementation 依赖项。
lint: (敷伤口用的)纱布;(织物在制作过程中从表面掉落的)纤维屑，飞花;(毛料、棉布等的)绒毛
eg. （敷伤口用的）纱布 a type of soft cotton cloth used for covering and protecting wounds
dependencies {
// Executes lint checks from the ':checks' project
// at build time.
翻译后：构建时从'：checks'项目执行 link 检查
lintChecks project(':checks')
// Compiles lint checks from the ':checks-to-publish'
// into a lint.jar file and publishes it to your
// Android library.
翻译后：将'：checks-to-publish'编译lint检查放入lint.jar文件并将其发布到你的Android库
lintPublish project(':checks-to-publish')
}
configurations {
// Initializes a placeholder for the freeDebugRuntimeOnly dependency
// configuration.
翻译后：为freeDebugRuntimeOnly依赖项初始化一个占位符 配置
1.
freeDebugRuntimeOnly {}
}
dependencies {
2.
freeDebugRuntimeOnly fileTree(dir: 'libs', include: ['*.jar'])
}
如需为本地测试和插桩测试添加 implementation 依赖项，请使用如下所示的代码：
dependencies {
// Adds a remote binary dependency only for local tests.
翻译后：仅为本地测试添加远程二进制依赖项
testImplementation 'junit:junit:4.12'
// Adds a remote binary dependency only for the instrumented test APK.
翻译后：仅为自动化测试的APK添加远程二进制依赖项。
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
WARNING: Configuration 'androidTestApi' is obsolete and has been replaced with
'androidTestImplementation'.
翻译后：配置“ androidTestApi”已过时，并已替换为 'androidTestImplementation'
###3.添加注释处理器
如果将注释处理器添加到编译类路径，您将看到一条与以下内容类似的错误消息
Error: Annotation processors must be explicitly declared now. 翻译后：现在必须显式声明注释处理器
dependencies {
// Adds libraries defining annotations to only the compile classpath.
翻译后：仅将定义注释的库添加到编译类路径
compileOnly 'com.google.dagger:dagger:version-number'
// Adds the annotation processor dependency to the annotation processor classpath.
翻译后：将注释处理器依赖项添加到注释处理器类路径
annotationProcessor 'com.google.dagger:dagger-compiler:version-number'
}
class MyArgsProvider implements CommandLineArgumentProvider {
// Annotates each directory as either an input or output for the
// annotation processor.
翻译后：通过 注释处理器将每个目录注释为该目录的输入或输出
@InputFiles
// Using this annotation helps Gradle determine which part of the file path
// should be considered during up-to-date checks.
翻译后：使用此注释有助于Gradle确定在最新检查期间应考虑文件路径的哪一部分
自己理解为 更新的编译
@PathSensitive(PathSensitivity.RELATIVE)
FileCollection inputDir
@OutputDirectory
File outputDir
// The class constructor sets the paths for the input and output directories.
翻译后：类构造函数设置输入和输出目录的路径
MyArgsProvider(FileCollection input, File output) {
inputDir = input
outputDir = output
}
// Specifies each directory as a command line argument for the processor.
// The Android plugin uses this method to pass the arguments to the
// annotation processor.
翻译后：将每个目录指定为处理器的命令行参数。 Android插件使用此方法将参数传递给注释处理器。
@Override
Iterable<String> asArguments() {
// Use the form '-Akey[=value]' to pass your options to the Java compiler.
翻译后：使用格式“ -Akey [= value]”将您的选项传递给Java编译器。
["-AinputDir=${inputDir.singleFile.absolutePath}",
"-AoutputDir=${outputDir.absolutePath}"]
}
}
android {...}
// This is in your module's build.gradle file.
翻译后：这是在你的模块的build.gradle文件中
android {
defaultConfig {
javaCompileOptions {
annotationProcessorOptions {
// Creates a new MyArgsProvider object, specifies the input and
// output paths for the constructor, and passes the object
// to the Android plugin.
翻译后：创建一个新的MyArgsProvider对象，指定输入并输出构造函数的路径，并传递对象至Android插件
compilerArgumentProvider new MyArgsProvider(files("input/path"),
new File("output/path"))
}
}
}
}
// In the app's build.gradle file.
android {
buildTypes {
debug {}
release {}
staging {
// Specifies a sorted list of fallback build types that the
// plugin should try to use when a dependency does not include a
// "staging" build type. You may specify as many fallbacks as you
// like, and the plugin selects the first build type that's
// available in the dependency.
翻译后：
指定后备构建类型的排序列表， 插件在不包含依赖项时应尝试使用 “ staging”构建类型。
您可以指定与您一样多你喜欢的后备广告，然后插件在依赖项中可选择第一个构建类型 。
matchingFallbacks = ['debug', 'qa', 'release']
}
}
}
// In the app's build.gradle file.
android {
defaultConfig{
// Do not configure matchingFallbacks in the defaultConfig block.
// Instead, you must specify fallbacks for a given product flavor in the
// productFlavors block, as shown below.
翻译后：
不要在defaultConfig块中配置matchFallbacks。 相反，您必须在 productFlavors块 给定fallbacks，如下所示。
}
flavorDimensions 'tier'
productFlavors {
paid {
dimension 'tier'
// Because the dependency already includes a "paid" flavor in its
// "tier" dimension, you don't need to provide a list of fallbacks
// for the "paid" flavor.
翻译后：
因为依赖项已在“层”维度的依赖项中包含“付费”形式， 对于“付费”口味您无需提供后备列表。
}
free {
dimension 'tier'
// Specifies a sorted list of fallback flavors that the plugin
// should try to use when a dependency's matching dimension does
// not include a "free" flavor. You may specify as many
// fallbacks as you like, and the plugin selects the first flavor
// that's available in the dependency's "tier" dimension.
翻译后：
在不包含“免费”的味道插件时候，后备味道的排序列表 应该在依赖项的匹配维度确实起作用时。您可以 根据需要指定尽可能多的后备fallbacks，然后在依赖项的“tier”维度中可用的第一个样式插件。
matchingFallbacks = ['demo', 'trial']
}
}
}
编译错误原因
解决方案
库依赖项包含您的应用不包含的变种维度。例如，库依赖项包含“minApi”维度的变种，但您的应用仅包含“tier”维度的变种。因此，当您要构建“freeDebug”版本的应用时，插件不知道是使用“minApi23Debug”还是“minApi18Debug”版本的依赖项。请注意，如果您的应用包含库依赖项不包含的变种维度，这不会引发问题。这是因为，插件只会匹配依赖项中存在的维度的变种。例如，如果依赖项不包含 ABI 的维度，“freeX86Debug”版本的应用将直接使用“freeDebug”版本的依赖项。
// In the app's build.gradle file.
android {
defaultConfig{
// Specifies a sorted list of flavors that the plugin should try to use from
// a given dimension. The following tells the plugin that, when encountering
// a dependency that includes a "minApi" dimension, it should select the
// "minApi18" flavor. You can include additional flavor names to provide a
// sorted list of fallbacks for the dimension.
翻译后：
插件应尝试从一个维度使用一组指定的口味的排序列表。下面告诉插件，当遇到 包含“ minApi”维的依赖项，应选择 “ minApi18”风味。您可以包括其他风味名称以提供 维度的后备列表排序
missingDimensionStrategy 'minApi', 'minApi18', 'minApi23'
// You should specify a missingDimensionStrategy property for each
// dimension that exists in a local dependency but not in your app.
翻译后：
您应该为每个属性指定一个丢失维度策略属性 ，那些存在于本地依赖项中但不存在于您的应用程序中的维度
存在于本地依赖关系中，但不存在于您的应用中
missingDimensionStrategy 'abi', 'x86', 'arm64'
}
flavorDimensions 'tier'
productFlavors {
free {
dimension 'tier'
// You can override the default selection at the product flavor
// level by configuring another missingDimensionStrategy property
// for the "minApi" dimension.
翻译后：
您可以覆盖产品口味的默认选择，通过配置另一个missingDimensionStrategy属性进行级别 //用于“ minApi”维度
missingDimensionStrategy 'minApi', 'minApi23', 'minApi18'
}
paid {}
}
}
####远程代码库
当您的依赖项不是本地库或文件树时，Gradle 会在
build.gradle
文件的
repositories
代码块中指定的所有在线代码库中查找相关文件。各个代码库的列出顺序决定了 Gradle 在这些代码库中搜索各个项目依赖项的顺序。例如，如果从代码库 A 和 B 均可获得某个依赖项，而您先列出了代码库 A，则 Gradle 会从代码库 A 下载该依赖项。
默认情况下，新的 Android Studio 项目会将 Google 的 Maven 代码库和 JCenter 指定为项目的顶级
您可以在 Google 的 Maven 代码库索引中查看所有可用的工件（如需了解以编程方式访问，请参阅下文）。
如需将其中某个库添加到您的 build 中，请在顶级
build.gradle
文件中包含 Google 的 Maven 代码库：
maven :专家
allprojects {
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
翻译后:
如果您使用的Gradle版本低于4.1，则必须使用： maven{ url “ https://maven.google.com” //} //备用网址是'https://dl.google.com/dl/android/maven2
// An alternative URL is 'https://dl.google.com/dl/android/maven2/'
}
}
![与专家面对面：Android开发入门问与答[图]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)