Release Note


  • Release Date:

    November 28, 2019

  • Release Contents
    Release Contents
    Data Libraries Libraries to sync health data with Samsung Health
    Sample Sample app codes with SimpleHealth, StepDiary, FoodNote
    Tool DataViewer to test a created app
    Documents API Reference, Programming Guide
    Service Libraries Libraries to have an interaction with Samsung Health’s tracker
    Sample Sample app codes with PluginTracker
    Documents API Reference, Programming Guides, Tracker Design Guidelines

Change History

  • Service 1.4.0
    [Android 10 support]
    • In Samsung Health 6.8, TrackerManager.startActivity() is updated for Android 10 to work well even Samsung Health is on the background.

    [Deprecation Features]
    • The following trackers are deprecated in TrackerManager.TrackerId.

      • SPO2


      • UV

  • Data 1.4.0
    [Important Notice]
    • Data 1.4.0 library includes important changes. All partner app must use this version until July 2019. Otherwise, your app will do not work with Samsung Health properly.

      • It supports security enhancements in Android 8.0. Applications that target Android 9 or higher cannot share data with other applications using socket.

      • It works with Samsung Health 6.2 or above.
        HealthConnectionErrorResult.OLD_VERSION_PLATFORM must be handled to install the latest Samsung Health.

      • Update your app by applying all changes below to make a seamless service.

    [New Feature]
    • HealthConstants.Nutrition

      • A Nutrition data type is added.

      • Replace HealthConstants.FoodInfo & HealthConstants.FoodIntake to HealthConstants.Nutrition. They will be removed in the next release.

    [Deprecation Features & Behavior Changes]
    • HealthDataService is deprecated.

      • Call just HealthDataStore.connectService() without after calling HealthDataService.initialize().

      • Remove sdk-v1.0.0.jar.

    • HealthUserProfile’s some APIs are deprecated and have a behavior change.

      • getUserId() is not valid anymore. Its behavior is changed to return an empty string for privacy policy enhancement. It will be removed in the next release.

      • getImage()is not valid anymore. Its behavior is changed to return null for privacy policy enhancement. It will be removed in the next release.

    • HealthDataResolver’s inserting and updating data APIs have a behavior change:

      • IllegalArgumentException is returned only if the request contains invalid instance type.

      • Check the result with getStatus() of HealthResultHolder.BaseResult. A data validation error is received as STATUS_INVALID_INPUT_DATA in HealthResultHolder.ResultListener.onResult().
        The data validation includes missing mandatory fields, wrong field type, out of the data value range and oversized BLOB.

      • See its example .

    [Sample & Tool Update]
    • Sample apps

      • FoodNote is updated as replacing HealthConstants.FoodInfo and HealthConstants.FoodIntake to HealthConstants.Nutrition.

      • StepDiary’s typo is fixed.

    • DataViewer

      • A data type list is updated with HealthConstants.Nutrition.
        HealthConstants.FoodInfo and HealthConstants.FoodIntake is dropped out.

  • Service 1.3.1
    • TrackerManager.Destination

      • REWARD destination is deprecated. It goes to an error page from Samsung Health 6.0.

    • TrackerTile

      • Setting date and content color in a tracker tile is not available from Samsung Health 6.0.

      • setDate() is deprecated.

      • setContentColor() is deprecated.

    • Tracker Design Guide is updated.

  • Data 1.3.0
    • Daily Step Count Trend ("")

      • "1" and "2" source type values that indicate wearable and activity trackers are deprecated. See deprecated info here .

      • The data library is same.

  • Data 1.3.0
    • HealthConstants.FoodInfo

      • Deprecated as he data library is same. Do not use it any more. It will be removed.

    • HealthConstants.FoodIntake

      • FOOD_INFO_ID is deprecated.

  • Service 1.3.0
    • TrackerManager.TrackerId added.

      • The existing fields for Samsung Health’s trackers are deprecated. Use the new class fields.

    • Jumping to a tracker’s specific destination like TRENDS is available.

      • TrackerManager.Destination added.

      • A new startActivity() API that has a destination param is added to TrackerManager.

    • Sample app is updated to “SampleService”.

    • For more detailed information, refer to here.

    • The SDK name became “Samsung Health Android SDK” as the following SDK is release:

      • Samsung Health Server SDK

    • DataViewer tool is updated. A minor defect is patched.

  • Data 1.3.0
    • New data types

      • Supported data types are added including floors climbed and health document.

    • Instant permission

      • Instant permission APIs to handle health document are added.

    • Some properties are added:

      • HealthConstants.Common: CUSTOM

      • HealthConstants.Exercise: ADDITIONAL, MAX_RPM

      • HealthConstants.HeartRate: MIN, MAX, BINNING_DATA


    • HealthData

      • APIs to handle InputStream are added.

    • setLocalTimeRange() is added to handle the local time zone change easily.

      • HealthDataResolver.AggregateRequest.Builder

      • HealthDataResolver.ReadRequest.Builder

    • iterator() and close() are added to HealthDataResolver.AggregateResult.

    • More health data units are added.

    • HealthDataUtil class is added.

    • A new sample app “StepDiary” is added.

    • The DataViewer tool is updated.

      • More supported data types are added.

      • The user interfaces are improved.

    • For more detailed information, refer to here

    • Some terms are changed:

      • "S Health" app name is rebranded to "Samsung Health".

      • "Samsung Health SDK" is used for the SDK’s name instead of "Samsung Digital Health SDK".

      • Only the library names are changed according to the SDK naming. You don’t need to update your app.

    • Sample apps are updated by the changed terms.

    • Related documents are updated by the changed terms.

  • Service 1.2.1
    • Only an unused library is removed from the sample app project. You don’t need to update your app with this version.

  • Service 1.2.0
    • APIs for the feature availability check are added in the Shealth class.



      • isFeatureEnabled(int...)

    • Shealth.isFeatureEnabled(int) was the default implementation and didn’t work. It is updated to check the feature availability.

    • To launch the S Health’s specific tracker with TrackerInfo and TrackerManager, S Health 4.8 or above is needed.

  • Data 1.2.1
    • A new meal type, MEAL_TYPE_BEFORE_SLEEP is added to HealthConstants.BloodGlucose.

    • MEAN_RPM is added to HealthConstants.Exercise.

    • In 1.2.0, HealthConnectionErrorResult.UNKNOWN had been retrieved when S Health prior to 4.6 is installed on the device. In this release, a bug for the wrong error value is fixed to give HealthConnectionErrorResult.OLD_VERSION_PLATFORM. You can solve the error situation by calling HealthConnectionErrorResult.resolve().

    • The following APIs are deprecated:

      • HealthResultHolder.cancel()

      • HealthResultHolder.BaseResult.STATUS_CANCELED

  • Data 1.2.0
    • HealthDevApp is removed. Use DataViewer to test your application.

      • "" in manifest to use HealthDevApp is not required.

    • To make a clear operation after the Permission UI is popped up, the existing PermissionManager.requestPermissions() is deprecated. Use new API with the activity parameter instead of it.

    • connectService() with the timeout parameter is added to HealthDataStore.

    • HealthConstants.SleepStage to present detailed sleep data is added.

    • Body fat, skeletal muscle, muscle mass, and basal metabolic rate properties are added to HealthConstants.Weight.

    • The minimum heart rate property is added to HealthConstants.Exercise.

    • The user name and user’s picture image can be retrieved through HealthUserProfile.

    • For more detailed information, refer to here .

    Service 1.1.0
    • S Health Simulator is removed from the SDK tool because S Health’s available devices had been expanded.

    • Shealth.initialize() doesn’t throw SsdkUnsupportedException and SecurityException.

    • permission is not required.

    • The title of tile design guidelines is changed to Tracker Design Guidelines.

  • Data 1.1.0
    • Sample application projects are updated to import them on Android Studio.

    • HealthConnectionErrorResult

      • The device that supports S Health 4.x can be checked with hasResolution().

      • hasResolution() and resolve() require the android.permission.INTERNET permission.

    • HealthConstants.BloodGlucose


      • MEAL_TYPE_AFTER_BEDTIME is deprecated.

    • "Treadmill" and "Elliptical trainer" are added to the predefined type of HealthConstants.Exercise.

    • putNull() to set a value of data property as null is added to HealthData.

    • Available ranges or operations of some APIs are changed. For more detailed information, refer to here.

  • Data 1.0.0
    • HealthConnectionErrorResult.resolve()'s operation is changed without a dialog.

    • Some constants for unit are added and descriptions of HealthConstants interfaces are changed.

    • If the handler parameter of the HealthDataObserver’s constructor is null, the looper of the current thread will be used for the callback.

    • A permissible range of medical data for countries is expanded.

    • For more detailed information, refer to here.

    Service 1.0.0
    • Guide for TrackerEventListener is supplemented. Check your application after referring to the API Reference and Programming Guide .

    • Description of Tile Design Guideline for Tracker is supplemented.

    • The icon size of TRACKER_TILE_TYPE_1 is changed to 60.

Known Issues

  • None


Health data store
  • Handles the service connection.

  • Inserts, reads, updates and deletes health data.

Health data type
  • Predefined data types such as counting steps or food intake.

Data Permission
  • Checks and Requests permissions to handle health data.

Launching Samsung Health Tracker
  • Checks a Samsung Health tracker’s availability in the device.

  • Launches the Samsung Health’s tracker.

  • Provides a specific tracker’s info including its name and icon.

App Tracker Tile Definition
  • Defines an app’s tracker tile.

  • Posts the app’s tracker tile on the Samsung Health’s main screen.

  • Receives the app tracker tile’s events from the Samsung Health.