Development Process

If you checked prerequisites and downloaded the SDK, it’s ready to create your application. Make it with the following steps.

Samsung Health Branding Guidelines

Samsung Health SDK provides the user interface guidelines for its partner applications to unify the entry point for the connection to Samsung Health and related interfaces. Read " Samsung Health Branding Guidelines" and apply them to your application. An application that doesn’t keep the guidelines can be rejected for the partner application.

Data Synchronization Design

The partner app of Samsung Health needs to synchronize health data with Samsung Health. See Data types for the available data types.

Samsung Health SDK enables your app to read Samsung Health’s data and write your app’s data to Samsung Health.

Main data types that represent your application should be contained for data integration. The synchronized data between your application and Samsung Health needs to give a natural flow to users. E.g. In case of the nutrition app, the user thinks food intake data would be shared with Samsung Health without doubt.

Creating an Application

Create an app project and complete your app. See hello health data for a quick start.

Testing Your Application

The app that uses the SDK works with Samsung Health after the partner app approval. It needs to be tested fully before applying for the partner app. The SDK provides the following environments.

  • Samsung Health‘s developer mode.

  • SDK’s DataViewer.

  • Checklist for Samsung Health’s partner app.

You can apply for Samsung Health’s partner app before publishing your app. Otherwise the app publication can be first before applying for partner app. The former is proper to provide a seamless service of your app.

Note

Samsung Health SDK doesn’t support the Emulator test. Android 4.4 KitKat (API level 19) device or above is required to test your app.

Samsung Health’s Developer Mode

Samsung Health has the developer mode for the app test before the partner app approval. The Samsung Health’s developer mode is not activated by default. You can activate it with the following steps.

  1. 1.

    Select the action overflow of Samsung Health on the top-right side.

  2. 2.

    Find Settings > About Samsung Health in the action list.

  3. 3.

    Tap the version region quickly for 10 times.
    The exact region, illustrated in the red and blue box in Figure 7 needs to be tapped.

  4. 4.

    If it succeeds, "*(Developer Mode)*" is shown in front of the version and it means the developer mode is activated. Now you can test your app with Samsung Health.

Figure 7 shows how to turn on or off the developer mode in Samsung Health. If you tap the version region quickly for 10 times in the developer mode as the right figure, the developer mode is deactivated.

Figure 7: On or off of Samsung Health’s developer mode
DataViewer

DataViewer reads saved health data in Samsung Health and can create new test data for each data type. It works after the Samsung Health’s developer mode is active. See Data Viewer for more information.

Figure 8: DataViewer
Checklist for Samsung Health’s Partner App

Samsung Health SDK provides a checklist that includes basic test items for the app test. Download it here and check your app before applying for partner app. It helps you save the time on the registration process for Samsung Health’s partner app.

Publishing Your Application

Package and publish your app on the application market such as Google Play if it is ready for publication.

Your released app should run well even if it doesn’t become the Samsung Health’s partner app yet. Check connection error handling to the health data store of Samsung Health especially.

Registering for Partner Apps

The application works properly with Samsung Health after the partner app approval. Samsung Health team checks the app’s violations and registers your app as the Samsung Health’s partner because health data is closely connected to the privacy issue.

You can request for the partner application on the developer site .

Note

Only the approved partner app runs with Samsung Health. Otherwise the application can be run and tested on the developer mode.