用户指南¶

Mach 是 mozilla-central 中大多数操作的中心入口点。

命令帮助¶

要查看所有可用命令的概述，请运行

$ ./mach help

有关特定命令的更详细的信息，请运行

$ ./mach help <command>

如果一个命令列出了子命令，可以通过运行以下命令查看子命令的更多详细信息

$ ./mach help <command> <subcommand>

或者，您可以传递 -h/--help。例如，以下所有命令都是有效的

$ ./mach help try
$ ./mach help try fuzzy
$ ./mach try -h
$ ./mach try fuzzy --help

mach 中内置了可以为各种 shell 生成快速 Tab 自动补全脚本的命令。当前支持的 shell 为 bash、zsh 和 fish。这些生成的脚本会随着时间的推移逐渐过时，因此您可能需要创建一个 cron 任务来定期重新生成它们。

请参阅下面的安装说明

$ mach mach-completion bash -f _mach
$ sudo mv _mach /etc/bash_completion.d

$ mach mach-completion bash -f $(brew --prefix)/etc/bash_completion.d/mach.bash-completion

$ mkdir ~/.zfunc
$ mach mach-completion zsh -f ~/.zfunc/_mach

然后编辑 ~/.zshrc 并添加

fpath+=~/.zfunc
autoload -U compinit && compinit

您可以使用您选择的任何目录。

$ mkdir $ZSH/plugins/mach
$ mach mach-completion zsh -f $ZSH/plugins/mach/_mach

然后编辑 ~/.zshrc 并将 'mach' 添加到启用的插件中

plugins(mach ...)

$ mach mach-completion zsh -f ~/.zprezto/modules/completion/external/src/_mach

$ ./mach mach-completion fish -f ~/.config/fish/completions/mach.fish

$ ./mach mach-completion fish -f (brew --prefix)/share/fish/vendor_completions.d/mach.fish

一些 mach 命令可以从 machrc 文件中读取配置。此文件的默认位置为 ~/.mozbuild/machrc（您需要创建它）。这也可以通过设置 MACHRC 环境变量来设置为其他位置。

要查看所有可用设置的列表，请运行

$ ./mach settings

设置文件遵循 ini 格式，例如

[alias]
eslint = lint -l eslint

[build]
telemetry = true

[try]
default = fuzzy