手动数据同步

场景介绍

为了保障生态应用数据的实时性，当运动健康App数据未能及时同步到云端时，生态App应用在获得用户授权的前提下，通过让用户主动触发数据同步的操作，以达到用户数据实时上云的目的，便于能够从Health Service Kit云及时获取到用户最新的运动健康数据。

OAuth权限

联盟卡片申请的权限名称：数据同步 > 手动数据同步

权限	权限描述
<https://www.huawei.com/healthkit/huaweihealthdata.cloudsync>	允许触发华为运动健康应用同步个人数据到云（基于华为运动健康应用的数据同步管理设置）。

该权限仅企业开发者账号可见。

接口说明

接口名	描述
syncAll(): Promise<void>	用户主动触发数据同步。

开发前检查

• 完成申请运动健康服务与配置Client ID。
• 接口首次调用前，需先使用init方法进行初始化。
• 需先通过用户授权接口引导用户授权，参见AuthorizationRequest中scopes参数。用户授权数据同步权限后，才可调用手动数据同步接口。
• 错误码请参考ArkTS API错误码，常见问题请参考Health Service Kit常见问题。

开发步骤

1. 导入运动健康服务功能模块及相关公共模块。

   import { healthStore } from '@kit.HealthServiceKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';

2. 调用syncAll方法同步数据，并处理返回结果。

   try {
     await healthStore.syncAll();
     hilog.info(0x0000, 'testTag', 'Succeeded in synchronizing data.');
   } catch (err) {
     hilog.error(0x0000, 'testTag', `Failed to synchronize data. Code: ${err.code}, message: ${err.message}`);
   }