建構設定

Android 建構系統會編譯應用程式資源和原始碼，並封裝至 APK 或 Android App Bundle，供您測試、部署、簽署及發布。

在「Gradle 建構總覽」和「Android 建構結構」中，我們討論了建構概念和 Android 應用程式的結構。現在要來設定建構作業。

Android 建構詞彙表

Gradle 和 Android Gradle 外掛程式可協助您設定建構作業的下列切面：

建構類型

建構類型可定義 Gradle 在建構及封裝應用程式時採用的特定屬性，通常是針對開發生命週期的不同階段進行設定。

舉例來說，偵錯建構類型會啟用偵錯選項，並使用偵錯金鑰簽署應用程式；而發布建構類型可能會經過壓縮、模糊處理，並以發布金鑰簽署應用程式供發布使用。

您必須定義至少一個建構類型，才能建構應用程式。根據預設，Android Studio 會建立偵錯和發布這兩種建構類型。如要開始為應用程式自訂封裝設定，必須瞭解如何設定建構類型。

變種版本
變種版本代表可向使用者發布的不同應用程式版本，例如免費版和付費版。您可以運用不同的程式碼和資源來自訂變種版本，同時也能共用及重複使用所有應用程式版本之間通用的部分。您可以選擇是否提供變種版本，但必須手動建立這些版本。如要開始建立應用程式的不同版本，請參閱「設定變種版本」一文。
建構變數
建構變數是建構類型和變種版本的交叉乘積，也是 Gradle 用於建構應用程式的設定。使用建構變數，您可以在開發期間建構變種版本的偵錯版本，並建構變種版本的簽署發布版本以供發布。 雖然您無法直接設定建構變數，但可以設定組成建構變數的建構類型和變種版本。建立其他建構類型或不同變種版本也會產生額外的建構變數。如要瞭解如何建立及管理建構變數，請參閱「設定建構變數」總覽。
資訊清單項目
您可以在設定產品建構變數時，指定資訊清單檔案中一部分屬性的數值。相關建構值會覆寫資訊清單檔案中原本的數值。如果要為應用程式產生多種變化版本，指定不同的應用程式名稱、最低 SDK 版本或目標 SDK 版本，這項功能就能派上用場。當同時存在多個資訊清單時，資訊清單合併工具會 合併資訊清單設定。
依附元件
建構系統可管理來自本機檔案系統和遠端存放區的專案依附元件。也就是說，您不需要手動搜尋或下載依附元件的二進位套件，以及將套件複製到專案目錄中。詳情請參閱「新增建構依附元件」。
簽署
建構系統可讓您在建構設定中指定簽署設定，也能在建構程序期間自動簽署應用程式。建構系統會使用已知憑證，透過預設金鑰和憑證簽署偵錯版本，以免在建構期間收到要求輸入密碼的提示。除非您明確指定此建構作業的簽署方式，否則建構系統不會主動簽署發布版本。如果您沒有發布金鑰，可按照「簽署應用程式」中的說明產生金鑰。您必須使用經過簽署的發布版本，才能透過多數應用程式商店發布應用程式。
程式碼和資源縮減
您可以透過建構系統為每個建構變數指定不同的 ProGuard 規則檔案。建構應用程式時，建構系統會套用適當的規則，並透過 R8 等內建縮減工具縮減程式碼和資源。 縮減程式碼和資源有助於縮減 APK 或 AAB 的大小。
支援多個 APK
建構系統可讓您自動建構不同的 APK，讓每個 APK 只包含特定螢幕密度或應用程式二進位檔介面 (ABI) 所需的程式碼和資源。詳情請參閱「 建構多個 APK」。不過，建議您採用發布單一 AAB 的做法，因為除了螢幕密度和 ABI 之外，此做法還能依據語言分割應用程式套件，同時降低將多個構件上傳至 Google Play 的必要性。凡是在 2021 年 8 月以後提交的新應用程式，都必須使用 AAB。

Android 建構作業中的 Java 版本

無論原始碼是以 Java、Kotlin 或兩者編寫，您都必須在多個位置為建構作業選擇 JDK 或 Java 語言版本。詳情請參閱「Android 建構作業中的 Java 版本」。

建構設定檔

建立自訂建構設定時，您需要變更一或多個建構設定檔。這些純文字檔會使用領域特定語言 (DSL) 描述建構邏輯，並利用 Kotlin 指令碼加以操控。Kotlin 指令碼是 Kotlin 語言的變種版本。您也可以使用 Groovy (Java 虛擬機器 (JVM) 的動態語言) 設定建構作業。

您不需要瞭解 Kotlin 指令碼或 Groovy，即可開始設定建構作業，因為 Android Gradle 外掛程式已提供需要使用的大多數 DSL 元素。如要進一步瞭解 Android Gradle 外掛程式 DSL，請參閱 DSL 參考說明文件。Kotlin 指令碼也需要使用基礎 Gradle Kotlin DSL

啟動新專案時，Android Studio 會自動為您建立一些檔案，並根據適當預設值填入資訊。如要瞭解所建立檔案的總覽，請參閱「Android 建構結構」。

Gradle Wrapper 檔案

Gradle 包裝函式 (gradlew) 是隨附於原始碼的小型應用程式，可下載並啟動 Gradle 本身。這有助於建構作業更穩定地執行。開發人員下載應用程式來源並執行 gradlew。這會下載必要的 Gradle 發行版本，並啟動 Gradle 來建構應用程式。

gradle/wrapper/gradle-wrapper.properties 檔案包含 distributionUrl 屬性，用於說明執行建構作業的 Gradle 版本。

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

Gradle 設定檔

settings.gradle.kts 檔案 (適用於 Kotlin DSL) 或 settings.gradle 檔案 (適用於 Groovy DSL) 位於專案根目錄中。這個設定檔可定義專案層級的存放區設定，並告知 Gradle 應在建構應用程式時納入哪些模組。多模組專案必須指定應加入至最終版本的所有模組。

在大多數專案中，預設的檔案內容如下所示：

Kotlin

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
      google()
      mavenCentral()
  }
}
rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "My Application"
include ':app'

頂層建構檔案

頂層 build.gradle.kts 檔案 (適用於 Kotlin DSL) 或 build.gradle 檔案 (適用於 Groovy DSL) 位於專案根目錄中，通常會定義專案中模組使用的外掛程式通用版本。

以下程式碼範例說明建立新專案後，頂層建構指令碼中的預設設定和 DSL 元素：

Kotlin

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id("com.android.application") version "8.11.0" apply false
    id("com.android.library") version "8.11.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

Groovy

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id 'com.android.application' version '8.11.0' apply false
    id 'com.android.library' version '8.11.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}