QMK MSYS 安装与配置指南

QMK MSYS 安装与配置指南

qmk_distro_msys A Windows one-click installer for the QMK CLI 项目地址: https://gitcode.com/gh_mirrors/qm/qmk_distro_msys

1. 项目基础介绍

QMK MSYS 是一个针对 Windows 用户的一键安装程序，它将 MSYS2 和 QMK CLI（QMK 固件开发工具）打包在一起。此项目的目的是为那些希望快速开始使用 QMK 固件开发的人提供一个尽可能简化配置过程的开发环境。它支持 Windows 8/10 操作系统，可以避免复杂的安装过程。

主要编程语言：Inno Setup（用于创建安装程序），Batchfile（用于批处理脚本）。

2. 项目使用的关键技术和框架

• MSYS2：一个用于 Windows 的 POSIX 兼容环境，它提供了一个类似 Unix 的环境，允许运行各种 Unix 工具和应用程序。
• QMK CLI：QMK 固件开发工具，用于编译和上传固件到兼容的键盘。
• Inno Setup：一个用于创建 Windows 安装程序的脚本语言和编译器。
• Batchfile：Windows 下的批处理脚本，用于自动化安装过程中的某些步骤。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保您的操作系统是 Windows 8 或 Windows 10。
• 下载并安装 Git：Git - Downloading and installing Git（请忽略这个链接，只做说明用，不要实际添加到文档中）。
• 确保您的电脑上已经安装了 MSYS2 或其他类似环境。

安装步骤

1. 从 GitHub 下载 QMK MSYS 的最新发布版本。
2. 运行下载的安装程序。
3. 安装程序会自动将 QMK CLI 和必要的依赖项安装到您的系统上。
4. 安装完成后，您可以在开始菜单中找到并打开 QMK MSYS 快捷方式。
5. 在 QMK MSYS 命令行界面中，运行 qmk setup 命令以进行必要的配置和初始化。
6. 接下来，使用 qmk compile 命令编译您的键盘固件。
7. 编译完成后，您可以使用 QMK CLI 提供的其他命令来上传固件到您的键盘。

请确保在执行以上步骤时，按照屏幕上的提示进行操作，并仔细阅读任何出现的提示信息。

以上步骤应该能够帮助您成功安装和配置 QMK MSYS，开始您的 QMK 固件开发之旅。如果在安装或配置过程中遇到问题，请查阅项目的官方文档或在社区中寻求帮助。

qmk_distro_msys A Windows one-click installer for the QMK CLI 项目地址: https://gitcode.com/gh_mirrors/qm/qmk_distro_msys