Karabiner Elements

卡拉宾元件

Karabiner-Elements 是一款功能强大的 macOS 按键重新映射器。

下载

您可以从官方网站下载 Karabiner-Elements。

或者，对于自制软件的用户，可以使用brew install --cask karabiner-elements安装Karabiner-Elements。

旧版本

您可以从此处下载以前版本的 Karabiner-Elements。

支持的系统

• macOS 15 红杉

• 基于 Intel 的 Mac 和 Apple Silicon Mac

• macOS 14 索诺玛

• 基于 Intel 的 Mac 和 Apple Silicon Mac

• macOS 13 文图拉

• 基于 Intel 的 Mac 和 Apple Silicon Mac

用法

文档可以在这里找到：https://karabiner-elements.pqrs.org/docs/

捐款

如果您想为 Karabiner-Elements 的开发提供经济捐助，可以通过 https://karabiner-elements.pqrs.org/docs/pricing/ 进行捐款

---

对于开发商

如何建造

构建 Karabiner-Elements 的系统要求：

• macOS 13+

• Xcode 15.0.1+

• Xcode 命令行工具 ( xcode-select --install )

• xz（ brew install xz ）

• XcodeGen（ brew install xcodegen ）

• CMake（ brew install cmake ）

步骤

1. 通过在 Terminal.app 中执行以下命令来获取源代码。

    git clone --深度 1 https://github.com/pqrs-org/Karabiner-Elements.gitcd Karabiner-Elements
   git子模块更新--init--recursive--深度1

2. （可选）如果您有协同设计身份：

1. 找到您的协同设计身份。

   安全查找身份-p 协同设计-v | grep '开发者 ID 应用程序'

   结果如下。

   1) 8D660191481C98F5C56630847A6C39D95C166F22 "Developer ID Application: Fumihiko Takayama (G43BCU2T37)"

   在上述情况下，您的协同设计身份为8D660191481C98F5C56630847A6C39D95C166F22 。

2. 设置环境变量以使用您的协同设计身份。

   导出 PQRS_ORG_CODE_SIGN_IDENTITY=8D660191481C98F5C56630847A6C39D95C166F22

3. 查找您的协同设计身份以进行安装程序签名。

   安全查找身份-p 基本-v | grep '开发者 ID 安装程序'

   结果如下。

   1) C86BB5F7830071C7B0B07D168A9A9375CC2D02C5 "Developer ID Installer: Fumihiko Takayama (G43BCU2T37)"

   在上述情况下，您的协同设计身份为C86BB5F7830071C7B0B07D168A9A9375CC2D02C5 。

4. 设置环境变量以使用您的协同设计身份进行安装程序签名。

   导出 PQRS_ORG_INSTALLER_CODE_SIGN_IDENTITY=C86BB5F7830071C7B0B07D168A9A9375CC2D02C5

3. 通过在 Terminal.app 中执行以下命令来构建包。

   制作包

   make脚本将在当前目录中创建可再发行的Karabiner-Elements-VERSION.dmg 。

关于源树中预构建二进制文件的注意事项

Karabiner-Elements 使用源树中的一些预构建的二进制文件。

• src/vendor/Karabiner-DriverKit-VirtualHIDDevice/dist/Karabiner-DriverKit-VirtualHIDDevice-*.pkg （最新的）

• Sparkle.framework位于src/apps/SettingsWindow/

上面的make package命令不会重建这些二进制文件。
（这些二进制文件将被复制到分发包中。）

如果您想重建这些二进制文件，则必须手动构建它们。
请遵循这些项目的说明。