Android Studio 中使用命令行構(gòu)建應(yīng)用

前面的小節(jié)我們介紹了通過圖形界面如何構(gòu)建和運行我們的應(yīng)用，從本小結(jié)我們學(xué)習(xí)如何在命令行中構(gòu)建我們的應(yīng)用。

1. 關(guān)于構(gòu)建類型

1.1 關(guān)于 Gradle 封裝容器

在命令行中構(gòu)建應(yīng)用，我們使用的是 Gradle 封裝容器，它可作為 Windows 的批處理文件 (gradlew.bat) 和 Linux 與 Mac 的 shell 腳本 (gradlew) 使用，而且我們可以從使用 Android Studio 創(chuàng)建的每個項目的根目錄啟動該工具。

我們可以使用 Gradle 封裝容器命令行工具執(zhí)行 Android 項目可用的所有構(gòu)建任務(wù)。要使用封裝容器運行任務(wù)，請在終端窗口中（在 Android Studio 中，依次選擇 View > Tool Windows > Terminal）使用下列命令之一：

• 在 Windows 上：

gradlew task-name

• 在 Mac 或 Linux 上：

./gradlew task-name

Tips：task-name是代指具體的 Gradle 任務(wù)名稱。

如需查看項目的所有可用構(gòu)建任務(wù)的列表，請執(zhí)行如下命令：

gradlew tasks

輸出結(jié)果如下：

------------------------------------------------------------
Tasks runnable from root project
------------------------------------------------------------

Android tasks
-------------
androidDependencies - Displays the Android dependencies of the project.
signingReport - Displays the signing info for the base and test modules
sourceSets - Prints out all the source sets defined in this project.

Build tasks
-----------
assemble - Assemble main outputs for all the variants.
assembleAndroidTest - Assembles all the Test applications.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildNeeded - Assembles and tests this project and all projects it depends on.
bundle - Assemble bundles for all the variants.
clean - Deletes the build directory.
cleanBuildCache - Deletes the build cache directory.
compileDebugAndroidTestSources
compileDebugSources
compileDebugUnitTestSources
compileReleaseSources
compileReleaseUnitTestSources
extractDebugAnnotations - Extracts Android annotations for the debug variant into the archive file
extractReleaseAnnotations - Extracts Android annotations for the release variant into the archive file

Build Setup tasks
-----------------
init - Initializes a new Gradle build.
wrapper - Generates Gradle wrapper files.

Cleanup tasks
-------------
lintFix - Runs lint on all variants and applies any safe suggestions to the source code.

Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'FirstApp'.
components - Displays the components produced by root project 'FirstApp'. [incubating]
dependencies - Displays all dependencies declared in root project 'FirstApp'.
dependencyInsight - Displays the insight into a specific dependency in root project 'FirstApp'.
dependentComponents - Displays the dependent components of components in root project 'FirstApp'. [incubating]
help - Displays a help message.
model - Displays the configuration model of root project 'FirstApp'. [incubating]
projects - Displays the sub-projects of root project 'FirstApp'.
properties - Displays the properties of root project 'FirstApp'.
tasks - Displays the tasks runnable from root project 'FirstApp' (some of the displayed tasks may belong to subprojects).

Install tasks
-------------
installDebug - Installs the Debug build.
installDebugAndroidTest - Installs the android (on device) tests for the Debug build.
uninstallAll - Uninstall all applications.
uninstallDebug - Uninstalls the Debug build.
uninstallDebugAndroidTest - Uninstalls the android (on device) tests for the Debug build.
uninstallRelease - Uninstalls the Release build.

Verification tasks
------------------
check - Runs all checks.
connectedAndroidTest - Installs and runs instrumentation tests for all flavors on connected devices.
connectedCheck - Runs all device checks on currently connected devices.
connectedDebugAndroidTest - Installs and runs the tests for debug on connected devices.
deviceAndroidTest - Installs and runs instrumentation tests using all Device Providers.
deviceCheck - Runs all device checks using Device Providers and Test Servers.
lint - Runs lint on all variants.
lintDebug - Runs lint on the Debug build.
lintRelease - Runs lint on the Release build.
lintVitalRelease - Runs lint on just the fatal issues in the release build.
test - Run unit tests for all variants.
testDebugUnitTest - Run unit tests for the debug build.
testReleaseUnitTest - Run unit tests for the release build.

1.2 關(guān)于 Build 類型

默認(rèn)情況下，每個 Android 應(yīng)用都有兩個版本類型：一個是調(diào)試版本，用于調(diào)試我們的應(yīng)用；另一個是發(fā)布版本，用于向用戶發(fā)布我們的應(yīng)用。必須先使用證書為從每個版本生成的輸出簽名，然后才能將我們的應(yīng)用部署到設(shè)備。調(diào)試版本會使用 SDK 工具提供的調(diào)試密鑰自動簽名（此版本不安全，我們不能將其發(fā)布到應(yīng)用市場），而發(fā)布版本必須使用我們自己的私鑰進行簽名。

Tips：如果我們要構(gòu)建發(fā)布版應(yīng)用，還請務(wù)必使用適當(dāng)?shù)暮灻荑€為我們的應(yīng)用簽名。 不過，如果我們剛剛?cè)腴T，也可以構(gòu)建調(diào)試版 APK，這樣就可以盡快在模擬器或連接的設(shè)備上運行我們的應(yīng)用。

2. 構(gòu)建APK

2.1 構(gòu)建調(diào)試版 APK

調(diào)試版 APK 使用 SDK 工具提供的調(diào)試密鑰進行簽名，并允許通過 adb 進行調(diào)試。要構(gòu)建調(diào)試版 APK，請打開命令行，然后轉(zhuǎn)到項目的根目錄。如需啟動調(diào)試版本，請調(diào)用 assembleDebug 任務(wù)：

gradlew assembleDebug

這將在 project_name/module_name/build/outputs/apk/ 中創(chuàng)建一個名為 module_name-debug.apk 的 APK。 該文件已使用調(diào)試密鑰進行簽名并使用 zipalign 對齊，因此我們可以立即將其安裝到設(shè)備上。

或者，如需構(gòu)建 APK 并立即在運行的模擬器或連接的設(shè)備上安裝，請改為調(diào)用 installDebug：

gradlew installDebug

Tips：上述任務(wù)名稱中的“Debug”部分只是構(gòu)建變體名稱的駝峰式大小寫版本，因此可以替換為我們想組裝或安裝的任何 Build 類型或變體。例如，如果我們有“demo”這個產(chǎn)品變種，則可以使用 assembleDemoDebug 任務(wù)來構(gòu)建調(diào)試版本。

2.2 構(gòu)建發(fā)布版 APK

當(dāng)我們準(zhǔn)備好發(fā)布和分發(fā)我們的應(yīng)用時，必須構(gòu)建一個使用我們的私鑰進行簽名的發(fā)布版 APK。發(fā)布版 APK 和調(diào)試版 APK 的不同之處在于私鑰簽名，關(guān)于應(yīng)用簽名部分將在后面介紹。

3. 構(gòu)建 app bundle

Android App Bundle 包含應(yīng)用的所有經(jīng)過編譯的代碼和資源，但 APK 的生成和簽名將轉(zhuǎn)到 Google Play 上來完成。與 APK 不同的是，我們不能直接將 app bundle 部署到設(shè)備上。

如需構(gòu)建 app bundle，最簡單的方法是使用 Android Studio。不過，如果需要從命令行構(gòu)建 app bundle，我們可以使用 Gradle 或 bundletool 來執(zhí)行這項操作。

3.1 Gradle 構(gòu)建 app bundle

如果我們更喜歡從命令行生成 app bundle，請在應(yīng)用的基礎(chǔ)模塊上運行 bundleVariant Gradle 任務(wù)。 例如，以下命令會為基礎(chǔ)模塊的調(diào)試版本構(gòu)建 app bundle：

./gradlew :base:bundleDebug

如果我們要構(gòu)建已簽名的 bundle 以上傳到 Play 管理中心，則需要先使用應(yīng)用的簽名信息來配置基礎(chǔ)模塊的 build.gradle 文件。如何配置 Gradle 來為我們的應(yīng)用簽名將在后面介紹。當(dāng)我們配置好 build.gradle 之后，我們就可以構(gòu)建應(yīng)用的發(fā)布版本，Gradle 會自動生成 app bundle，并使用我們在 build.gradle 文件中提供的簽名信息為其簽名。

3.2 bundletool 構(gòu)建 app bundle

bundletool 是一個命令行工具，Android Studio、Android Gradle 插件和 Google Play 使用這項工具將應(yīng)用的經(jīng)過編譯的代碼和資源轉(zhuǎn)換為 app bundle，并根據(jù)這些 bundle 生成可部署的 APK。

bundletool 要求關(guān)于應(yīng)用項目的某些信息（如應(yīng)用的清單和資源）采用 Google 的協(xié)議緩沖區(qū)格式（也稱為“protobuf”），并以 *.pb 作為文件擴展名。Protobuf 提供了一種不依賴于語言和平臺且可擴展的機制，用于對結(jié)構(gòu)化數(shù)據(jù)進行序列化。

3.2.1 下載 AAPT2

我們可以使用 Google Maven 代碼庫中的最新版 AAPT2 以 protobuf 格式生成應(yīng)用的清單文件和資源表。

Tips：請勿使用 Android 構(gòu)建工具包中包含的 AAPT2 版本，因為它不支持 bundletool。

要從 Google 的 Maven 代碼庫下載 AAPT2，請按以下步驟操作：

1. 在代碼庫索引中依次轉(zhuǎn)到 com.android.tools.build > aapt2；

2. 復(fù)制最新版 AAPT2 的名稱；

3. 將復(fù)制的版本名稱插入以下網(wǎng)址并指定目標(biāo)操作系統(tǒng)：https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/aapt2-version/aapt2-aapt2-version-[windows|linux|osx].jar；
   例如，要下載適用于 Windows 的版本 3.2.0-alpha18-4804415，我們應(yīng)使用：https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar；

4. 在瀏覽器中導(dǎo)航到該網(wǎng)址，系統(tǒng)應(yīng)該會隨即開始下載 AAPT2；

5. 解壓縮剛剛下載的 JAR 文件。

3.2.2 編譯并鏈接應(yīng)用的資源

我們可以通過以下命令，使用 AAPT2 編譯應(yīng)用的資源：

aapt2 compile \
project_root/module_root/src/main/res/drawable/Image1.png \
project_root/module_root/src/main/res/drawable/Image2.png \
-o compiled_resources/

Tips：雖然我們可以使用 --dir 標(biāo)記將資源目錄傳遞給 AAPT2，但這樣做會重新編譯目錄中的所有文件，無論我們實際更改了多少個文件。

在鏈接階段（在此階段，AAPT2 會將各種編譯后的資源鏈接到一個 APK 中），通過添加 --proto-format 標(biāo)記，指示 AAPT2 將應(yīng)用的清單和編譯后的資源轉(zhuǎn)換為 protobuf 格式，如下所示：

aapt2 link --proto-format -o output.apk \
-I android_sdk/platforms/android_version/android.jar \
--manifest project_root/module_root/src/main/AndroidManifest.xml \
-R compiled_resources/*.flat \
--auto-add-overlay

Tips：此外，當(dāng)使用 -R 標(biāo)記指定已編譯的資源時，我們可以指定一個包含每個已編譯資源的絕對路徑（各路徑之間用一個空格分隔）的文本文件。然后，我們可以將該文本文件傳遞給 AAPT2，如下所示：aapt2 link … -R @compiled_resources.txt。

接下來，我們可以從輸出 APK 提取內(nèi)容，如應(yīng)用的 AndroidManifest.xml、resources.pb 及其他資源文件（這些文件現(xiàn)在采用 protobuf 格式）。在準(zhǔn)備 bundletool 構(gòu)建 app bundle 所需的輸入時，我們需要用到這些文件。

3.2.3 打包預(yù)編譯的代碼和資源

在使用 bundletool 為我們的應(yīng)用生成 app bundle 之前，我們必須先提供 ZIP 文件，每個 ZIP 文件包含給定應(yīng)用模塊的經(jīng)過編譯的代碼和資源。每個模塊的 ZIP 文件的內(nèi)容和組織方式都與 Android App Bundle 格式非常類似。 例如，我們應(yīng)該為應(yīng)用的基礎(chǔ)模塊創(chuàng)建一個 base.zip 文件，并按如下方式組織其內(nèi)容：

準(zhǔn)備好每個應(yīng)用模塊的 ZIP 文件后，我們可以將其傳遞給 bundletool 來構(gòu)建 app bundle。

3.2.4 構(gòu)建 app bundle

要構(gòu)建 app bundle，請使用 bundletool build-bundle 命令，如下所示：

bundletool build-bundle --modules=base.zip --output=mybundle.aab

下表對用于 build-bundle 命令的標(biāo)記進行了更詳細(xì)的說明：

3.2.5 自定義 APK 生成

app bundle 包含一個 BundleConfig.pb 文件，該文件提供應(yīng)用商店（如 Google Play）在根據(jù) bundle 生成 APK 時所需的元數(shù)據(jù)。 雖然 bundletool 會為我們創(chuàng)建此文件，但我們可以在 BundleConfig.json 文件中配置元數(shù)據(jù)的某些方面，并將其傳遞給 bundletool build-bundle 命令。bundletool 隨后會轉(zhuǎn)換此文件并將其與每個 app bundle 中包含的 protobuf 版本進行合并。

例如，我們可以控制要啟用或停用哪些類別的配置 APK。以下 BundleConfig.json 文件示例會停用分別以不同語言為目標(biāo)的配置 APK（即，各個語言的資源分別包含在各自的基礎(chǔ)功能 APK 或動態(tài)功能 APK 中）：

{
  "optimizations": {
    "splitsConfig": {
      "splitDimension": [{
        "value": "LANGUAGE",
        "negate": true
      }]
    }
  }
}

在 BundleConfig.json 文件中，我們還可以指定在使用 glob 模式打包 APK 時要讓哪些類型的文件保持未壓縮狀態(tài)，如下所示：

{
  "compression": {
    "uncompressedGlob": ["res/raw/**", "assets/**.uncompressed"]
  }
}

4. 應(yīng)用簽名

不使用 Android Studio 也可以為我們的應(yīng)用簽名。我們可以從命令行為我們的應(yīng)用簽名（對于 APK，使用 apksigner；對于 app bundle，使用 jarsigner），或在構(gòu)建期間配置 Gradle 來為我們的應(yīng)用簽名。無論使用哪種方式，我們都需要先使用 keytool 生成一個私鑰，如下所示：

keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

上面的示例會提示我們輸入密鑰庫和密鑰的密碼，并提示我們在 Distinguished Name 字段中為我們的密鑰輸入相應(yīng)的名稱。隨后，它會生成一個名為 my-release-key.jks 的密鑰庫文件，并將其保存在當(dāng)前目錄中。該密鑰庫包含一個有效期為 10000 天的密鑰。

現(xiàn)在，我們可以手動為我們的 APK 或 app bundle 簽名，也可以在構(gòu)建過程中配置 Gradle 來為我們的應(yīng)用簽名，

4.1 使用命令行為應(yīng)用簽名

如果要從命令行為 app bundle 簽名，我們可以使用 jarsigner。 如果要為 APK 簽名，則需要使用 zipalign 和 apksigner。

1. 打開命令行（在 Android Studio 中，依次選擇 View > Tool Windows > Terminal），然后轉(zhuǎn)到未簽名的 APK 所在的目錄。

2. 使用 zipalign 對齊未簽名的 APK：

zipalign -v -p 4 my-app-unsigned.apk my-app-unsigned-aligned.apk

zipalign 可以確保所有未壓縮數(shù)據(jù)的開頭均相對于文件開頭執(zhí)行特定的字節(jié)對齊，從而減少應(yīng)用占用的 RAM 量。

3. 通過 apksigner 使用我們的私鑰為 APK 簽名：

apksigner sign --ks my-release-key.jks --out my-app-release.apk my-app-unsigned-aligned.apk

在本例中，在使用存儲在單個密鑰庫文件 my-release-key.jks 中的私鑰和證書為 APK 簽名后，將以 my-app-release.apk 的形式輸出已簽名的 APK。

4. 驗證我們的 APK 是否已簽名：

apksigner verify my-app-release.apk

4.2 配置 Gradle 為應(yīng)用簽名

打開模塊級 build.gradle 文件，并添加包含 storeFile、storePassword、keyAlias 和 keyPassword 條目的 signingConfigs {} 代碼塊，然后將該對象傳遞給我們的版本類型中的 signingConfig 屬性。例如：

android {
    ...
    defaultConfig { ... }
    signingConfigs {
        release {
            // You need to specify either an absolute path or include the
            // keystore file in the same directory as the build.gradle file.
            storeFile file("my-release-key.jks")
            storePassword "password"
            keyAlias "my-alias"
            keyPassword "password"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            ...
        }
    }
}

現(xiàn)在，當(dāng)我們通過調(diào)用 Gradle 任務(wù)來構(gòu)建我們的應(yīng)用時，Gradle 會為我們的應(yīng)用簽名（并運行 zipalign）。此外，因為我們已使用簽名密鑰配置了發(fā)布版本，所以該版本類型可以執(zhí)行“安裝”任務(wù)。因此，我們可以使用 installRelease 任務(wù)在模擬器或設(shè)備上構(gòu)建、對齊、簽署和安裝發(fā)布版 APK。

5. 小結(jié)

本節(jié)課程我們主要學(xué)習(xí)了如何在命令行中構(gòu)建我們的應(yīng)用。本節(jié)課程的重點如下：

• 了解命令行構(gòu)建應(yīng)用的方法；
• 掌握命令行為應(yīng)用簽名的方法。