Instruction for upgrading the Onegini Android SDK to version 10.0

Mobile authentication

The deprecated handleMobileAuthWithPushRequest(final RemoteMessage pushMessage, final OneginiMobileAuthenticationHandler mobileAuthenticationHandler) method has been removed. Please use handleMobileAuthWithPushRequest(final OneginiMobileAuthWithPushRequest request, final OneginiMobileAuthenticationHandler handler) instead.

The com.google.firebase:firebase-messaging is not used by the SDK anymore, therefore it was removed from it's dependencies. It is the app's responsibility to handle FCM as described in the "Mobile Authentication" topic guide

Migration from SpongyCastle to BouncyCastle

A third-party library called SpongyCastle has been replaced with BouncyCastle. SpongyCastle was an unofficial re-packaged version of BouncyCastle that was addressing some namespace issues on very old Android versions. Since those issues were solved on modern Android devices, the vanilla BouncyCastle dependency can be used.

If you use the same library in your project it is advised to update it as well:

  • Remove existing SpongyCastle dependencies: com.madgag.spongycastle:core com.madgag.spongycastle:prov com.madgag.spongycastle:bcpg-jdk15on com.madgag.spongycastle:bcpkix-jdk15on

  • Add two new BouncyCastle dependencies: org.bouncycastle:bcprov-jdk15on:1.64 org.bouncycastle:bcpg-jdk15on:1.64

Third-party libraries were updated

A couple of third-party libraries were updated, if you use the same libraries in your project it is advised to update them as well:

  • OkHttp library was updated to the version 3.12.6:

    com.squareup.okhttp3:okhttp:3.12.6
    com.squareup.okhttp3:okhttp-urlconnection:3.12.6
    com.squareup.okhttp3:logging-interceptor:3.12.6
    

    The Onegini SDK still maintains support for Android 4.x and thus could not use the latest version of the OkHttp library (3.13.x or 4.x) as it does not have support Android 4.x at this time.

  • Retrofit library was updated to the version 2.6.2:

    com.squareup.retrofit2:retrofit:2.6.2
    com.squareup.retrofit2:converter-gson:2.6.2
    com.squareup.retrofit2:adapter-rxjava2:2.6.2
    
  • RxJava library was updated the the version 2.2.15: io.reactivex.rxjava2:rxjava:2.2.15