迭代代码开发

作为移动开发者，您通常需要逐步开发应用界面，而不是一次性开发所有内容。Android Studio 通过提供不需要完整 build 即可检查、修改值和验证最终结果的工具，支持使用 Jetpack Compose 进行逐步开发。

实时编辑

重要提示： 此功能仍处于开发阶段，因此您可能会遇到一些不稳定的行为。在 Android Studio Giraffe 及更高版本中，它需要 Jetpack Compose 运行时 1.3.0 或更高版本以及 AGP 8.1.0-alpha05 或更高版本。Google 一直在努力改进此功能，欢迎您提供反馈。 如果您发现问题，请向我们报告。报告时，请提供来自 Logcat 的信息和关于您所做代码更改的说明。您还可以查看待解决问题的列表。

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

重要提示： 在 Koala 功能分发中，手动模式快捷键已更新为 Control+'（在 macOS 上为 Command+'）。 以前的 Android Studio 版本使用 Control+\（在 macOS 上为 Command+\）作为手动模式快捷键。

实时编辑有三种模式：

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

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

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

最佳实践工作流程如下：

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

开始使用实时编辑功能

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

设置新项目

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

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

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

   

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

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

   

   图 2. 项目设置示例。

5. 点击 Finish。

启用实时编辑功能

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

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

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

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

   

   图 3. “实时编辑”设置。

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

4. 点击 Run 图标 以部署应用。

5. 开启实时编辑功能后，Running Devices 工具窗口的右上角会显示 Up-to-date 绿色对勾标记：

   

进行更改并查看更改效果

当您在编辑器中做出支持的更改时，虚拟或实体测试设备会自动更新。

例如，将 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)
    )
}
IterativeDevelopmentSnippets.kt

您所做的更改会立即显示在测试设备上，如图 4 所示。

图 4. 一台测试设备，其中显示了对 Greeting 方法的实时编辑更改。

排查实时编辑问题

如果在测试设备上没有看到修改效果，则说明 Android Studio 可能未能更新您的修改。请检查实时编辑指示器是否显示 Out Of Date（如图 5 所示），这表示发生了编译错误。如需了解有关错误的信息以及有关如何解决该错误的建议，请点击指示器。

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

实时编辑功能的限制

以下是现有限制的列表。

• [仅适用于 Android Studio Giraffe 及更高版本] 实时编辑需要 Compose 运行时 1.3.0 或更高版本。如果您的项目使用较低版本的 Compose，系统会停用实时编辑功能。

• [仅适用于 Android Studio Giraffe 及更高版本] 实时编辑功能需要 AGP 8.1.0-alpha05 或更高版本。如果您的项目使用较低版本的 AGP，系统会停用实时编辑功能。

• 实时编辑功能要求实体设备或模拟器搭载 API 级别为 30 或更高级别的操作系统。

• 实时编辑功能仅支持修改函数正文，也就是说，您无法进行下列操作：更改函数名称或签名、添加或移除函数、更改非函数字段。

• 当您首次更改文件中的 Compose 函数时，实时编辑功能会重置应用的状态。只有在第一次更改代码后才会发生这种情况，您对该文件中的 Compose 函数进行的后续代码更改不会重置应用状态。

• 使用实时编辑功能修改过的类可能会导致性能下降。如果要评估应用的性能，请使用干净的发布 build 运行应用。

• 您必须执行完整的运行，以便调试程序在使用实时编辑修改过的类上运行。

• 使用实时编辑修改正在运行的应用，可能会导致应用崩溃。如果发生这种情况，可以使用 Run 按钮 重新部署应用。

• 实时编辑不会执行项目 build 文件中定义的任何字节码处理，例如，使用 Build 菜单中的选项或通过点击 Build 或 Run 按钮构建项目时要应用的字节码处理。

• 非可组合函数会在设备或模拟器上实时更新，并且会触发完全重组。完全重组可能不会调用更新后的函数。对于非可组合函数，您必须触发新更新的函数或再次运行应用。

• 应用重启后，实时编辑不会自动恢复。您必须再次运行应用。

• 实时编辑功能仅支持可调试的进程。

• 实时编辑不支持在 build 配置中的 kotlinOptions 下为 moduleName 使用自定义值的项目。

• 实时编辑功能不适用于多部署部署。这意味着，您不能先部署到一台设备，然后再部署到另一个设备。实时编辑功能仅在应用部署到的最后一组设备上有效。

• 实时编辑功能支持多设备部署（部署到通过目标设备下拉菜单中的 Select multiple devices 创建的多台设备）。不过，该功能并非官方支持的功能，因此可能会出现问题。如果您遇到问题，请报告。

• “Apply Changes”（应用更改）/“Apply Code Changes”（应用代码更改）与实时编辑功能不兼容，并且需要重启正在运行的应用。

• 实时编辑目前不支持 Android Automotive 项目。

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

• 实时编辑功能目前处于什么状态？

  Android Studio Giraffe 中提供了实时编辑功能。如需开启此功能，请依次前往 File > Settings > Editor > Live Edit（在 macOS 上，则依次前往 Android Studio > Settings > Editor > Live Edit）。

• 何时应使用实时编辑功能？

  如果您想快速查看用户体验元素更新（例如，修饰符更新、动画更新）对整体应用体验的影响，就可以使用实时编辑功能。

• 何时应避免使用实时编辑功能？

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

• 何时应使用 Compose 预览？

  开发单个可组合项时，请使用 Compose 预览。预览会直观呈现 Compose 元素，还会自动刷新来显示代码更改的效果。预览还支持在不同的配置和状态（例如深色主题、语言区域和字体大小）下查看界面元素。

实时编辑字面量（已废弃）

已废弃： 实时编辑字面量功能（实时编辑功能的早期版本，仅限于少数受支持的类型）已废弃。我们建议改用实时编辑。

Android Studio 可以实时更新在预览、模拟器和实体设备中的可组合项中使用的一些常量字面量。下面是一些受支持的类型：

• Int
• String
• Color
• Dp
• Boolean

通过“Live Edit of Literals”界面指示器启用字面量修饰功能，无需进行编译即可查看触发实时更新的常量字面量：

注意 ：“Live Editing of Literals”界面指示器会显示在 Code/Split/Design 旁边，前提是与模拟器或实体设备上正在运行的应用保持有效连接。

Apply Changes

Apply Changes 可让您更新代码和资源，而不必将应用重新部署到模拟器或实体设备上，不过，这项功能存在一些限制。

每当您添加、修改或删除可组合项时，您只需点击一下应用代码更改按钮，即可更新应用，而不必重新部署：