Instructions for upgrading the Onegini Android SDK to version 12.0
Third party library updates
With update of androidx.core-core
library into version 1.12.0
update ofcompileSdk
and targetSdk
is needed on the side of customer app.
Added Androidx Biometric version 1.1.0:
androidx.biometric:biometric:1.1.0
Stateless registration
With new feature added into the app, in order to be able to use stateless registration developers need to:
- Export new config from the backend. No changes needed, just download recent version once again. It contains new necessary fields.
- Download 5.3.0 SDK configurator version.
- Apply new config using SDK configurator.
New biometric authentication
We decided to deprecate old fingerprint authentication and all classes related and remove it in the future major release. This will give you time for migration to biometric authentication based on Android BiometricPrompt
.
One important change that has to be done even if you are not planning to migrate right away is to change all occurrences of OneginiAuthenticator.FINGERPRINT
to OneginiAuthenticator.BIOMETRIC
as we renamed it to better reflect the new possibilities.
New biometric authentication changes the user experience, but the way refresh token is stored on the device stays the same. Thanks to that users with registered fingerprint/biometric authenticator won't have to register it again after the update.
Third-party libraries were updated
A third-party library was updated, if you provide the SDK as an aar archive please update the dependency in your project:
OkHttp library was updated to the version 4.12.0
com.squareup.okhttp:4.12.0
Dagger library was updated to the version 2.49.0
com.google.dagger:dagger:2.49.0
RxJava library was updated to the version 3.1.6
io.reactivex:rxjava3:rxjava:3.1.8
Androidx SQLite library was updated to the version 2.4.0
androidx.sqlite:sqlite-ktx:2.4.0
SQLCipher library was updated and renamed to the version 4.5.5
net.zetetic:sqlcipher-android:4.5.5
Androidx core library was updated to the version 1.12.0
androidx.core:core:1.12.0