dart compile

使用 dart compile 命令将 Dart 程序编译到目标平台。 您可以使用子命令指定输出，输出可以包含Dart 运行时，也可以是模块（也称为快照）。

这是一个使用 exe 子命令生成自包含可执行文件 (myapp.exe) 的示例

$ dart compile exe bin/myapp.dart
Generated: /Users/me/myapp/bin/myapp.exe

下一个示例使用 aot-snapshot 子命令生成预先 (AOT) 编译的模块 (myapp.aot)。 然后，它使用dartaotruntime 命令（提供Dart 运行时）来运行 AOT 模块

$ dart compile aot-snapshot bin/myapp.dart
Generated: /Users/me/myapp/bin/myapp.aot
$ dartaotruntime bin/myapp.aot

要指定输出文件的路径，请使用 -o 或 --output 选项

$ dart compile exe bin/myapp.dart -o bin/runme

有关更多选项和用法信息，请运行 dart compile [<子命令>] --help

$ dart compile exe --help

dart compile 命令取代了 dart2native、dart2aot 和 dart2js 命令。

请参阅native_app 示例，了解如何使用 dart compile 编译本机应用的简单示例，以及运行应用的示例。

下表显示了 dart compile 的子命令。

以下部分详细介绍了 dart compile 可以生成的每种输出类型。

exe 子命令生成适用于 Windows、macOS 或 Linux 的独立可执行文件。 独立可执行文件是来自指定的 Dart 文件及其依赖项编译的本机机器码，外加一个小的Dart 运行时，用于处理类型检查和垃圾回收。

您可以像运行任何其他可执行文件一样分发和运行输出文件。

编译您的应用并设置输出文件

$ dart compile exe bin/myapp.dart -o /tmp/myapp

成功后，此命令输出以下内容

Generated: /tmp/myapp

从 /tmp 目录运行编译后的应用

$ ./tmp/myapp

使用 dart compile exe 创建的可执行文件支持在 macOS 和 Windows 上进行签名。

要了解有关特定于平台的代码签名的更多信息，请参阅这些操作系统的平台文档

• Windows SignTool.exe 文档
• Apple 代码签名指南

exe 子命令有一些已知的限制

不支持交叉编译 (issue 28617)

编译器只能为编译时所在的操作系统创建机器码。 要为 macOS、Windows 和 Linux 创建可执行文件，您需要运行编译器三次。 您还可以使用支持所有三个操作系统的持续集成 (CI) 提供商。

不支持 dart:mirrors 和 dart:developer

有关可以使用的核心库的完整列表，请参阅多平台和本机平台库表。

当分发多个命令行应用时，请使用 AOT 模块来减少磁盘空间需求。 aot-snapshot 子命令生成特定于当前编译应用时所在架构的输出文件。

例如，如果您使用 macOS 创建 .aot 文件，则该文件只能在 macOS 上运行。 Dart 支持 Windows、macOS 和 Linux 上的 AOT 模块。

$ dart compile aot-snapshot bin/myapp.dart
Generated: /Users/me/myapp/bin/myapp.aot
$ dartaotruntime bin/myapp.aot

aot-snapshot 子命令有一些已知的限制。

不支持交叉编译 (issue 28617)

编译器只能为编译时所在的操作系统创建机器码。 要为 macOS、Windows 和 Linux 创建可执行文件，您需要运行编译器三次。 您还可以使用支持所有三个操作系统的持续集成 (CI) 提供商。

不支持 dart:mirrors 和 dart:developer

有关可以使用的核心库的完整列表，请参阅多平台和本机平台库表。

要了解更多信息，请参阅dartaotruntime 文档。

JIT 模块包括在程序的训练运行期间生成的所有已解析的类和已编译的代码。

$ dart compile jit-snapshot bin/myapp.dart
Compiling bin/myapp.dart to jit-snapshot file bin/myapp.jit.
Hello world!
$ dart run bin/myapp.jit
Hello world!

从应用模块运行时，Dart VM 不需要解析或编译在训练运行期间已使用的类和函数，因此 VM 会更快地开始运行用户代码。

这些模块是特定于架构的，这与使用kernel 子命令生成的模块不同。

使用 kernel 子命令将应用打包到一个可在所有操作系统和 CPU 架构上运行的单个可移植文件中。 kernel 模块包含 Dart 程序的抽象语法树的二进制形式 (Kernel AST)。

这是一个创建和运行 kernel 模块的示例

$ dart compile kernel bin/myapp.dart
Compiling bin/myapp.dart to kernel file bin/myapp.dill.
$ dart run bin/myapp.dill

虽然与 Dart 代码相比，kernel 模块的启动时间有所减少，但它们的启动时间可能比特定于架构的 AOT 输出格式慢得多。

js 子命令将 Dart 代码编译为可部署的 JavaScript。

dart compile js 命令有多个选项来自定义 JavaScript 代码编译。

• 基本选项
• 路径和环境选项
• 显示选项
• 分析选项

常见选项包括

-o <文件> 或 --output=<文件>

将输出生成到 <文件> 中。 如果未指定，则输出将转到名为 out.js 的文件中。

--enable-asserts

启用断言检查。

-O{0|1|2|3|4}

控制优化以减小文件大小并提高代码性能。 要了解有关这些优化的更多信息，请运行 dart compile js -hv。

• -O0：禁用许多优化。

• -O1：启用默认优化。

• -O2：启用 -O1 优化以及其他优化（例如缩小），这些优化尊重语言语义并对所有程序都是安全的。

• -O3：启用 -O2 优化，并省略隐式类型检查。

• -O4：启用比 -O3 更激进的优化，但具有相同的假设。

--no-source-maps

不生成源映射文件。

-h 或 --help

显示帮助信息。要获取有关所有选项的信息，请使用 -hv。

其他一些方便的选项包括

--packages=<路径>

指定包解析配置文件的路径。有关更多信息，请查看 Dart 包配置文件规范。

-D<标记>=<值>

定义一个环境声明和值对，可以使用 String.fromEnvironment、int.fromEnvironment、bool.fromEnvironment 或 bool.hasEnvironment 访问。要了解有关环境声明的更多信息，请参阅使用编译环境声明配置应用。

--version

显示 dart 的版本信息。

以下选项可帮助您控制编译器输出。

--suppress-warnings

不显示警告。

--suppress-hints

不显示提示。

--terse

发出诊断信息，不建议如何解决已诊断的问题。

-v 或 --verbose

显示大量信息。

以下选项控制对 Dart 代码执行的分析。

--fatal-warnings

将警告视为编译错误。

--enable-diagnostic-colors

为诊断消息添加颜色。

--show-package-warnings

显示从包生成的警告和提示。

--csp

禁用生成输出中动态生成代码。这对于满足 CSP 限制是必要的（请参阅 W3C 内容安全策略）。

--dump-info

生成一个文件（后缀为 .info.json），其中包含有关生成代码的信息。您可以使用 dart2js_info 中的工具检查生成的文件。

例如，要将 Dart 应用程序编译为优化的 JavaScript，请运行以下命令

$ dart compile js -O2 -o out/main.js web/main.dart

请遵循以下实践来改进类型推断、减少文件大小并提高 JavaScript 性能

• 不要使用 Function.apply()。
• 不要重写 noSuchMethod()。
• 避免将变量设置为 null。
• 保持传递给每个函数或方法的参数类型一致。

要了解有关构建和部署 JavaScript 应用程序的更多信息，请查看Web 部署。

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2024-05-13。 查看源代码 或 报告问题。