Skip to content

Create "What's new" engine#4664

Merged
bgoncal merged 4 commits into
mainfrom
whats-new
May 27, 2026
Merged

Create "What's new" engine#4664
bgoncal merged 4 commits into
mainfrom
whats-new

Conversation

@bgoncal
Copy link
Copy Markdown
Member

@bgoncal bgoncal commented May 26, 2026

Summary

This PR adds the foundation to set and display "What's new" screen linked to app version.

Screenshots

CleanShot 2026-05-26 at 14 04 20@2x

Link to pull request in Documentation repository

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

Any other notes

@bgoncal bgoncal self-assigned this May 26, 2026
Copilot AI review requested due to automatic review settings May 26, 2026 12:04
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 introduces the initial “What’s New” system for the iOS app: a small engine + models + SwiftUI view to present version/platform-scoped native release notes, with persistence for “seen” releases and entry points from app launch and Settings.

Changes:

  • Add WhatsNewEngine, models, and an (empty) catalog to decide which release notes to show per app version/platform.
  • Present “What’s New” on app launch (over the WebViewController) and add a Settings entry to open the latest applicable release.
  • Persist “seen” release IDs in SettingsStore, add localizations, and add unit tests covering selection logic and persistence.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
Tests/App/WhatsNew/WhatsNewEngine.test.swift Adds unit tests for engine selection logic, release ID stability, and persistence of “seen” releases.
Sources/Shared/Settings/SettingsStore.swift Stores and updates a persisted set of “seen” What’s New release IDs in app-group UserDefaults.
Sources/Shared/Resources/Swiftgen/Strings.swift SwiftGen output updated to include new L10n.WhatsNew accessors.
Sources/App/WhatsNew/WhatsNewView.swift Adds the SwiftUI “What’s New” UI to display release items and mark as viewed.
Sources/App/WhatsNew/WhatsNewModels.swift Adds version/platform/item/release models and stable releaseID computation.
Sources/App/WhatsNew/WhatsNewEngine.swift Implements release selection (releaseToShow, latestRelease) and “mark seen” behavior.
Sources/App/WhatsNew/WhatsNewCatalog.swift Adds the catalog entry point for defining native “What’s New” releases (currently empty).
Sources/App/Settings/Settings/SettingsView.swift Replaces the Settings “What’s New” behavior with a native sheet flow (currently gated on catalog content).
Sources/App/Resources/en.lproj/Localizable.strings Adds English strings for the new “What’s New” view title and version format.
Sources/App/Frontend/WebView/WebViewWindowController.swift Adds automatic “What’s New” presentation after app launch once the web view is ready.
HomeAssistant.xcodeproj/project.pbxproj Wires new source files into the app target and adds the new test file to the unit test target.

Comment thread Sources/App/WhatsNew/WhatsNewView.swift Outdated
Comment thread Sources/App/Settings/Settings/SettingsView.swift
Agent-Logs-Url: https://github.com/home-assistant/iOS/sessions/d06d2fbf-7b3b-4534-aee0-56023dee1876

Co-authored-by: bgoncal <5808343+bgoncal@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI commented May 26, 2026

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • cdn.jsdelivr.net
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/pod install --repo-update --64 -o crc8_1wire.o /tmp/ccco6PGh.s /usr/include/rubas s /usr/include/rub/usr/include/x86_64-linux-gnu/ruby-3.2.0 as s by-3.2.0 -I kward -I /usr/include/rub-I -I as (dns block)
  • https://api.github.com/repos/fastlane/fastlane/releases
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint --gdwarf-5 --64 -o crc8_ext.o /tmp/ccDEZI20.s -I y-3.2.0/ruby/bac-I -I y-3.2.0 -qui�� -I . _64-linux-gnu/ru-I /usr/include/x86as y-3.2.0/ruby/bac-I /usr/include/rub. y-3.2.0 (http block)
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane test x86_64-linux-gnu -D _FORTIFY_SOURCE=3 conftest.c -quiet -dumpbase conftest.c -dumpbase-ext .c comp�� /x86_64-linux-gn-I /libexec/gcc/x86/usr/include/ruby-3.2.0/ruby/backward by-3.2.0 s-through=-lgcc kward s-through=-lc /x86_64-linux-gn-I (http block)
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint -pie s-th�� _64-linux-gnu/ru-I -I de/node/bin/as -I kward -I as -I by-3.2.0 -I kward -I /usr/include/rub/usr/bin/gem -I e (http block)
  • https://api.github.com/search/issues
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint --gdwarf-5 --64 -o crc8_ext.o /tmp/ccDEZI20.s -I y-3.2.0/ruby/bac-I -I y-3.2.0 -qui�� -I . _64-linux-gnu/ru-I /usr/include/x86as y-3.2.0/ruby/bac-I /usr/include/rub. y-3.2.0 (http block)
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint -pie s-th�� _64-linux-gnu/ru-I -I de/node/bin/as -I kward -I as -I by-3.2.0 -I kward -I /usr/include/rub/usr/bin/gem -I e (http block)
  • www.google-analytics.com
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane test x86_64-linux-gnu -D _FORTIFY_SOURCE=3 conftest.c -quiet -dumpbase conftest.c -dumpbase-ext .c comp�� /x86_64-linux-gn-I /libexec/gcc/x86/usr/include/ruby-3.2.0/ruby/backward by-3.2.0 s-through=-lgcc kward s-through=-lc /x86_64-linux-gn-I (dns block)
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint --gdwarf-5 --64 -o crc8_ext.o /tmp/ccDEZI20.s -I y-3.2.0/ruby/bac-I -I y-3.2.0 -qui�� -I . _64-linux-gnu/ru-I /usr/include/x86as y-3.2.0/ruby/bac-I /usr/include/rub. y-3.2.0 (dns block)
    • Triggering command: /usr/bin/ruby3.2 ruby3.2 /home/REDACTED/work/iOS/iOS/vendor/bundle/ruby/3.2.0/bin/fastlane lint -pie s-th�� _64-linux-gnu/ru-I -I de/node/bin/as -I kward -I as -I by-3.2.0 -I kward -I /usr/include/rub/usr/bin/gem -I e (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

@codecov
Copy link
Copy Markdown

codecov Bot commented May 26, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (main@3293f43). Learn more about missing BASE report.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4664   +/-   ##
=======================================
  Coverage        ?   44.07%           
=======================================
  Files           ?      280           
  Lines           ?    17028           
  Branches        ?        0           
=======================================
  Hits            ?     7505           
  Misses          ?     9523           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@bgoncal bgoncal merged commit 59b87c9 into main May 27, 2026
12 checks passed
@bgoncal bgoncal deleted the whats-new branch May 27, 2026 08:07
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.

3 participants