HUAWEI Health接入指南（DevEco方式）

华为 HUAWEI Health 是一个数据接入和服务汇聚的开放平台，包括华为运动健康APP和运动健康云。其中，运动健康APP运行在手机端侧，为用户提供专业的运动记录、减脂塑型训练、科学睡眠和健康管理等功能。运动健康云提供了安全可靠的数据存储能力，用户可选择将历史数据上传并保存到云侧。

HUAWEI Health面向开发者提供端侧Java接口、云侧Restful接口，基于用户主动授权开放运动健康数据共享能力。同时，提供端侧JavaScript接口引入优质的H5服务到运动健康APP。本Codelab主要介绍端侧Java接口如何集成。

APP开发者采用集成SDK的方式将HUAWEI Health集成到其开发的APP内部，其APP调用HUAWEI Health提供的Java接口，在用户授权后，该APP可获取华为运动健康APP上的本地用户数据，或将该APP的数据写入华为HUAWEI Health开放平台。通过接入华为HUAWEI Health开放平台，可以在APP之间进行安全的数据共享(纯端侧)，为用户融合各生态开发者开发的应用，从而提供更优质、更安全和更专业的服务。用户授权后才允许数据共享，可以随时取消授权，可以随时删除写入华为HUAWEI Health开放平台的第三方数据。

APP请求用户授权的交互图：

要了解更多信息，请参阅我们官网：
https://developer.huawei.com/consumer/cn/huaweihealth

你将建立什么

本codelab提供了一个三方应用基础开发样例，开发者只需要完成相应的代码片段补充，就可以熟悉HUAWEI Health的数据读取、实时数据接口API基本使用方法。

您将会学到什么

使用DevEco Studio高效集成HUAWEI Health
熟悉HUAWEI Health的数据读取、实时数据接口API基本使用方法

你需要什么

硬件要求

开发计算机（台式机或笔记本电脑）
已登录运动健康账号的华为手机（带USB线），用于真机调试开发。
华为手环/手表（非必须，用于获取心率）

软件要求

JAVA JDK安装包
DevEco Studio 安装包版本1.0.4.2506及以上
Android SDK包

步骤1 打开 DevEco Studio

步骤2 导入官网工程

工程下载链接如下：

源码下载

步骤3 打开 Kit Assistant

点击 Tools EMUI Kits Kit Assistant

步骤4 选择HUAWEI Health模块

1. 服务接入

步骤1 切换包名

参考以下方式将工程中的包名切换成您自己的包名

步骤2 签名文件和配置信息
拷贝在服务接入中生成的签名文件(如HUAWEI health_demo.jks)到health_keystore目录下，如下图所示：

在app-phone目录下的build.gradle文件里的TODO: signingConfigs位置下添加签名文件的相关配置信息：


signingConfigs {
    debug {
        storeFile file('health_keystore\\your_keystore.jks')
        storePassword '****'
        keyAlias = '****'
        keyPassword '****'
    }
    release {
        storeFile file('health_keystore\\your_keystore.jks')
        storePassword '****'
        keyAlias = '****'
        keyPassword '****'
    }
}

其中storeFile file填写签名文件在工程中的位置；keyAlias、storePassword和keyPassword都是生成签名文件时配置的，需要根据自己的实际情况进行配置。

步骤3 添加APPID

在工程中的AndroidManifest.xml清单文件中的android:value中添加接入华为运动健康服务时的APPID

2. 数据读取

数据读取API提供三方APP读取华为HUAWEI Health平台上数据的接口，范围是用户授权的数据类型，在获得用户允许后，可以共享华为对外开放的各类运动、健康数据给三方APP。

步骤1 打开工程中的HistoryActivity

步骤2 点击数据读取条目进入详情页面

步骤3 拖动代码块到工程

拖动代码块1.execQuery到工程execQuery(){ } 方法中

3. 实时数据

实时数据API可以获取用户当前心率、运动状态、距离、速度等数据。

步骤1 打开工程中的MainActivity

步骤2 点击实时数据条目进入详情页面

步骤3 拖动代码块到工程

拖动代码块5.startRealTimeSportData到工程startRealTimeSportData (){ } 方法中

拖动代码块6.stopRealTimeSportData到工程stopRealTimeSportData (){ } 方法中

在 DevEco Studio中，在工程完成同步后，单击"运行"图标。然后，选择您的设备作为部署目标，然后单击" 确定"以在设备上启动示例应用程序。如下图

步骤1 用户授权

只有在获得用户授权后，才能获取到运动、健康数据。

步骤2 绑定设备（非必须）

前往【运动健康】【设备】，点击添加设备绑定华为手环/手表。
注：绑定手环/手表是为了获取心率数据，未绑定手环/手表也可以获取到其他实时运动数据。

步骤3 开启运动模式

要获取实时运动数据，必须先进入运动模式，请前往【运动健康】【运动】中选择一项运动模式并开启。

运行效果

已复制代码