Skip to content

How to upgrade

The TrulyHandsfree and TrulyNatural SDKs are fully backwards-compatible with application code and models from earlier releases.

To upgrade to a new version or variant (for example from TrulyHandsfree to TrulyNatural), replace the library files and rebuild your application.

C applications

Use these steps for all applications that link against libsnsr.a. This includes those that use other application languages via an adapter, such as iOS.

  1. Replace both libsnsr.a and snsr.h with their updated versions.
    • Find libsnsr.a appropriate for your target platform in the ~/Sensory/TrulyNaturalSDK/7.6.1/lib/ directory, and snsr.h in ~/Sensory/TrulyNaturalSDK/7.6.1/include/
    • new does a runtime check to verify that the library and its header are in sync, if they're not it will return the LIBRARY_HEADER error code.
    • For iOS, update the XCFramework from ~/Sensory/TrulyNaturalSDK/7.6.1/lib/ios/snsr.xcframework
  2. If you are using custom library initialization you must recreate snsr-custom-init.c using snsr-edit from the new SDK version.
  3. Rebuild your application.

Android and Java applications

If you're using the recommended Android build recipe:

  1. Edit gradle.properties and update SNSR_REPOSITORY, SNSR_LIB_VERSION, and possibly SNSR_LIB_TYPE.
    • The SDK installers publish the library artifacts in mavenLocal() too. If you're using these, there's no need to update SNSR_REPOSITORY.
  2. Rebuild your application.