Oracle Help Center | Oracle Push Cloud Service (Standalone) title

Upgrade Guide

This topic contains the information you need to upgrade your mobile app to the latest Oracle Push Cloud Service SDK, starting with the 2.10.7 SDK through the most current release.

We also recommend that you review the "Release Notes" and "Change Log" files in the Android Push IO Manager project on GitHub. These files contain SDK upgrade information and updates to the step-by-step setup instructions that may not have made the publication deadline for this document.


PushIO SDK 6.29.1 to 6.31

The sections below provide information about migrating your mobile application from using the 6.29.1 SDK to the 6.31 SDK. Please refer to the ChangeLog for a list of fixed issues and updates. We recommend that customers use the latest SDK version, but there is no need to upgrade if the SDK updates are not applicable for your mobile app.

Minimum Android SDK Version

PushIO SDK now requires a minimum Android SDK version of 14 (Ice Cream Sandwich). Update the build.gradle file as follows:

    android {
        defaultConfig {
            minSdkVersion 14
       }
    }

GCM Update

The internal GCM implementation has been updated to not conflict with other libraries using GCM within your app.

As part of this change, you are required to declare the following services inside the <application> element in the AndroidManifest.xml file.

<application>
    .
    .
    .
    <service android:name="com.pushio.manager.PIOGCMRegistrationIntentService"
            android:exported="false"/>
    <service
            android:name="com.pushio.manager.PIOInstanceIDListenerService"
            android:exported="false">
      <intent-filter>
           <action android:name="com.google.android.gms.iid.InstanceID" />
      </intent-filter>
    </service>
    .
    .
    .
</application>

Also, as part of this update, the following libraries are now required in the dependencies section of your modules' build.gradle file.

dependencies {
    compile 'com.google.android.gms:play-services-location:10.2.0'    
    compile 'com.google.android.gms:play-services-gcm:10.2.0'
}

PushIO SDK 6.29.0 to 6.29.1

No specific steps are required to migrate from 6.29.0 to 6.29.1.


Push SDK Version Numbering Change

Starting in August 2016, the Oracle Push Cloud Service SDK version numbering scheme will change from 2.13.x to 6.29.x. This change aligns the SDK version number with that of its parent product. The latest SDK release for Android is always available from the PushIOManager_Android SDK download page.

No specific steps are required to migrate from 2.13.6 to 6.29.0.


PushIO SDK 2.12.0 through 2.13.6


PushIO SDK 2.11.1 to 2.12.0

It is now possible to include only the part of Google Play services library that support GCM and location. So, if you had previously added the complete Google Play services library then replace this line in build.gradle,

    compile 'com.google.android.gms:play-services:6.5.87'

with this line,

    compile 'com.google.android.gms:play-services-location:6.5.87'

PushIO SDK 2.11.0 to 2.11.1

No specific steps required to upgrade from 2.11.0 to 2.11.1


PushIO SDK 2.10.7 to 2.11.0