GAEN iOS Mobile Builds

Owned by Art Gibson
Last updated: Feb 13, 2021 by Arthur Gibson
3 min read

This page will provide details on how to prepare builds for the iOS GAEN Mobile App to allow development and distribution with GAEN entitlements.

Prerequisites: Please submit the following form through Apple to enable GAEN entitlements on your App Store account: https://developer.apple.com/contact/request/exposure-notification-entitlement

Setting up App, Build Profiles for Development and Public Distribution:

Setting up an App:

Via App Store Connect, create an app, bundle id, and development and provision profiles for GAEN entitlements with the steps below. This needs to be done by a user with at least “App Manager” privilege.

  1. Create an App on the App Store i.e. “PathCheck App”

  2. Create a bundle id for the app. i.e. “org.pathcheck.region_code.bt”

  3. Ensure you have a Apple Developer Certificate and Distribution Certificates via Developer Portal.

  4. Create Development, Adhoc and AppStore Distribution profiles. (See Generating Profiles)

  5. Open Xcode and add your bundle identifier, load your Development Profile and enable Push Notifications, Associated Domains via Capabilities tab. See: Identifiers

Generating Profiles:

Prerequisites: This assumes you have a Development and Distribution Certificate setup for your account with “Push Notifications” (SSL Cert not required), “Associated Domains” enabled. Certificate create steps are not covered in the documentation. See: Developer Portal

Create the following profiles below to start building the GAEN mobile app for development and public release. You will need to add developer device ids to the Development and Adhoc profile in order to run the app with GAEN permissions locally. Once on TestFlight this is not a requirement.

  • Development Provisioning Profile (with devices attached, see instructions below)

  • Adhoc Provisioning Profile Signed for Distribution (with devices attached, see instructions below)

  • AppStore Provisioning Profile Signed for Distribution
     

Instructions to generate profiles for the bundle id via the Apple Developer Portal:

  1. Add your developer device UDIDs to devices list https://developer.apple.com/account/resources/devices/list 

  2. Create a iOS App Development Provisioning Profile for your bundle id with Exposure Notification entitlements:

    1. During generation add devices from Step 1 to profile

  3. Create 1 Adhoc Provisioning Profile for your bundle id signed for Distribution.

    1. During generation add devices from Step 1 to profile.

  4. Create 1 AppStore Provisioning Profiles for your bundle id signed for App Store distribution with Exposure Notification Entitlements.

  5. For Automated build setup: save the .p12 file containing certificate + private key used to sign the Adhoc and AppStore Provisioning distribution profiles. (generated from the Keychain access app by exporting the cert + private key as a .p12)



Full Entitlement List for App:

Development:

Production/Distribution: