qmk-firmware/docs/zh-cn/cli.md
IskandarMa f6a7f4d4ac
update the Chinese translation based on the latest English version (#14924)
Co-authored-by: peepeetee <43021794+peepeetee@users.noreply.github.com>
Co-authored-by: Joy Lee <chang.li@westberrytech.com>
Co-authored-by: LitoMore <LitoMore@users.noreply.github.com>
Co-authored-by: Dasky <32983009+daskygit@users.noreply.github.com>
2022-01-18 18:24:02 +00:00

1.9 KiB
Raw Blame History

QMK CLI :id=qmk-cli

总览 :id=overview

QMK CLI可以让构建QMK键盘的过程更轻松一些我们已提供的一批指令可用于简化及流式化地处理一些常见工作如获取并编译QMK固件创建新的键映射等。

依赖项 :id=requirements

QMK依赖Python 3.6或更高版本。我们已经尽力缩减依赖项,但在requirements.txt中的依赖项是需安装的包。在安装QMK CLI时这些依赖项也会自动完成安装。

通过 Homebrew 安装(macOS 及部分 Linux) :id=install-using-homebrew

若已安装Homebrew可以按如下方法安装QMK:

brew install qmk/qmk/qmk
export QMK_HOME='~/qmk_firmware' # 可选,指定 `qmk_firmware` 的路径
qmk setup  # 拉取 `qmk/qmk_firmware` 并选择性地配置构建环境

通过 pip 安装 :id=install-using-easy_install-or-pip

未在以上列出的操作系统可以手动安装QMK。首先确认已安装Python 3.6(或更高版本)及 pip然后通过如下指令安装QMK

python3 -m pip install qmk
export QMK_HOME='~/qmk_firmware' # 可选,指定 `qmk_firmware` 的路径
qmk setup  # 拉取 `qmk/qmk_firmware` 并选择性地配置构建环境

其它操作系统的安装包 :id=packaging-for-other-operating-systems

我们正在寻求可以制作维护更多操作系统下可用的 qmk 安装包的开发者,若您愿意为您的操作系统制作安装包,请遵循如下指引:

  • 当该系统下的最佳实践与本指引冲突时,请遵循系统的最佳实践方案
    • 但请在注释中列明此处违反这份指引的原因
  • 在 virtualenv 下安装
  • 指引用户去设置 QMK_HOME 环境变量,使得固件源文件拉取路径不再是默认的 ~/qmk_firmware