Skip to main content

Changelog

4.0.0​

New Features​

Android 16 Support

The SDK now targets Android 16 (API level 36). Ensure your project's compileSdk and targetSdk are updated to 36 to avoid compatibility warnings.

Improved Synchronization

  • Current day Summary sync: Enabled summary synchronization for the current day.
  • Current day Heart Rate Events sync: Get accumulated Hear Rate measurements for the current day with RookSamsung.getTodayHeartRate().
  • Temperature events sync with RookSamsung.syncEvents(DateTime, HCEventSyncType)(requires SamsungHealthPermission.bodyTemperature permission).
  • Automatic background cleanup: A successful call to deleteUserFromRook now automatically halts and cancels any previously scheduled BackgroundSync tasks.

Diagnostics

Get the current SDK state during development. Read documentation.

New Authentication​

The authentication flow has been redesigned to improve security and eliminate the need for embedding secret keys within your application code.

New Requirements

To initialize the SDK, you must now provide your Client UUID and an secret. The SDK will perform a server-side validation of these credentials against the package name of your application.

Critical Requirement

You must register your applicationId (package name) and its corresponding secret in the ROOK Portal before attempting to initialize the SDK. Failure to register these credentials will cause the initialization to fail with an SDKNotAuthorizedException.

If you come from a previous version you MUST re-initialize the SDK with the new authentication flow.

Environment Management

The ROOK Portal supports independent configurations for Sandbox and Production environments. Each environment requires its own unique pair of Package Name and secret.

Breaking Changes​

SDK Version Requirements

The library has increased its baseline requirements to align with lastest Samsung Health Data SDK requirements.

  • Minimum Support: Updated to Android 10 (API 29). The minSdk is now set to 29.

Exception Renaming

The following exception classes have been renamed for consistency.

Legacy ExceptionNew ExceptionPackage
SamsungHealthNotInstalledExceptionHealthKitNotInstalledExceptionrook_sdk_core
SamsungHealthNotReadyExceptionHealthKitNotReadyExceptionrook_sdk_core
SamsungHealthOutdatedExceptionHealthKitOutdatedExceptionrook_sdk_core
SamsungHealthDisabledExceptionHealthKitDisabledExceptionrook_sdk_core

Function Signatures

The following functions have updated return types:

  • RookSamsung.sync(bool?, DateTime?, SHSummarySyncType?): Now returns Future<void>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.syncEvents(DateTime, SHEventSyncType): Now returns Future<void>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getSleepSummary(DateTime): Now returns Future<List<SleepSummary>>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getPhysicalSummary(DateTime): Now returns Future<PhysicalSummary>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getBodySummary(DateTime): Now returns Future<BodySummary>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getActivityEvents(DateTime): Now returns Future<<List<ActivityEvent>>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getTodayStepsCount(DateTime): Now returns Future<int>, sync attempts without data will return a RecordsNotFoundException.
  • RookSamsung.getTodayCaloriesCount(DateTime): Now returns Future<DailyCalories>, sync attempts without data will return a RecordsNotFoundException.

Migrations​

ComponentStatusMigration Action
clearUserIDRemovedReplace with deleteUserFromRook.

AAR Updated

To use this version you need to download the new samsung-health-data-api-1.0.0.aar, copy it to your project libs directory and replace the dependency implementation in your build.gradle (app module).

This version of the rook_sdk_samsung_health plugin already includes gson so you can remove it from your dependencies.

dependencies {
    // Before
//    implementation(files("$rootDir/libs/samsung-health-data-api-1.0.0-b2.aar"))
//    implementation("com.google.code.gson:gson:2.13.0")

    // After
    implementation(files("$rootDir/libs/samsung-health-data-api-1.0.0.aar"))
}

Core SDK​

Go to the rook_sdk_core changelog to check the latest changes.

Dependency updates

  • rook-sdk-samsung (Gradle): 1.1.0 → 4.0.0
  • com.google.code.gson:gson (Gradle): New → 2.13.2
  • Dart SDK: >=3.0.0 <4.0.0 → >=3.10.4 <4.0.0

V1 — Long-Term Support (LTS)​

rook_sdk_samsung_health v1.1.0 remains our Long-Term Support (LTS) version. It will continue to receive critical bug fixes and security patches until September 27, 2026.

What this means

  • Guaranteed long-term stability for existing integrations.
  • Continued critical updates and security maintenance.
  • Ideal for production environments requiring predictable and reliable support.

Maintenance releases

1.1.0

  • Improved logging
  • Improved nutrition calories calculation.
  • Improved Heart Rate Min, Avg and Max calculation
  • Improved Heart Rate granular extraction

Local Summaries and Activity: You can now get a local copy of a Sleep Summary, Physical Summary, Body Summary and Activity events after syncing, check the documentation for more details.

Dependency updates

  • rook-sdk-samsung (Gradle): 1.0.0 → 1.1.0

1.0.0​

  • Initial release