构建和运行您的应用

查看应用在设备上的外观和行为，则需要构建并运行该应用。Android Studio 会设置新的项目，这样您只需点击几下，就能将应用部署到虚拟设备或实体设备。

本概览重点介绍如何使用 Android Studio 构建和运行应用，以便进行测试和调试。如需了解如何使用 Android Studio 构建可向用户发布的应用，请参阅构建应用以向用户发布。如需详细了解如何管理和自定义 build（无论是否使用 Android Studio），请参阅配置 build。

基本构建和运行

如需构建和运行应用，请按以下步骤操作：

1. 在工具栏中，从运行配置菜单中选择您的应用。

2. 从目标设备菜单中，选择要用来运行应用的设备。

   

   如果您未配置任何设备，则需要创建 Android 虚拟设备以便使用 Android 模拟器，或连接实体设备。

3. 点击 Run 按钮 。

如果尝试将项目启动到存在相关错误或警告的设备，Android Studio 会发出警告。图标和样式的变更分成了错误（导致配置失败的设备选择）和警告（可能导致意外行为但仍可运行的设备选择）。

监控构建流程

如需查看有关构建流程的详细信息，请依次选择 View > Tool Windows > Build，或点击工具窗口栏中的 Build 图标 。Build 工具窗口会显示 Gradle 为构建应用而执行的任务，如图 1 所示。

图 1. Android Studio 中的 Build 工具窗口。

1. “Sync”标签页：显示 Gradle 为与项目文件同步而执行的任务。与 Build 标签页类似，如果您遇到同步错误，可以在树中选择元素来获取有关错误的更多信息。
2. “Build Output”标签页：以树状显示 Gradle 执行的任务，其中每个节点表示一个构建阶段或一组任务依赖项。如果您收到构建时错误或编译时错误，可以检查该树并选择一个元素来查看错误输出，如图 2 所示。

   

   图 2. 在 Build Output 标签页中检查错误消息。

3. “Build Analyzer”标签页：提供有关 build 的构建性能分析信息。如需了解详情，请参阅使用 Build Analyzer 排查构建性能问题。
4. Restart：通过为项目中的所有模块生成中间构建文件，执行与依次选择 Build > Make Project 相同的操作。
5. Filters：过滤掉已成功完成的警告和/或任务。这样可以更轻松地在输出结果中找出相应问题。

如果您的 build 变体使用产品变种，Gradle 也会调用任务来构建这些产品变种。如需查看所有可用构建任务的列表，请依次点击 View > Tool Windows > Gradle，或点击工具窗口栏中的 Gradle 图标 。

如果在构建流程中出现错误，Gradle 可能会向您推荐一些命令行选项来帮助您解决问题，如 --stacktrace 或 --debug。如需在构建流程中使用命令行选项，请执行以下操作：

1. 打开 Settings 或 Preferences 对话框：
   • 在 Windows 或 Linux 上，从菜单栏中依次选择 File > Settings。
   • 在 macOS 上，从菜单栏中依次选择 Android Studio > Preferences。
2. 依次转到 Build, Execution, Deployment > Compiler。
3. 在“Command-line Options”旁边的文本字段中，输入您的命令行选项。
4. 点击 OK 保存，然后退出。

当您下次尝试构建应用时，Gradle 会应用这些命令行选项。

高级构建和运行功能

在 Android Studio 中构建和运行应用的默认方式应该足以测试简单的应用。不过，您可以将这些构建和运行功能用于更高级的用例：

• 如需在调试模式下部署应用，请点击 Debug 图标 。 在调试模式下运行应用，您就可以在代码中设置断点、在运行时检查变量和对表达式求值，以及运行调试工具。如需了解详情，请参阅调试您的应用。

• 如果您的应用较大且较复杂，请使用 Apply Changes，而不是点击 Run 图标 。这样可以节省时间，因为这能避免在每次部署更改时重启应用。如需详细了解 Apply Changes，请参阅 使用 Apply Changes 进行增量部署 部分。

• 如果您使用的是 Jetpack Compose，实时编辑是一项实验性功能，可让您实时更新可组合项，而无需重复点击 Run 图标 。这样一来，您就可以集中精力编写界面代码，最大限度地减少中断。如需了解详情，请参阅实时编辑（实验性）部分。

• 如果您的应用有多个 build 变体或版本，您可以使用 Build Variants 工具窗口选择要部署的 build 变体。如需详细了解如何运行特定 build 变体，请参阅更改 build 变体部分。

• 如需调整应用安装、启动和测试选项，您可以更改运行/调试配置。如需详细了解如何创建自定义运行/调试配置，请参阅创建运行/调试配置部分。

• 我们建议您使用 Android Studio 来满足开发需求，但您也可以通过命令行将应用部署到虚拟设备或实体设备。如需了解详情，请参阅从命令行构建您的应用。

使用 Apply Changes 进行增量部署

在 Android Studio 3.5 及更高版本中，Apply Changes 可让您将代码和资源更改推送给正在运行的应用，而无需重启应用（在某些情况下，甚至无需重启当前的 activity）。当您要部署和测试小范围的增量更改，同时保持设备的当前状态时，这种灵活性可帮助您控制应用的重启范围。

Apply Changes 使用搭载 Android 8.0（API 级别 26）或更高版本的设备上支持的 Android JVMTI 实现中的功能。如需详细了解 Apply Changes 的工作原理，请参阅 Android Studio Project Marble：Apply Changes。

要求

Apply Changes 操作仅在满足以下条件时可用：

• 您使用调试 build 变体来构建应用的 APK。
• 您将应用部署到搭载 Android 8.0（API 级别 26）或更高版本的目标设备或模拟器上。

使用 Apply Changes

如果要将更改部署到兼容设备，请使用以下选项：

Apply Changes and Restart Activity 尝试通过重启 activity 但不重启应用来应用资源和代码更改。通常，如果您修改了方法正文中的代码或修改了现有资源，则可以使用此选项。

您还可以按 Ctrl + Alt + F10（在 macOS 上，按 Ctrl + Command + Shift + R）。

Apply Code Changes 尝试仅应用代码更改而不重启任何内容。通常，如果您修改了方法正文中的代码，但没有修改任何资源，则可以使用此选项。如果您既修改了代码，又修改了资源，则应改用 Apply Changes and Restart Activity。

您还可以按 Ctrl + F10（在 macOS 上，按 Ctrl + Command + R）。

Run ：部署所有更改并重启应用。如果使用哪个 Apply Changes 选项都无法应用您所做的更改，请使用此选项。如需详细了解需要重启应用的更改类型，请参阅 Apply Changes 的限制部分。

为 Apply Changes 启用运行回退机制

在您点击 Apply Changes and Restart Activity 或 Apply Code Changes 后，Android Studio 会构建新 APK 并确定是否可以应用更改。如果无法应用更改并且会导致 Apply Changes 失败，则 Android Studio 会改为提示您重新运行您的应用（通过点击 Run 图标 ）。

如果您不想在每次发生这种情况时都收到提示，则可以将 Android Studio 配置为在无法应用更改时自动重新运行您的应用。如需启用此行为，请按以下步骤操作：

1. 打开 Settings 或 Preferences 对话框：

   • 在 Windows 或 Linux 上，从菜单中依次选择 File > Settings。
   • 在 macOS 上，从菜单中依次选择 Android Studio > Preferences。

2. 依次转到 Build, Execution, Deployment > Deployment。

3. 选中复选框以针对任一 Apply Changes 操作启用自动运行回退机制。

4. 点击 OK。

注意：某些类型的更改不会导致 Apply Changes 失败，但仍然要求您手动重启应用，然后才能看到这些更改。例如，如果您更改了某个 activity 的 onCreate() 方法，则只有在该 activity 重新启动后，这些更改才会生效，因此您必须重启应用才能看到这些更改。

依赖于平台的更改

Apply Changes 的某些功能依赖于 Android 平台的特定版本。如要应用这些类型的更改，您的应用必须部署到搭载相应 Android 版本（或更高版本）的设备上。例如，添加方法需要 Android 11 或更高版本。

Apply Changes 的限制

Apply Changes 旨在加快应用部署流程。不过，它的使用时机存在一些限制。

需要重启应用才能实现的代码更改

某些代码和资源更改必须在重启应用之后才能应用，其中包括以下更改：

• 添加或移除字段
• 移除方法
• 更改方法签名
• 更改方法或类的修饰符
• 更改类继承行为
• 更改枚举中的值
• 添加或移除资源
• 更改应用清单
• 更改原生库（SO 文件）

库和插件

某些库和插件会自动更改应用的清单文件或清单中引用的资源。这些自动更新可能会通过以下方式干扰 Apply Changes：

• 如果库或插件更改应用的清单，您不能使用 Apply Changes。您必须重启应用才能看到更改。
• 如果库或插件更改应用的资源文件，您不能使用 Apply Code Changes 图标 。您必须使用 Apply Changes and Restart Activity 图标 （或重启应用）才能看到更改。

为避免这些限制，请为调试 build 变体停用所有自动更新。

例如，Firebase Crashlytics在每次构建过程中使用唯一的 build ID 更新应用资源，这会阻止您使用 Apply Code Changes 图标 ，并且您需要重启应用的 activity 才能看到相应更改。停用此行为以便能将 Apply Code Changes 与 Crashlytics 一起用于调试 build。

直接引用已安装 APK 中的内容的代码

如果您的代码直接引用已在设备上安装的应用 APK 中的内容，在您点击 Apply Code Changes 图标 后，该代码可能会导致崩溃或出现异常。 发生此行为的原因是，当您点击 Apply Code Changes 时，设备上的底层 APK 会在安装过程中被替换。在这些情况下，您可以改为点击 Apply Changes and Restart Activity 图标 或 Run 图标 。

如果您在使用 Apply Changes 时遇到任何其他问题，请提交 bug。

实时编辑（实验性）

重要提示：这是一项尚处于积极开发阶段的实验性功能，因此您可能会遇到一些不稳定的行为。建议您使用 Jetpack Compose 1.3.0 或更高版本，以获得最佳体验。Google 一直在努力改进此功能，欢迎您提供反馈。如果您发现问题，请向我们报告。报告时，请提供来自 Logcat 的信息和关于您所做代码更改的说明。

实时编辑是 Android Studio Flamingo Canary 版本中的一项实验性功能，可让您实时更新模拟器和实体设备中的可组合项。此功能可最大限度地减少编写应用与构建应用之间的上下文切换，从而减少中断，让您有更多时间专注于代码编写。

实时编辑有两种模式：

• 手动：所做的代码更改会在您使用 Ctrl + S（在 macOS 上，则使用 Command+S）手动保存时应用。
• 自动：当您更新可组合函数时，所做的更改会应用到设备或模拟器中。

实时编辑侧重于界面和用户体验方面的代码更改，而不支持进行方法签名更新、新方法添加或类层次结构变更等方面的更改。如需了解详情，请参阅实时编辑的限制列表。

此功能不能代替构建和运行应用或 Apply Changes，而旨在优化 Compose 界面开发过程中的构建、部署和迭代工作流程。

最佳实践工作流程如下：

1. 设置应用，使其能够运行。
2. 尽可能多地进行实时编辑，直到您需要进行实时编辑功能不支持的更改，例如，在应用运行时添加新方法。
3. 进行不受支持的更改后，点击 Run 图标 以重启应用并恢复实时编辑。

图 3. 在自动模式下，每次进行实时编辑功能支持的修改时，设备或模拟器上正在运行的应用都会实时更新。

开始使用实时编辑功能

如需开始使用，请按照以下步骤创建空的 Compose activity，为项目启用实时编辑功能，并使用该功能来进行更改。

设置新项目

1. 在开始之前，请确保您已安装最新的 Canary 版 Android Studio Flamingo，并且实体设备或模拟器的 API 级别不低于 30。

2. 打开 Android Studio，然后在 Welcome to Android Studio 对话框中选择 New Project。如果已经打开了项目，则可以依次转到 File > New > New Project 来创建一个新项目。

3. 对于 Phone and Tablet，选择 Empty Compose Activity 模板，然后点击 Next。

   图 4. 可供选择的模板。为实时编辑选择 Empty Compose Activity。

4. 使用所需信息填写 New Project 对话框，其中包含名称、软件包名称、保存位置、语言（设置为 Kotlin）和最低 SDK 要求。

   图 5. 项目设置示例。

5. 点击 Finish。

启用实时编辑功能

1. 前往设置以启用实时编辑功能。

   • 在 Windows 或 Linux 上，依次前往 File > Settings > Editor > Live Edit。
   • 在 macOS 上，依次前往 Android Studio > Preferences > Editor > Live Edit。

2. 从设置中选择 Live Edit 选项和要运行的模式。

   在手动模式下，所做的代码更改会在您每次使用 Ctrl + S（在 macOS 上，则使用 Command+S）手动保存时应用。在自动模式下，所做的代码更改会即时应用到设备或模拟器中。

   图 6. 实时编辑设置。

3. 在编辑器中，打开 MainActivity 文件，这是应用的入口点。

4. 点击 Run 图标 以部署应用，然后点击编辑器右上角的 Split 以打开预览。

5. 启用实时编辑功能后，编辑器的右上角会显示实时编辑绿色对勾标记。

   

进行更改并查看更改效果

当您在编辑器中做出支持的更改时，预览会自动更新。

例如，将 MainActivity 中的现有 Greeting 方法修改为以下代码：

@Composable
fun Greeting(name: String) {
    Text(text = "Hello $name!",
        Modifier.padding(80.dp) // Outer padding; outside background
            .background(color = Color.Cyan) // Solid element background color
            .padding(16.dp) // Inner padding; inside background, around text)
    )
}

您所做的更改会立即在预览中显示，如图 7 所示。

图 7. 显示对 Greeting 方法进行实时编辑更改的预览。

排查实时编辑问题

如果在预览窗格中没有看到修改效果，则说明 Android Studio 可能未能更新您的修改。请查看实时编辑界面指示器是否显示已暂停的图标（如图 8 所示），这表示发生了编译错误。如需了解有关错误的信息以及有关如何解决该错误的建议，请点击错误指示器。

图 8. 实时编辑状态指示器。

实时编辑功能的限制

注意：实时编辑是 Android Studio Flamingo Canary build 中的一项实验性功能，这意味着存在一些已知的问题和限制。在 Google 改进此功能期间，请发送您的反馈。您也可以点击此处查看待解决问题的列表。

以下是现有限制的列表。

• 使用 Compose 1.2.0 或更低版本时，实时编辑功能可能不支持错误处理和报告。建议您使用 Compose 1.3.0 或更高版本，以获得最佳体验。
• 实时编辑功能要求实体设备或模拟器搭载 API 级别为 30 或更高级别的操作系统。
• 实时编辑功能仅支持修改函数正文，也就是说，您无法进行下列操作：更改函数名称或签名、添加或移除函数、更改非函数字段。
• 使用实时编辑功能修改过的类可能会导致性能下降。如果要评估应用的性能，请使用干净的发布 build 运行应用。
• 您必须执行完整的运行，以便调试程序在使用实时编辑修改过的类上运行。
• 使用实时编辑修改正在运行的应用，可能会导致应用崩溃。如果发生这种情况，可以使用 Run 按钮 重新部署应用。
• 实时编辑不会执行项目 build 文件中定义的任何字节码处理，例如，使用 Build 菜单中的选项或通过点击 Build 或 Run 按钮构建项目时要应用的字节码处理。
• 非可组合函数会在设备或模拟器上实时更新，并且会触发完全重组。完全重组可能不会调用更新后的函数。对于非可组合函数，您必须触发新更新的函数或再次运行应用。
• 应用重启后，实时编辑不会自动恢复。您必须再次运行应用。
• 如果您的项目使用的是 Compose 1.2 或更高版本，则只有对给定文件进行的第一项代码更改才会重置组合。对该文件所做的后续修改不会重置组合。

关于实时编辑功能的常见问题解答

• 实时编辑功能目前处于什么状态？
  • 实时编辑是 Android Studio Flamingo Canary 版渠道中提供的一项实验性功能。如需开启或关闭此功能，请依次前往 File > Settings > Editor > Live Edit（在 macOS 上，则依次前往 Android Studio > Preferences > Editor > Live Edit）。
• 何时应使用实时编辑功能？
  • 如果您想快速查看用户体验元素更新（例如，修饰符更新、动画更新）对整体应用体验的影响，就可以使用实时编辑功能。
• 何时应避免使用实时编辑功能？
  • 实时编辑功能目前侧重于界面和用户体验方面的代码更改，而不支持进行方法签名更新、新方法添加或类层次结构变更等方面的更改。如需了解详情，请参阅实时编辑功能的限制。
• 何时应使用 Compose 预览？
  • 开发单个可组合项时，请使用 Compose 预览。预览会直观呈现 Compose 元素，还会自动刷新来显示代码更改的效果。预览还支持在不同的配置和状态（例如深色模式、语言区域、字体大小）下查看界面元素。

更改 build 变体

默认情况下，在您点击 Run 图标 后，Android Studio 会构建应用的调试版本，不过这仅供在开发期间使用。

如需更改 Android Studio 使用的 build 变体，请执行以下操作之一：

• 在菜单中依次选择 Build > Select Build Variant。
• 在菜单中依次选择 View > Tool Windows > Build Variants。
• 点击工具窗口栏上的 Build Variants 标签页。

对于不含原生/C++ 代码的项目，Build Variants 面板有两列：Module 和 Active Build Variant。模块的 Active Build Variant 值决定了 IDE 部署到连接的设备并显示在编辑器中的 build 变体。

图 9. 对于不含原生/C++ 代码的项目，Build Variants 面板有两列。

如需在变体之间切换，请点击模块的 Active Build Variant 单元格，然后从列表中选择所需的变体。

对于含有原生/C++ 代码的项目，Build Variants 面板包含三列：

• Module
• Active Build Variant
• Active ABI

模块的 Active Build Variant 值决定了 IDE 部署到设备并显示在编辑器中的 build 变体。对于原生模块，Active ABI 值决定了编辑器使用的 ABI，但不会影响部署的内容。

图 10. 对于含有原生/C++ 代码的项目，Build Variants 面板增加了 Active ABI 列

如要更改 build 变体或 ABI，请点击 Active Build Variant 或 Active ABI 列的单元格，然后从列表中选择所需的变体或 ABI。您更改选择后，IDE 会自动同步您的项目。更改应用或库模块的任一列都会将更改应用于所有相关行。

默认情况下，新项目设有两个 build 变体：调试变体和发布变体。您需要构建发布变体来为应用的公开发布做好准备。如需定义具有不同功能或设备要求的应用变体，您可以定义其他 build 变体。

Android Studio 的“Build Variants”对话框中的冲突

在 Android Studio 的 Build Variants 对话框中，您可能会看到一些错误消息，指出 build 变体之间存在冲突，示例如下：

此错误并不表示 Gradle 存在构建问题。这表示 Android Studio IDE 无法解析所选模块的变体之间的符号。

例如，如果您的模块 M1 依赖于模块 M2 的变体 v1，但在 IDE 中选定了 M2 的变体 v2，那么 IDE 中就会有未解析的符号。假设 M1 依赖于仅在 v1 中提供的类；当 v2 被选定时，该类无法被 IDE 识别，这就会导致 IDE 无法解析该类名称并在 M1 模块的代码中显示错误。

显示这些错误消息的原因在于 IDE 无法同时加载多个变体的代码。不过，在应用的 build 方面，此对话框中选定的变体不会产生任何影响；因为在构建您的应用时，Gradle 使用的是您的 Gradle 构建方案中指定的源代码，而不是基于 IDE 中当前已加载的代码。

更改运行/调试配置

当您首次运行应用时，Android Studio 会使用默认运行配置。运行配置用于指定要通过 APK 还是 Android App Bundle 部署您的应用、要运行的模块、要部署的软件包、要启动的 activity、目标设备、模拟器设置、Logcat 选项，等等。

默认运行/调试配置会构建 APK，启动默认项目 activity，并使用 Select Deployment Target 对话框选择目标设备。如果默认设置不适合您的项目或模块，您可以自定义运行/调试配置，也可以在项目、默认和模块级别创建新配置。

如要修改运行/调试配置，请依次选择 Run > Edit Configurations。如需了解详情，请参阅创建和修改运行/调试配置。