1.7.3 - 2020-11-24


  • DEV-1976: Provide a compatability copy method for NearbyPostBox.

1.7.2 - 2020-11-09


  • TSUP-483: provide externalIdentifier property for class BookableUnit to let the app filter bookings that are not of type locker.

1.7.1 - 2020-11-06


  • TSUP-321: Catch rare IncompatibleClassChangeError exception that happens on some devices (Sony, Samsung) on Android 5 and 6.
  • DEV-1874: Do early check for properties baseUrl and certificate in SmartSpacesSdk.Builder. They can break dependency injection, when a required instance can not be created because of a malformed parameter. And the resulting Stacktrace can be misleading here.

1.7.0 - 2020-09-29


  • Remove the Result wrapper in AuthenticationController. Now you get a Flow<QrCode>.
  • DEV-1647: Update jsonapi-converter to 0.10
  • DEV-1298: In BookingManager.getBookings(), make ‘to’ parameter optional. (Note: Backend is pre-sorting bookings by startsAt).
  • DEV-1241: Update Gatt exception messages (to be more clear on the backend).

1.6.1 - 2020-09-09


  • Use shortened pkaId (12 characters - without underscores).


  • Fix crash with Ble scanner.
  • Fix crash when trying to unregister BroadcastReceiver that was not registered before.

1.6.0 - 2020-08-14

This versions includes a refactoring of the Bluetooth scanner, supporting now Coroutines. It also provides new PostBoxController that scans for nearby MyRenz boxes and opens them.


  • BookingManager has a new function getBookableParameters().
  • PostBoxController offering open() and getNearbyPostBoxes() functions .


  • Renamed LetterBoxController to PostBoxController.
  • BookingManager getSchedules(unitId: String) does not return Result<Schedule> but Result<Paged<TimePeriod>> instead.
  • Removed com.sensorberg.smartspaces.domain.schedule.Schedule. List of TimePeriod and BookableParams are delivered separately.


  • Refactor Bluetooth Scanner, supporting Coroutines.

1.5.3 - 2020-07-02

  • Added: LetterBoxController to open a letter box. This Api experimental and will change in future!

1.5.2 - 2020-06-25

  • Changed: (DEV-950) When Ble opening fails send the error message that is displayed to the user (incl. error code) to the backend.

1.5.1 - 2020-06-19

  • Fixed: (TSUP-124) Bluetooth based opening lead to constant invalid checksum errors

1.5.0 - 2020-06-10

  • Added: query() to GraphQl which lets you execute your custom queries.
  • Added: Result.Error has now a list of Exception which gives more information by printing StackTraces.
  • Added: to BookingManager:
    • getBookings return your bookings with page information.
    • getBookableUnits() return bookable units with page information.
    • getSchedules() gives you the already booked times of a unit.
    • removeBooking() removes a booking with a given ID.
    • createBooking() creates a booking.
  • Added: getRootUnits() to UnitController that gives you all root units.
  • Changed: SmartSpacesSdk.refresh() does not longer expect a vararg. You can either pass a single Refresh or a List<Refresh>.
  • Changed: Renew Authentication Token when its older than 24 hours.
  • Changed: Move com.sensorberg.smartspaces.sdk.model.TimePeriod to com.sensorberg.smartspaces.domain.schedule.TimePeriod.
  • Changed: Remove booking id field from TimePeriod.
  • Changed: Result.onError() gets called with List<Throwable> instead of Result<Error>.
  • Changed: Result.onSuccess() gets called with data of type T instead of Result<Success>.
  • Changed: Result.onLoading() gets called without any parameter instead of Result<Loading>.
  • Deprecated: createBookingLiveData()
  • Deprecated: getMyBookingsLiveData()
  • Deprecated: getSchedulesLiveData()
  • Deprecated: endBookingNowLiveData()
  • Deprecated: deleteBookingLiveData()

1.4.0 - 2020-02-19

  • Added: AuthenticationController that gives you way(s) to authenticate yourself. At the moment it only provide QrCodes.
  • Changed: BookableParams of type Long are now nullable - in case they are not set on the Backend.
  • Changed: Result has now subtypes Loading, Success or Error.
  • Changed: Clients of the SDK must add maven { url "" } repository url to their build.gradle.
  • Changed: Renamed functions in UserManager, BookingManager and UnitController that return LiveData.
  • Deprecated: IotDeviceController.getStatusLiveData(), will be removed from SDK soon
  • Fixed: When trying to login while you already logged in successfully, you will get an IllegalStateException. This prevents having the SDK in a wrong state.
  • Fixed: Publish Kotlin Sources and documentation so they are available in your IDE.

1.3.1 - 2020-01-14

1.3.0 - 2020-01-09

  • Changed: If network fails and only cached data was available the response status will be Response.Status.SUCCESS instead of Response.Status.FAIL.
  • Changed: Increase booking scheduling time frame from 2 to 6 weeks
  • Removed: Testing Module containing TestSdk
  • Added: Support for Kotlin Coroutines. For clients that are not able to use Kotlin Coroutines alternative methods with a callback parameter are provided.
  • In IotDeviceController
    • Changed: getIotDevices() renamed to getIotDevicesLiveData()
    • Changed: execute() renamed to executeLiveData()
    • Changed: getStatus() renamed to getStatusLiveData()
    • Deprecated: getIotDevicesLiveData(), will be removed soon from the SDK
    • Deprecated: executeLiveData(), will be removed soon from the SDK
  • In GraphQl
    • Changed: query() renamed to queryLiveData()
    • Changed: mutate() renamed to mutateLiveData()
    • Deprecated: queryLiveData(), will be removed soon from the SDK
    • Deprecated: mutateLiveData(), will be removed soon from the SDK

1.2.9 - 2019-10-28

  • Changed: GraphQl caching age is controlled by backend

1.2.8 - 2019-10-24

  • Changed: Updated to latest blue-id SDK
  • Changed: Improve blue-id time-sync
  • Fixed: Blue-id battery status handling

1.2.7 - 2019-10-02

  • Changed: Improved logout process, avoid leaked objects
  • Changed: Improved devices removal from nearby list
  • Changed: Preset GraphQL cache expiration

1.2.6 - 2019-09-24

  • Added: BookableParameters to IotUnits
  • Removed: Deprecated NfcHandler. There are no gateways with NFC tags anymore.

1.2.5 - 2019-09-18

  • Added: GraphQl interface
  • Added: Caching layer to GraphQl queries - 2019-09-23

  • Fixed: NullPointerException handling bad formatted NFC data-packs

1.2.4 - 2019-09-11

  • Changed: Update and organization of internal dependencies

1.2.3 - 2019-08-30

  • Fixed: Timber crash when network connection fail

1.2.2 - 2019-08-30

  • Fixed: Change password error message, when operation fail

1.2.1 - 2019-08-29

  • Fixed: GraphQl pooling logic

1.2.0 - 2019-08-23

  • Changed: Updated to Koin 2.0
  • Added: Support for IotDevices using IotDeviceController
  • Added: Locker cluster
  • Deprecated: IotDeviceRequest. Renamed to DeprecatedIotDeviceRequest. Instead use IotDeviceController
  • Deprecated: IotDeviceState. Renamed to DeprecatedIotDeviceState. Instead use IotDeviceController
  • Deprecated: IotDevice. Renamed to DeprecatedIotDevice. Instead use IotDeviceController

1.1.8 - 2019-08-02

  • Fixed: Rare crash on backend response parser
  • Fixed: Uninitialized unit controller status

1.1.7 - 2019-06-20

  • Added: GraphQl Apollo support
  • Fixed: Threading issue on bluetooth connection

1.1.6 - 2019-05-23

  • Changed: Lower Timber.e to Timber.w for catched exceptions

1.1.5 - 2019-05-21

  • Fixed: rare crash on statistics calculation

1.1.4 - 2019-05-16

  • Added: IotUnit debug screen
  • Added: Detekt checks and fixes
  • Fixed: Login process was not changing status to Initializing

1.1.3 - 2019-05-03 (internal release)

  • Fixed: Proguard rules

1.1.2 - 2019-05-02 (internal release)

  • Added: Improved handling of Actuator request and Statistics post.
  • Changed: Updated Gradle Plugin to 3.4.0 and Gradle to 5.1.1
  • Fixed: On rare cases opening process stuck.
  • Fixed: On rare cases backend does not receive actuator request

1.1.1 - 2019-04-18

  • Fixed: Dealing properly when backend sends same actuator in different units

1.1.0 - 2019-04-17

  • Added: NfcActivity, see docs for implementation
  • Added: backendUnitType field to IotUnit class
  • Added: DebugActivity
  • Removed: AbstractNfcActivity
  • Changed: Improved logout handling
  • Changed: Improved NFC handling

1.0.5 - 2019-04-09

  • Fixed: SDK initialize forever when no connection.
  • Changed: Make IotUnit unitId and actuatorId public

1.0.4 - 2019-04-08

  • Fixed: Case when UnitController not scaning for devices, would report as ready, even if bluetooth or location was off.
  • Fixed: Different booking requests and parsing for lockers and doors.
  • Changed: Improved blue-id scan detection on debugGetBlueIdDetails
  • Fixed: Blue-id battery -1 on debugGetBlueIdDetails

1.0.3 - 2019-04-02

  • Fixed: Unit Controller would get stuck on busy when ble fail on a ble-only unit.
  • Fixed: availableNow not properly processed.

1.0.2 - 2019-03-26

  • Changed: calls to do not throw Exception anymore if the controller is not ready. It will return a with an IllegalStateException parameter

1.0.1 - 2019-03-21

  • Fixed: ProGuard rules with new smartspaces package.

1.0.0 - 2019-03-20

  • Changed: renamed from smartworkspace to smartspaces.
    This change affects the maven artifacts, package and class names.

0.11.6 - 2019-03-19

  • Fixed: Executing state of getSchedules() not reporting properly.

0.11.5 - 2019-03-15

  • Fixed: A few different rare crash events.

0.11.4 - 2019-03-13

  • Changed: clean-up, removing unused IotUnit.Types

0.11.3 - 2019-03-13

  • Changed: improve usage of cached data
  • Fixed: IotUnit matching on schedules call

0.11.2 - 2019-03-12

  • Changed: extracted CancellationSignal to its own class

0.11.1 - 2019-03-11

  • Fixed: Backend endpoint changes
  • Changed: refresh() can receive multiple parameters.

0.11.0 - 2019-03-11

  • Changed: API changes on the SDK interface.
  • Added: Added TapController and UserManager
  • Changed: now receives an optional CancellationSignal and returns a normal LiveData with the execution status.
  • Changed: refresh() method accepts optional Refresh enum to include what’s to be refreshed.
  • Changed: Test implementation now is on a separate maven artifact.

0.10.1 - 2019-03-06

  • Changed: Changed to WorkManager 1.0.0.

0.10.0 - 2019-02-28

  • Changed: Moved the whole project to JetPack (androidx) package naming.
  • Fixed: All the internal calls on the SDK now goes through background threads.

0.9.2 - 2019-02-26

  • Fixed: Bluetooth scanning crash when enabling/disabling bluetooth radio

0.9.1 - 2019-02-18

  • Fixed: Bookings id matching

0.9.0 - 2019-01-24

  • Added: Get blue-id details method. This call also fixes blue-id clock if needed
  • Fixed: Crash during logout.
  • Changed: Better handling of encryptiong failure
  • Changed: getUnits() Proximity have been removed in favour of Sorting. Sorting.None is the same as Proximity.All. Sorting.Distance orders the units from closest to furthers, including all the out-of-range IotUnits. The call IotUnit.isNearby() should be used to check if unit is in range or not.

0.8.0 - 2018-12-18

  • Changed: Simplified SDK status. This is a breaking API change. Check the documentation
  • Changed: Updated to Kotlin 1.3.11, Android Gradle Plugin 3.2.1 and Gradle 4.10.3
  • Fixed: Automatic logout when encryption fails
  • Fixed: Failing decryption when Android auto-backup previous data
    • Moved encryptor and preferences to no-backup folder (file-preferences library)
  • Fixed: Unit bookings without actuator-id not getting mapped
  • Changed: moved API calls to /mobile-sdk/ backend endpoints
  • Changed: Improved some Exception messages
  • Fixed: Checks to bluetooth radio status before starting scan