Enable Direct Installation

A direct installation allows users to install an eSIM on their iOS device without a QR code. Direct installations provide the smoothest experience for installing an eSIM.

To enable the direct installation on an iOS device, please make sure to perform these steps on your Xcode project:

1. Request the Direct Installation at DENT and follow the process

2. Once approved, proceed with the technical integration

The Direct Installation feature is not available for these kind of apps: - eSIM Marketplace apps - Apps from Mobile (Virtual) Network Operators - VPN apps

Request Direct Installation

To download a DENT eSIM in your app through Apple’s eSIM API, we need to register your app.

To start this process, please submit a request here.

Once the request has been received, we will schedule your request and guide you through the process.

Be aware that the entire process can take several weeks. Once approved, you can start with the technical integration.

Technical Integration

Info.plist and Entitlements

Your Info.plist and your <TargetName>.entitlements must be extended.

Please make sure that you have an entitlements file in your project/target.

An additional build phase will take care of the update of your Info.plist and the entitlements file:

Add Build Phase

"'PATH_TO_THE_SDK'/DENTGigastoreSDK.xcframework/Scripts/Run.sh" \
"${PROJECT_DIR}/${INFOPLIST_FILE}" \
"${PROJECT_DIR}/PATH_TO_THE_ENTITLEMENTS/<TargetName>.entitlements"

• In the tab bar at the top of the window, open the "Build Phases" panel.

• Above the "+" icon, add a "New Run Script Phase".

• Add this line with the path to the SDK script, the path to your Info.plist, and the path to your <TargetName>.entitlements file.

Provisioning Profile

For using Direct Installation you need to create a provisioning profile with "eSIM entitlements" enabled. To do so, please follow these steps:

1. Log in to your Appstore Developer portal
2. Start the assistant to Register a new provisioning profile for the type of build
3. Select the needed App ID, certificate, and devices for your app

4. Select "eSIM Development" in the "Additional Entitlements" section (See screenshot below)

If this screen is not visible to you, please make sure you followed the process for enabling the direct installation with DENT already.

If the process was done and you still don't see the profile, please double-check the Team ID on the top right with the Team ID mentioned in your request.

Manual Signing

Apple only supports manual signing when using eSIM entitlements.

In case you're using Automatic Signing you need to update your project.

If you are unfamiliar with Manual Signing, please check the Apple Developer documentation. Make sure you manually create the provisioning profile that supports your test devices and your correct App ID.