iOS Developer Documentation

📘

Objective

To provide an iOS App Developer with an overview of the information required to implement the Bubbl Plugin into an existing app written in Objective-C or Swift.

📘

Audience

iOS App Developer

Versions

Bubbl iOS Plugin Version: 2.0.10
iOS Version: 14.0

Prerequisites

A Bubbl Dashboard account must be setup for the app prior to integrating the Bubbl Plugin into your app. If you haven't already done so you can register here.

Bubbl API Key

To integrate the plugin with your app, you will need a unique API Key and API URL.

You will find your API_KEY on the Bubbl Dashboard Company page.

The API URL is: https://mobilegateway.bubbl.tech

iOS Push Notifications

An iOS Push Certificate is needed to send Push Notifications to a device. A valid Production Push Certificate must be uploaded on SDK Configurations page on the Bubbl Dashboard, then select the IOS Certificate tab.

📘

How to create an iOS Push Notification Certificate

See our How to create an iOS Push Notification Certificate guide.

🚧

Sandbox Push Notification Certificate

If you require the use of a Sandbox Push Notification Certificate to receive push notifications while running your app inside XCode please contact our support team.
Note: this method can be unreliable.

👍

Testing

We recommend IPA or TestFlight build for testing.

Device Tokens

When creating device tokens to register for push notifications, do not convert the token to hex, the token should be passed without conversion.

Notification Limits

The SDK Configurations page has an option to limit the number of notifications presented on a device; during testing you may need to increase this value.

Respecting your app users

The Bubbl Plugin can be configured to respect app users by restricting notification features when a device's battery reached a lower limit, this can be set on the SDK Configurations page.