Apple 健康接入链路|授权边界核查 2026-11-05|直接核对 Apple Developer 官方 Markdown 与 Apple Support。仅说明授权和可读取结果的技术边界,最终字段范围、入口与文案仍由产品评审。 核心结论 “介绍拟读取数据 → 系统授权 → 本次读取结果/数据准备 → 数据页”可实现。 “授权后自动准确列出用户批准了哪些读取项、哪些拒绝”无法按公开 HealthKit 常规读取接口完整实现。系统授权页本身由 Apple 显示用户选择;浮光屿回来后只能可靠报告请求过程、查询结果及系统明确给出的有限历史边界。 官方事实 1. HealthKit 读写权限分开且逐数据类型授权。应用可只申请有明确用途的类型,不必一次申请所有字段。“活动”是系统分组或产品描述,实际请求由具体类型集合构成,不能以“活动已授权”推定组下步数、距离、楼层等全有读取权限。普通心率、静息心率、HRV各为独立类型。此次核查不扩大拟申请字段。[1] 2. requestAuthorization(toShare:read:completion:) 的 success 只表示请求处理过程是否成功。官方明确该布尔值不表示用户实际授予权限;即使所有类型早已被允许或拒绝,再调用也可能直接完成且不弹窗。不能凭 success=true 显示“全部授权成功”“已授权5项”。界面应继续执行查询。[2] 3. authorizationStatus(for:) 检查保存到 HealthKit 的权限,即写入权限。它不能查询读权。无读权时外部样本对应用不可见;若应用曾自己写过数据,仍可能只读到自己写的记录。因此既不能将 .sharingAuthorized 当成可读,也不能仅因读到本App写的样本就推定获得外部读取权限。[1][3] 4. getRequestStatusForAuthorization / HKAuthorizationRequestStatus 只表示再次请求给定类型时是否需要显示授权页。unnecessary不等于允许,shouldRequest也不代表某项明确拒绝。用户在本App是否点击过连接,可由本App保存流程标记,但该标记不是系统读权状态。[4] 5. 拒绝读取与没有可读样本无法完整区分。查询空结果的可能原因包括无记录、来源未写入、日期范围没有样本、权限不可读等。技术查询错误独立呈现,不把成功但空与错误混为一类。设备锁定时后台读取也可能暂不可用,不能据此显示撤权。[1][5] 6. iOS 27+ 的 getEarliestAuthorizedSampleDate 可在有边界时给出各类型最早可读日期。其返回项可用于提示“可读取历史自…起”;没有返回项仍无法区分完整访问、拒绝,或有限访问但无明确日期。它不会返回“所有已授权类型”的可靠完整清单。该新接口须做系统版本判断,旧版本不承诺此状态。[6] 建议中间页与状态文案 页面名候选“健康数据准备”或“本次读取结果”,按已确认的申请范围列出数据用途和当下结果。 • 请求前,“选择你愿意分享的数据”,按钮“前往 Apple 健康授权”。可给“稍后设置”继续使用既有记录。 • 请求返回后,“正在读取所选日期的记录”。不要等待“全部已授权”才开放数据页。 • 读取到记录,“已读取记录”,并可显示日期范围、条数或最近记录时间,具体展示粒度另定。这描述本次结果,不承诺持续授权。 • 查询成功但无外部可读记录,“暂无可读取记录”。说明候选“可能尚无记录,或尚未允许读取。你可以继续,也可以前往系统中查看设置。” • 请求或查询错误,“读取暂未完成”,保留继续与重试,错误确切且适合用户理解时才具体解释。 • 历史范围有限且系统能确认,“可读取的历史自〔日期〕起”。 • 有部分记录时,“已找到部分记录”,逐项显示可读结果。避免“只授权了2项/剩余3项未授权”的推断。 • 继续按钮可称“查看生活记录”或“进入数据页”;只有App自己明确关闭数据用途时,才用“已暂停本应用读取”描述App内部选择。缓存保留与清理按后续冻结策略执行。 权限调整与恢复的真实路径 Apple 当前中文支持文档(页面标注2026-09-16)给出的健康内路径是“健康 App → 右上个人资料 → 隐私下的 App → 浮光屿 → 调整健康类别”。英文资料同样列 Apps。可在教程中附“具体名称可能随系统版本不同,以系统界面为准”。本次没有实机验证拟支持的全部 iOS,不能擅自把 App 改成另一个菜单名。[7][8] Apple 系统隐私文档亦确认“设置 → 隐私与安全性”中可管理健康数据访问。具体浮光屿条目是否出现,须该App已请求相应权限后验证。可作为备用文字指引。[9] UIApplication.openSettingsURLString 的官方定义仅保证打开本App在设置中的自定义设置页(若有)。它不承诺直接跳到健康读权页或某一个指标开关;发布前按目标 iOS 实测。按钮标“查看权限管理指引”始终可实现。若按钮标“打开设置”,应严格对应实际能打开的系统位置,且附后续导航指引。[10] 已有类型被拒后,再点同一授权请求不保证重弹该项;提供系统管理指引,用户回来后重新查询。新添加的请求类型可能触发新的系统授权页。不能在App里制作看似真实、实际控制系统读权的开关。[2] 不得在原型或需求中承诺 • 自动检测普通健康类型的“已允许读取/已拒绝读取”完整列表。 • 授权完成等于全部字段允许,或允许等于当天一定有数据。 • 显示没有数据即用户未运动、没睡,或说明某个具体读权被拒。 • 再点授权一定重弹已拒绝的项目,或默认存在可直达某项健康读权的公开深链。 • 列出数据来源即已直接连接该设备;读权通过亦不证明外部设备已实时同步。 建议验收 全选允许、部分允许、全不允许、空库、只有本App自写记录、外部来源有记录、重复请求不弹窗、用户系统内改权后返回、查询错误与有限历史分别走通。所有状态按请求过程和查询结果判定。已有缓存与当前查询结果分开,不能由缓存存在显示“当前已授权”。最终文案与按钮是否可达均在目标 iOS 真机验证。 原始 Apple 来源 [1] 授权总则与有限历史 https://developer.apple.com/documentation/healthkit/authorizing-access-to-health-data [2] 授权请求 completion 成功的含义 https://developer.apple.com/documentation/healthkit/hkhealthstore/requestauthorization(toshare:read:completion:) [3] authorizationStatus 只检查写入权限 https://developer.apple.com/documentation/healthkit/hkhealthstore/authorizationstatus(for:) [4] 授权页请求状态 https://developer.apple.com/documentation/healthkit/hkhealthstore/getrequeststatusforauthorization(toshare:read:completion:) 及 https://developer.apple.com/documentation/healthkit/hkauthorizationrequeststatus [5] 隐私与锁屏读取 https://developer.apple.com/documentation/healthkit/protecting-user-privacy [6] iOS27+ 最早可读日期及无法区分全读/拒读的限制 https://developer.apple.com/documentation/healthkit/hkhealthstore/getearliestauthorizedsampledate(for:completion:) [7] 当前中文健康App菜单路径 https://support.apple.com/zh-cn/108779 [8] 选择与健康共享的App https://support.apple.com/en-gb/104997 [9] iOS隐私管理说明 https://support.apple.com/en-us/102515 [10] 公共“打开本App设置”入口 https://developer.apple.com/documentation/uikit/uiapplication/opensettingsurlstring 核查方法 本轮先打开官方网页,Apple Developer JavaScript壳页无法返回正文时读取其官方 .md 版本,内容包括方法参数、Discussion和iOS最低可用版本。以上结论为公开接口与官方说明核对,未运行浮光屿安装包或目标机授权实测。