Release NoteAug 24, 2017

Introduction

  • Release Date

    Aug 24, 2017

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

    • 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

      • HealthConstants.Weight: BODY_FAT_MASS, FAT_FREE, FAT_FREE_MASS, SKELETAL_MUSCLE_MASS, TOTAL_BODY_WATER

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

      • FEATURE_TRACKER_LAUNCH

      • FEATURE_TRACKER_TILE

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

      • "com.samsung.android.health.platform_type" 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.

    • com.samsung.android.providers.context.permission.WRITE_USE_APP_FEATURE_SURVEY 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 BEFORE_MEAL and MEAL_TYPE GENERAL are added.

      • 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

Features

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

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.