创建和编辑运行/调试配置

在运行、调试或测试代码时，Android Studio 使用运行/调试配置确定如何执行此操作。通常，默认配置足以满足要求，您只需运行或调试应用即可。但是，您可以修改和创建新配置，还可以修改默认模板，以满足开发流程要求。

关于运行/调试配置

运行/调试配置指定应用安装、启动和测试选项等详情。您可以将配置定义为一次性使用，也可以保存配置，以备日后使用。保存配置后，您可以从工具栏中的 Select Run/Debug Configuration 下拉列表选择配置。Android Studio 会将配置保存为项目的一部分。

默认的运行/调试配置

在您首次创建一个项目时，Android Studio 会根据 Android App 模板，为主 Activity 创建一个默认的运行/调试配置。要运行或调试项目，您必须始终定义至少一个运行/调试配置。因此，我们建议您不要删除此配置。

项目范围和版本控制

运行/调试配置和模板更改仅应用于当前项目。如果您选择共享某个运行/调试配置，然后将项目签入版本控制系统，则会与任何签出此项目的用户共享此配置。您不能共享模板。

打开“Run/Debug Configurations”对话框

“Run/Debug Configurations”对话框显示运行/调试配置和可用的默认模板。在此对话框中，您可以：

• 创建新的运行/调试配置。
• 编辑运行/调试配置。
• 编辑默认模板。
• 对配置进行排序和分组。

要打开此对话框，请执行以下操作之一：

• 选择 Run > Edit Configurations。
• 从工具栏中的 Select Run/Debug Configuration 下拉列表中选择 Edit Configurations。
  此下拉列表位于 Run 和 Debug 的左侧 ；例如 。

如果当前未显示工具栏，请选择 View > Toolbar 以显示工具栏。

此时将显示 Run/Debug Configurations 对话框，如图 1 所示。

图 1. Run/Debug Configurations 对话框。

此对话框的左侧面板将显示 Defaults 文件夹中的默认模板。它会按照模板类型对定义的配置进行分组。您可以调整对话框大小以查看任何隐藏的项。

创建新的运行/调试配置

您可以通过 Run/Debug Configurations 对话框、Project 窗口或代码编辑器定义新的运行/调试配置。新配置必须基于默认模板。

在 Run/Debug Configurations 对话框中，您可以直接通过模板或通过其他配置的副本开始定义新配置。然后，您可以根据需要更改字段值。

或者，您可以在 Project 窗口中右键点击某个项，以自动创建特定于此项的配置。例如，如果您要运行特定的 Activity，则可以右键点击此 Activity Java 文件，然后选择 Run。Android Studio 会使用 Android App、Android Tests 或 JUnit 默认模板创建配置，这取决于具体的项。

在代码编辑器中，您可以轻松为某个类或方法创建测试和运行/调试配置，然后执行此配置。

如果您不是使用 Run/Debug Configurations 对话框创建配置，则此配置在保存之前只是临时配置。默认情况下，项目中最多可以包含五个临时配置，否则，Android Studio 将开始移除多余的配置。要更改此默认值，请在 Run/Debug Configurations 对话框中点击 Defaults 文件夹，然后在 Temporary Configurations Limit 字段中键入一个值。如需了解有关临时配置的详细信息，请参阅创建和保存临时运行/调试配置。

您可以通过版本控制系统共享运行/调试配置（而非模板）。如果您在运行/调试配置中选择 Shared，然后将项目签入版本控制系统，则签出项目的任何用户将收到此配置。

根据模板开始定义配置

要根据模板定义运行/调试配置，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。
• 点击 Add New Configuration。
• 选择一个默认模板。
• 在 Name 字段中键入名称。

• 根据需要修改配置。
  务必纠正此对话框底部显示的任何错误。

• 点击 Apply 或 OK。

通过副本开始定义配置

要从其他配置的副本开始定义运行/调试配置，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。
• 在左侧窗格中选择现有的运行/调试配置。
• 点击 Copy Configuration。
• 在 Name 字段中键入名称。

• 根据需要修改配置。
  务必纠正此对话框底部显示的任何错误。

• 点击 Apply 或 OK。

为项目中的项定义配置

Android Studio 可以为 Project 窗口中显示的某些项自动创建运行/调试配置。此配置基于默认模板：

• Activity Java 文件 - Android App 模板。
• 软件包 - Android Tests 或 JUnit 模板，取决于源集。如果您选择的是工具测试，则系统使用 Android Tests 模板。如果您选择的是本地单元测试，则系统使用 JUnit 模板。对于本地单元测试，您可以选择使用代码覆盖范围选项运行。如需了解详细信息，请参阅代码覆盖范围。

注：对于 build.gradle 或 settings.gradle 文件，Android Studio 使用 Groovy 模板。而对于 build.gradle 文件，则应使用 Gradle Console 运行或调试。

要为项目中的某个项创建运行/调试配置，请按以下步骤操作：

• 在 Android 或 Project 视图中打开一个项目。

• 在 Project 窗口中，右键点击某个项，然后选择 Run 或 Debug。
  Android Studio 会创建一个临时的运行/调试配置并启动应用。

• 要保存配置，请从工具栏中的 Select Run/Debug Configuration 下拉列表中选择 Save。
  此下拉列表位于 Run 和 Debug 的左侧 ；例如 。

或者，再次右键点击此项并选择 Save。

或者，在 Run/Debug Configurations 对话框中选择配置并点击左上角的 Save Configuration 。

如果您右键点击后重新运行或调试该项，Android Studio 会创建新配置，Activity 除外。

为类或方法定义测试配置

在 Android Studio 中，您可以为某个类或方法定义测试运行配置，然后执行此配置。例如，如果您创建一个新类，则可以为其创建和运行测试。如果测试通过，则您可以对项目的其余类运行测试，以确保新代码未在其他地方出现问题。

Android Studio 会使用 Android Tests 或 JUnit 模板，具体取决于您的源集对于本地单元测试，您可以选择使用代码覆盖范围选项运行。

要为 Java 代码中的某个类或方法创建运行/调试配置，请按以下步骤操作：

• 在 Android 或 Project 视图中打开一个项目。
• 在代码编辑器中打开一个 Java 文件。
• 选择代码中的某个类或方法，然后按 Ctrl+Shift+T (⌘⇧T)。
• 在出现的菜单中选择 Create New Test。
• 在 Create Test 对话框中，可以选择更改字段值，然后点击 OK。

• 在 Choose Destination Directory 对话框中，选择 androidTest 创建工具测试，或选择 test 创建本地单元测试。点击 OK。
  新测试出现在 Project 窗口中对应的测试源集内。

• 要运行测试，请执行以下操作之一：

• 在 Project 窗口中，右键点击测试，然后选择 Run 或 Debug。
• 在代码编辑器中，右键点击测试文件中的某个类定义，然后选择 Run 或 Debug，测试此类中的所有方法。
• 在代码编辑器中，右键点击测试文件中的某个方法名称，然后选择 Run 或 Debug，仅测试此方法。
• 在代码编辑器中，点击 某个类或方法旁边的左边缘的“Play”，然后选择 Run 或 Debug。
• 要保存配置，请从工具栏中的 Select Run/Debug Configuration 下拉列表中选择 Save。
  此下拉列表位于 Run 和 Debug 的左侧 ；例如 。

或者，再次右键点击此项并选择 Save。

或者，在 Run/Debug Configurations 对话框中选择配置并点击左上角的 Save Configuration 。

使用保存的配置运行或调试应用

如果您已保存一个运行/调试配置，则可以选择此配置，然后运行或调试应用。

要使用保存的运行/调试配置，请按以下步骤操作：

• 从工具栏中的 Select Run/Debug Configuration 下拉列表选择此运行/调试配置。
  此下拉列表位于 Run 和 Debug 的左侧 ；例如 。

• 选择 Run > Run 或 Run > Debug。
  或者，点击 Run 或 Debug。

注：在 Instant Run 会话期间，选择其他运行/调试配置，然后再次点击 Run 或 Debug 可以结束当前会话。

编辑运行/调试配置

要编辑运行/调试配置，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。
• 在左侧窗格中选择一个配置。

• 根据需要修改配置。
  务必纠正此对话框底部显示的任何错误。

• 点击 Apply 或 OK。

编辑默认的运行/调试配置模板

您可以编辑 Android Studio 提供的默认模板，以满足开发流程要求。编辑某个模板不会影响使用此模板的现有配置。因此，例如，如果您需要创建某一类型的多个配置，您可以编辑模板，然后在完成操作后还原模板。

尽管您无法创建新模板，但您可以创建与模板用途类似的配置。您可以复制配置和编辑此副本，以创建新配置。

要编辑模板，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。
• 展开 Defaults 文件夹，选择一个默认模板。

• 根据需要修改配置。
  务必纠正此对话框底部显示的任何错误。

• 点击 Apply 或 OK。

对配置进行排序和分组

在 Run/Debug Configurations 对话框中，您可以对配置进行排序，以便快速查找配置。您可以按字母顺序对文件夹中的项排序，并创建新的文件夹以对配置进行分组。

要按字母顺序对配置排序，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。
• 选择包含配置的文件夹。
• 点击 Sort Configurations。

• 点击 Apply 或 OK。
  要对文件夹中的配置进行分组，请按以下步骤操作：

• 打开“Run/Debug Configurations”对话框。

• 选择包含配置的文件夹。
• 点击 Create New Folder。
• 在 Name 字段中键入名称。
• 将相同模板类别中的项拖到此文件夹中。
• 对同一模板类别中的文件夹和配置进行排序的方法是：将其拖到适当位置或使用 Move Up 和 Move Down 上下移动它们 。
• 点击 Apply 或 OK。

定义启动之前的操作

您可以指定要在应用运行/调试配置前执行的任务。任务会按照其在列表中显示的顺序来执行。定义启动之前的操作是一项高级功能。

我们建议您不要使用此功能，而应将任何准备逻辑作为任务添加到 build.gradle 文件中，以便在从命令行构建时执行这些逻辑。

要创建任务列表，请按以下步骤操作：

• 要将任务添加到任务列表中，请点击 Add 并选择一种任务类型。如果打开一个对话框，请填充其中的字段并点击 OK。
• 可根据需要添加更多任务。
• 要对任务进行排序，请选择一个任务并点击 Up 和 Down， 以在列表中向上或向下移动任务。

• 如果您想在应用运行/调试配置设置前显示这些设置，请选择 Show this page。
  默认情况下，此选项为未选中状态。

• 如果您希望在运行或调试应用时自动激活 Run 或 Debug 工具窗口，请选择 Active tool window。
  默认情况下，此选项处于选中状态。

要从此列表中移除任务，请按以下步骤操作：

• 选择一个任务。

• 点击 Remove。
  要编辑任务，请按以下步骤操作：

• 选择一个任务。

• 点击 Edit。
• 在打开的对话框中编辑任务设置，然后点击 OK。
  下表列出了可供添加的任务。

默认的运行/调试配置模板

Android Studio 提供默认的配置模板，以帮助您快速入门。在使用 Android Studio 进行 Android 开发时，可使用以下模板：

• Android App
• Android Tests
• App Engine DevAppServer
• JUnit
  注：Android Studio 2.1.x 及更低版本具有本机应用模板，而较新的版本则没有此模板。如果您的项目具有本机应用模板，则在您加载项目时，Android Studio 会自动将此模板转换为 Android App 模板。Convert Project 对话框会指导您完成该过程。

以下不受支持的模板来自 IntelliJ IDEA，并且不适用于使用 Android Studio 进行的 Android 开发：

• Application
• Compound
• Gradle
• Groovy
• JAR Application
• JUnit Test Discovery
• Java Scratch
• Remote
• TestNG
• TestNG Test Discovery
  请跟踪这些链接访问 IntelliJ IDEA 文档，了解有关使用这些模板的详情。

Android 应用

您可以使用基于此模板的配置，在虚拟或硬件设备上运行或调试 Android 应用和 Activity。

Name 和 Share

运行/调试配置具有 Name 和 Share 选项，而模板没有这两个选项。

“General”标签

在 General 标签中，您可以指定安装、启动和部署选项。Miscellaneous 标签也包含安装选项。

<intent-filter>
  <action android:name="android.intent.action.MAIN" />
  <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>

“Miscellaneous”标签

在 Miscellaneous 标签中，您可以指定 logcat、安装、启动和部署选项。General 标签也包含安装选项。

“Debugger”标签

在 Debugger 标签中指定调试选项。

对于 C 和 C++ 代码，Android Studio 会使用 LLDB 调试程序。除了普通的 Android Studio UI，调试程序窗口还有一个 LLDB 标签，让您可以在调试过程中输入 LLDB 命令。您可以输入 Android Studio 用于在调试程序 UI 中显示信息的相同命令，还可以执行其他操作。

对于 C 和 C++ 项目，您可以在 Debugger 标签中添加符号目录，以及 LLDB 启动与连接后命令。要执行此操作，您可以使用如下所示的按钮：

• Add - 添加目录或命令。
• Remove - 选择目录或命令，然后点击此按钮可移除项。
• Up - 选择目录或命令，然后点击此按钮可在列表中向上移动项。
• Down - 选择目录或命令，然后点击此按钮可在列表中向下移动项。
  如需了解在 Android Studio 中调试的详细信息，请参阅调试您的应用。

“Profiling”标签

在 Profiling 标签中为 Android Monitor 指定 GPU 调试程序分析选项。

Android Tests

您应使用的测试模板取决于源集。Android Tests 模板用于工具测试。JUnit 模板用于本地单元测试。

如果您正利用 Firebase 测试实验室在各种设备上测试，您可以使用此模板定义工具测试。如需了解详细信息，请参阅利用 Firebase 测试实验室运行测试。

Name 和 Share

运行/调试配置具有 Name 和 Share 选项，而模板没有这两个选项。

“General”标签

在 General 标签中，您可以指定测试位置、测试工具运行器、adb shell 和部署选项。

“Miscellaneous”标签

Miscellaneous 标签包含 logcat 和安装选项。

“Debugger”标签

在 Debugger 标签中指定调试选项。

对于 C 和 C++ 代码，Android Studio 会使用 LLDB 调试程序。除了普通的 Android Studio UI，调试程序窗口还有一个 LLDB 标签，让您可以在调试过程中输入 LLDB 命令。您可以输入 Android Studio 用于在调试程序 UI 中显示信息的相同命令，还可以执行其他操作。

对于 C 和 C++ 项目，您可以在 Debugger 标签中添加符号目录，以及 LLDB 启动与连接后命令。要执行此操作，您可以使用如下所示的按钮：

• Add - 添加目录或命令。
• Remove - 选择目录或命令，然后点击此按钮可移除项。
• Up - 选择目录或命令，然后点击此按钮可在列表中向上移动项。
• Down - 选择目录或命令，然后点击此按钮可在列表中向下移动项。
  如需了解在 Android Studio 中调试的详细信息，请参阅调试您的应用。

“Profiling”标签

在 Profiling 标签中为 Android Monitor 指定 GPU 调试程序分析选项。

App Engine DevAppServer

此运行/调试配置适用于 Google 云端平台。如需了解详细信息，请参阅添加 App 引擎 Java Servlet 模块和运行、测试和部署后端。当您按照上述步骤将项目同步到 build.gradle 文件后，Android Studio 将为您创建 App Engine DevAppServer 配置。

请注意，IntellJ IDEA App Engine Server 模板是 Android Studio 中未提供的其他模板。