Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page will provide details on how to build prepare builds for the iOS GAEN Mobile App for 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 Release: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)

    • .p12 file containing the cert and private key used to sign the Adhoc Profile (this can be generated from the Keychain access app by exporting the cert + private key as a .p12)

    • Save password for .p12

  • p12

    AppStore Provisioning Profile Signed for Distribution

  • .p12 file containing the cert and private key used to sign the AppStore Profile (this can be generated from the Keychain access app by exporting the cert + private key as a .p12)

  • Save password for .


     

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

  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 with the following 5 for your bundle id with Exposure Notification entitlements:

    Image RemovedImage Added
    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 and APS entitlements.

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



Full Entitlement List for App:

Development:

...

Production/Distribution:

...