# Flutter 的构建模式选择

> 在使用 Flutter 构建的时候，你应该选择哪种模式呢？Debug、Release、或者是 Profile 模式。



The Flutter tooling supports three modes when compiling your app,
and a headless mode for testing.
You choose a compilation mode depending on where you are in
the development cycle. Are you debugging your code? Do you
need profiling information? Are you ready to deploy your app?

Flutter 支持三种模式编译 app，也支持使用 headless 模式来测试。
选择哪种编译模式取决于你处于哪个开发周期中。
是调试代码阶段，还是需要性能优化分析，抑或是准备部署你的应用了呢？

A quick summary for when to use which mode is as follows:

快速简要介绍下列三种构建模式：

* Use [debug](#debug) mode during development,
  when you want to use [hot reload][].

  开发过程中，需要使用 [热重载][hot reload] 功能，
  请选择 [debug](#debug) 构建模式；
  
* Use [profile](#profile) mode when you want to analyze
  performance.

  当你需要分析性能的时候，
  选择使用 [profile](#profile) 构建模式；
  
* Use [release](#release) mode when you are ready to release
  your app.

  发布应用的时候，需要选择使用 [release](#release) 构建模式。

The rest of the page details these modes.

下文详细解释了每种模式以及何时使用它。

* To learn about the headless testing mode,
  refer to the engine wiki's docs on [Flutter's build modes][].

  要了解无头 (headless) 测试模式，
  请参考 engine wiki 文档：[Flutter's build modes][]。

* To learn how to detect the build mode, check out the
  [Check for Debug/Release Mode in Flutter Apps] blog post.

  要了解如何检测构建模式，
  请参考 [Flutter 应用的 Debug/Release 模式][Check for Debug/Release Mode in Flutter Apps] 文章。

[Check for Debug/Release Mode in Flutter Apps]: https://retroportalstudio.medium.com/check-for-debug-release-mode-in-flutter-apps-d8d545f20da3

## Debug

## 调试模式

In _debug mode_, the app is set up for debugging on the physical
device, emulator, or simulator.

在 **Debug 模式**下，app 可以被安装在物理设备、仿真器或者模拟器上进行调试。

Debug mode for mobile apps mean that:

Debug 模式意味着：

* [Assertions][] are enabled.
   
  [断点](https://dart.cn/guides/language/language-tour#assert) 是开启的。

* Service extensions are enabled.

  服务扩展是开启的。

* Compilation is optimized for fast development and run cycles
  (but not for execution speed, binary size, or deployment).

  针对快速开发和运行周期进行了编译优化（但不是针对执行速度、二进制文件大小或者部署）。
  
* Debugging is enabled, and tools supporting source level debugging
  (such as [DevTools][]) can connect to the process.

  调试开启，类似 [开发者工具][DevTools] 等调试工具可以连接到进程里。

Debug mode for a web app means that:

在 Web 平台下的调试模式意味着：

* The build is _not_ minified and tree shaking has _not_ been
  performed.

  本次构建 **没有** 最小化资源并且整个构建 **没有** 优化性能。
  
* The app is compiled with the [dartdevc][] compiler for
  easier debugging.

  为了简化调试，这个 Web 应用使用了 [dartdevc][] 编译器。

By default, `flutter run` compiles to debug mode.
Your IDE supports this mode. Android Studio,
for example, provides a **Run > Debug...** menu option,
as well as a green bug icon overlaid with a small triangle
on the project page.

默认情况下，运行 `flutter run` 会使用 Debug 模式。
你的 IDE 也支持这些模式。例如，Android Studio 提供了 **Run > Debug...** 菜单选项，
而且在项目面板中还有一个三角形的绿色运行按钮图标
（菜单选项中会显示相应图标的图片）。

:::note

* Hot reload works _only_ in debug mode.

  热重载功能**仅能**在调试模式下运行；

* The emulator and simulator execute _only_ in debug mode.

  仿真器和模拟器**仅能**在调试模式下运行；

* Application performance can be janky in debug mode.
  Measure performance in [profile](#profile)
  mode on an actual device.

  在调试模型下，应用的性能可能会掉帧或者卡顿，
  [profile](#profile) 模式下会更接近真机性能。

:::

## Release

## Release 模式

Use _release mode_ for deploying the app, when you want maximum
optimization and minimal footprint size. For mobile, release mode
(which is not supported on the simulator or emulator), means that:

当你想要最大的优化以及最小的占用空间时，
就使用 **Release 模式**来部署 app 吧。
release 模式是不支持模拟器或者仿真器的，
使用 **Release 模式**意味着：

* Assertions are disabled.

  断点是不可用的。

* Debugging information is stripped out.

  调试信息是不可见的。

* Debugging is disabled.

  调试是禁用的。

* Compilation is optimized for fast startup, fast execution,
  and small package sizes.
  
  编译针对快速启动、快速执行和小的 package 的大小进行了优化。

* Service extensions are disabled.

  服务扩展是禁用的。
  
Release mode for a web app means that:

在 Web 平台的 Release 模式意味着：

* The build is minified and tree shaking has been performed.

  这次构建资源已经被压缩，并且性能得以优化。
  
* The app is compiled with the [dart2js][] compiler for
  best performance.

  这个 Web 应用通过 [dart2js][] 编译器构建，以确保更优秀的性能。

The command `flutter run --release` compiles to release mode.
Your IDE supports this mode. Android Studio, for example,
provides a **Run > Run...** menu option, as well as a triangular
green run button icon on the project page.
(The menu item shows a pic of the corresponding icon.)

`flutter run --release` 命令会使用 Release 模式来进行编译。
你的 IDE 同样也支持这个模式。
例如，Android Studio 提供了 **Run > Run...** 菜单选项，
而且在项目面板中还有一个被小三角覆盖的绿色虫子图标。
（菜单选项中会显示相应图标的图片）

You can compile to release mode for a specific target
with `flutter build <target>`. For a list of supported targets,
use `flutter help build`.

你可以使用 `flutter build <target>` 针对特定目标编译 release 模式。请使用 `flutter help build` 查看支持的目标列表。

You can also compile to release mode with `flutter build --release`.

你也可以通过 `flutter build --release` 命令来使用 release 模式。

For more information, see the docs on releasing
[iOS][] and [Android][] apps.

更多详细信息，可以参阅发布 [iOS][] 和 [Android][] app 的文档。

## Profile

## Profile 模式

In _profile mode_, some debugging ability is maintained&mdash;enough
to profile your app's performance. Profile mode is disabled on
the emulator and simulator, because their behavior is not representative
of real performance. On mobile, profile mode is similar to release mode,
with the following differences:

在 **profile** 模式下，一些调试能力是被保留的&mdash;足够分析你的 app 性能。
在仿真器和模拟器上，Profile 模式是不可用的，
因为他们的行为不能代表真实的性能。
profile 模式和 release 类似，但有以下不同：

* Some service extensions, such as the one that enables the performance
  overlay, are enabled.
  
  一些服务扩展是启用的。例如，支持 performance overlay。

* Tracing is enabled, and tools supporting source-level debugging
  (such as [DevTools][]) can connect to the process.

  Tracing 是启用的，一些调试工具，比如 [开发者工具][DevTools] 可以连接到进程里。
  
Profile mode for a web app means that:

在 Web 平台的 Profile 模式意味着：

* The build is _not_ minified but tree shaking has been performed.
 
  资源文件 **没有** 被压缩，但是整体性能已经优化。

* The app is compiled with the [dart2js][] compiler.

  这个 Web 应用通过 [dart2js][] 编译器构建。

* DevTools can't connect to a Flutter web app running
  in profile mode. Use Chrome DevTools to
  [generate timeline events][] for a web app.

  DevTool 无法连接至以性能模式运行的 Flutter Web 应用。
  你需要用 Chrome 的 DevTools 来为 Web 应用
  [生成时间线事件][generate timeline events]。

Your IDE supports this mode. Android Studio, for example,
provides a **Run > Profile...** menu option.
The command `flutter run --profile` compiles to profile mode.

`flutter run --profile` 命令是使用 Profile 模式来编译的。
你的 IDE 也是支持这个模式的。例如，Android Studio 提供了 **Run > Profile...** 菜单选项。

:::note

Use the [DevTools][] suite to profile your app's performance.

可以使用 [开发者工具][DevTools] 来测试应用性能。

:::

For more information on the build modes, see
[Flutter's build modes][].

关于这些模式的更多信息，可以查看 
[Flutter's build modes][] 文档。

[Android]: /deployment/android
[Assertions]: https://dart.cn/language/error-handling#assert
[dart2js]: https://dart.cn/tools/dart2js
[dartdevc]: https://dart.cn/tools/dartdevc
[DevTools]: /tools/devtools
[Flutter's build modes]: https://github.com/flutter/flutter/blob/main/docs/engine/Flutter's-modes.md
[generate timeline events]: https://developers.google.cn/web/tools/chrome-devtools/evaluate-performance/performance-reference
[hot reload]: /tools/hot-reload
[iOS]: /deployment/ios