Kiibohd Configurator 项目常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00936/article/details/143876417

Kiibohd Configurator 项目常见问题解决方案

configurator Client-side component of the configurator 项目地址: https://gitcode.com/gh_mirrors/co/configurator

项目基础介绍

Kiibohd Configurator 是一个用于配置和刷写 Kiibohd 兼容键盘的客户端组件。该项目的主要目的是为用户提供一个图形化界面，以便轻松配置和更新键盘固件。Kiibohd Configurator 主要使用 JavaScript 和 Node.js 进行开发，同时也涉及到一些前端技术如 HTML 和 CSS。

新手使用注意事项及解决方案

1. 安装依赖问题

问题描述：新手在安装项目依赖时可能会遇到各种错误，尤其是在不同操作系统上。

解决步骤：

Windows 系统：
- 确保已安装 Chocolatey 包管理器。
- 以管理员身份运行命令提示符，执行以下命令：
```
choco feature enable -n allowGlobalConfirmation
choco install python python2 nodejs yarn
```
- 安装完成后，运行 yarn 命令来安装项目依赖。

Linux 系统：

安装必要的开发工具和库：

sudo apt-get install build-essential libudev-dev

安装 Node.js 和 Yarn：

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g yarn

运行 yarn 命令来安装项目依赖。

macOS 系统：
- 安装 Homebrew 包管理器：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- 使用 Homebrew 安装 Node.js 和 Yarn：
```
brew install node yarn
```
- 运行 yarn 命令来安装项目依赖。

2. 驱动安装问题

问题描述：在某些操作系统上，用户可能需要手动安装驱动程序才能正常使用 Kiibohd Configurator。

解决步骤：

Windows 系统：
- 打开 Kiibohd Configurator 应用。
- 进入“设置” > “驱动程序”选项卡。
- 按照提示安装 Zadig 驱动程序。

Linux 系统：

安装 dfu-util 工具：
```
sudo apt-get install dfu-util
```

创建并编辑 /etc/udev/rules.d/60-input-club.rules 文件，添加以下内容：

# UDEV Rules for Input Club keyboards
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", ATTRS{idProduct}=="b04d", MODE="664", GROUP="plugdev"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", ATTRS{idProduct}=="b007", MODE="664", GROUP="plugdev"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="01c0", MODE="664", GROUP="plugdev"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="01cb", MODE="664", GROUP="plugdev"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="308f", MODE="664", GROUP="plugdev"

重新加载 udev 规则：
```
sudo udevadm control --reload-rules
```

macOS 系统：
- 安装 libusb 库：
```
brew install libusb
```
- 运行 Kiibohd Configurator 应用。

3. 编译和运行问题

问题描述：新手在尝试编译和运行项目时可能会遇到各种错误，尤其是在没有预编译版本的情况下。

解决步骤：

检查 Node.js 版本：
- 确保 Node.js 版本在 10.x 以上：
```
node -v
```
- 如果版本不符，使用 nvm 或 n 工具进行版本管理。
安装项目依赖：
- 进入项目目录，运行以下命令：
```
yarn install
```
运行开发模式：
- 运行以下命令启动开发服务器：
```
yarn dev
```
- 如果需要运行 KiiConf，请确保 KiiConf 也在本地运行。
构建项目：
- 运行以下命令进行项目构建：
```
yarn dist
```
- 构建完成后，进入 output 目录，找到对应平台的可执行文件并运行。