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 [<subcommand>] --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子命令有一些已知的限制

不支持交叉编译（问题 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子命令有一些已知的限制。

不支持交叉编译（问题 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 体系结构上运行。内核模块包含 Dart 程序的抽象语法树 (内核 AST) 的二进制形式。

以下是如何创建和运行内核模块的示例

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

尽管与 Dart 代码相比，内核模块的启动时间减少了，但它们的启动速度可能比特定于体系结构的 AOT 输出格式慢得多。

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

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

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

常用选项包括

-o <file> 或 --output=<file>

将输出生成到 <file> 中。如果未指定，则输出将放在名为 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=<path>

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

-D<flag>=<value>

定义一个环境声明和值对，可以使用 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.5.3。页面上次更新时间：2024-05-13。 查看源代码 或 报告问题.