erabo/spiegel-keyman
1
0
Fork 0
mirror of https://github.com/keymanapp/keyman.git synced 2026-08-05 00:15:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9
spiegel-keyman/mac
History
Tom Bogle 2c024805a5 WIP: This is what I have tried so far. The config window does NOT display when accessed via the menu. It still works (the old/right way) in Sierra when accessed via the About window. If you first try to access it via the menu and then access it via the Configuration button on the About window, it displays twice!
2017-11-19 23:55:22 -05:00
..
Keyman4Mac Made changes to allow CI to set version numbers dynamically (similar to changes made in previous repo, but with some refactoring and also included testapp). 2017-08-11 02:40:43 -04:00
Keyman4MacIM WIP: This is what I have tried so far. The config window does NOT display when accessed via the menu. It still works (the old/right way) in Sierra when accessed via the About window. If you first try to access it via the menu and then access it via the Configuration button on the About window, it displays twice! 2017-11-19 23:55:22 -05:00
KeymanEngine4Mac Cherry picked a few small changes from "mac compatibility" branch to fix bug whereby command keys were sometimes causing characters to be output. 2017-10-23 22:44:57 -04:00
.gitignore Made changes to allow CI to set version numbers dynamically (similar to changes made in previous repo, but with some refactoring and also included testapp). 2017-08-11 02:40:43 -04:00
bashHelperFunctions.sh Added #!/bin/sh to indicate that bashHelperFunctions.sh is an executable shell script. 2017-08-10 22:51:10 -04:00
build.sh Changed test option to a) work and b) only be applicable to KeymanEngine4Mac. (Can't get it to work for the other two projects, and it probably isn't necessary.) 2017-09-07 14:00:58 -04:00
ComponentInputModeDict.rtf [Mac] Initial check-in to open-source repo 2017-08-10 13:11:52 +07:00
history.md Found a piece missing from macOS's version history, throwing it in too. 2017-09-29 09:13:04 +07:00
README.md Update README.md 2017-10-04 22:37:21 -04:00

README.md

Keyman for macOS

Minimum Mac Requirements

Xcode 8.3.3 (it might also work to use an older version)

Keyman for macOS Development

Keyman for macOS can be built from a command line (preferred) or Xcode.

Compiling from Command Line

To build Keyman for macOS, do the following:

  1. Open a Terminal window.
  2. cd to keyman/mac. build.sh must be run in the directory containing the script.
  3. Build using ./build.sh -no-codesign. Run ./build.sh -help to see all options.
    • If you have signing credentials from the core development team, you can build a signed version by omitting -no-codesign.

Running Keyman

  1. Deploy Keyman locally using ./build.sh -deploy local -deploy-only.
    • Alternatively copy keyman/mac/Keyman4MacIM/build/Debug/Keyman.app to ~/Library/Input Methods
  2. If running for the first time, follow the installation instructions at Installing Keyman for Mac OS X.

Compiling from Xcode

To build using Xcode, you will need to build KeymanEngine4Mac first and then build Keyman4MacIM.

  1. Launch Xcode
  2. Open keyman/mac/KeymanEngine4Mac/KeymanEngine4Mac.xcodeproj
  3. Build the project: Product > Build (or Cmd-B)
  4. Open keyman/mac/Keyman4MacIM/Keyman4MacIM.xcodeproj
  5. If you do not have signing credentials from the core development team, disable code signing in Xcode.
    1. Open the Project Navigator: View > Navigators > Show Project Navigator (Cmd-1)
    2. Select Keyman4MacIM and click Build Settings
    3. In the Signing section, change Code Signing Identity to Don't Code Sign. This will modify Keyman4MacIM.xcodeproj. Do not commit the change.
  6. Build the project. Refer to Running Keyman on how to install the app.

Testing

The Keyman4Mac project builds a test-bed app that can be used to test keyboards without installing the input method. It can also be used as reference for the usage of Keyman Engine.

Keyman4Mac tests are run using ./build.sh -test -no-codesign.