Mobile Cloud Services JavaScript SDK for IBM Push for Bluemix
ATTENTION: This service is currently deprecated on Bluemix and will be completely removed shortly. Please use the 2nd generation of Bluemix MobileFirst Services.
This package contains the required native components to interact with the IBM Mobile Cloud Services for Bluemix. You can use the JavaScript SDK to build Web or Hybrid applications. You can also use this SDK in server-side Node.js JavaScript modules. The SDK manages all the communication and security integration between the client and the Mobile Cloud Services in Bluemix.
When you use Bluemix to create a Mobile Cloud application, BlueMix provisions multiple services under a single application context. Your mobile application is given access to the following mobile services: Mobile Application Security, Push, and Mobile Data.
Version: v1.0.0-20160421-1718
Install the SDK
You can install the SDK:
- By installing the individual components with Bower or NPM. Use these tools to shorten the startup time for new projects and lessen the burden of managing library version requirements and dependencies. If you are using one of the Mobile Cloud samples, instructions for using the package manager is included with the documentation.
- By downloading a zip file.
Get the SDK with NPM (Node.js)
NPM is included in current Node.js distributions. To install Node.js, go to Download Node.js.
Run the following command to install the ibmpush
package:
npm install ibmpush
Get the SDK for Web or Hybrid (Bower)
To install Bower, see Bower.io.
Run the following command to install the ibmpush
package:
bower install https://hub.jazz.net/git/bluemixmobilesdk/ibmpush-javascript/.git
Download zip file
To download a zip of the entire SDK, see Building Mobile Cloud applications.
SDK modules
The complete SDK consists of a core, plus a collection of modules that correspond to function that is included in the Mobile Cloud Services.
The downloaded zip file contains all of these components. However, each piece of the JavaScript SDK is also available as a separate module that you can add to your project individually so that you can choose the modules that are required for your application.
- ibmbluemix : SDK foundation, and controls connection and communication with back end services
- ibmpush - Service SDK for Push
- ibmdata - Service SDK for Mobile Data
- ibmfilesync - Service SDK for cloud file storage with Mobile Data
- ibmcloudcode - Service SDK for cloud code invocation
- ibmlocation - Service SDK for the beta mobile location services
- docs/ - Documentation for the SDK
Get started
Services are associated with a Mobile Cloud application. Connectivity and interaction with these services depends on the application ID, application secret, and application route that is associated with a Mobile Cloud application.
The IBMBluemix
module is the entry point for interacting with the Mobile Cloud Services SDKs. You must invoke the initialize
method before any other API calls. IBMBluemix
provides information about the current SDK level and access to service SDKs.
An example of initializing the Mobile Cloud Services SDK and Push follows:
var config = applicationId:"<ApplicationID>" applicationRoute:"<ApplicationRoute>" applicationSecret:"<ApplicationSecret>";IBMBluemix;var push = IBMPush;
Learn more
- Getting started with Push
- Mobile Cloud Services SDK Developer Guide
- Samples and Tutorials
- Bluemix Developers Community
- Connect with Bluemix: Twitter | YouTube | Blog | Facebook | Meetup
Licensed Materials - Property of IBM (C) Copyright IBM Corp. 2013, 2015. All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.