11 macOS Build Agent Setup

Marc Durdin edited this page 2021-11-18 10:28:08 +11:00

Table of Contents

• Basic Setup
• Keyman for macOS, Keyman for iOS, KeymanWeb, FirstVoices Keyboards for iOS requirements
• Keyman Core requirements

Basic Setup

1. Install macOS Big Sur + updates
2. Install XCode, start once
3. Change sleep preference to never sleep
4. Enable ssh login (with appropriate password etc of course https://superuser.com/questions/104929/how-do-you-run-a-ssh-server-on-mac-os-x)
5. Set default shell to /opt/homebrew/bin/bash (add that to /etc/shells first), then chsh -s

Keyman for macOS, Keyman for iOS, KeymanWeb, FirstVoices Keyboards for iOS requirements

1. Install certificates and private keys
   • FVKeyboards certificate
   • Keyman for iOS
   • Keyman for macOS
   • ~/fastlane
2. Install provisioning profiles
   • Keyman x 2
   • FVKeyboards x 2
3. xcode-select --install
4. Install Homebrew
5. brew install node.js
6. brew install swiftlint
7. brew install carthage
8. brew install pandoc
9. brew install coreutils
10. brew install getsentry/tools/sentry-cli
11. brew install jq
12. brew install bash
13. brew install wget
14. brew install cocoapods
15. brew install openjdk@11
16. brew install rsync
17. brew install hub
18. Install Build Agent software
19. Add KeymanBuildAgent environment variable to .zshrc and .bashrc
20. Add ssh keys for publishing artifacts
21. brew install fastlane
22. Login to keyman-server@github
23. Setup fastlane UTF-8 in .bash_profile / .zprofile:

    export LC_ALL=en_US.UTF-8
    export LANG=en_US.UTF-8
    

Keyman Core requirements

1. brew install meson
2. curl https://sh.rustup.rs -sSf | sh
3. Add ~/.cargo/bin to path for buildAgent.properties

(For now we don't support rebuilding keyboards on macOS for core, until we have a better cross-platform kmcomp)