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.
Create an App on the App Store i.e. “PathCheck App”
Create a bundle id for the app. i.e. “org.pathcheck.region_code.bt”
Ensure you have a Apple Developer Certificate and Distribution Certificates via Developer Portal.
Create Development, Adhoc and AppStore Distribution profiles. (See Generating Profiles)
Open Xcode and add your bundle identifier, load your Development Profile and enable Push Notifications via Capabilities tab.
Generating Profiles:
Prerequisites: This assumes you have a Development and Distribution Certificate setup for your account with “Apple Push Notification service SSL” 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:
Add your developer device UDIDs to devices list https://developer.apple.com/account/resources/devices/list
Create a iOS App Development Provisioning Profile for your bundle id with Exposure Notification entitlements:
During generation add devices from Step 1 to profile
Create 1 Adhoc Provisioning Profile for your bundle id signed for Distribution.
During generation add devices from Step 1 to profile.
Create 1 AppStore Provisioning Profiles for your bundle id signed for App Store distribution with Exposure Notification Entitlements.
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)