Instructions to upgrade to Flutter plugin version 2.0
Instructions to upgrade to Flutter plugin version to 2.0
-
Due to the upgrade of the native Android SDK the following requirements are upgraded as well
- CompileSDK is now increased to 33
- Required Kotlin version is increased to 1.8.0
-
The Error structure has been reworked:
- This causes some of the Error codes to be changed. The new codes can be found under the updated documentation Error handling. If you want to compare these to the old codes, those can be found here.
- Previously, iOS returned an object within the details property of a Platform Exception. This object has been slightly reworked, which causes some of its properties to be changed. The new structure, which is now also available for Android, can be found in Details Property
-
The Onegini.instance.userClient.registerUser function has been reworked
- Previously, two-step registration was partially implemented using the
openCustomTwoStepRegistrationScreen
event. This event has been replaced for theeventFinishRegistration
where the user now also needs to make use ofeventInitRegistration
as described in Handling Events. This will allow the use of custom registration as documented in Registration with Custom IdP.
- Previously, two-step registration was partially implemented using the
-
The Onegini.instance.userClient.fetchUserProfiles() function is now deprecated and replaced for Onegini.instance.userClient.getUserProfiles();
-
To support multiple registered UserProfiles some functions now require an additional parameter profileId to link the action to a specific UserProfile. The functions that require changes:
-
-
setPreferredAuthenticator and deregisterAuthenticator will now only set the preferred or deregister the authenticator of the currently authenticated user. Previously, it would allow the user to perform this action using the first registered user on a device.