预设

某些选择器,例如 fuzzysyntax,允许从文件中保存和加载预设。这是一种在以后或与他人共享时重复使用选择的好方法。在 mach <selector> --help 中查找“preset”部分,以确定选择器是否支持此功能。

使用预设

要保存预设,请运行

$ mach try <selector> --save <name> <args>

例如,要保存一个选择所有 Windows mochitests 的预设

$ mach try fuzzy --save all-windows-mochitests --query "'win 'mochitest"
preset saved, run with: --preset=all-windows-mochitests

然后像这样运行保存的预设

$ mach try --preset all-windows-mochitests

要查看所有可用预设的列表,请运行

$ mach try --list-presets

编辑和共享预设

预设可以在两个位置之一中定义,在您的主目录中或在检入 mozilla-central 的文件中。

本地预设

这些定义在您的 $MOZBUILD_STATE_DIR 中,通常为 ~/.mozbuild/try_presets.yml。此处定义的预设是您自己的个人预设集合。您可以通过运行以下命令修改它们:

$ ./mach try --edit-presets

共享预设

您还可以将预设检入 tools/tryselect/try_presets.yml 中的 mozilla-central。这些预设将可供所有 mach try 用户使用,因此在编辑此文件时请注意。确保预设的名称范围适当(即不包含任何团队或模块特定的术语)。最佳实践是在预设名称前加上将从中获得最大收益的团队或模块的名称。

预设格式

预设是简单的键/值对象,其中名称作为键,元数据对象作为值。例如,上面保存的预设在 try_presets.yml 中看起来像这样

all-windows-mochitests:
    selector: fuzzy
    description: >-
        Runs all windows mochitests.
    query:
        - "'win 'mochitest"

selector 键(必需)允许 mach try 确定要分派到的子命令。 description 键(用户预设中可选,但共享预设中必需)是描述预设选择内容以及何时使用它的易于理解的字符串。预设中的所有其他值都按原样转发到指定的选择器。