配置构建

    Gradle 和 Android 插件独立于 Android Studio 运行。 这意味着，您可以在 Android Studio 内、计算机上的命令行或未安装 Android Studio 的计算机（例如持续性集成服务器）上构建 Android 应用。 如果您不使用 Android Studio，可以学习如何。 无论您是从命令行、在远程计算机上还是使用 Android Studio 构建项目，构建的输出都相同。

    注：由于 Gradle 和 Android 插件独立于 Android Studio 运行，您需要单独更新构建工具。 请阅读版本说明，了解如何更新 Gradle 和 Android 插件。

    Android 构建系统非常灵活，让您能够在不修改应用核心源文件的情况下执行自定义构建配置。 本节帮助您了解 Android 构建系统的工作原理，以及它如何帮助您对多个构建配置进行自定义和自动化处理。 如果您只想了解有关部署应用的更多信息，请参阅。 要立即开始使用 Android Studio 创建自定义构建配置，请参阅配置构建变体。

    构建流程涉及许多将您的项目转换成 Android 应用软件包 (APK) 的工具和流程。 构建流程非常灵活，因此了解它的一些底层工作原理会很有帮助。

    图 1. 典型 Android 应用模块的构建流程。

    如图 1 所示，典型 Android 应用模块的构建流程通常依循下列步骤：

    • 编译器将您的源代码转换成 DEX（Dalvik Executable) 文件（其中包括 Android 设备上运行的字节码），将所有其他内容转换成已编译资源。
    • APK 打包器将 DEX 文件和已编译资源合并成单个 APK。 不过，必须先签署 APK，才能将应用安装并部署到 Android 设备上。
    • APK 打包器使用调试或发布密钥库签署您的 APK：
      • 如果您构建的是调试版本的应用（即专用于测试和分析的应用），打包器会使用调试密钥库签署您的应用。 Android Studio 自动使用调试密钥库配置新项目。
      • 如果您构建的是打算向外发布的发布版本应用，打包器会使用发布密钥库签署您的应用。 要创建发布密钥库，请阅读。

    Gradle 和 Android 插件可帮助您完成以下方面的构建配置：

    • 构建类型
    • 构建类型定义 Gradle 在构建和打包您的应用时使用的某些属性，通常针对开发生命周期的不同阶段进行配置。 例如，调试构建类型支持调试选项，使用调试密钥签署 APK；而发布构建类型则可压缩、混淆 APK 以及使用发布密钥签署要分发的 APK。 您必须至少定义一个构建类型才能构建应用 - Android Studio 默认情况下会创建调试和发布构建类型。 要开始为应用自定义打包设置，请学习如何配置构建类型。
    • 产品风格
    • 产品风格代表您可以向用户发布的不同版本的应用，例如免费和付费版本的应用。 您可以将产品风格自定义为使用不同的代码和资源，同时对所有应用版本共有的部分加以共享和重复利用。 产品风格是可选项，并且您必须手动创建。 要开始创建不同的应用版本，请学习如何。
    • 构建变体
    • 构建变体是构建类型与产品风格的交叉产物，是 Gradle 在构建应用时使用的配置。 您可以利用构建变体在开发时构建调试版本的产品风格，或者构建要分发的已签署发布版产品风格。 您不是直接配置构建变体，而是配置组成变体的构建类型和产品风格。 创建附加构建类型或产品风格也会创建附加构建变体。 要了解如何创建和管理构建变体，请阅读配置构建变体 概览。
    • 清单条目
    • 您可以为构建变体配置中清单文件的一些属性指定值。 这些构建值会替换清单文件中的现有值。 如果您想为模块生成多个 APK，让每一个 APK 文件都具有不同的应用名称、最低 SDK 版本或目标 SDK 版本，便可运用这一技巧。 存在多个清单时，Gradle 会。
    • 依赖项
    • 构建系统管理来自您的本地文件系统以及来自远程存储区的项目依赖项。 这样一来，您就不必手动搜索、下载依赖项的二进制文件包以及将它们复制到项目目录内。 要了解更多信息，请参阅添加构建依赖项。
    • 签署
    • 构建系统让您能够在构建配置中指定签署设置，并可在构建过程中自动签署您的 APK。 构建系统通过使用已知凭据的默认密钥和证书签署调试版本，以避免在构建时提示密码。 除非您为此构建明确定义签署配置，否则，构建系统不会签署发布版本。 如果您没有发布密钥，可以按中所述生成密钥。
    • ProGuard
    • 构建系统让您能够为每个构建变体指定不同的 ProGuard 规则文件。 构建系统可在构建过程中运行 ProGuard 对类进行压缩和混淆处理。
    • 多 APK 支持

    创建自定义构建配置需要您对一个或多个构建配置文件（或 文件）进行更改。 这些纯文本文件使用域特定语言 (DSL) 以 语言描述和操作构建逻辑，其中 Groovy 是一种适用于 Java 虚拟机 (JVM) 的动态语言。 您无需了解 Groovy 便可开始配置构建，因为 Android Plugin for Gradle 引入您需要的大多数 DSL 元素。 如需了解有关 Android 插件 DSL 的更多信息，请阅读 DSL 参考文档。

    开始新项目时，Android Studio 会自动为您创建其中的部分文件（如图 2 所示），并为其填充合理的默认值。

    图 2. Android 应用模块的默认项目结构。

    有几个 Gradle 构建配置文件是 Android 应用标准项目结构的组成部分。 您必须了解其中每个文件的范围和用途及其应定义的基本 DSL 元素，才能着手配置构建。

    settings.gradle 文件位于项目根目录，用于指示 Gradle 在构建应用时应将哪些模块包括在内。 对大多数项目而言，该文件很简单，只包括以下内容：

    不过，多模块项目需要指定应包括在最终构建之中的每个模块。

    顶级构建文件

    顶级 build.gradle 文件位于项目根目录，用于定义适用于项目中所有模块的构建配置。 默认情况下，此顶级构建文件使用 buildscript 代码块来定义项目中所有模块共用的 Gradle 存储区和依赖项。 以下代码示例描述的默认设置和 DSL 元素可在新建项目后的顶级 build.gradle 文件中找到。

    配置项目范围的属性

    对于包含多个模块的 Android 项目，在项目级别定义某些属性，并在所有模块间共享这些属性可能会非常有用。 为此，您可以将 添加到顶级 build.gradle 文件的 ext 代码块中。

    要从相同项目中的模块访问这些属性，请在模块的 build.gradle 文件（您可以在以下部分了解有关此文件的详细信息）中使用以下语法。

    注：虽然 Gradle 可让您在模块级别定义项目范围的属性，但您应避免这样做，因为这样会导致共享这些属性的模块进行耦合。 模块耦合会加大之后以独立项目形式导出模块的难度，并会妨碍 Gradle 利用功能加快多模块构建。

    模块级 build.gradle 文件位于各 目录中，用于配置适用于其所在模块的构建设置。 您可以通过配置这些构建设置来提供自定义打包选项（例如附加构建类型和产品风格），以及替换 main/ 应用清单或顶级 build.gradle 文件中的设置。

    此 Android 应用模块 build.gradle 文件示例概括您应了解的某些基本 DSL 元素和设置。

    Gradle 属性文件

    • gradle.properties
    • 您可以在其中配置项目范围 Gradle 设置，例如 Gradle 后台进程的最大堆大小。 如需了解详细信息，请参阅构建环境。
    • local.properties
    • 为构建系统配置本地环境属性，例如 SDK 安装路径。 由于该文件的内容由 Android Studio 自动生成并且专用于本地开发者环境，因此您不应手动修改该文件，或将其纳入您的版本控制系统。

    当您在项目中对构建配置文件进行更改时，Android Studio 会要求您同步项目文件，以便其导入您的构建配置更改并执行一些检查来确保您的配置不会造成构建错误。

    要同步项目文件，请点击做出更改后出现的通知栏中的 Sync Now（如图 3 所示），或者点击菜单栏中的 Sync Project。 如果 Android Studio 通知配置出现错误，例如：您的源代码使用了只有在 compileSdkVersion 以上的 API 级别中才会提供的 API 功能，则会显示 Messages 窗口以描述该问题。</imgsrc=”>

    Configure your build - 图1

    图 3. 在 Android Studio 中将项目与构建配置文件同步。

    源集

    Android Studio 按逻辑关系将每个模块的源代码和资源分组为源集。 模块的 main/ 源集包括其所有构建变体使用的代码和资源。 其他源集目录为可选项，在您配置新的构建变体时，Android Studio 不会自动为您创建这些目录。 不过，创建类似于 main/ 的源集有助于让 Gradle 仅在构建特定应用版本时才应使用的文件和资源井然有序：

    • 此源集包括所有构建变体共用的代码和资源。
    • src/buildType/
    • 创建此源集可加入特定构建类型专用的代码和资源。
    • src/productFlavor/

    • 创建此源集可加入特定产品风格专用的代码和资源。
      注：如果配置构建以，则可为风格维度间产品风格的各个组合创建源集目录： src/productFlavor1ProductFlavor2/

    • src/productFlavorBuildType/

    • 创建此源集可加入特定构建变体专用的代码和资源。
      例如，要生成应用的“完整调试”版本，构建系统需要合并来自以下源集的代码、设置和资源：

    • src/fullDebug/（构建变体源集）

    • src/debug/（构建类型源集）
    • src/full/（产品风格源集）

    这样一来，Gradle 便可使用专用于您试图构建的构建变体的文件，同时对与其他应用版本共用的 Activity、应用逻辑和资源加以重复利用。 在合并多个清单时，Gradle 使用同一优先顺序，这样每个构建变体都能在最终清单中定义不同的组件或权限。 如需了解有关创建自定义源集的更多信息，请转至。