实验性子工具

您可以将子工具标记为实验性,并阻止其运行 而不会面临用户预期的不稳定问题。在旧版 您可以将其作为 ffx_plugin 的参数来执行此操作 proc 宏。在新宏中,您可以对派生宏使用 check 属性 作为工具定义的一部分

use fho::{AvailabilityFlag, FfxTool,};


#[derive(FfxTool)]
#[check(AvailabilityFlag("selftest.experiment"))]
pub struct ExperimentTool {
    #[command]
    pub cmd: ExperimentCommand,
}

工具何时处于实验阶段?

任何新工具都应该从一开始就处于实验阶段。这样,用户就可以在 他们需要在发展过程中需要它,当它稳定下来时, 符合纳入 SDK 的条件,即可取消标记为实验性,直接使用 。

我需要怎么做才能取消工具的实验性标记

可能需要获得工具团队和/或 SDK 团队的批准 然后再取消将某个工具标记为实验性版本 新工具已包含在 SDK 中

工具团队仍在努力提供具体的迁移方式和迁移时间指南 某些内容超出了实验状态,但有一些实用的准则可以包括 完成子工具的主要文档中列出的所有操作 并遵守 RFC-0169