WillowTree Technical Onboarding

Read First

These steps are for contributors with access to WillowTree internal resources who wish to build the project locally in Xcode and run on a physical device.

Prerequisites

Github

If you don't regularly use Github, you will need to set up an account

1. You'll need to make sure you can connect via SSH
2. You'll need to work with IT to ensure your account can connect via Single Sign-On
3. You'll need to ensure you have read access to the match repo

Fastlane

Fastlane is what we use to automate builds and ensure consistency between our CI environment and our local development environment. It can be installed by running the following in Terminal:

brew install fastlane

If you already have it installed, you may want to run brew upgrade fastlane to ensure it is up to date.

Environment Setup

1. Clone the project to your directory of choice [email protected]:willowtreeapps/vocable-ios.git
2. Ensure you are on the develop branch
3. cd to the project directory in Terminal

Set up provisioning environment

1. Paste in fastlane wt_setup_build_environment and hit return
2. Once it completes, you should be prepared to build and run on a physical device

If you need to enroll a test device

1. Request access to the Vocable vault in 1Password and open the Fastlane Match + CircleCI Secrets note
2. Open your text editor of choice and paste in this template:

export APP_STORE_KEY_ID="";\
export APP_STORE_ISSUER_ID="";\
export APP_STORE_KEY_BASE64="";\
\
fastlane wt_register_new_device

3. Each variable in that template has a corresponding value in 1Password. Paste each corresponding value into the quotes in the template above
4. Select-all and copy the prepared command
5. Paste the command into Terminal and hit return to execute it
6. When prompted enter a device name and press enter. Something descriptive like Jane Doe - iPhone 13 Pro is recommended.
7. When prompted enter the device UDID and press enter. Found in Xcode -> Window -> Devices and Simulators
8. When prompted enter a [email protected] for username and press enter.
9. Fastlane may ask you to enter a username again, use [email protected].