Instructions to upgrade to iOS SDK version to 5.02

When upgrading from an older SDK version to version 5.02, several changes have to be applied in your application.

Although it is still possible to use the old API's we recommend to update to the new API's since the old ones will be removed in the next big update of the SDK.

Deprecated API's

ONGUserClient

  • handleApplicationURL: ==> respondWithURL:challenge: method of id<ONGRegistrationRequestChallengeSender> object provided by the ONGRegistrationRequestChallenge
    Registration redirect URL can now be passed to the sdk using id<ONGRegistrationRequestChallengeSender>, which makes handleApplicationURL: obsolete.

ONGRegistrationDelegate

  • userClient:didReceiveRegistrationRequestWithUrl: ==> userClient:didReceiveRegistrationRequestChallenge:
    The URL is passed within ONGRegistrationRequestChallenge object. It also provides sender object used to respond with redirect URL or to cancel registration.

ONGClientBuilder

  • setUseEmbeddedWebView ==> No longer required.
    Onegini SDK no longer distinguishes how registration request URL is handled.

ONGPublicCommons

  • ONGCloseWebViewNotification ==> No longer required. Called only if setUseEmbeddedWebView was set to YES.
    Onegini SDK no longer distinguishes how registration request URL is handled. If registration request URL was handled by within UIWebView, it could be closed as soon as you send response to ONGRegistrationRequestChallengeSender or when you receive userClient:didReceivePinRegistrationChallenge: on your ONGRegistrationDelegate.