1. 项目缘起为什么需要获取华为运动健康数据最近在做一个健康管理类的Android应用其中有一个核心功能是展示用户的每日运动数据。市面上有很多运动健康App比如华为运动健康、小米运动、Keep等等。对于开发者来说一个很现实的问题是用户的数据可能分散在各个App里如果想让用户在我们的App里看到一个汇总的、全面的健康视图就需要想办法把这些数据“拿”过来。华为运动健康作为国内用户基数庞大的应用其记录的步数、心率、睡眠等数据非常有价值。直接通过Android系统提供的标准接口比如Google Fit来获取在国内环境下往往水土不服。于是研究如何从华为运动健康App中获取数据就成了一个刚需。今天我就以获取“总步数”这个最基础也最常用的数据为例分享一下我的探索过程和实现方案。这不仅仅是调用一个API那么简单还涉及到对Android权限体系、内容提供者Content Provider机制以及华为生态适配的深入理解。2. 核心原理Android应用间数据共享的桥梁在Android系统中应用之间默认是沙盒隔离的一个应用不能直接访问另一个应用的数据。为了实现安全可控的数据共享Android提供了几种机制其中最常用的就是内容提供者Content Provider。你可以把它想象成一个应用对外开设的“数据窗口”其他应用可以通过标准的URI统一资源标识符和一套固定的“查询语言”即ContentResolver的query方法在获得授权的前提下从这个窗口请求数据。华为运动健康App作为一个成熟的应用很可能也对外提供了这样一个Content Provider用于让其他合规的应用查询用户的健康数据。我们的任务就是找到这个Provider的“地址”Authority和“数据表结构”即哪些列代表步数、时间等信息。这通常需要查阅官方文档或者通过一些技术手段进行分析。注意任何尝试获取用户数据的行为都必须严格遵守用户隐私和数据安全规范。我们必须确保获取数据是经过用户知情同意的并且仅用于向用户提供服务的明确目的。私自、未授权的数据抓取是违规且违法的。3. 实战准备环境、权限与依赖在开始写代码之前我们需要做好几项准备工作。这个过程看似繁琐但每一步都关系到最终功能能否顺利运行。3.1 开发环境与项目配置首先确保你的开发环境是标准的。我使用的是Android Studio这是Google官方的IDE对Android开发的支持最完善。项目基于Android API Level 24 (Nougat)或以上进行构建以兼容大多数现代设备。在项目的build.gradle文件中需要确保已经引入了必要的依赖。虽然华为运动健康可能没有提供官方的SDK到公共仓库但我们需要确保项目能处理可能的数据格式和网络请求。// app/build.gradle android { compileSdk 34 defaultConfig { minSdk 24 targetSdk 34 ... } } dependencies { implementation androidx.core:core-ktx:1.12.0 implementation androidx.appcompat:appcompat:1.6.1 // 可能用于处理日期时间 implementation joda-time:joda-time:2.12.5 }3.2 声明必要的权限访问其他应用的数据尤其是健康数据属于敏感权限。我们需要在AndroidManifest.xml文件中明确声明。这里主要涉及两类权限健康数据读写权限Android系统定义了android.permission.health.READ权限在Android 14/API 34中引入用于规范健康数据的访问。对于更早的版本或特定厂商数据可能需要其他权限。包可见性权限从Android 11API 30开始系统加强了应用间交互的管控。如果你想通过包名查询其他应用的信息比如判断华为运动健康是否安装可能需要声明queries元素。!-- AndroidManifest.xml -- manifest ... !-- 声明健康数据读取权限 -- uses-permission android:nameandroid.permission.health.READ / !-- 对于Android 11声明需要查询的包 -- queries package android:namecom.huawei.health / /queries ... application ... ... /application /manifest重要提示android.permission.health.READ是一个运行时权限Runtime Permission。这意味着你不仅要在清单里声明还需要在代码中动态向用户申请并且用户同意后你才能使用。这是保护用户隐私的关键一环。3.3 定位华为运动健康的Content Provider这是最关键也最具挑战性的一步。理想情况下华为会提供官方的健康数据开放接口文档。我们可以搜索“华为运动健康 开放平台”或“Huawei Health Kit”来寻找官方解决方案。华为确实提供了Huawei Health Kit这是一个功能强大的SDK允许开发者安全地接入华为的健康数据云。但它的集成过程相对复杂需要申请开发者账号、创建应用、配置签名证书等。对于本示例我们探讨一种更“轻量”的可能性直接访问App本地数据库。这需要极其谨慎因为非公开的接口可能随时变更且存在兼容性和政策风险。以下分析仅供技术学习参考。通过连接Android设备的ADB并使用一些工具我们可以尝试探查华为运动健康App包名通常为com.huawei.health对外暴露了哪些Content Provider。# 在终端中使用ADB命令 adb shell # 进入设备shell后查询所有provider pm list providers # 或者更精确地查找 dumpsys package com.huawei.health | grep provider通过分析我们可能会发现一些Authority例如com.huawei.health.provider。但这只是猜测真正的Authority和URI路径必须依据官方文档或反编译不推荐且可能违反条款才能准确获得。在正式项目中强烈建议使用官方Health Kit。4. 代码实现从查询到数据解析假设我们已经通过某种方式例如早期版本的公开资料或技术分析得知了查询步数的URI下面展示核心的代码实现逻辑。请注意以下URI和列名均为示例不可直接用于生产环境。4.1 动态权限申请首先在尝试查询数据前必须确保已经获得了用户的授权。// MainActivity.kt import android.content.pm.PackageManager import androidx.core.app.ActivityCompat import androidx.core.content.ContextCompat class MainActivity : AppCompatActivity() { companion object { private const val PERMISSION_REQUEST_HEALTH_READ 1001 } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) checkAndRequestPermission() } private fun checkAndRequestPermission() { val permission Manifest.permission.health.READ if (ContextCompat.checkSelfPermission(this, permission) ! PackageManager.PERMISSION_GRANTED) { // 权限尚未授予向用户解释并申请 if (ActivityCompat.shouldShowRequestPermissionRationale(this, permission)) { // 向用户展示一个对话框解释为什么需要这个权限 AlertDialog.Builder(this) .setTitle(需要健康数据权限) .setMessage(本应用需要读取华为运动健康数据以便为您提供综合健康报告。) .setPositiveButton(确定) { _, _ - requestPermission() } .setNegativeButton(取消, null) .show() } else { // 直接申请权限 requestPermission() } } else { // 权限已授予开始查询数据 queryStepData() } } private fun requestPermission() { ActivityCompat.requestPermissions( this, arrayOf(Manifest.permission.health.READ), PERMISSION_REQUEST_HEALTH_READ ) } override fun onRequestPermissionsResult( requestCode: Int, permissions: Arrayout String, grantResults: IntArray ) { super.onRequestPermissionsResult(requestCode, permissions, grantResults) when (requestCode) { PERMISSION_REQUEST_HEALTH_READ - { if (grantResults.isNotEmpty() grantResults[0] PackageManager.PERMISSION_GRANTED) { queryStepData() } else { Toast.makeText(this, 未授予健康数据权限功能无法使用, Toast.LENGTH_LONG).show() } } } } private fun queryStepData() { // 下一步实现查询逻辑 } }4.2 构建查询并获取数据在queryStepData()方法中我们将使用ContentResolver来执行查询。这里需要构建一个URI并指定要查询的列和条件。// MainActivity.kt (续) import android.net.Uri import android.database.Cursor private fun queryStepData() { // 示例URI非真实URI请使用华为Health Kit官方接口。 val suspectedUri Uri.parse(content://com.huawei.health.provider/step_count) // 假设我们想查询今天2023年10月27日的步数 val today SimpleDateFormat(yyyy-MM-dd, Locale.getDefault()).format(Date()) val selection date ? val selectionArgs arrayOf(today) // 假设数据表中有 steps 和 date 两列 val projection arrayOf(steps, date) val cursor: Cursor? try { contentResolver.query( suspectedUri, projection, selection, selectionArgs, null // sortOrder ) } catch (e: SecurityException) { Log.e(StepQuery, 权限不足或URI错误, e) Toast.makeText(this, 无法访问数据请检查权限和华为运动健康版本, Toast.LENGTH_LONG).show() null } catch (e: Exception) { Log.e(StepQuery, 查询发生异常, e) null } cursor?.use { // 使用use扩展函数确保Cursor被关闭 if (it.moveToFirst()) { val stepsIndex it.getColumnIndex(steps) val dateIndex it.getColumnIndex(date) if (stepsIndex ! -1) { val todaySteps it.getInt(stepsIndex) val date if (dateIndex ! -1) it.getString(dateIndex) else N/A runOnUiThread { // 更新UI显示步数 stepCountTextView.text 今日步数$todaySteps ($date) } Log.d(StepQuery, 成功获取到步数$todaySteps) } else { Log.w(StepQuery, 未找到‘steps’列) } } else { Log.d(StepQuery, 未查询到今天的数据) runOnUiThread { stepCountTextView.text 今日暂无步数数据 } } } ?: run { // cursor为null的情况 Log.e(StepQuery, 查询失败Cursor为null) } }代码解析与避坑点异常处理至关重要contentResolver.query可能抛出多种异常。SecurityException通常意味着权限不足或URI不被允许访问其他异常可能是URI格式错误或Provider不存在。必须捕获并妥善处理给用户明确的反馈而不是让应用崩溃。Cursor必须关闭Cursor是系统资源必须在使用完毕后关闭。Kotlin的.use{}扩展函数或Java的try-with-resources可以自动处理避免内存泄漏。列索引检查不要直接假设列名存在。使用getColumnIndex()获取索引并检查其是否为-1。如果返回-1说明查询的投影projection中指定的列在结果集中不存在。UI更新数据库查询可能在后台线程执行更新UI必须切回主线程使用runOnUiThread。4.3 处理多日数据与聚合查询通常我们不仅需要当天的数据还可能需要最近7天、30天的步数趋势。这就需要修改查询条件。private fun queryLastSevenDaysSteps() { val suspectedUri Uri.parse(content://com.huawei.health.provider/step_count) val calendar Calendar.getInstance() calendar.add(Calendar.DAY_OF_YEAR, -6) // 7天前 val startDate SimpleDateFormat(yyyy-MM-dd, Locale.getDefault()).format(calendar.time) val today SimpleDateFormat(yyyy-MM-dd, Locale.getDefault()).format(Date()) // 查询从startDate到今天的所有数据 val selection date BETWEEN ? AND ? val selectionArgs arrayOf(startDate, today) val projection arrayOf(date, steps) val sortOrder date ASC // 按日期升序排列 val cursor contentResolver.query(suspectedUri, projection, selection, selectionArgs, sortOrder) val stepMap mutableMapOfString, Int() cursor?.use { val dateIndex it.getColumnIndex(date) val stepsIndex it.getColumnIndex(steps) while (it.moveToNext()) { if (dateIndex ! -1 stepsIndex ! -1) { stepMap[it.getString(dateIndex)] it.getInt(stepsIndex) } } } // 此时 stepMap 包含了日期到步数的映射可以用于绘制图表 Log.d(StepQuery, 最近七天步数数据$stepMap) }5. 官方路径华为Health Kit集成指南推荐由于直接访问私有Content Provider存在巨大风险且不稳定集成华为官方的Health Kit是唯一可靠、合法且长期可持续的方案。下面简述其核心流程。5.1 前期准备与申请注册华为开发者账号访问 华为开发者联盟 网站并注册。创建应用在开发者控制台创建一个Android应用填写应用包名等基本信息。这一步会获得一个App ID。开通Health Kit服务在项目设置中找到并开通Health Kit能力。你需要仔细阅读并同意相关的服务条款和隐私协议。配置签名证书指纹Health Kit会校验应用签名。你需要将应用的签名证书SHA-256指纹配置到开发者后台。这通常通过生成签名文件.jks并获取其指纹来完成。keytool -list -v -keystore your-keystore.jks下载配置文件在控制台生成并下载agconnect-services.json文件将其放入项目的app模块根目录。5.2 项目集成与配置配置项目级Gradle在项目根目录的build.gradle文件中添加华为Maven仓库和AGC插件依赖。// project/build.gradle buildscript { ext.kotlin_version 1.9.0 repositories { google() mavenCentral() maven { url https://developer.huawei.com/repo/ } // 华为仓库 } dependencies { classpath com.android.tools.build:gradle:8.1.0 classpath org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version classpath com.huawei.agconnect:agcp:1.9.1.300 // AGC插件 } }配置应用级Gradle在app/build.gradle文件头部应用插件并添加依赖。// app/build.gradle apply plugin: com.android.application apply plugin: kotlin-android apply plugin: com.huawei.agconnect // 应用AGC插件 android { ... } dependencies { // Health Kit SDK依赖 implementation com.huawei.hms:health:6.11.0.300 // 可选用于账户授权 implementation com.huawei.hms:hwid:6.12.0.300 }5.3 核心代码实现使用Health Kit使用Health Kit的流程比直接查询Provider规范得多主要分为授权和数据读写两步。// Step 1: 初始化Health Kit和华为帐号服务 val healthService Health.getHealthService(this, HuaweiHiHealthOptions.builder().build()) val authHuaweiId HuaweiIdAuthManager.getService(this, HuaweiIdAuthParams.DEFAULT_AUTH_REQUEST_PARAM).silentSignIn() authHuaweiId.addOnSuccessListener { huaweiId - // 静默登录成功huaweiId包含用户授权信息 readStepDataWithHealthKit(healthService) }.addOnFailureListener { e - // 静默登录失败需要启动显式授权界面 startActivityForResult( HuaweiIdAuthManager.getService(this, HuaweiIdAuthParams.DEFAULT_AUTH_REQUEST_PARAM).signInIntent, REQUEST_SIGN_IN_LOGIN ) } // Step 2: 使用Health Kit API读取步数数据 private fun readStepDataWithHealthKit(healthService: HealthService) { // 1. 构建数据读取请求 val readOptions ReadOptions.Builder() .read(DataType.DT_CONTINUOUS_STEPS_TOTAL) // 读取总步数数据类型 .setTimeRange( // 查询今天0点到现在的数据 System.currentTimeMillis() - 24 * 60 * 60 * 1000, System.currentTimeMillis(), TimeUnit.MILLISECONDS ) .build() // 2. 执行读取 healthService.dataController.read(readOptions) .addOnSuccessListener { readReply - // 3. 处理返回的数据集 val dataSet readReply.getDataSet(DataType.DT_CONTINUOUS_STEPS_TOTAL) var totalSteps 0L for (samplePoint in dataSet.samplePoints) { val stepValue samplePoint.getFieldValue(Field.FIELD_STEPS) totalSteps stepValue.asLongValue() } runOnUiThread { stepCountTextView.text 今日步数Health Kit$totalSteps } Log.d(HealthKit, Total steps: $totalSteps) } .addOnFailureListener { e - Log.e(HealthKit, 读取步数失败, e) Toast.makeText(this, 读取健康数据失败: ${e.message}, Toast.LENGTH_LONG).show() } }使用Health Kit的优势官方支持接口稳定长期维护兼容性好。数据全面不仅能获取步数还能获取心率、睡眠、体重、运动记录等数十种健康数据。安全合规所有数据访问都经过用户明确的OAuth授权流程符合隐私规范。云端同步获取的是用户同步在华为云上的健康数据不依赖于手机本地是否安装了运动健康App。6. 常见问题排查与优化建议在实际开发中你肯定会遇到各种各样的问题。下面我总结几个常见的坑和解决思路。6.1 权限申请被拒绝或无效问题即使动态申请了android.permission.health.READ权限查询时依然抛出SecurityException。排查检查Target SDK确保targetSdkVersion设置为29或更高某些权限模型在低版本上行为不同。检查权限名称确认权限字符串完全正确。不同厂商可能有自定义权限。检查授权来源android.permission.health.READ是Android标准权限但华为运动健康的数据可能受其自身权限控制。用户可能在系统设置中单独关闭了华为运动健康对“身体传感器”或类似权限的授权。引导用户去华为运动健康的应用信息里检查权限。Health Kit专属问题如果使用Health Kit权限问题通常表现为授权失败。检查agconnect-services.json文件是否正确放置检查应用签名SHA-256是否与开发者后台配置的一致确认在华为手机上已登录华为帐号且该帐号已授权给运动健康应用。6.2 查询返回空数据或列不存在问题Cursor不为null但moveToFirst()返回false或者getColumnIndex()返回-1。排查URI是否正确这是最常见的原因。Content Provider的URI可能因应用版本不同而改变。对于非官方接口此路基本不通。数据是否存在确认在指定的时间范围内华为运动健康App里确实有记录步数。可以打开App确认一下。列名是否正确数据库表结构可能变更。同样非官方接口无法保证。使用Health Kit如果使用Health Kit检查DataType是否正确。步数相关数据类型可能有多种如总步数DT_CONTINUOUS_STEPS_TOTAL、步行步数DT_CONTINUOUS_STEPS_WALKING等需要根据需求选择。另外检查时间范围是否合理。6.3 性能优化与用户体验后台数据同步不应该在应用每次打开时都实时查询尤其是使用Health Kit涉及网络请求。应该设计一个后台服务或使用WorkManager定期如每小时一次同步数据到本地数据库App界面从本地库读取这样响应更快体验更流畅。错误降级处理如果无法从华为运动健康获取数据应有降级方案。例如可以尝试读取Android系统自带的传感器步数计数器Sensor.TYPE_STEP_COUNTER或者引导用户手动输入。给用户一个选择而不是直接功能失效。数据缓存与更新策略对获取到的步数数据进行缓存并设置合理的过期时间如30分钟。在需要显示时先读缓存同时发起一个异步请求更新数据更新成功后再刷新UI。这能避免等待网络请求时的白屏或卡顿。电量考虑频繁唤醒设备或进行网络请求会耗电。定期同步的任务应使用WorkManager并设置合理的约束条件如在设备充电且连接Wi-Fi时执行。6.4 关于“微信运动修改步数”等热词的联想在搜索过程中你可能看到了“微信运动修改步数”这样的热词。这从侧面反映了用户对步数数据的关注以及数据的可塑性。但作为一名开发者我们必须坚守底线绝不参与或提供任何篡改、伪造健康数据的功能。这不仅违背了健康类应用的初衷也可能违反平台规则甚至法律法规。我们的目标是整合与呈现帮助用户更好地理解自己的健康状况而不是制造虚假的健康表象。如果用户有“修改”需求我们应该引导他们去思考如何通过真实的运动来达成目标或者提供目标设定与达成度的正向激励而不是技术上的捷径。7. 总结与个人体会折腾这一圈下来最大的体会就是接入第三方生态一定要走官方正道。早期我也尝试过分析非公开的Content Provider URI结果就是不同华为手机型号、不同运动健康App版本之间兼容性一塌糊涂今天能跑通明天系统一升级就崩溃维护成本极高用户体验极差。切换到华为Health Kit后虽然前期的注册、配置、签名校验稍微麻烦一点但一旦跑通后面就是一马平川。数据稳定、接口规范、还有详细的技术支持文档和社区。对于需要正式上线的项目花在走通官方流程上的时间绝对会在后期的稳定性和可维护性上加倍回报回来。另外在处理用户健康数据时要时刻保持敬畏之心。每一次权限申请都要清晰告知用户用途获取的数据要安全存储建议加密并且要有明确的隐私政策告知用户数据如何被使用。技术是工具用它来创造正向价值才能走得长远。最后如果你只是做技术原型验证或者个人学习想快速看到效果那么理解Content Provider的机制并做一番探索是很有价值的。但如果是商业项目请务必、务必、务必选择华为Health Kit或类似的其他厂商官方健康开放平台。