0. Distribution Setup

First, create the apps on their respective distribution portals, and get the API keys to allow the CI to authenticate with them. (Complete instructions for retrieving the keys can also be found here https://docs.fastlane.tools/actions/supply/)

iOS

  1. Create the new app on Appstore Connect.

    <aside> 💡 You can create the app using the following fastlane command fastlane produce -u user@apple.com -a app.identifier

    </aside>

  2. Obtain an Appstore Connect API Key

    1. Visit https://appstoreconnect.apple.com/access/api
    2. Select App Store Connect API on the left panel, under Key Type.
    3. Click Request Access and select Submit on the new popup.
    4. Click Generate API Key.
      1. Name can be mobile-app or anything else.
      2. The Access role must be set to App Manager.
    5. Click Download API Key to obtain the .p8 file (don't change the file name).
    6. Copy the Issuer ID from the top of the page.
    7. Send both the API Key file and Issuer ID back to us.

  3. Save the API Key in 1password.

Android

  1. Create the Firebase project and Enable App Distribution.
  2. Obtain a PlayStore Console API Key
    1. Open the Google Play Console
    2. Click Account Details, and note the Developer Account ID listed there
    3. Click Setup → API access
    4. Click the Create new service account button
    5. Follow the Google Cloud Platform link in the dialog, which opens a new tab/window:
      1. Click the CREATE SERVICE ACCOUNT button at the top of the Google Cloud Platform Console
      2. Verify that you are on the correct Google Cloud Platform Project by looking for the Developer Account ID from earlier within the light gray text in the second input, preceding .iam.gserviceaccount.com. If not, open the picker in the top navigation bar, and find the one with the ID that contains it.
      3. Provide a Service account name and click Create (example name: “PlayStore Release CI”). ****
      4. Click Select a role, then find and select Service Account User, and proceed
      5. Click the Done button
      6. Click on the Actions vertical three-dot icon of the service account you just created
      7. Select Manage keys on the menu
      8. Click ADD KEY -> Create New Key
      9. Make sure JSON is selected as the Key type, and click CREATE
      10. Save the file on your computer when prompted and remember where it was saved to
    6. Return to the Google Play Console tab, and click DONE to close the dialog
    7. Click on Grant Access for the newly added service account at the bottom of the screen (you may need to click Refresh service accounts before it shows up)
    8. Choose the permissions you'd like this account to have. We recommend Admin (all permissions), but you may want to manually select all checkboxes and leave out some
    9. Click Invite user to finish

1. Setup Fastlane

Run fastlane init with custom/empty configuration on each android and/or ios project folder.

iOS:

  1. Create the app on Appstore Connect

  2. Add all the files from the Fastlane repository example folder:

    https://github.com/levin-riegner/fastlane/tree/master/example/ios

  3. Configure the .env files with your project variables.

    https://developer.apple.com/account

  4. Get the new API Keys from the Appstore Connect API by following the instructions at the beginning of the page.

Android

Internal Testing

  1. Add all the files from the Fastlane repository example folder:

    https://github.com/levin-riegner/fastlane/tree/master/example/android

  2. Configure the .env files with your project variables.