Prepare eSIM Installation

Check for eSIM capable device

First, you need to check if the device is eSIM capable.

This query may take some time to complete.

Gigastore.isEsimCapable { isCapable ->
    Log.i("GigastoreSDK", "isCapable: $isCapable") 
}

If a "false" is returned from the query despite the following criteria being met:

• Your device is eSIM capable

Then there is likely another problem.

If this problem persists, don't hesitate to contact [email protected]

The isEsimCapable method can be used to check whether the user's device is eSIM capable or not.

Activate Inventory Item using API

Implementation changed with SDK version 1.1.

To install an eSIM, an inventory item must first be activated using the Gigastore API on your server. For more information, refer to the First PackageAPI documentation.

Use the esimProfile.uid parameter of the API response and transfer it securely to your app.

Retrieve the profile

Use the getProfile method with the created profile uid to fetch all needed profile data. The method will return a profile you can install in the next step using Install Profile.

val profileUID = "123456-abcde-abcde-789" // from API
Gigastore.getProfile(CONTEXT_PLACEHOLDER,
                     profileUID) { profile, error ->
    Log.i("GigastoreSDK", "PreparedProfile: $profile)
    Log.i("GigastoreSDK", "error: $error")
})

Make sure to replace CONTEXT_PLACEHOLDER with your current Activity or Application context.