This framework combines multipe functionalities provided by PACE i.e. authorizing via PACE ID or requesting and displaying Apps. These functionalities are separated and structured into different Kits by namespaces, i.e. IDKit, AppKit and POIKit.
The full documentation and instructions on how to integrate PACE Cloud SDK can be found here
The complete source code of the SDK can be found on GitHub.
PACECloudSDK currently supports Android 6.0 (API level 23) and above.
It uses the following dependencies:
In 3.0.0 we’ve introduced a universal setup method: PACECloudSDK.setup(context: Context, configuration: Configuration) and removed the setup for AppKit and POIKit.
The universal Configuration almost has the same signature as the previous AppKit Configuration, only the isDarkTheme parameter has been removed, which is now an enum instead of a Boolean and defaults to Theme.LIGHT. In case you want to change it, you can set it via AppKit’s theme property: AppKit.theme = Theme.LIGHT/Theme.DARK.
We’ve added two new AppCallbacks: getAccessToken and logout. The getAccessToken method replaces the invalidToken call. While its callback is equal to the invalidToken callback, we changed the response to be an object with an accessToken property and a new isInitialToken boolean.
The logout callback is used to handle the logout natively. Please refer to Native login, token renewal and logout for more information.
Also from now on this callback will only be sent if IDKit is not used/set up. If you’re using IDKit the SDK will now first try to renew the session automatically. If the renewal fails there is a new fun onSessionRenewalFailed(throwable: Throwable?, onResult: (String?) -> Unit) AppCallback that you may implement to specify your own behavior to retrieve a new access token. To implement this method pass an AppCallbackImpl instance to AppKit.openApps(...) or AppKit.openAppActivity(...) and override onSessionRenewalFailed. If either this method is not implemented or you didn’t pass an AppCallbackImpl instance at all the SDK will automatically perform an authorization hence showing a sign in mask for the user.
We’ve moved everything that belongs to the GeoAPI from AppKit/API to POIKit:
AppKit.isPoiInRange(...) call is now part of POIKit, available under POIKit.isPoiInRange(...)AppKit.requestCofuGasStations(...) calls are now part of POIKit, available under POIKit.requestCofuGasStations(...)cloud.pace.sdk.api.geo and cloud.pace.sdk.appkit.geo were moved to package cloud.pace.sdk.poikit.geoThe IDKit setup has been combined with the general PACECloudSDK setup:
IDKit.setup(...) is no longer accessible.OIDConfiguration has been added to the Configuration class of the PACECloudSDK.OIDConfiguration, the IDKit can not be used.OIDConfiguration needs to be initialized with at least the clientId and the redirectUri of your identity provider. You can also use the factory methods of the OIDConfiguration if you want to use another environment than production which is now set by default with the primary constructor.The PACECloudSDK.setup() has been simplified:
CustomOIDConfiguration has been added to the Configuration class of the PACECloudSDK.CustomOIDConfiguration, the IDKit can not be used.CustomOIDConfiguration needs to be initialized with at least the clientId and the redirectUri of your identity provider. All other properties in CustomOIDConfiguration can be additionally set if e.g. own identity provider endpoints are wanted.The connectedFuelingStatus property of the CofuGasStation is now nullable so that the Cofu gas station is not skipped in the cache loading if this property is absent in the API response.
If you use the CofuGasStation object, keep in mind that the connectedFuelingStatus property can now be null.
The GasStations properties paymentMethods, amenities, foods, loyaltyPrograms, postalServices, services, shopGoods and fuelType will now be from type string instead of enums. The client app has to then manage these values itself.
POIKit.getRegionalPrice(...) function now returns List<RegionalPrices> instead of the RegionalPrices typealias, which was List<RegionalPrice> before. This means that the only difference now is that the RegionalPrice model is called RegionalPrices and the RegionalPrices typealias no longer exists. The properties of the new RegionalPrices model are the same as those of the old RegionalPrice model.IDKit.userInfo method anymore, because it is automatically added to the request by the IDKit.UserInfoResponse model have changed to subject, zoneInfo, emailVerified, createdAt, locale and email. The old properties are outdated.Environment.STAGE environment completely. Please use Environment.SANDBOX during testing and Environment.PRODUCTION for everything else.NoSupportedBrowser exception which will now be returned from all IDKit.authorize(...) and IDKit.endSession(...) calls instead of crashing the app with an ActivityNotFoundException if no supported browser is installed and enabled to handle the Custom Tab intent. In this case, we show a Toast prompting the user to enable Google Chrome.IDKit.authorize(...) and IDKit.endSession(...) now return the Completion result instead of invoking a function parameter on result to make the calls synchronous.Here is a complete list of all our SDK API documentations: