Example app for Bluemix iOS push notification
Switch branches/tags
Nothing to show
Clone or download
Latest commit 5947f79 Jun 28, 2018
Failed to load latest commit information.
HelloPush added new sample Jun 28, 2018
.gitignore Adding .gitignore for Pods Oct 29, 2015
LICENSE Initial commit Oct 27, 2015
README.md updated the doc for new app Jun 28, 2018


iOS helloPush Sample Application for IBM Cloud Push Notifications Service

This iOS helloPush sample contains an Swift project that you can use to learn more about the IBM Cloud Push Notification Service.



  • iOS 8.0+
  • Xcode 9.3 (9E145)
  • Swift 4.1

Before you start, make sure you have the following:

Create an instance of IBM Cloud Push Notifications Service

  • Create an instance of IBM Cloud Push Notifications Service and configure it .

Download and setup the sample

  • Clone the sample from Github with the following command:

      git clone https://github.com/ibm-bluemix-mobile-services/bms-samples-swift-hellopush.git

Setup cocoapods or carthage

Navigate to the HelloPush folder and do the following,

Cocoa Pods
  1. If the CocoapPods client is not installed, install it using the following command: sudo gem install Cocoapods
  2. If the CocoaPods repository is not configured, configure it using the following command: pod setup
  3. Run the pod install command to download and install the required dependencies.
  4. Open the Xcode workspace: HelloPush.xcworkspace . From now on, open the xcworkspace file since it contains all the dependencies and configuration.
  5. Open the BMSPushRegister.swift and add the IBM Cloud push notification service credentials
let cloudRegion = BMSClient.Region.usSouth
let pushAppGUID = "27ee87ce-ed4c-4167-XXXX-XXXXXXX"
let pushClientSecret = "813a430f-XXXXX-XXXXXX-b8e0-XXXXXXXXX"
let userId = "David"
let customeDeviceId = "DavidmobiledeviceId"
let pushVariables = ["username":"David","accountNumber":"3564758697057869"]

Modify the options code in the sample

Check the getPushOptions() method in BMSPushRegister.swift and add the options you need.

Run the sample app

For push notifications to work successfully, you must run the helloPush sample on a physical iOS device. You will also need a valid APNs enabled bundle id, provisioning profile, and development certificate.

When you run the application, you will see a single view application with a "Register for Push" Switch. When you click this switch the application will attempt to register the device and application to the Push Notification Service. The app uses an text view to display the registration status (successful or failed).

Now, switch over to the IBM Cloud Push Notifications service and open the service dashboard. Navigate to 'Send Notifications' and send a notification. You could either send a broadcast notification or a notification targeted to iOS platform so that a notification is sent to the helloPush Swift application. When a push notification is received and the application is in the foreground, an alert is displayed showing the notification's content.

Samples and videos

======================= Copyright 2016 IBM Corp.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.