Karabiner Elements Neo selbst bauen

pl0pix edited this page Jul 31, 2017 · 8 revisions

Voraussetzungen

  1. Installiere die aktuellste Version von Xcode über den App Store.
  2. Installiere die „Command line developer tools“, entweder über Xcode oder folgenden Terminal-Befehl: xcode-select --install.
  3. Installiere Boost 1.61.0+ (header-only); dies ist am komfortabelsten über Homebrew oder MacPorts möglich (z.B. brew install boost bzw. sudo port install boost).

Einrichten der Code-Signing-Identität

Für Xcode Versionen kleiner 8.3.3

  1. Öffne die Xcode-Einstellungen (⌘,), wähle den Reiter „Nutzerkonten“ (Accounts) aus und klicke auf deine Apple ID (ggf. über das Plus-Symbol hinzufügen).
  2. Klicke unten rechts auf „Details anschauen“ (View details…).
  3. Klicke rechts neben „Mac Development“ auf „Erstellen“ (Create).
  4. Öffne das Programm „Keychain Access“ und suche nach dem Zertifikat „Mac Developer: [Deine Emailadresse]“. Wähle es aus und klicke unten in der Statusleiste auf das „i“-Informationssymbol.
  5. Scrolle im sich öffnenden Informationsfenster ganz nach unten. Unter „Fingerabdrücke“ (Fingerprints) befindet sich neben „SHA1“ eine lange Zeichenkette. Lass dieses Fenster am besten geöffnet; in ein paar Schritten wird dieser SHA1-Fingerabdruck benötigt.

Xcode 8.3.3

  1. Öffne die Xcode-Einstellungen (⌘,), wähle den Reiter „Nutzerkonten“ (Accounts) aus und klicke auf deine Apple ID (ggf. über das Plus-Symbol hinzufügen).
  2. Klicke unten rechts auf „Verwalte Zertifikate“ (Manage Certificates…).
  3. Auf das Plus Symbol in der linken, unteren Ecke klicken.
  4. Klicke auf „macOS Development“.
  5. Öffne das Programm „Keychain Access“ und suche nach dem Zertifikat „Mac Developer: [Deine Emailadresse]“. Wähle es aus und klicke unten in der Statusleiste auf das „i“-Informationssymbol.
  6. Scrolle im sich öffnenden Informationsfenster ganz nach unten. Unter „Fingerabdrücke“ (Fingerprints) befindet sich neben „SHA1“ eine lange Zeichenkette. Lass dieses Fenster am besten geöffnet; in ein paar Schritten wird dieser SHA1-Fingerabdruck benötigt.

Build

  1. Öffne des Terminal.
  2. Clone Karabiner-Elements-Neo: git clone https://github.com/jgosmann/Karabiner-Elements-Neo.git.
  3. Dies erstellt ein Verzeichnis mit Namen Karabiner-Elements-Neo. Navigiere in diesen Ordner mit cd Karabiner-Elements-Neo (oder über den Finder).
  4. Im Unterordner scripts befinden sich die Dateien codesign-pkg.sh und codesign.sh. Ersetze in beiden in der dritten Zeile den SHA1-Fingerabdruck mit deinem eigenen: CODESIGN_IDENTITY='<Dein SHA1-Fingerabdruck ohne Leerzeichen>'. (Entferne die Leerzeichen, nachdem du ihn hineinkopiert hast.)
  5. Führe den Build-Prozess durch: make. Wenn du aufgefordert wirst, “codesign” Zugriff zum Schlüsselbund zu geben, klicke auf „Akzeptieren“.

(An dieser Stelle kann es zu Hinweisen zu „analyzer issues“ sowie der Meldung „productsign: error: Could not find appropriate signing identity“ kommen. Dies ist an sich kein Grund zur Sorge.)

Das Endprodukt des Builds ist die Datei Karabiner-Elements-<version>-neo.dmg, welche wie üblich einen Installer enthält.

Falls du bereits eine andere Version von Karabiner-Elements installiert hast, deinstalliere diese Version und starte deinen Rechner neu bevor du Karabiner-Elements-Neo installierst. Außerdem sind nach der ersten Installation noch ein paar Konfigurationsschritte nötig; folge dazu den Anweisungen im README.