erabo/spiegel-keyman
1
0
Fork 0
mirror of https://github.com/keymanapp/keyman.git synced 2026-08-05 08:25:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10
spiegel-keyman/mac
History
Tom Bogle db9475e0c6 Solved the chirality problem on Mac (#178) 
Also made the Scheme for the IM build shared in preparation for adding unit tests to thta project.
2018-01-25 00:00:44 -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 Solved the chirality problem on Mac (#178) 2018-01-25 00:00:44 -05:00
KeymanEngine4Mac Solved the chirality problem on Mac (#178) 2018-01-25 00:00:44 -05: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 Version number 2017-11-21 13:20:26 +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.