Dart pragma用法及代码示例

工具提示。

与 Dart 程序一起使用的工具可能会接受提示来指导它们的行为，如声明中的 pragma 注释。每个工具决定它接受哪些提示，它们的含义，以及它们是否以及如何应用于注释实体的sub-parts。

识别编译指示提示的工具应选择编译指示前缀来标识该工具。他们应该识别带有 name 的任何提示，以他们的前缀开头，后跟 :，就好像它是为那个工具准备的一样。应忽略带有另一个工具前缀的提示(除非以与该其他工具兼容为目标)。

一个工具也可以识别无前缀的名字，如果他们能识别那个名字前面有自己的前缀的话。

如果提示可以参数化，则还可以添加一个额外的options 对象。

例如：

@pragma('Tool:pragma-name', [param1, param2, ...])
class Foo { }

@pragma('OtherTool:other-pragma')
void foo() { }

这里类Foo 使用特定于工具的编译指示'pragma-name' 进行注释，而函数foo 使用特定于OtherTool 的编译指示'other-pragma' 进行注释。