跳转到相应内容

最常访问

最近访问

navigation

使用构建缓存加快干净构建的速度

构建缓存可以存储 Android Plugin for Gradle 在构建您的项目时生成的特定输出(例如未打包的 AAR 和 pre-dexed 远程依赖项)。使用缓存时,您的干净构建将显著加快,因为构建系统在后续构建期间可以直接重用这些缓存文件,而不用重新创建它们。构建缓存也可以在持续性集成服务器上工作,并适合在一台本地机器上运行多个构建进程的情况。

使用 Android 插件 2.3.0 及更高版本的项目在默认情况下会启用构建缓存(除非您明确停用构建缓存)。不过,如果您将以下构建属性之一设置为与下面所示不同的值,插件将停用 pre-dexed 远程依赖项的缓存。(这些是每个属性的默认设置,因此如果您完全不声明它们,pre-dexed 远程依赖项的缓存将保持启用。)

android {
  defaultConfig {
    // If you do enable multidex, you must also set
    // minSdkVersion to 21 or higher.
    multiDexEnabled false
  }
  buildTypes {
    <build-type> {
      minifyEnabled false
    }
  }
  dexOptions {
    preDexLibraries true
  }
  ...
}
...

:如果您的项目使用 Android 插件版本 2.2.2 或 2.2.3,那么它使用的是实验性版本的构建缓存功能。您应更新您的项目以使用最新版本的 Android 插件

如果您想要了解可以让您的构建变快的其他方式,请阅读优化您的构建速度

更改构建缓存的位置

默认情况下,Android 插件将您的缓存保存在 <user-home>/.android/build-cache/ 中。如果您配置以下路径变量(按优先级逐渐降低的顺序列示)之一,Android Studio 将使用 <path-variable>/.android/build-cache/

Android 插件将为构建缓存使用一个默认位置,以便在您使用 Android 插件 2.3.0 或更高版本(并且未停用构建缓存)的所有项目之间共享缓存的文件。例如,在您的一个项目构建并缓存 pre-dexed 依赖项后,也使用该依赖项的其他项目可以从共享的构建缓存复制它,再次跳过预 dexing。

如果希望项目创建其自己的缓存(并且不与其他项目共享该缓存),您可以在该项目的 gradle.properties 文件中为缓存指定一个唯一位置,如下所示:

// You can specify either an absolute path or a path relative
// to the gradle.properties file.
android.buildCacheDir=<path-to-directory>

完成文件的编辑后,请点击 Sync Project 以创建新的构建缓存目录。

:避免为您在 <project-root>/build/<project-root>/<module-root>/build/ 目录中的构建缓存指定目录,因为 Gradle 会在每次运行 clean 任务时删除这些目录。

如果您仅希望将缓存与特定的其他项目共享,请在这些项目的 gradle.properties 文件中指定相同的构建缓存目录。

清除构建缓存

Android 插件的 clean 任务可以清除您的项目的 build/ 目录,与之类似,您可以运行 cleanBuildCache 任务来清除您的项目的构建缓存。如果项目为其构建缓存指定非默认目录,从该项目运行此任务仅会清除相关缓存,而无法清除默认位置中的共享缓存。要执行此任务,请从菜单栏中选择 View > Tool Windows > Terminal,并使用以下命令之一:

:如果您停用构建缓存,cleanBuildCache 任务将不可用。

停用构建缓存

由于构建缓存可以加快您的干净构建的速度,因此不建议停用此功能。如果您仍希望为您的项目停用构建缓存,请将以下内容添加到项目的 gradle.properties 文件中:

// To re-enable the build cache, either delete the following
// line or set the property to 'true'.
android.enableBuildCache=false

完成文件的编辑后,请点击 Sync Project 以应用您的更改。

:在您停用构建缓存后,Android 插件将忽略 android.buildCacheDir 属性,cleanBuildCache 任务将不再可用。同样,停用构建缓存不会自动清除构建目录。如果您决定重新启用构建缓存,这样可以让您保留缓存的文件。

此网站会使用 Cookie 来存储您在此网站上指定的语言和显示选项偏好设置。

获取最新的 Android Developers 资讯和提示,助您在 Google Play 上取得成功。

* 必填字段

成功!

在微信上关注 Google Developers

要以浏览此网站吗?

您请求访问的是网页,但是您为此网站设置的语言偏好为

要更改您的语言偏好设置并以浏览此网站吗?如果以后您想要更改语言偏好设置,请使用每个页面底部的语言菜单。

该类需要 或更高的 API 级别

此文档已被隐藏,因为您为该文档选择的 API 级别是 。您可以使用左侧导航栏上方的选择器来更改文档的 API 级别。

要详细了解如何根据您的应用需求指定 API 级别,请参阅支持不同平台版本

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)