SmartWorkspaceSdk

Sensorberg Smart Spaces SDK interface. All methods are expected to be called from UI-thread. The SDK handles all needed threading internally. The Smart Workspaces SDK must be a singleton in the application. Consult the implementation guide for singleton pattern.

There are three implementations of the SDK:

• the real SDK instantiated via SmartWorkspaceSdk.Builder

    SmartWorkspaceSdk
        .Builder(context) // Android context
        .baseUrl(baseUrl) // base URL to the server
        .oauthId(oauthId) // oauth ID of the Android application on the server
        .certificate(certificate) // server public key certificate hash on the format: "sha256/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
        .build()

• An empty implementation with exposed fields that can be easily used for unit testing

    testImplementation 'com.sensorberg.smartworkspace:test-sdk:VERSION'

    val sdk = EmptySdk()
    sdk.getUserResponse.value = Response.success(user)
    sdk.getUnitsResponse.value = Response.success(units) ... etc

    assertEquals(user, sdk.getUnitController().getUnits(Availability.All, Sorting.None))

• A test implementation that roughly behaves like the real implementation but uses randomly mocked data. That's mostly ideal for UI testing The test implementation initial status is always Status.NotLoggedIn Operations (backend queries, open, etc) are time delayed and are always successful

    androidTestImplementation 'com.sensorberg.smartworkspace:test-sdk:VERSION'

    val sdk = TestSdk()
    sdk.getUnitController().getUnits(...)
                           .observeForEver {
    					       // response will be executing and later success with some mocked data
    					 }

Types

Functions