← TestFlight

1. Machine Setup

Here’s how you prepare your machine to make TestFlight builds:

1. Set Up Google Cloud CLI

The gcloud command-line tool is required to use many of the deployment tools. We install it using the Homebrew formulae.

Before starting, use the Privileges tool to request administrator privileges on your laptop. The step below for installing the gcloud-cli cask may fail without doing this first. If prompted for your password (or Touch ID), provide that accordingly.

Install gcloud-cli thusly:

brew install --cask gcloud-cli

Then, run this command to set up GCP Application Default Credentials:

gcloud auth application-default login

This will open a web browser and guide you through Google Cloud authentication. Be sure to use your jackhenry.com Google ID. We have command line tools that use the Google Could Secret Manager REST API, and Application Default Credentials are needed for making successful requests to that API.

2. Verify Azure Access

  • Open Azure DevOps Pipelines in a browser.
  • Verify you can see and navigate to the Banno Mobile iOS Deploy and Banno Mobile iOS Build pipelines.
  • If you don’t have proper access to Azure, contact the iOS Engineering Manager.

3. Setup FI Assets

4. Configure Azure DevOps API Access

  • Navigate to GitHub Tokens (classic).

    • Validate you have a token with the read:org and repo permissions. If you do not, create one.

  • Create an Azure DevOps personal access token.

    • The minimum level of access required is being able to read and execute builds. This can be achieved by checking the “Read & execute” box under the “Build” heading.
    • The expiration date is up to you.
    • Store the key locally. Putting it in your macOS login (not Local items) keychain is recommended. Without customization, the azdo-config.sh script referenced below will attempt to get the value of the azdo-token password item.

  • Using Keychain Access, create new password items for the following:

    Name and AccountValue
    azdo-tokenAzure DevOps PAT from above
    artifactory-keyqtebJ{74?<8Sm:)k

  • Download the azdo-config.sh file in the iOS team folder to your user directory /Users/{username}.

  • Edit the shell script with the following:

    • The value for BANNO_PROJECTS_DIR should be the directory where you keep your copy of banno-ios.
    • The value for ASSETS_FOLDER should be the directory where you cloned grip-assets.

  • Save your changes.