Skip to content

Add HealthKit update usage description to Info.plist - #5267

Merged
bgoncal merged 1 commit into
mainfrom
fix/healthkit-update-usage-description
Jul 28, 2026
Merged

Add HealthKit update usage description to Info.plist#5267
bgoncal merged 1 commit into
mainfrom
fix/healthkit-update-usage-description

Conversation

@bgoncal

@bgoncal bgoncal commented Jul 28, 2026

Copy link
Copy Markdown
Member

AI Policy

Select exactly one option that describes AI usage in this contribution:

  • I have not used AI for this contribution.
  • AI assistance was used for this contribution.
  • AI fully generated the code for this contribution, but I've reviewed and understood it before submitting and will respond without AI during review.

Summary

The App Store upload of the iOS build fails with error 90683 because the app now ships the HealthKit entitlement but is missing the NSHealthUpdateUsageDescription key in its Info.plist:

Missing purpose string in Info.plist. ... The Info.plist file for the "Home Assistant.app" bundle should contain a NSHealthUpdateUsageDescription key with a user-facing purpose string...

Apple requires this key whenever the HealthKit entitlement is present, even for read-only usage. The app only reads Health data (requestAuthorization uses an empty toShare set), so the purpose string states that no data is written.

Screenshots

No visual change. The string is only shown if write access is ever requested, which the app never does.

Link to pull request in Documentation repository

Documentation: home-assistant/companion.home-assistant#

Any other notes

Follow-up to #4923 and #5264.

Apple rejects the App Store upload (error 90683) when the HealthKit
entitlement is present but NSHealthUpdateUsageDescription is missing.
The app only reads HealthKit data, so the string states that no data is
written.
Copilot AI review requested due to automatic review settings July 28, 2026 21:19

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR addresses an App Store upload failure (error 90683) by adding the missing HealthKit write-purpose string required whenever the HealthKit entitlement is present, even if the app only reads Health data.

Changes:

  • Add NSHealthUpdateUsageDescription to the app’s Info.plist with a user-facing explanation.

Comment thread Sources/App/Resources/Info.plist
@bgoncal
bgoncal merged commit a1bc76e into main Jul 28, 2026
12 checks passed
@bgoncal
bgoncal deleted the fix/healthkit-update-usage-description branch July 28, 2026 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants