Native Health SDK

Native Health SDK 是一款 Tuanjie 插件，用于在 Tuanjie C# 代码与 Apple HealthKit 和 Android Health Connect 之间建立原生桥接。

核心功能

• 统一的 Tuanjie C# API，同时支持 HealthKit 与 Health Connect
• 运行时平台可用性检测
• 原生健康数据权限申请流程
• 支持读取和写入平台支持的健康数据类型
• 提供活动、步数、距离、能量消耗、运动记录、睡眠、心率、数值型健康数据、数据概览、趋势分析及健康评分等 API
• 提供用于权限申请、数据读取和写入测试的 Tuanjie 示例场景
• 包含集成文档与隐私政策模板

Demo Apps

• iOS Demo
• Android Demo

包含文件

• Tuanjie C# 运行时脚本
• Android Health Connect AAR 插件二进制文件
• Apple HealthKit XCFramework 插件二进制文件
• Android 编辑器安装工具（用于配置 Gradle 依赖及最低 SDK）
• 示例场景与示例 MonoBehaviour
• 面向购买者的集成文档

Android 要求

• Android 9（API 28）及以上版本
• 已安装 Google Play Services
• 设备支持并启用了 Health Connect

Health Connect 版本说明

• Android 14 及以上版本：Health Connect 已集成至系统设置
• Android 13 及以下版本：需从 Google Play 安装 Health Connect 应用

发布要求

在发布包含 Health Connect 功能的应用前，需要完成 Google Play Health Apps 声明。

Apple 平台要求

• 支持 HealthKit 的 Apple 设备目标平台
• 在 Xcode 中启用 HealthKit Capability
• 为应用目标添加 HealthKit Entitlement
• 配置读取权限说明：NSHealthShareUsageDescription
  
• 配置写入权限说明：NSHealthUpdateUsageDescription
  
• 若 HealthKit 为可选功能，需手动审核和配置 UIRequiredDeviceCapabilities

兼容性

Android

• Android 9 / API 28 及以上版本
• 设备需安装 Google Play Services
• 设备需支持并启用 Health Connect

Apple 平台

• iOS：支持 HealthKit 的 iPhone 设备
• iPadOS：支持 HealthKit 的 iPad 设备
• macOS：支持 HealthKit 的 macOS 设备
• Mac Catalyst：支持 HealthKit 的 Catalyst 应用
• visionOS：支持 HealthKit 的 visionOS 应用

测试建议

HealthKit 与 Health Connect

• 建议使用真实设备进行最终验证
• 建议使用 Google Play 认证设备或支持的 Android 模拟器镜像进行 Health Connect 测试

权限流程测试

请验证以下场景：

• 用户授权权限
• 用户拒绝权限
• 用户撤销权限
• 不支持设备场景

Android 构建测试

在更新 SDK 或 Gradle 依赖后：

• 重新构建 Android 项目
• 重新安装应用进行验证

重要说明

本 SDK 不包含以下服务：

• 后端服务（Backend）
• 数据分析（Analytics）
• 广告服务（Advertising）
• 遥测服务（Telemetry）
• 用户账户系统（Account System）
• 云同步服务（Cloud Sync）

使用健康数据的应用必须自行提供：

• 隐私政策（Privacy Policy）
• 应用商店健康数据声明
• 平台要求的相关合规配置

本插件专注于提供 Tuanjie 与 HealthKit / Health Connect 之间的原生集成能力，方便开发者快速构建健康与运动类应用。