Skip to main content

Changelog

4.1.0​

New Features​

Sleep Apnea

The SleepSummary uploaded to ROOK servers now contains detection signs of sleep apnea; DETECTED, NOT_DETECTED or UNDEFINED in the non_structured_data section of the SleepSummary JSON. Please note that SamsungHealthPermission.sleepApnea is required to enable this behavior.

New Exceptions

  • HealthKitNotAllowedException this will be thrown when the consumer app is not allowed to use Samsung Health. ( ACCESS CONTROL: 2003). To fix it submit your package name and signing key for a partnership in Samsung Developer Portal. In case of testing the app enable developer mode on Samsung Health Settings.

Summaries Sync

RookSamsung.sync(bool? enableLogs) now uses an expedited worker to increase the sync process resilience. This is an internal change, no migration is required.

Older Android behavior

On Android 11 or lower the sync worker will fall back to a foreground service with a temporal notification. You can customize the notification through the AndroidManifest file:


<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <meta-data
            android:name="io.tryrook.samsung.sync.notification.ICON"
            android:resource="@drawable/sync_notification_icon"/>

        <meta-data
            android:name="io.tryrook.samsung.sync.notification.TITLE"
            android:resource="@string/sync_notification_title"/>

        <meta-data
            android:name="io.tryrook.samsung.sync.notification.CONTENT"
            android:resource="@string/sync_notification_content"/>
    </application>
</manifest>

Alarms, Battery Optimizations and OEM Auto Start

Some phone manufactures add their own energy restriction on top of Android's, these restrictions are mostly enabled by default and depending on the device will add a delay to background sync or even stopping it completely.

We have added 3 optimization paths to RookSamsung to help you to ask your users optimizing your application performance:

  • Alarms
    • checkExactAlarmPermissions: Checks if the SCHEDULE_EXACT_ALARM permission is granted. (Android 11 or lower always returns true)
    • requestExactAlarmPermissions: Request the SCHEDULE_EXACT_ALARM permission. (Android 11 or lower always returns alreadyGranted)
  • Battery Optimizations
    • checkBatteryOptimizationsDisabled: Checks if battery optimizations are disabled.
    • requestDisableBatteryOptimizations: Opens the system dialog that lets the user disable battery optimizations.
  • Auto Start
    • requiresOemAutoStartSetup: Checks if current device belongs to an OEM that enforces a proprietary auto start restriction.
    • openOemAutoStartSetup: Opens the OEM-specific auto start settings screen.

Check the Optimization permissions documentation to see more.

Background Sync

  • Removed low battery constraint.
  • Removed low storage constraint.
  • Added a watchdog to check Background Sync liveness and re-schedule if necessary. No extra permissions required ( You'll need to call RookSamsung.enableBackground again to activate this behavior).
  • Added an alarm to check Background Sync liveness and re-schedule if necessary. Alarms permission required (You'll need to call RookSamsung.enableBackground after granting alarm permissions to activate this behavior).

Medical Devices

This update improves the context sent with Samsung Health medical readings by attaching the device source used to capture the data when that information is available.

The following events include the device source metadata:

  • Blood glucose
  • Blood pressure
  • Oxygenation (Resting/Active)
  • Temperature

Device source metadata can include one or all of the following properties:

  • Device manufacturer
  • Device model
  • Device/app source identifier

Behavior Changes​

  • updateUserID now trims it's input before attempting to register, a string like " userID " will become "userID". If the trimmed string is empty IllegalStateException will be returned.

Breaking Changes​

Function Signatures

The following functions have updated return types:

  • 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.

New AAR​

The Samsung Health Data AAR has been upgraded to 1.1.0 version, download and update your dependencies:

dependencies {
    implementation(files("$rootDir/libs/samsung-health-data-api-1.1.0.aar"))
}

Core SDK​

Go to the rook_sdk_core changelog to check the latest changes.

Dependency updates

  • rook-sdk-samsung (Gradle): 4.0.0 → 4.1.0
  • rook_sdk_core: 4.0.0 → 4.1.0

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