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
orTestFlight
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.
Updated over 1 year ago