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

当您运行、调试或测试代码时，Android Studio 会使用运行/调试配置来确定如何执行操作。通常，最初创建的配置足以运行或调试应用。但是，您可以修改和创建新的配置，并修改配置模板以适合您的开发流程，如本页面所述。

有关更多信息，另请参阅以下 IntelliJ 文档

关于运行/调试配置

运行/调试配置指定了应用安装、启动和测试选项等详细信息。您可以定义一个配置供一次性使用，也可以将其保存以备将来使用。保存后，您可以在 工具栏 中的**选择运行/调试配置**下拉列表中选择该配置。Android Studio 将配置作为项目的一部分保存。

初始创建的运行/调试配置

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

项目范围和版本控制

运行/调试配置和模板更改仅适用于当前项目。您可以通过版本控制系统共享运行/调试配置（但不能共享模板）。有关如何共享配置的更多信息，请参阅配置名称和共享选项。

打开运行/调试配置对话框

要打开运行/调试配置对话框，请选择运行 > 编辑配置。将显示运行/调试配置对话框，如图 1 所示。

图 1. 运行/调试配置对话框

对话框的左侧面板按模板类型对您定义的配置进行分组，并允许您在底部编辑配置模板。您可以在右侧面板中编辑选定的配置。调整对话框大小以查看任何隐藏的项目。

在此对话框中，您可以

创建新的运行/调试配置

您可以从运行/调试配置对话框、项目窗口或代码编辑器中定义新的运行/调试配置。新配置必须基于配置模板。

运行/调试配置对话框显示您的运行/调试配置和可用的配置模板。您可以直接从模板或从另一个配置的副本开始新的配置。然后，您可以根据需要更改字段值。

或者，您可以右键单击项目窗口中的某个项目以自动创建特定于该项目的配置。例如，如果您要运行特定活动，则可以右键单击活动 Java 文件并选择运行。根据项目，Android Studio 将使用Android 应用、Android Instrumentation 测试或JUnit配置模板来创建配置。

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

在运行/调试配置对话框外部创建配置时，除非您保存它，否则该配置是临时的。默认情况下，您可以在项目中最多有五个临时配置，然后 Android Studio 将开始删除它们。要更改此默认设置，请打开 Android Studio 设置，然后更改高级设置 > 运行/调试 > 临时配置限制。有关临时配置的更多信息，请参阅创建和保存临时运行/调试配置。

基于模板启动配置

要基于模板定义运行/调试配置，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 单击添加新配置 。
  3. 选择配置模板。
  4. 在名称字段中输入名称。
  5. 根据需要修改配置。

    6. 确保更正对话框底部显示的任何错误。

  6. 单击应用或确定。

从副本启动配置

要从另一个配置的副本开始定义运行/调试配置，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 在左侧窗格中选择现有的运行/调试配置。
  3. 单击复制配置 。
  4. 在名称字段中输入名称。
  5. 根据需要修改配置。

    6. 确保更正对话框底部显示的任何错误。

  6. 单击应用或确定。

为项目中的项目定义配置

Android Studio 可以为项目窗口中显示的某些项目创建运行/调试配置。该配置基于配置模板，如下所示

要为项目中的项目创建运行/调试配置，请执行以下步骤

  1. 在Android 或项目视图中打开项目。
  2. 在项目窗口中，右键单击可测试的项目，然后选择运行 filename或调试 filename。Android Studio 将创建一个临时运行/调试配置并启动您的应用。
  3. 在工具栏中打开选择运行/调试配置下拉列表。
  4. 从您要保存的配置旁边的选项中选择保存配置。

    图 2. 保存配置

注意：如果您右键单击并运行或调试相同的项目（但不是活动），Android Studio 将创建一个新的配置。

为类或方法定义测试配置

Android Studio 允许您为类或方法定义测试运行配置，然后执行它。例如，如果您创建了一个新类，则可以为其创建和运行测试。如果测试通过，则可以运行项目的其余测试，以确保您的新代码不会在其他地方破坏任何内容。

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

要为 Java 代码中的类或方法创建运行/调试配置，请执行以下步骤

  1. 在Android 或项目视图中打开项目。
  2. 在代码编辑器中打开 Java 文件。
  3. 在代码中选择一个类或方法，然后按 Control+Shift+T (Command+Shift+T)。
  4. 从出现的菜单中选择创建新测试。
  5. 在创建测试对话框中，可以选择更改或设置值，然后单击确定。
  6. 在选择目标目录对话框中，选择要在项目中放置测试的位置。您可以通过目录结构或选择相邻类来指定位置。
  7. 单击确定。

    新测试将显示在相应测试源集的项目窗口中。

  8. 要运行测试，请执行以下操作之一
    • 在项目窗口中，右键单击测试，然后选择运行或调试。
    • 在代码编辑器中，右键单击测试文件中的类定义或方法名称，然后选择运行或调试以测试类中的所有方法。
  9. 在工具栏中打开选择运行/调试配置下拉列表。
  10. 从您要保存的配置旁边的选项中选择保存配置。

    图 3. 保存配置

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

如果已保存运行/调试配置，则可以在运行或调试应用之前选择它。

要使用已保存的运行/调试配置，请执行以下步骤

  1. 从工具栏中的选择运行/调试配置下拉列表中选择运行/调试配置。

    2. 下拉列表位于运行 和调试 的左侧；例如，。

  2. 选择运行 > 运行或运行 > 调试。

    3. 或者，单击运行 或调试 。

编辑运行/调试配置

要编辑运行/调试配置，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 在左侧窗格中选择一个配置。
  3. 根据需要修改配置。

    4. 确保更正对话框底部显示的任何错误。

  4. 单击应用或确定。

编辑运行/调试配置模板

您可以编辑 Android Studio 提供的配置模板以适合您的开发流程。当您编辑模板时，它不会影响使用该模板的现有配置。因此，例如，如果您需要创建许多特定类型的配置，则可以编辑模板，然后在完成操作后将其改回。

虽然您无法创建新的模板，但您可以创建类似于模板的配置以供使用。您可以复制配置并编辑副本以创建新的配置。

要编辑模板，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 单击编辑配置模板...。
  3. 选择一个配置模板。
  4. 根据需要修改配置。

    5. 确保更正对话框底部显示的任何错误。

  5. 单击应用或确定。

排序和分组配置

在运行/调试配置对话框中，您可以对配置进行排序以快速找到它们。您可以按字母顺序对文件夹中的项目进行排序，并创建新的文件夹以对配置进行分组。

要按字母顺序对配置进行排序，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 选择包含配置的文件夹。
  3. 单击排序配置 。
  4. 单击确定关闭对话框。

要将配置分组到文件夹中，请执行以下步骤

  1. 打开运行/调试配置对话框.
  2. 选择包含配置的文件夹。
  3. 单击创建新文件夹 。
  4. 在文件夹名称字段中输入名称。
  5. 单击应用保存名称。
  • 将相同模板类别的项目拖动到文件夹中。
  • 通过将相同模板类别的文件夹和配置拖动到相应位置来对它们进行排序。
  • 单击确定关闭对话框。

    • 定义启动前操作

    您可以指定在应用运行/调试配置之前执行的任务。任务将按照它们在列表中出现的顺序执行。

    注意：定义启动前任务是一项高级功能。我们建议您不要使用此功能，而是将任何准备逻辑作为任务放在您的build.gradle文件中，以便在您从命令行构建时执行它们。

    要创建任务列表，请执行以下步骤

    1. 在运行/调试配置对话框底部启动前下方（您可能需要向下滚动），单击添加 并选择任务类型。如果出现对话框，请填写字段并单击确定。
    2. 根据需要添加更多任务。
    3. 要对任务进行排序，请拖动它们或选择一个任务，然后单击上移 和下移 以将其向上或向下移动到列表中。
    4. 如果您希望在应用运行/调试配置设置之前显示它们，请选择显示此页面。

      默认情况下，此选项未选中。

    5. 如果您希望在运行或调试应用程序时激活运行或调试工具窗口，请选择活动工具窗口。

      此选项默认选中。

    要从列表中删除任务，请按照以下步骤操作

    1. 选择一个任务。
    2. 点击移除 。

    要编辑任务，请按照以下步骤操作

    1. 选择一个任务。
    2. 点击编辑 。
    3. 在打开的对话框中编辑任务设置，然后点击确定。

    下表列出了您可以添加的可用任务。

    任务 描述
    运行外部工具 运行 Android Studio 外部的应用程序。在外部工具对话框中，选择要运行的一个或多个应用程序，然后点击确定。如果应用程序尚未在 Android Studio 中定义，请在创建工具对话框中添加其定义。有关更多信息，请参阅配置第三方工具和外部工具。
    运行其他配置 执行现有的运行/调试配置之一。在选择要执行的配置对话框中，选择要执行的配置，然后点击确定。
    构建 编译项目或模块。如果运行/调试配置指定了特定模块，则 Android Studio 会执行构建模块命令；如果未指定模块，则会执行构建项目命令。
    构建项目 编译项目。Android Studio 会执行构建项目命令。
    构建，不检查错误 此选项与构建相同，只是 Android Studio 无论编译结果如何都会执行运行/调试配置。
    构建工件 在 Android Studio 中不受支持。
    运行 Gradle 任务 运行 Gradle 任务。在打开的对话框中，指定详细信息，然后点击确定。有关更多信息，请参阅Gradle。
    Gradle 感知构建 编译项目并运行 Gradle。
    App Engine Gradle 构建器 App Engine Gradle 构建器任务会同步项目，然后构建模块。

    配置模板

    Android Studio 提供配置模板，帮助您快速入门。以下部分描述了适用于使用 Android Studio 进行 Android 开发的模板

    注意：Android Studio 2.1.x 及更低版本有一个原生应用程序模板，较新版本没有。如果项目中存在原生应用程序模板，则 Android Studio 在加载项目时将其转换为 Android 应用。转换项目对话框将指导您完成此过程。

    不受支持的模板

    以下不受支持的模板来自 IntelliJ IDEA，并非特定于使用 Android Studio 进行 Android 开发。有关使用这些模板的信息，请按照链接访问 IntelliJ IDEA 文档。

    常见配置选项

    名称、允许并行运行和存储为项目文件选项对于多个配置模板都是通用的。要了解有关它们的更多信息，请参阅常见设置。

    Android Studio 将共享运行/调试配置存储在 project_directory/.idea/runConfigurations/ 文件夹下的各个 XML 文件中。有关更多信息，请参阅 IntelliJ 项目文档中的基于目录的格式。

    Android 应用

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

    常规选项卡

    在常规选项卡中，您可以指定安装、启动和部署选项。其他选项卡也包含安装选项。

    字段 描述
    模块 选择要应用此配置的模块。
    安装选项：部署

    选择一个选项

    • 默认 APK - 为您的当前选定的变体构建和部署 APK。
    • 来自应用包的 APK - 从Android 应用包构建和部署您的应用。也就是说，Android Studio 首先将您的应用项目转换为包含所有应用已编译代码和资源的应用包。然后，Android Studio 从该应用包中仅生成将应用部署到连接设备所需的 APK。当您测试打算上传到 Google Play 的应用包时，通常应使用此选项，因为从应用包进行部署会延长总构建时间。
    • 自定义工件 - 在 Android Studio 中不受支持。
    • 无 - 不在设备上安装 APK。例如，如果您希望手动安装 APK，则不需要 Android Studio 来安装它。
    安装选项：作为即时应用部署 如果您的应用支持即时体验（即，您在创建新项目时添加了对即时应用的支持，或者创建了一个或多个启用即时的功能模块），则可以选择通过选中作为即时应用部署旁边的复选框来部署这些启用即时的模块。
    安装选项：要部署的功能 如果您的应用包含功能模块，请选中要部署应用时包含的每个功能旁边的复选框。仅当您的应用包含功能模块时，您才会看到此选项。

    注意：如果要测试按需下载和安装功能模块，则必须在发布应用包后执行此操作，然后使用 Play 管理中心内部测试轨道。要了解详情，请阅读将应用包上传到 Play 管理中心。
    安装选项：安装标志 键入要使用的任何 adb pm install 选项。以与在命令行中相同的方式格式化选项，但不带路径。以下是一些示例

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

    和

    -d -r

    默认：无选项。
    启动选项：启动

    选择一个选项

    • 无 - 选择运行或调试时不启动任何内容。但是，如果您的应用已在运行并且您选择了调试，则 Android Studio 会将调试器附加到您的应用进程。
    • 默认活动 - 启动您在清单中标记为启动的活动。例如
      <intent-filter>
  <action android:name="android.intent.action.MAIN" />
  <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
    • 指定活动 - 在模块中启动特定应用活动。选中后，下方会出现活动字段，您可以在其中键入要启动的活动的名称，或点击更多从列表中选择活动。
    • URL - 启动与应用清单中的意图过滤器匹配的 URL。选中后，下方会出现URL字段，您可以在其中输入 URL。

      您必须填写此字段才能启动Android 即时应用。您也可以使用此功能测试您的Android 应用链接。
    启动选项：启动标志 键入要使用的任何 adb am start 选项。以与在命令行中相同的方式格式化选项，但不带意图。例如

    -W

    如果您选择了启动值为无，则不会显示此选项。

    默认：无选项。
    部署目标选项：目标

    选择一个选项

    • 打开选择部署目标对话框 - 打开选择部署目标对话框以选择虚拟设备或硬件设备。
    • USB 设备 - 使用通过 USB 端口连接到开发计算机的硬件设备。如果有多个，则会出现一个对话框供您选择。
    • 模拟器 - 使用虚拟设备。在配置中，您可以选择 AVD；否则，它只使用列表中的第一个 AVD。

    部署目标选项：对未来启动使用同一设备

    		 默认情况下，此选项未选中，以便每次运行应用时，都会显示选择部署对话框供您选择设备。选中此选项后，然后运行应用时，将显示选择部署对话框供您选择设备。然后，每次运行应用时，它都会在您选择的设备上启动，而不会显示选择部署对话框。要在其他设备上运行应用，请取消选中对未来启动使用同一设备，或使用运行 > 停止app或停止 停止应用，然后再次启动它。将显示选择部署对话框，以便您可以选择设备。
    启动前 请参阅定义启动前操作。

    其他选项卡

    在其他选项卡中，您可以指定 logcat、安装、启动和部署选项。常规选项卡也包含安装选项。

    字段 描述
    Logcat：自动显示 Logcat 选中此选项后，每次使用此配置成功部署和启动应用时，都会打开Logcat窗口。默认：选中。
    Logcat：启动前清除日志 如果希望 Android Studio 在启动应用之前从日志文件中删除先前会话中的数据，请选择此选项。默认：未选中。
    安装选项：如果 APK 未更改，则跳过安装。 选中后，如果 Android Studio 检测到 APK 未更改，则不会重新部署 APK。如果希望 Android Studio 强制安装 APK，即使它没有更改，也要取消选中此选项。默认：选中
    安装选项：在启动活动之前强制停止正在运行的应用程序

    如果选中，当 Android Studio 检测到它不必重新安装 APK（因为它没有更改）时，它将强制停止应用，以便应用从默认启动器活动开始。如果取消选中此选项，Android Studio 不会强制停止应用。

    此选项与控制是否安装 APK 的上一个选项一起使用。对于这两个安装选项字段，请保留默认值，除非您明确希望每次都强制安装。

    在某些情况下，您可能希望取消选中此选项。例如，如果您正在编写输入法引擎 (IME)，则强制停止应用会将其取消选中为当前键盘，这可能是您不希望看到的。

    默认：选中
    启动前 请参阅定义启动前操作。

    调试器选项卡

    在调试器选项卡中指定调试选项。

    对于 C 和 C++ 代码，Android Studio 使用 LLDB 调试器。除了正常的 Android Studio UI 之外，调试器窗口还有一个LLDB 选项卡，允许您在调试期间输入 LLDB 命令。您可以输入与 Android Studio 用于在调试器 UI 中显示信息的命令相同的命令，还可以执行其他操作。

    对于 C 和 C++ 项目，您可以在调试器选项卡中添加符号目录，以及 LLDB 启动和附加后命令。为此，您使用类似于以下的按钮

    • 添加 - 添加目录或命令。
    • 移除 - 选择一个目录或命令，然后单击此按钮以移除该项。
    • 上移 - 选择一个目录或命令，然后单击此按钮以在列表中向上移动该项。
    • 下移 - 选择一个目录或命令，然后单击此按钮以在列表中向下移动该项。

    有关在 Android Studio 中进行调试的更多信息，请参阅 调试您的应用。

    字段 描述
    调试类型

    选择以下选项之一

    • 仅限 Java - 仅调试 Java 代码。
    • 自动检测 - 让 Android Studio 为您的项目选择最佳调试类型。
    • 仅限 Native - 调试原生 C 或 C++ 代码。
    • 双重 (Java + Native) - 在两个单独的调试会话中调试 Java 和原生代码。

    建议使用自动检测选项，因为它会为您的项目选择正确的调试类型。
    符号目录

    如果您想添加符号文件以向调试器提供在 Android Studio 外部生成的 C 或 C++ 信息，则可以在这里添加一个或多个目录。Android Studio 优先使用这些目录中的任何文件，而不是由 Android Gradle 插件 生成的文件。调试器按顺序从上到下搜索这些目录，直到找到它需要的内容。它会递归搜索目录中的文件。为了优化列表并节省时间，请将最常使用的目录放在列表的顶部。

    如果您在树中较高位置指定了一个目录，则搜索所有子目录可能需要更长时间。如果您添加了一个非常具体的目录，则搜索所需的时间更少。您需要在速度和查找调试所需的文件之间找到合适的平衡点。例如，如果您有一个包含不同 Android 二进制接口 (ABI) 的子目录的目录，则可以选择添加特定 ABI 或所有 ABI 的目录。虽然搜索上层目录可能需要更长时间，但如果您决定在不同的设备上进行调试，则这种方法也更可靠。

    请注意，您无需添加包含 Gradle 符号文件的目录，因为调试器会自动使用它们。
    LLDB 启动命令

    添加您希望在调试器附加到进程之前执行的 LLDB 命令。例如，您可以定义环境设置，如下面的命令所示

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

    LLDB 按顺序从上到下执行这些命令。
    LLDB 附加后命令

    添加您希望在调试器附加到进程后立即执行的 LLDB 命令。例如

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

    LLDB 按顺序从上到下执行这些命令。
    主机工作目录 指定 LLDB 工作目录。
    日志记录：目标通道

    指定 LLDB 日志选项。Android Studio 根据团队的经验设置默认选项，因此它不会太慢，但包含解决问题所需的信息。日志通常用于 Android Studio 错误报告。此默认值为

    lldb process:gdb-remote packets

    您可以更改默认值以收集更多信息。例如，以下日志选项收集有关特定 platform 的信息

    lldb process platform:gdb-remote packets

    有关日志命令的完整列表，请在 Android Studio 中的 LLDB shell 窗口中输入 log list 命令。

    Android Studio 将设备日志放置在以下位置，其中 ApplicationId 是您构建的 APK 清单中使用的唯一应用程序 ID，并在您的设备和 Google Play 商店中标识您的应用

    /data/data/ApplicationId/lldb/log

    或者，如果多个用户访问设备，则将其放置在以下位置，其中 AndroidUserId 是设备上用户的唯一标识符

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

    有关使用 LLDB 进行远程调试的信息，请参阅 远程调试。
    启动前 请参阅定义启动前操作。

    性能分析选项卡

    当您的设备运行 Android 7.1 或更低版本时，必须选中启用高级性能分析选项才能在 Android Profiler 中启用某些功能。

    Android 测试

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

    注意：如果您使用 Firebase Test Lab 在各种设备上进行测试，则可以使用 Android JUnit 模板定义您的 Instrumentation 测试。有关更多信息，请参阅 使用 Firebase Test Lab 运行您的测试。

    以下选项卡说明涵盖了 Android Instrumentation 测试模板的选项卡和字段。有关 Android JUnit 测试模板的选项卡和字段的信息，请参阅 IntelliJ 的 运行/调试配置：JUnit 页面。

    常规选项卡

    在常规选项卡中，您可以指定测试位置、Instrumentation 测试运行器、adb shell 和部署选项。

    字段 描述
    模块 选择要应用此配置的模块。
    测试

    在此区域中，指定要运行的测试的位置

    • 模块中的所有测试 - 启动选定模块中的所有测试。
    • 包中的所有测试 - 启动包字段中指定的包中的所有测试。键入名称，或单击更多以从对话框中选择包。
    • 类 - 启动类字段中指定的类的测试。键入名称，或单击更多以从对话框中选择类。
    • 方法 - 启动测试方法。在类字段中，指定包含该方法的类。在方法字段中，指定该方法。键入名称，或单击更多以从对话框中选择类或方法。
    特定 Instrumentation 测试运行器（可选） 键入 Instrumentation 测试运行器 的位置；单击更多以使用对话框。build.gradle 文件指定 Instrumentation 测试运行器的位置；此值会覆盖它。默认值通常是来自 AndroidX Test 的 AndroidJUnitRunner 类。
    额外选项

    键入您要使用的任何 adb am instrument 选项。不要键入组件。例如，如果您使用的是来自 AndroidX Test 的 AndroidJUnitRunner，则可以使用此字段将其他选项传递给运行器，例如 -e size small。

    默认值：无选项
    部署目标选项：目标

    选择一个选项

    • 打开选择部署目标对话框 - 打开选择部署目标对话框以选择虚拟设备或硬件设备。
    • USB 设备 - 使用通过 USB 端口连接到开发计算机的硬件设备。如果有多个，则会出现一个对话框供您选择。
    • 模拟器 - 使用虚拟设备。在配置中，您可以选择 AVD；否则，它只使用列表中的第一个 AVD。
    • Firebase Test Lab 设备矩阵 - 请参阅 使用 Firebase Test Lab 运行您的测试。
    部署目标选项：对未来启动使用同一设备 如果您希望将来自动使用您通过选择部署目标对话框选择的设备，请选择此选项。如果该设备不可用，您将收到一个对话框。默认值：未选中
    启动前 请参阅定义启动前操作。

    其他选项卡

    杂项选项卡包含 logcat 和安装选项。

    字段 描述
    Logcat：启动前清除日志 如果希望 Android Studio 在启动应用之前从日志文件中删除先前会话中的数据，请选择此选项。默认：未选中。
    安装选项：如果 APK 未更改，则跳过安装 选中后，如果 Android Studio 检测到 APK 未更改，则不会重新部署 APK。如果希望 Android Studio 强制安装 APK，即使它没有更改，也要取消选中此选项。默认：选中
    安装选项：在启动活动之前强制停止正在运行的应用程序

    如果选中，当 Android Studio 检测到它不必重新安装 APK（因为它没有更改）时，它将强制停止应用，以便应用从默认启动器活动开始。如果取消选中此选项，Android Studio 不会强制停止应用。

    此选项与控制是否安装 APK 的先前选项结合使用。对于这两个安装选项字段，请保留默认值，除非您明确希望每次都强制安装。

    在某些情况下，您可能希望取消选中此选项。例如，如果您正在编写输入法引擎 (IME)，则强制停止应用会将其取消选中为当前键盘，这可能是您不希望看到的。

    默认：选中
    启动前 请参阅定义启动前操作。

    调试器选项卡

    在调试器选项卡中指定调试选项。

    对于 C 和 C++ 代码，Android Studio 使用 LLDB 调试器。除了正常的 Android Studio UI 之外，调试器窗口还有一个LLDB 选项卡，允许您在调试期间输入 LLDB 命令。您可以输入与 Android Studio 用于在调试器 UI 中显示信息的命令相同的命令，还可以执行其他操作。

    对于 C 和 C++ 项目，您可以在调试器选项卡中添加符号目录，以及 LLDB 启动和附加后命令。为此，您使用类似于以下的按钮

    • 添加 - 添加目录或命令。
    • 移除 - 选择一个目录或命令，然后单击此按钮以移除该项。
    • 上移 - 选择一个目录或命令，然后单击此按钮以在列表中向上移动该项。
    • 下移 - 选择一个目录或命令，然后单击此按钮以在列表中向下移动该项。

    有关在 Android Studio 中进行调试的更多信息，请参阅 调试您的应用。

    字段 描述
    调试类型

    选择以下选项之一

    • 仅限 Java - 仅调试 Java 代码。
    • 自动检测 - 让 Android Studio 为您的项目选择最佳调试类型。
    • 仅限 Native - 调试原生 C 或 C++ 代码。
    • 双重 (Java + Native) - 在两个单独的调试会话中调试 Java 和原生代码。

    建议使用自动检测选项，因为它会为您的项目选择正确的调试类型。
    符号目录

    如果您想添加符号文件以向调试器提供在 Android Studio 外部生成的 C 或 C++ 信息，则可以在这里添加一个或多个目录。Android Studio 优先使用这些目录中的任何文件，而不是由 Android Gradle 插件 生成的文件。调试器按顺序从上到下搜索这些目录，直到找到它需要的内容。它会递归搜索目录中的文件。为了优化列表并节省时间，请将最常使用的目录放在列表的顶部。

    如果您在树中较高位置指定了一个目录，则搜索所有子目录可能需要更长时间。如果您添加了一个非常具体的目录，则搜索所需的时间更少。您需要在速度和查找调试所需的文件之间找到合适的平衡点。例如，如果您有一个包含不同 Android 二进制接口 (ABI) 的子目录的目录，则可以选择添加特定 ABI 或所有 ABI 的目录。虽然搜索上层目录可能需要更长时间，但如果您决定在不同的设备上进行调试，则这种方法也更可靠。

    请注意，您无需添加包含 Gradle 符号文件的目录，因为调试器会自动使用它们。
    LLDB 启动命令

    添加您希望在调试器附加到进程之前执行的 LLDB 命令。例如，您可以定义环境设置，如下面的命令所示

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

    LLDB 按顺序从上到下执行这些命令。
    LLDB 附加后命令

    添加您希望在调试器附加到进程后立即执行的 LLDB 命令。例如

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

    LLDB 按顺序从上到下执行这些命令。
    主机工作目录 指定 LLDB 工作目录。
    日志记录：目标通道

    指定 LLDB 日志选项。Android Studio 根据团队的经验设置默认选项，因此它不会太慢，但包含解决问题所需的信息。日志通常用于 Android Studio 错误报告。此默认值为

    lldb process:gdb-remote packets

    您可以更改默认值以收集更多信息。例如，以下日志选项收集有关特定 platform 的信息

    lldb process platform:gdb-remote packets

    有关日志命令的完整列表，请在 Android Studio 中的 LLDB shell 窗口中输入 log list 命令。

    Android Studio 将设备日志放置在以下位置，其中 ApplicationId 是您构建的 APK 清单中使用的唯一应用程序 ID，并在您的设备和 Google Play 商店中标识您的应用

    /data/data/ApplicationId/lldb/log

    或者，如果多个用户访问设备，则将其放置在以下位置，其中 AndroidUserId 是设备上用户的唯一标识符

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

    有关使用 LLDB 进行远程调试的信息，请参阅 远程调试。
    启动前 请参阅定义启动前操作。

    App Engine DevAppServer

    此运行/调试配置适用于 Google Cloud Platform。有关更多信息，请参阅 运行、测试和部署后端。当您按照这些步骤操作并将项目同步到 build.gradle 文件时，Android Studio 会为您创建一个 App Engine DevAppServer 配置。

    请注意，IntellJ IDEA 的 App Engine Server 模板是一个不同的模板，在 Android Studio 中不可用。

    字段 描述
    仅限单实例 如果您希望确保当前仅执行运行/调试配置的一个实例，请选择此选项。它不允许同时运行多个相同配置。默认值：选中
    模块 选择要应用此配置的模块。
    与 build.gradle 配置同步 如果您添加了 App Engine 模块并与 build.gradle 文件同步，则 App Engine DevAppServer 配置字段将为您填写（推荐）。选择文件 > 使用 Gradle 文件同步项目也会同步项目。默认值：选中
    App Engine SDK 键入本地计算机上 Google App Engine SDK for Java 的路径。单击...以从对话框中选择它。
    War 路径 键入您在本地开发服务器上部署的应用的 Web 应用归档 (WAR) 目录的路径。单击...以从对话框中选择它。
    VM 参数

    指定您要传递给 VM 以启动 DevAppServer 的命令行选项。指定选项时

    • 使用空格分隔不同的选项。
    • 对于包含空格的选项，请将空格括在引号 (" ") 中。
    • 如果选项包含引号，请在引号前添加反斜杠 (\")。

    有关 VM 选项的更多信息，请参阅您 J2SE 版本的文档，例如 java JDK 7 和 java JDK 8。

    默认值：无选项
    服务器地址 键入要用于服务器的主机 地址。您可能需要提供地址才能从网络上的另一台计算机访问开发服务器。地址 0.0.0.0 允许 localhost 访问和主机名访问。默认值：localhost
    服务器端口 键入要用于服务器的 端口 号。默认值：8080
    禁用检查 App Engine SDK 更新 如果给出，则开发服务器将 不会联系 App Engine 以检查 SDK 新版本的可用性。默认情况下，服务器会在启动时检查新版本，如果发现新版本，则会打印一条消息。
    启动前 请参阅定义启动前操作。

    Wear OS 运行/调试配置

    Wear OS 复杂功能、磁贴和表盘模板允许您在虚拟或硬件设备上运行或调试 Wear OS 应用。大多数模板配置选项与 Android 应用选项 相同。以下是更特定于 Wear OS 运行/调试配置的选项

    • 对于所有 Wear 运行/调试配置，您必须选择一个特定的复杂功能数据源、磁贴或表盘（取决于模板）来应用配置。通常，这些实体中的每一个都对应于您代码中的一个类。
    • 对于 Wear OS 复杂功能运行/调试配置，您必须选择要放置复杂功能数据源提供的复杂功能数据的插槽。您可以选择将其放置在表盘的顶部、右侧、底部、左侧或背景。
    • 对于 Wear OS 复杂功能运行/调试配置，您还必须选择复杂功能数据源提供的复杂功能数据的类型。您可以选择的类型仅限于所选复杂功能数据源提供且所选插槽支持的类型。有关复杂功能数据类型的列表，请参阅类型和字段。

    或者，您也可以从位于表面声明旁边的边距图标运行这些表面，如下面的图像所示。

    Run button in the gutter next to a WatchFaceService class.
    图 1. 使用边距图标直接运行 Wear OS 表面。