mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-06 00:45:32 +00:00
53 lines
No EOL
2.8 KiB
Markdown
53 lines
No EOL
2.8 KiB
Markdown
# Keyman for macOS
|
|
|
|
## Mac Tools Requirements/Setup
|
|
Install Xcode 8.3.3 or later (it might also work to use an older version)
|
|
Install [Carthage](https://github.com/Carthage/Carthage/blob/master/README.md) *see Homebrew note below
|
|
|
|
## 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`.
|
|
|
|
Note: If Carthage prompts you to allow it access to your github credentials, it's fine to click Deny.
|
|
|
|
### 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](https://help.keyman.com/products/mac/1.0/docs/start_download-install_keyman.php).
|
|
|
|
### 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](#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`.
|
|
|
|
*note about Homebrew:
|
|
Installing Carthage directly from the pkg file is simple. Homebrew seemed simple, but it
|
|
changes a lot of settings and I think it messed up the build in a way that took me a long
|
|
time to sort out. One specific problem is that using Homebrew seems to mess up the
|
|
command-line tools, so you will probably get this error from xcodebuild:
|
|
Error: xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory is a command line tools instance
|
|
To fix it run this command:
|
|
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer |