/// Execution context, always required.
    pub struct DummyCtx;

    /// Task spawner, always required
    /// and must implement `trait orchestra::Spawner`.
    pub struct DummySpawner;

    fn main() {
        let _orchestra = Opera::builder()
            .sub_a(AwesomeSubSysA::default())
            .sub_b(AwesomeSubSysB::default())
            .spawner(DummySpawner)
            .build();
    }

在所示的 main 中，乐团是通过生成的编译时错误生成器模式创建的。

构建器要求在调用 build 方法之前，必须通过相应的设置方法设置所有子系统、行李字段（附加结构数据）和生成器。未能进行此类初始化会导致编译错误。这是通过将每个构建器字段编码为所谓的 state generics 来实现的，这意味着每个字段可以是 Init<T> 或 Missing<T>，因此每个设置器将特定结构字段的从 Missing 状态转换到 Init 状态。因此，如果您在期望 Init 的位置看到关于 Missing 的编译时错误，通常意味着在调用 build 之前没有设置某些子系统或行李字段。

要排除子系统进行此类检查，可以在尚未准备好包含在 orchestra 中的某些子系统上设置 wip 属性。

    #[orchestra(signal=SigSigSig, event=Event, gen=AllMessages, error=OrchestraError)]
    pub struct Opera {
        #[subsystem(MsgA, sends: MsgB)]
        sub_a: AwesomeSubSysA,

        #[subsystem(MsgB, sends: MsgA), wip]
        sub_b: AwesomeSubSysB, // This subsystem will not be required nor allowed to be set
    }

行李字段可以初始化多次，但对于子系统则不然：子系统必须只初始化一次（另一个编译时检查）或通过特殊设置器如 replace_<子系统> 方法进行替换。

任务生成器和子系统上下文需要使用 Spawner 和分别 SubsystemContext 实现。

调试

和往常一样，由于存在问题的 proc-macros，调试非常令人烦恼，请参阅 功能 "expand"。

功能

功能 "expand"

expander 用于提供更好的错误信息。通过 --features=orchestra/expand 启用。

功能 "dotgraph"

根据声明要发送和消费的消息生成一个有向图，显示连接性。通过启用--features=orchestra/dotgraph。生成的文件路径将显示出来，形式为${OUT_DIR}/${orchestra|lowercase}-subsystem-messaging.dot。使用dot -Tpng ${OUT_DIR}/${orchestra|lowercase}-subsystem-messaging.dot > connectivity.dot将其转换为图像，例如png，或使用您喜欢的dot文件查看器。它还会在.dot图旁边创建一个.svg，可以直接使用。

注意事项

没有工具是没有缺点的，orchestra也不例外。

大消息类型

不建议通过通道发送大消息，就像其他通道实现一样。如果您需要传输大于几百字节的数据，请使用Box<_>包裹它，或者使用全局标识符来访问持久状态，例如数据库，具体取决于用例。

响应通道

将响应通道作为消息的一部分似乎非常吸引人，并且在许多情况下，这些都是维护结构化数据流的一种非常方便的方式，但如果不谨慎使用，它们可能会给您带来麻烦。所需的谨慎包括三个方面：

1. 循环消息依赖导致单线程子系统死锁
2. 跨多个子系统太深的消息依赖
3. 由于响应通道导致的延迟

每个问题都有各种解决方案，例如使用本地缓存来纠正频繁查找相同信息的操作，或者在某些异常情况下将子系统拆分为多个以避免循环依赖，或者将拓扑上紧密相关的子系统合并，但这强烈取决于orchestra使用的具体环境。

要查找这些，功能dotgraph提供了子系统到子系统级别的所有交互的可视化（目前还不是消息级别），以研究循环。在生成阶段注意警告。

许可证

根据您的要求，许可协议为以下之一：

• Apache License，版本2.0，（LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

任选。