18.104.22.168 and Later¶
Changed package names¶
All public entities are now located in the
The Tapkey service factory (and the Tapkey service factory builder) have been reworked to provide a simpler interface. All changes can be found in the table below.
|Before 22.214.171.124||From 126.96.36.199 on|
|BleLockManager||BleLockScanner + BleLockCommunicator|
The BleLockManager class has been split into two separate components: A BLE lock scanner and a BLE lock communicator.
The BLE lock scanner (
com.tapkey.mobile.ble.BleLockScanner) provides means to
scan for Tapkey locks via BLE. It can be used to scan for nearby locks and to
determine whether a specific lock is nearby. Use TapkeyServiceFactory to
retrieve an instance of BleLockScanner. Background scanning has been removed
The BLE lock communicator (
provides means to communicate with Tapkey locks via BLE. It can be used to send
commands to locks. Use TapkeyServiceFactory to retrieve an instance of
The key manager's interface has been simplified and only offers two methods:
queryLocalKeysAsync(String userId, boolean forceUpdate, CancellationToken cancellationToken)
Users and UserManager¶
Authentication has been reworked in the 188.8.131.52 release. The SDK no longer
handles users as complex objects. All methods that returned a User are now
returning a String with the user's ID. All parameters that accepted a User are
now accepting a String with the user's ID. Furthermore, authentication is no
longer a part of the mobile SDK. Instead, the SDK takes a Tapkey access token
to "log in" a user to the SDK instance on the present device. The reworked
user manager (
com.tapkey.mobile.manager.UserManager) essentially provides the
following two methods
logInAsync(String accessToken, CancellationToken cancellationToken)
logOutAsync(String userId, CancellationToken cancellationToken)
to handle user login and logout. This means that implementors have to obtain a Tapkey access token on their own, using one of the OAuth grant types supported by Tapkey. In most cases, this will be the Token Exchange grant type.
The SDK uses the token refresh handler
com.tapkey.mobile.auth.TokenRefreshHandler) to request a new access token
from the implementing application. The token refresh handler is passed to the
PushNotificationReceiver has been renamed to
The Tapkey service factory builder exposes a new setter that accepts a token refresh handler as described above.
The new support manager exposes a method that will return information about the current SDK state that can be used for troubleshooting. Note that the information returned might contain sensitive data.