建立及編輯執行/偵錯設定

您在執行、偵錯或測試程式碼時,Android Studio 會根據執行/偵錯設定來決定執行作業的方式。一般來說,預設設定足以執行應用程式或對應用程式進行偵錯;但您也可以按照這個頁面上的說明,修改並建立新的設定,並配合您的開發程序修改預設範本。

如需詳細資訊,請一併參閱下列 IntelliJ 說明文件:

關於執行/偵錯設定

執行/偵錯設定會指定詳細資料,例如應用程式安裝、啟動和測試選項。您可以定義一次性設定,或是儲存設定以供日後使用。儲存後,您可以在工具列的「Select Run/Debug Configuration」下拉式清單中選取設定。Android Studio 會在專案中儲存設定。

預設執行/偵錯設定

第一次建立專案時,Android Studio 會根據「Android App」範本,為主要活動建立預設的執行/偵錯設定。如要執行專案或偵錯,您必須至少定義一項執行/偵錯設定。因此,我們建議您不要刪除預設設定。

專案範圍和版本管控

執行/偵錯設定和範本變更僅適用於目前的專案。您可以透過版本管控系統共用執行/偵錯設定,但無法共用範本。如要進一步瞭解如何共用設定,請參閱「名稱和共用設定選項」。

開啟「Run/Debug Configurations」對話方塊

如要開啟「Run/Debug Configurations」對話方塊,請依序選取「Run」>「Edit Configurations」。畫面上隨即會顯示「Run/Debug Configurations」對話方塊 (如圖 1 所示)。

圖 1. 「Run/Debug Configurations」對話方塊

對話方塊會在左側面板的「Defaults」資料夾下方顯示預設範本,並會依照範本類型將您定義的設定分組,顯示在「Defaults」資料夾上方。您可以調整對話方塊大小,以查看隱藏的項目。

在此對話方塊中,您可以執行下列操作:

建立新的執行/偵錯設定

您可以透過「Run/Debug Configurations」對話方塊、「Project」視窗或程式碼編輯器定義新的執行/偵錯設定。新設定必須採用預設範本

「Run/Debug Configurations」對話方塊會顯示您的執行/偵錯設定,以及可用的預設範本。您可以從範本或其他設定的副本直接開始新設定,並視需求變更欄位值。

您也可以在「Project」視窗中的項目上按一下滑鼠右鍵,自動建立該項目專屬的設定。舉例來說,如果您想執行特定活動,請在活動 Java 檔案上按一下滑鼠右鍵,然後選取「Run」。視項目而定,Android Studio 會使用「Android App」、「Android Instrumented Tests」或「Android JUnit」預設範本來建立設定。

在程式碼編輯器中,您可以輕鬆建立類別或方法的測試和測試/偵錯設定,並加以執行。

在「Run/Debug Configurations」對話方塊以外的位置建立設定時,除非您儲存設定,否則系統只會暫時保留該設定。根據預設,在 Android Studio 開始移除設定之前,專案中最多可以有五項暫時性設定。如要變更這項預設設定,請在「Run/Debug Configurations」對話方塊中按一下「Defaults」資料夾,然後在「Temporary Configurations Limit」欄位中輸入值。如要進一步瞭解暫時性設定,請參閱「建立並儲存臨時執行/偵錯設定」。

根據範本開始設定

如要根據範本定義執行/偵錯設定,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 按一下「Add New Configuration」圖示
  3. 選取預設範本
  4. 在「Name」欄位中輸入名稱。
  5. 視需要修改設定。
  6. 請務必修正對話方塊底部顯示的任何錯誤。

  7. 按一下「Apply」或「OK」

從副本開始設定

如要從另一項設定的副本開始定義執行/偵錯設定,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 選取左側窗格中的現有執行/偵錯設定。
  3. 按一下「Copy Configuration」圖示
  4. 在「Name」欄位中輸入名稱。
  5. 視需要修改設定。
  6. 請務必修正對話方塊底部顯示的任何錯誤。

  7. 按一下「Apply」或「OK」

為專案中的項目定義設定

Android Studio 可以為「Project」視窗中顯示的部分項目建立執行/偵錯設定。設定以預設範本為基礎,如下所示:

如要為專案中的項目建立執行/偵錯設定,請按照下列步驟操作:

  1. 「Android」或「Project」檢視畫面中開啟專案。
  2. 在「Project」視窗中,在可測試的項目上按一下滑鼠右鍵,然後選取「Run filename或「Debug filename。Android Studio 會建立暫時性的執行/偵錯設定,並啟動應用程式。
  3. 從工具列的「Select Run/Debug Configuration」下拉式清單中選取「Save」。如果沒有看到工具列,請依序選取「View」(檢視畫面)>「Toolbar」(工具列)

圖 2. 儲存設定

注意:如果您在相同項目 (而非活動) 上按一下滑鼠右鍵,並執行該項目或進行偵錯,Android Studio 會建立新的設定。

為類別或方法定義測試設定

Android Studio 可讓您為類別或方法定義測試執行設定,然後加以執行。舉例來說,如果您建立新類別,就可以建立並執行測試。如果測試通過,您就可以針對專案的其餘部分執行測試,確保新程式碼不會導致任何其他部分中斷。

Android Studio 會使用「Android Instrumented Tests」或「Android JUnit」範本 (視您的來源集而定)。針對本機單元測試,您也可以選擇在執行時使用程式碼涵蓋率指標。

如要在 Java 程式碼中為類別或方法建立執行/偵錯設定,請按照下列步驟操作:

  1. 「Android」或「Project」檢視畫面中開啟專案。
  2. 在程式碼編輯器中開啟 Java 檔案。
  3. 在程式碼中選取類別或方法,然後按下 Control + Shift + T 鍵 (Command + Shift + T 鍵)。
  4. 從隨即顯示的選單中選取「Create New Test」
  5. 在「Create Test」對話方塊中,視需要變更或設定值,然後按一下「OK」
  6. 在「Choose Destination Directory」對話方塊中,選取您希望 Android Studio 在專案中放置測試的位置。您可以按目錄結構或選取鄰近類別來指定位置。
  7. 按一下「OK」

    新測試會顯示在對應測試來源集的「Project」視窗中。

  8. 如要執行測試,請執行下列其中一項操作:
    • 在「Project」視窗中的測試上按一下滑鼠右鍵,然後選取「Run」或「Debug」
    • 在程式碼編輯器中,在測試檔案中的類別定義或方法名稱上按一下滑鼠右鍵,然後選取「Run」或「Debug」,以測試類別中的所有方法。
  9. 從工具列的「Select Run/Debug Configuration」下拉式清單中選取「Save」

圖 3. 儲存設定

使用已儲存的設定執行應用程式或對應用程式進行偵錯

如果您已儲存執行/偵錯設定,則可以在執行應用程式或對應用程式進行偵錯前選取該設定。

如要使用已儲存的執行/偵錯設定,請按照下列步驟操作:

  1. 工具列的「Select Run/Debug Configuration」下拉式清單中選取執行/偵錯設定。
  2. 下拉式清單位於「Run」圖示 和「Debug」圖示 的左側;例如

  3. 依序選取「Run」>「Run」或「Run」>「Debug」
  4. 或者,按一下「Run」圖示 或「Debug」圖示

編輯執行/偵錯設定

如要編輯執行/偵錯設定,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 在左側窗格中選取設定。
  3. 視需要修改設定。
  4. 請務必修正對話方塊底部顯示的任何錯誤。

  5. 按一下「Apply」或「OK」

編輯預設執行/偵錯設定範本

您可以根據自己的開發程序編輯 Android Studio 提供的預設範本。編輯範本並不會影響使用該範本的現有設定。舉例來說,如果您需要建立特定類型的多個設定,可以編輯範本,然後在完成時將範本還原。

雖然您無法建立新範本,但可以建立類似於範本的設定。您可以複製設定並編輯副本,藉此建立新的設定。

如要編輯範本,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 展開「Defaults」資料夾並選取預設範本
  3. 視需要修改設定。
  4. 請務必修正對話方塊底部顯示的任何錯誤。

  5. 按一下「Apply」或「OK」

排序及分組設定

在「Run/Debug Configurations」對話方塊中,您可以將設定排序以方便快速尋找。您可以依字母順序排序資料夾中的項目,然後建立新資料夾來將設定分組。

如要按字母順序排序設定,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 選取含有設定的資料夾。
  3. 按一下「Sort Configurations」圖示
  4. 按一下「Apply」或「OK」

如要將資料夾中的設定分組,請按照下列步驟操作:

  1. 開啟「Run/Debug Configurations」對話方塊
  2. 選取含有設定的資料夾。
  3. 按一下「Create New Folder」圖示
  4. 在「Folder Name」 欄位中輸入名稱。
  5. 將同一個範本類別中的項目拖曳到資料夾。
  6. 將同一個範本類別中的資料夾和設定拖曳至目標位置,或運用「Move Up」圖示 和「Move Down」圖示 來排列這些資料夾和設定。
  7. 按一下「Apply」或「OK」

定義啟動前作業

您可以指定套用執行/偵錯設定前應執行的工作。這些工作將依照清單中的順序執行。

注意事項:定義啟動前工作屬於進階功能。建議您不要直接使用這項功能,而是將所有預備程序邏輯設為 build.gradle 檔案中的工作,這樣系統就會在您透過指令列建構時執行這些作業。

如要建立工作清單,請按照下列步驟操作:

  1. 在「Run/Debug Configurations」(執行/偵錯設定)對話方塊底部,按一下「Before launch」下方的「Add」圖示 ,然後選取工作類型。如果畫面上隨即開啟對話方塊,請填妥欄位並按一下「OK」
  2. 視需要新增其他工作。
  3. 如要將工作排序,請選取工作,然後按一下「Up」圖示 和「Down」圖示 以在清單中移動工作。
  4. 如要先顯示執行/偵錯設定的設定,再套用這些設定,請選取「Show this page」(顯示此頁面)

    系統預設會取消選取這個選項。

  5. 如果您希望在執行應用程式或對應用程式進行偵錯時啟用「Run」(執行)或「Debug」(偵錯) 工具視窗,請選取「Active tool window」(啟用工具視窗)

    這是預設勾選的選項。

如要將工作從清單中移除,請按照下列步驟操作:

  1. 選取一項工作。
  2. 按一下「Remove」圖示

如要編輯工作,請按照下列步驟操作:

  1. 選取一項工作。
  2. 按一下「Edit」圖示
  3. 在隨即開啟的對話方塊中編輯工作設定,然後按一下「OK」

下表列出您可以新增的工作。

工作 說明
Run External tool 執行 Android Studio 以外的應用程式。在「External Tools對話方塊中,選取一或多個您要執行的應用程式,然後按一下「OK」。如果您尚未在 Android Studio 中定義該應用程式,請在「Create Tools對話方塊中新增定義。詳情請參閱「設定第三方工具」和「外部工具」。
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 這個選項與 Make 相同,差別在於 Android Studio 執行「執行/偵錯設定」時不考慮編譯結果。
Build Artifacts Android Studio 不支援這項操作。
Run Gradle task 執行 Gradle 工作。在隨即開啟的對話方塊中指定詳細資料,然後按一下「OK」。詳情請參閱「Gradle」。
Gradle-aware Make 編譯專案並執行 Gradle。
App Engine Gradle builder App Engine Gradle builder 工作會同步處理專案,然後建構模組。

預設執行/偵錯設定範本

Android Studio 提供預設的設定範本,可協助您快速上手。下列各節說明透過 Android Studio 進行 Android 開發作業的適用範本:

注意:Android Studio 2.1.x 以下的版本有原生應用程式範本,而較新的版本則沒有這個範本。如果您的專案已有原生應用程式範本,Android Studio 會在載入專案時將其轉換為 Android 應用程式。「Convert Project」對話方塊會引導您完成程序。

不支援的範本

以下不支援的範本來自 IntelliJ IDEA,且不是透過 Android Studio 進行 Android 開發作業的專用範本。如要進一步瞭解如何使用這些範本,請點選 IntelliJ IDEA 說明文件的連結。

名稱和共用設定選項

「Name」和「Share」選項僅適用於設定。建立設定時,請輸入設定名稱,如要共用設定,請勾選「Share」核取方塊。您無法為範本命名,也無法共用範本。

使用「Share」核取方塊,透過版本管控向其他團隊成員提供版本/偵錯設定。如果選取這個選項時專案已簽入版本控制系統,系統就會在他人簽出專案時納入執行/偵錯設定。

Android Studio 會將共用的執行/偵錯設定儲存在 project_directory/.idea/runConfigurations/ 資料夾內的個別 XML 檔案中。詳情請參閱「目錄型專案格式」。

Android App

您可以根據此範本使用設定,在虛擬或硬體裝置上執行 Android 應用程式/活動或進行偵錯。

「General」分頁

在「General」分頁中,您可以指定安裝、啟動和部署選項。「Miscellaneous」分頁也包含安裝選項。

欄位 說明
Module 選取要套用這項設定的模組
Installation Options: Deploy

選取下列其中一個選項:

  • 「Default APK」:為目前選取的變化版本建構及部署 APK。
  • 「APK from app bundle」:透過 Android App Bundle 建構及部署應用程式。也就是說,Android Studio 會先將應用程式專案轉換成應用程式套件,其中包含應用程式的所有編譯程式碼和資源。接著,Android Studio 只會從該套件產生將應用程式部署至連結裝置所需的 APK。由於從應用程式套件部署會延長整體建構時間,因此如要測試希望上傳到 Google Play 的應用程式套件,通常都應使用這個選項。
  • 「Custom Artifact」:Android Studio 不支援這項功能。
  • 「Nothing」:不要在裝置上安裝 APK。舉例來說,如果您想手動安裝 APK,就不需要由 Android Studio 進行安裝。
Installation Options: Deploy as instant app 如果您的應用程式支援免安裝體驗 (亦即您在建立新專案時新增免安裝應用程式支援功能,或是建立一或多個免安裝即用功能模組),則您可以勾選「Deploy as instant app」旁邊的方塊,藉此選擇部署這些免安裝即用模組。
Installation Options: Features to deploy 如果您的應用程式包含功能模組,請在部署應用程式時,一併勾選各項所要納入功能旁邊的方塊,只有在應用程式含有功能模組時,您才會看到這個選項。

注意事項:如果您想視需求測試下載與安裝功能模組,請務必在發布應用程式套件後,使用 Play 管理中心的內部測試群組。如要瞭解詳情,請參閱「將應用程式套件上傳至 Play 管理中心」。

Installation Options: Install Flags 輸入您要使用的任何 ADB pm install 選項;格式與使用指令列時相同,但不含路徑。例如:

-i foo.bar.baz -r /path/to/apk

-d -r

預設:不使用任何選項。

Launch Options: Launch

選取下列其中一個選項:

  • 「Nothing」:選取「**Run**」或「**Debug**」時不會啟動任何項目。不過,如果您已開始執行應用程式,並且選取「**Debug**」,Android Studio 就會將偵錯工具附加到應用程式程序中。
  • 「Default Activity」:啟動您在資訊清單中標示為啟動的活動。例如:
    
    <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    
  • 「Specified Activity」:在模組中啟動特定應用程式活動。 選取後,下方會顯示「Activity」欄位,可以在其中輸入您要啟動的活動名稱;您也可以按一下「More」,從清單中選取活動。
  • 「URL」:啟動與應用程式資訊清單中意圖篩選器相符的網址。 選取後,下方會顯示「URL」欄位,可以在其中輸入網址。

    您必須填寫這個欄位才能啟動 Android 免安裝應用程式。您也可以藉此測試 Android 應用程式連結

Launch Options: Launch Flags 輸入您要使用的任何 ADB am start 選項;格式與使用指令列時相同,但不含意圖。例如:

-W

如果「Launch」值設為「Nothing」,畫面上就不會顯示這個選項。

預設:不使用任何選項。

Deployment Target Options: Target

選取下列其中一個選項:

  • 「Open Select Deployment Target Dialog」:開啟「Select Deployment Target」對話方塊,選取虛擬或硬體裝置。
  • 「USB Device」:使用透過 USB 連接埠連接至開發電腦的硬體裝置。如有多個裝置,系統會顯示對話方塊,方便您選取。
  • 「Emulator」:使用虛擬裝置。您可以在設定中選取 AVD,否則系統只會使用清單中的第一個 AVD。

Deployment Target Options: Use same device for future launches

系統預設會取消選取這個選項,因此您每次執行應用程式時,畫面都會顯示「Select Deployment」對話方塊,供您選取裝置。選取這個選項後,當您執行應用程式,系統會顯示「Select Deployment」對話方塊,讓您選取裝置。接著,之後每次執行應用程式時,系統都會在所選裝置上啟動,而不會顯示「Select Deployment」對話方塊。如要在其他裝置上執行應用程式,請取消選取「Use same device for future launches」,或是依序點選「Run」>「Stop app或「Stop」圖示 以停止應用程式,然後再重新啟動。畫面上會隨即顯示「Select Deployment」對話方塊,方便您選取裝置。
Before Launch 請參閱「定義啟動前作業」。

「Miscellaneous」分頁

您可以在「Miscellaneous」分頁中指定 logcat、安裝、啟動和部署選項。「General」分頁也包含安裝選項。

欄位 說明
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 未變更所以不需要重新安裝時,就會強制停止應用程式,讓應用程式從預設的啟動器活動開始。如果取消選取,Android Studio 就不會強制停止應用程式。

這個選項會與前一個選項 (用於控制是否安裝 APK) 搭配運作。將這兩個「Install Options」欄位保留預設值,除非您明確希望每次都強制執行安裝。

在某些情況下,您可能需要取消選取這個選項。舉例來說,如果您要編寫輸入法引擎 (輸入法編輯器),強制停止應用程式會導致系統取消選取目前的鍵盤,這可能不是您希望的結果。

預設:已選取

Before Launch 請參閱「定義啟動前作業」。

「Debugger」分頁

在「Debugger」分頁中指定偵錯選項。

如果是 C 和 C++ 程式碼,Android Studio 會使用 LLDB 偵錯工具。除了一般 Android Studio UI 外,偵錯工具視窗也有「LLDB」分頁,可讓您在偵錯期間輸入 LLDB 指令。您可以在偵錯工具 UI 中輸入 Android Studio 用於顯示資訊的相同指令,也可以執行其他操作。

對於 C 和 C++ 專案,您可以在「Debugger」分頁中新增符號目錄、LLDB 啟動和附加後指令。如要這麼做,請使用類似下列選項的按鈕:

  • 「Add」圖示 :新增目錄或指令。
  • 「Remove」圖示 :選取目錄或指令,然後按一下這個按鈕移除項目。
  • 「Up」圖示 :選取目錄或指令,然後按一下這個按鈕,將清單中的項目向上移動。
  • 「Down」圖示 :選取目錄或指令,然後點選這個按鈕,將清單中的項目向下移動。

如要進一步瞭解如何在 Android Studio 中偵錯,請參閱「對應用程式進行偵錯」。

欄位 說明
Debug type

選取下列其中一個選項:

  • 「Java」:僅對 Java 程式碼進行偵錯。
  • 「Auto」:讓 Android Studio 選擇最適合專案的偵錯類型。
  • 「Native」:對原生 C 或 C++ 程式碼進行偵錯。
  • 「Dual」:使用兩個獨立的偵錯工作階段對 Java 和原生程式碼進行偵錯。

建議您選擇「Auto」選項,讓系統為專案選擇合適的偵錯類型。

Symbol Directories

如要新增符號檔案,以便向偵錯工具提供在 Android Studio 以外產生的 C 或 C++ 資訊,請在這裡新增一或多個目錄。Android Studio 會優先使用這些目錄中的任何檔案,而不是 Gradle 適用的 Android 外掛程式產生的檔案。偵錯工具會依序從上到下搜尋目錄,直到找出需要的內容為止。系統會遞迴搜尋目錄中的檔案。如要將清單最佳化並節省時間,請將最常使用的目錄放在清單頂端。

如果您指定樹狀結構中上層的目錄,系統可能需要較長的時間搜尋所有子目錄。如果您新增非常明確的目錄,則能縮短搜尋時間。您必須在速度與尋找偵錯所需的檔案之間取得平衡。舉例來說,如果您的目錄包含不同 Android 二進位檔介面 (ABI) 的子目錄,您可以選擇為特定 ABI 或所有 ABI 新增目錄。雖然搜尋上層目錄需要較長的時間,但如果您決定在其他裝置上進行偵錯,則這的確是較為萬無一失的做法。

請注意,您無須新增包含 Gradle 符號檔案的目錄,因為偵錯工具會自動使用這些檔案。

LLDB Startup Commands

新增您希望在偵錯工具附加到程序前執行的 LLDB 指令。例如,您可以定義環境的設定,如下列指令所示:

settings set target.max-memory-read-size 2048

LLDB 會依順序由上而下執行指令。

LLDB Post Attach Commands

新增您希望在偵錯工具附加到程序後立即執行的 LLDB 指令。例如:

process handle SIGPIPE -n true -p true -s false

LLDB 會依順序由上而下執行指令。

Host working directory 指定 LLDB 工作目錄。
Logging: Target channels

指定 LLDB 記錄選項。Android Studio 會根據團隊的使用體驗設定預設選項,因此這項程序不需花費太多時間,即包含疑難排解問題的必要資訊。系統通常會要求記錄,以用於 Android Studio 錯誤報告。預設為

lldb process:gdb-remote packets

您可以變更預設設定來收集更多資訊。例如,下列記錄選項會收集特定 platform 的相關資訊:

lldb process platform:gdb-remote packets

如需完整的記錄指令清單,請在 Android Studio 的 LLDB 殼層視窗中輸入 log list 指令。

Android Studio 會將裝置記錄放在下列位置,其中 ApplicationId 是在您建構的 APK 資訊清單中使用的專屬應用程式 ID,用來在裝置上和 Google Play 商店中識別應用程式:

/data/data/ApplicationId/lldb/log

或者,如果有多位使用者存取裝置,系統會將記錄放在下列位置,其中 AndroidUserId 是裝置上使用者的專屬 ID:

/data/user/AndroidUserId/ApplicationId/lldb/log

如要瞭解如何使用 LLDB 進行遠端偵錯,請參閱「遠端偵錯」。

Before Launch 請參閱「定義啟動前作業」。

「Profiling」分頁

如果裝置搭載的是 Android 7.1 以下版本,您必須勾選「Enable advanced profiling」選項,才能啟用 Android Profiler 中的特定功能。

Android 測試

您需要使用的測試範本取決於來源集。「Android Instrumented Tests」範本適用於檢測設備測試。「Android JUnit」範本適用於本機單元測試。

注意:如果您使用 Firebase Test Lab 在各種裝置上進行測試,可以使用「Android JUnit」範本定義檢測設備測試。詳情請參閱「使用 Firebase Test Lab 執行測試」。

下列分頁說明涵蓋 Android 檢測設備測試範本的分頁和欄位。如要瞭解 Android JUnit 測試範本的分頁和欄位,請參閱 IntelliJ「Run/Debug Configuration: JUnit」頁面。

「General」分頁

在「General」分頁中,您可以指定測試位置、檢測執行器、ADB 殼層和部署選項。

欄位 說明
Module 選取要套用這項設定的模組
Test

在這個區域中指定您要執行的測試位置:

  • 「All in module」:從所選模組啟動所有測試。
  • 「All in package」:從「Package」欄位中指定的套件啟動所有測試。輸入名稱,或按一下「More」,從對話方塊中選取套件。
  • 「Class」:針對「Class」欄位中指定的類別啟動測試。輸入名稱,或按一下「More」,從對話方塊中選取類別。
  • 「Method」:啟動測試方法。在「Class」欄位中,指定包含該方法的類別。在「Method」欄位中指定方法。輸入名稱,或按一下「More」,從對話方塊中選取類別或方法。
Specific instrumentation runner (optional) 輸入檢測執行器的位置;按一下「More」即可使用對話方塊。build.gradle 檔案會指定檢測執行器的位置;這個值會覆寫原本的值。預設值通常為 AndroidX Test 中的 AndroidJUnitRunner 類別。
Extra options

輸入您要使用的任何 ADB 選項 am instrument。請勿輸入元件。舉例來說,如果您使用的是 AndroidX Test 中的 AndroidJUnitRunner,您可以利用這個欄位將其他選項傳送到執行器,例如 -e size small

預設:不使用任何選項

Deployment Target Options: Target

選取下列其中一個選項:

  • 「Open Select Deployment Target Dialog」:開啟「Select Deployment Target」對話方塊,選取虛擬或硬體裝置。
  • 「USB Device」:使用透過 USB 連接埠連接至開發電腦的硬體裝置。如有多個裝置,系統會顯示對話方塊,方便您選取。
  • 「Emulator」:使用虛擬裝置。您可以在設定中選取 AVD,否則系統只會使用清單中的第一個 AVD。
  • 「Firebase Test Lab Device Matrix」:請參閱「使用 Firebase Test Lab 執行測試」。
Deployment Target Options: Use same device for future launches 如果您日後想要自動使用自己透過「Select Deployment Target」對話方塊選擇的裝置,請選取這個選項。如果裝置無法使用,系統會顯示對話方塊。預設:取消選取
Before Launch 請參閱「定義啟動前作業」。

「Miscellaneous」分頁

「Miscellaneous」分頁包含 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 未變更所以不需要重新安裝時,就會強制停止應用程式,讓應用程式從預設的啟動器活動開始。如果取消選取,Android Studio 就不會強制停止應用程式。

這個選項會與前一個選項 (用於控制是否安裝 APK) 搭配運作。將這兩個「Install Options」欄位保留預設值,除非您明確希望每次都強制執行安裝。

在某些情況下,您可能需要取消選取這個選項。舉例來說,如果您要編寫輸入法引擎 (輸入法編輯器),強制停止應用程式會導致系統取消選取目前的鍵盤,這可能不是您希望的結果。

預設:已選取

Before Launch 請參閱「定義啟動前作業」。

「Debugger」分頁

在「Debugger」分頁中指定偵錯選項。

如果是 C 和 C++ 程式碼,Android Studio 會使用 LLDB 偵錯工具。除了一般 Android Studio UI 外,偵錯工具視窗也有「LLDB」分頁,可讓您在偵錯期間輸入 LLDB 指令。您可以在偵錯工具 UI 中輸入 Android Studio 用於顯示資訊的相同指令,也可以執行其他操作。

對於 C 和 C++ 專案,您可以在「Debugger」分頁中新增符號目錄、LLDB 啟動和附加後指令。如要這麼做,請使用類似下列選項的按鈕:

  • 「Add」圖示 :新增目錄或指令。
  • 「Remove」圖示 :選取目錄或指令,然後按一下這個按鈕移除項目。
  • 「Up」圖示 :選取目錄或指令,然後按一下這個按鈕,將清單中的項目向上移動。
  • 「Down」圖示 :選取目錄或指令,然後點選這個按鈕,將清單中的項目向下移動。

如要進一步瞭解如何在 Android Studio 中偵錯,請參閱「對應用程式進行偵錯」。

欄位 說明
Debug type

選取下列其中一個選項:

  • 「Java」:僅對 Java 程式碼進行偵錯。
  • 「Auto」:讓 Android Studio 選擇最適合專案的偵錯類型。
  • 「Native」:對原生 C 或 C++ 程式碼進行偵錯。
  • 「Dual」:使用兩個獨立的偵錯工作階段對 Java 和原生程式碼進行偵錯。

建議您選擇「Auto」選項,讓系統為專案選擇合適的偵錯類型。

Symbol Directories

如要新增符號檔案,以便向偵錯工具提供在 Android Studio 以外產生的 C 或 C++ 資訊,請在這裡新增一或多個目錄。Android Studio 會優先使用這些目錄中的任何檔案,而不是 Gradle 適用的 Android 外掛程式產生的檔案。偵錯工具會依序從上到下搜尋目錄,直到找出需要的內容為止。系統會遞迴搜尋目錄中的檔案。如要將清單最佳化並節省時間,請將最常使用的目錄放在清單頂端。

如果您指定樹狀結構中上層的目錄,系統可能需要較長的時間搜尋所有子目錄。如果您新增非常明確的目錄,則能縮短搜尋時間。您必須在速度與尋找偵錯所需的檔案之間取得平衡。舉例來說,如果您的目錄包含不同 Android 二進位檔介面 (ABI) 的子目錄,您可以選擇為特定 ABI 或所有 ABI 新增目錄。雖然搜尋上層目錄需要較長的時間,但如果您決定在其他裝置上進行偵錯,則這的確是較為萬無一失的做法。

請注意,您無須新增包含 Gradle 符號檔案的目錄,因為偵錯工具會自動使用這些檔案。

LLDB Startup Commands

新增您希望在偵錯工具附加到程序前執行的 LLDB 指令。例如,您可以定義環境的設定,如下列指令所示:

settings set target.max-memory-read-size 2048

LLDB 會依順序由上而下執行指令。

LLDB Post Attach Commands

新增您希望在偵錯工具附加到程序後立即執行的 LLDB 指令。例如:

process handle SIGPIPE -n true -p true -s false

LLDB 會依順序由上而下執行指令。

Host working directory 指定 LLDB 工作目錄。
Logging: Target channels

指定 LLDB 記錄選項。Android Studio 會根據團隊的使用體驗設定預設選項,因此這項程序不需花費太多時間,即包含疑難排解問題的必要資訊。系統通常會要求記錄,以用於 Android Studio 錯誤報告。預設為

lldb process:gdb-remote packets

您可以變更預設設定來收集更多資訊。例如,下列記錄選項會收集特定 platform 的相關資訊:

lldb process platform:gdb-remote packets

如需完整的記錄指令清單,請在 Android Studio 的 LLDB 殼層視窗中輸入 log list 指令。

Android Studio 會將裝置記錄放在下列位置,其中 ApplicationId 是在您建構的 APK 資訊清單中使用的專屬應用程式 ID,用來在裝置上和 Google Play 商店中識別應用程式:

/data/data/ApplicationId/lldb/log

或者,如果有多位使用者存取裝置,系統會將記錄放在下列位置,其中 AndroidUserId 是裝置上使用者的專屬 ID:

/data/user/AndroidUserId/ApplicationId/lldb/log

如要瞭解如何使用 LLDB 進行遠端偵錯,請參閱「遠端偵錯」。

Before Launch 請參閱「定義啟動前作業」。

App Engine DevAppServer

這項執行/偵錯設定適用於 Google Cloud Platform。詳情請參閱「執行、測試及部署後端」。按照下列步驟進行,並將專案同步至 build.gradle 檔案時,Android Studio 會為您建立 App Engine DevAppServer 設定。

請注意,IntellJ IDEA 的「App Engine Server」範本是 Android Studio 不支援的另一種範本。

欄位 說明
Single instance only 如要確保目前僅執行「執行/偵錯設定」的一個執行個體,請選取這個選項。這個選項會禁止同時執行相同設定的多個執行個體。預設:已選取
Module 選取要套用這項設定的模組
Synchronize with build.gradle configuration 如果您新增 App Engine 模組並同步至 build.gradle 檔案,系統會為您填妥 App Engine DevAppServer 設定欄位 (建議做法)。 依序選取「File」>「Sync Project with Gradle Files」,系統也會同步處理專案。預設:已選取
App Engine SDK 輸入本機電腦上適用於 Java 的 Google App Engine SDK 路徑。按一下「...」,從對話方塊選取路徑。
War Path 對於您要在本機開發伺服器上部署的應用程式,輸入該應用程式的網頁應用程式封存 (WAR) 目錄路徑。按一下「...」,從對話方塊選取路徑。
VM Args

指定要傳送至 VM 以啟動 DevAppServer 的指令列選項。指定選項時,請注意下列事項:

  • 請以空格分隔不同的選項。
  • 關於包含空格的選項,請用半形引號括住空格 (" ")。
  • 如果選項包含引號,請在引號之前加上反斜線 (\")。

如要進一步瞭解 VM 選項,請參閱 J2SE 版本的說明文件,例如:java JDK 7 以及 java JDK 8

預設:不使用任何選項。

Server Address 輸入要用於伺服器的主機位址。您可能需要提供位址,才能從網路上的其他電腦存取開發伺服器。若將位址設為 0.0.0.0,就能同時進行 localhost 存取和主機名稱存取。預設:localhost
Server Port 輸入要用於伺服器的通訊埠編號。預設:8080
Disable Check for App Engine SDK Updates 若有指定,開發伺服器將不會聯絡 App Engine 以檢查是否有可用的新版本 SDK。根據預設,伺服器會在啟動時檢查新版本,並且在有可用的新版本時顯示訊息。
Before Launch 請參閱「定義啟動前作業」。