Android Studio 的運行配置

前面的小節我們介紹了代碼編輯和資源管理方面的知識，從本小結開始我們學習編譯運行相關的知識，首先我們學習下編譯運行前的配置。

1. 默認配置

在運行、調試我們的代碼時，Android Studio 使用運行/調試配置確定如何執行操作。通常，默認配置已可滿足運行或調試應用所需。在我們創建項目時，Android Studio 會根據 Android App 模板 為主 Activity 創建一個默認運行/調試配置。

要打開 Run/Debug Configurations 對話框，請依次選擇 Run > Edit Configurations。此時將顯示 Run/Debug Configurations 對話框，如下圖：

此對話框會在左側面板中的 Templates 文件夾下方顯示默認模板，并在 Templates 文件夾上方顯示我們已經定義的配置。

在我們創建項目時 Android Studio 會根據 Android App 模板 為主 Activity 創建一個默認運行/調試配置。我們可以使用基于此模板的配置，在虛擬或硬件設備上運行或調試 Android 應用和 Activity。

2. Android App 模板

Android App 模板有4個標簽：General，Miscellaneous，Debugger，Profiling。

2.1 General 標簽

在 General 標簽中，我們可以指定安裝、啟動和部署選項。

Module
選擇要應用此配置的模塊。

Installation Options：Deploy

• Default APK：為我們當前選擇的變體構建和部署 APK。

• APK from app bundle：從 Android App Bundle 構建和部署應用。也就是說，Android Studio 會先將我們的應用項目轉換為 app bundle，其中包含了應用的所有經過編譯的代碼和資源。然后，Android Studio 僅會從該 app bundle 生成將應用部署到已連接的設備所需的 APK。通常，在測試想要上傳到 Google Play 的 app bundle 時應使用此選項，因為從 app bundle 部署應用會延長總構建時間。

• Custom Artifact：在 Android Studio 中不受支持。

• Nothing：不在設備上安裝 APK。例如，如果我們更愿意手動安裝 APK，則無需使用 Android Studio 進行安裝。

Installation Options：Deploy as instant app

如果我們的應用支持免安裝體驗（也就是說，我們在創建新項目時添加了對免安裝應用的支持，或者我們創建了一項或多項支持免安裝體驗的動態功能），則我們可以選擇部署這些支持免安裝體驗的模塊，方法是勾選 Deploy as instant app 旁邊的復選框。

Installation Options：Dynamic features to deploy

如果我們的應用包含動態功能模塊，在部署應用時，請選中要包含的每個動態功能旁邊的復選框。只有在應用包含動態功能時，才會看到此選項。

Installation Options：Install Flags

鍵入我們要使用的任何 adb pm install 選項。設置選項格式的方式與在命令行上相同，但不指定路徑。

Launch Options：Launch

• Nothing：當我們選擇 Run 或 Debug 時，不啟動任何內容。不過，如果我們的應用已在運行且我們選擇了 Debug ，則 Android Studio 會將調試程序連接到我們的應用進程。

• Default Activity：啟動在清單中標記為啟動項的 Activity。

• Specified Activity：啟動模塊中特定的應用 Activity。選擇此選項后，Activity 字段將顯示在下方，我們可以在其中輸入要啟動的 Activity 的名稱，也可以點擊 More 以從列表中選擇一個 Activity。

• URL：啟動與應用清單中的 intent 過濾條件匹配的網址。選擇此選項后，URL 字段將顯示在下方，我們可以在其中輸入網址。

Launch Options：Launch Flags

鍵入我們要使用的任何 adb am start 選項。設置選項格式的方式與在命令行上相同，但不指定 intent。

Before Launch

定義啟動之前的操作。

2.2 Miscellaneous 標簽

在 Miscellaneous 標簽中，我們可以指定 logcat、安裝、啟動和部署選項。

Logcat：Show logcat automatically

選中此選項后，每次使用此配置成功部署和啟動應用時，系統都會打開 Logcat 窗口。

Logcat：Clear log before launch

如果我們希望 Android Studio 在啟動應用之前從日志文件中移除之前會話的數據，請選中此選項。

Installation Options：Skip installation if APK has not changed

選中此選項后，如果 Android Studio 檢測到我們的 APK 未更改，將不會重新部署 APK。如果我們希望 Android Studio 即使在 APK 未更改的情況下仍強行安裝 APK，則取消選中此選項。

Installation Options：Force stop running application before launching activity

如果選中此選項，則在 Android Studio 檢測到 APK 未更改從而無需重新安裝 APK 時，它將強行停止應用，以便應用從默認啟動器 Activity 啟動。如果取消選中此選項，則 Android Studio 不會強行停止應用。

Before Launch

定義啟動之前的操作。

2.3 Debugger 標簽

我們可以在 Debugger 標簽中指定調試選項。

對于 C 和 C++ 代碼，Android Studio 會使用 LLDB 調試程序。除了普通的 Android Studio 界面，調試程序窗口還有一個 LLDB 標簽，讓我們可以在調試過程中輸入 LLDB 命令。我們可以輸入與 Android Studio 用于在調試程序界面中顯示信息的命令相同的命令，還可以執行其他操作。對于 C 和 C++ 項目，我們可以在 Debugger 標簽中添加符號目錄，以及 LLDB 啟動與連接后命令。

Debug type

• Java：僅調試 Java 代碼；

• Auto：讓 Android Studio 為我們的項目選擇最合適的調試類型；

• Native：調試原生 C 或 C++ 代碼；

• Dual：在兩個單獨的調試會話中調試 Java 和原生代碼；

Symbol Directories

如果要添加符號文件來為調試程序提供在 Android Studio 外部生成的 C 或 C++ 代碼的信息，我們可以在此處添加一個或多個目錄。

LLDB Startup Commands

添加要在調試程序連接到進程之前執行的 LLDB 命令。

LLDB Post Attach Commands

添加要在調試程序連接到進程之后立即執行的 LLDB 命令。

Logging：Target channels

指定 LLDB 日志選項。Android Studio 會根據團隊的經驗設置默認選項，所以速度不會太慢，但卻包含問題排查所需的信息。Android Studio 錯誤報告經常需要請求日志。

Before Launch

定義啟動之前的操作。

2.4 Profiling 標簽

如果我們的設備搭載的是 Android 7.1 或更低版本，則必須勾選 Enable advanced profiling 選項才能啟用 Android Profiler 中的特定功能。

3. 創建新的配置

Run/Debug Configurations 對話框會顯示我們的運行/調試配置和可用的默認模板，我們可以直接根據模板或從其他配置的副本開始定義新配置，我們還可以在 Project 窗口中右鍵點擊某個項，以自動創建該項專用的配置。

3.1 根據模板開始配置

要根據模板定義運行/調試配置，請按以下步驟操作：

1. 打開 Run/Debug Configurations 對話框；

2. 點擊 Add New Configuration 圖標 ；

3. 選擇一個默認模板；

4. 在 Name 字段中輸入一個名稱；

5. 根據需要修改配置；請務必更正在此對話框底部顯示的所有錯誤；

6. 點擊 OK。

3.2 使用副本開始配置

要使用其他配置的副本開始定義運行/調試配置，請按以下步驟操作：

1. 打開 Run/Debug Configurations 對話框；

2. 在左側窗格中選擇現有的運行/調試配置；

3. 點擊 Copy Configuration 圖標 ；

4. 在 Name 字段中輸入一個名稱；

5. 根據需要修改配置；請務必更正在此對話框底部顯示的所有錯誤；

6. 點擊 OK。

3.3 為項目中的項定義配置

Android Studio 可以為 Project 窗口中顯示的某些項創建運行/調試配置。如需為項目中的某個項創建運行/調試配置，請按以下步驟操作：

1. 在 Android 或 Project 視圖中打開一個項目；

2. 在 Project 窗口中，右鍵點擊某個可測試項，然后選擇 Run 文件名 或 Debug 文件名。Android Studio 會創建一個臨時的運行/調試配置并啟動我們的應用；

3. 從工具欄的 Select Run/Debug Configuration 下拉列表中選擇 Save。

4. 使用自定義的配置

如果我們保存了運行/調試配置，則可以在運行或調試應用之前選擇該配置。

如需使用保存的運行/調試配置，請按以下步驟操作：

1. 從工具欄的 Select Run/Debug Configuration 下拉列表中選擇我們自定義的配置；
   
2. 選擇 Run > Run 或 Run > Debug 運行程序。

5. 定義啟動之前的操作

我們可以指定要在應用運行/調試配置之前執行的任務。任務會按照其在列表中顯示的順序來執行。

要創建任務列表，請按以下步驟操作：

1. 在 Run/Debug Configurations 對話框底部的 Before launch 下方，點擊 Add 圖標 ，然后選擇一種任務類型。如果對話框打開，請填充其中的字段并點擊 OK。

2. 根據需要添加更多任務。

3. 要對任務進行排序，請選擇一個任務并點擊 Up 圖標 或 Down 圖標 ，以將其在列表中上移或下移。

4. 如果我們想在應用運行/調試配置設置前顯示這些設置，請選擇 Show this page。

5. 如果我們希望在運行或調試應用時激活 Run 或 Debug 工具窗口，請選中 Active tool window。

可供添加的任務如下：

Run External tool

運行 Android Studio 外部的應用。在 External Tools 對話框中，選擇我們要運行的一個或多個應用，然后點擊 OK。

Run Another Configuration

執行某個現有的運行/調試配置。在 Choose Configuration to Execute 對話框中，選擇要執行的配置，然后點擊 OK。

Make

編譯項目或模塊。如果運行/調試配置指定了特定的模塊，Android Studio 會執行 Make Module 命令；如果未指定任何模塊，則會執行 Make Project 命令。

Make Project

編譯項目。Android Studio 將執行 Make Project 命令。

Make, no error check

Android Studio 在執行運行/調試配置時不考慮編譯結果，除此之外，此選項與 Make 相同。

Run Gradle task

運行 Gradle 任務。在打開的對話框中，指定詳情，然后點擊 OK。

Gradle-aware Make

編譯項目并運行 Gradle。

App Engine Gradle builder

App Engine Gradle builder 任務會同步項目，然后構建模塊。

6. 小結

本節課程我們主要學習了運行配置相關的知識。本節課程的重點如下：

• 掌握 Android Studio 默認運行配置；
• 掌握 如何創建和使用自定義配置。