Karabiner-Elements

Karabiner-Elements 是一款功能强大的 macOS 键盘映射工具。

下载

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

另外，对于 homebrew 用户，可以使用 brew install --cask karabiner-elements 命令安装 Karabiner-Elements。

旧版本

您可以从这里下载 Karabiner-Elements 的先前版本。

支持的系统

• macOS 15 Sequoia
  • 支持基于 Intel 和 Apple Silicon 的 Mac
• macOS 14 Sonoma
  • 支持基于 Intel 和 Apple Silicon 的 Mac
• macOS 13 Ventura
  • 支持基于 Intel 和 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. 在终端中执行以下命令获取源代码：

   git clone --depth 1 https://github.com/pqrs-org/Karabiner-Elements.git
   cd Karabiner-Elements
   git submodule update --init --recursive --depth 1
   

2. （可选）如果您有代码签名身份：

   1. 查找您的代码签名身份。

      security find-identity -p codesigning -v | grep 'Developer ID Application'
      

      结果如下：

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

      在上述情况下，您的代码签名身份是 8D660191481C98F5C56630847A6C39D95C166F22。

   2. 设置环境变量以使用您的代码签名身份。

      export PQRS_ORG_CODE_SIGN_IDENTITY=8D660191481C98F5C56630847A6C39D95C166F22
      

   3. 查找您的安装程序签名代码签名身份。

      security find-identity -p basic -v | grep 'Developer ID Installer'
      

      结果如下：

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

      在上述情况下，您的代码签名身份是 C86BB5F7830071C7B0B07D168A9A9375CC2D02C5。

   4. 设置环境变量以使用您的安装程序签名代码签名身份。

      export PQRS_ORG_INSTALLER_CODE_SIGN_IDENTITY=C86BB5F7830071C7B0B07D168A9A9375CC2D02C5
      

3. 在终端中执行以下命令构建软件包：

   make package
   

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

关于源代码树中预构建二进制文件的说明

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

• src/vendor/Karabiner-DriverKit-VirtualHIDDevice/dist/Karabiner-DriverKit-VirtualHIDDevice-*.pkg（最新版本）
• src/apps/SettingsWindow/ 中的 Sparkle.framework

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

如果您想重新构建这些二进制文件，您必须手动构建它们。 请按照这些项目的说明进行操作。