Neo ist eine ergonomische Tastaturbelegung, welche für die deutsche Sprache optimiert ist.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

66 lines
3.1 KiB

  1. # Build-Anleitung für kbdneo / kbdbone / kbdqwertz
  2. Für die weitergehende Entwicklung und Kompilierung der Treiberlayout-DLLs unter Windows 10 wurde eine Solution in Visual Studio 2019 erstellt, die die verschiedenen Varianten (Neo, Bone, Qwertz) zusammenfasst. Die Treiber-DLLs können somit auf zwei Arten gebaut werden:
  3. 1. Über Visual Studio
  4. 2. Über ein manuelles Buildskript
  5. Die erste Variante ist einfacher und dient auch der Entwicklung. Die zweite Variante benötigt kein Visual Studio und kein Windows Driver Kit.
  6. ## Regulärer Build mit Visual Studio
  7. ### Voraussetzungen
  8. Zum Bauen notwendig sind folgende Programme:
  9. * Visual Studio (2017 oder neuer)
  10. * Desktop-Entwicklung mit C++ installiert
  11. * Windows 10 SDK (10.0.18362 oder neuer)
  12. * Windows Driver Kit (Version 2004 oder neuer)
  13. * siehe Anleitung: https://docs.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk
  14. ### Build
  15. 1. `kbd.sln` aus `source` in Visual Studio öffnen
  16. 1. Release-Build einstellen und Konfiguration x64 auswählen
  17. 1. Build solution
  18. 1. Konfiguration x86 auswählen
  19. 1. Build solution
  20. Für jedes der enthaltenen Tastaturlayouts sind nun je zwei .dll-Dateien (Name = Projektname) gebaut worden. Diese müssen mit einem 64-Bit-fähigen Dateimanager (z.B. Windows Explorer) in die entsprechenden Verzeichnisse kopiert werden:
  21. * x64\release\kbd*.dll → C:\Windows\System32
  22. * release\kbd*.dll → C:\Windows\SysWOW64
  23. ## Manueller Build
  24. ### Voraussetzungen
  25. * Visual Studio Build Tools: Auf https://visualstudio.microsoft.com/de/downloads/ nach unten scrollen, unter „Alle Downloads“ den Reiter „Tools für Visual Studio 2019“ aufklappen und „Buildtools für Visual Studio 2019“ auswählen.
  26. * Im Installer unter „Workloads“ die C++-Buildtools auswählen – oder alternativ unter „Einzelne Komponenten“ die aktuellen x64/x86-Buildtools sowie das aktuelle Windows 10 SDK auswählen.
  27. ### Build
  28. Nach der Installation stehen im Startmenü im Ordner Visual Studio 2019 verschiedene Command Prompts zur Verfügung. Das Vorgehen ist wie folgt:
  29. * x86_x64 Cross Tools Command Prompt for VS 2019 starten
  30. * ins `build`-Verzeichnis unterhalb von kbdneo wechseln
  31. * `build_x64` ausführen
  32. Dies baut die x64-Varianten der DLLs. Für die x86-Varianten (für SysWOW64) lautet es:
  33. * x86 Native Tools Command Prompt for VS 2019 starten
  34. * ins `build`-Verzeichnis unterhalb von kbdneo wechseln
  35. * `build_x86` ausführen
  36. Die erzeugten DLLs sind anschließend in den Unterverzeichnissen `x64` und x86` der jeweiligen Layoutvarianten zu finden.
  37. ## kbdqwertz mit „ß“ unten
  38. Von kbdqwertz (aus historischen Gründen in kbdgr2 platziert) gibt es zwei Varianten, einmal mit dem regulären QWERTZ-Layout mit ß oben und dem Bindestrich unten. Die zweite Variante tauscht beides, sodass der Bindestrich gemeinsam mit anderen Strichen auf weiteren Ebenen auf der Strichtaste landet. Das „ß“ verschiebt sich dafür ins Hauptfeld.
  39. Um kbdqwertz mit „ß“ unten zu kompilieren, muss in `kbdgr2.h` folgende Zeile einkommentiert werden:
  40. ```
  41. // #define LOW_ESZETT
  42. ```
  43. Anschließend kann nach obiger Anleitung weiter verfahren werden.