Skip to content

Prepare the v2.1.0 stable release - #90

Merged
Mx-Iris merged 2 commits into
mainfrom
release/v2.1.0
Aug 12, 2026
Merged

Prepare the v2.1.0 stable release#90
Mx-Iris merged 2 commits into
mainfrom
release/v2.1.0

Conversation

@Mx-Iris

@Mx-Iris Mx-Iris commented Aug 12, 2026

Copy link
Copy Markdown
Member

Two things stand between the current main and cutting v2.1.0.

Bump the helper daemon protocol to 1.5.0

RuntimeViewerServiceVersion is the only signal that makes an installed client
replace its privileged helper — the launch-time check compares the running
daemon's reported version against this constant and reinstalls only on a
mismatch. A new app build ships a new daemon binary, but nothing installs it
while the string is unchanged.

Three daemon-side changes have landed since the constant last moved to 1.4.0:

RuntimeViewerCommunication/SandboxProbe.swift          | 60 ++++
RuntimeViewerServer/RuntimeViewerServer.swift          | 10 +-
RuntimeViewerServer/main.m                             | 44 +++

That is the work behind RC.3's "code injection picks its path from the whole
rule". It has been sitting in the shipped binary with no installed helper
picking it up, so RC.3 users have been running the 1.4.0 daemon and never got
the fix the release notes promised. Bumping here is what delivers it.

Documentations/SparkleRelease.md gains a pre-flight section with the diff
command, since nothing enforces this the way ArchiveScript.sh enforces
MARKETING_VERSION against --version-tag.

Add Changelogs/v2.1.0.md

Consolidates the whole 2.1 line — stable-channel users arriving from v2.0.1
have seen none of the nine betas or three release candidates. Two spots where
the RC notes could not simply be concatenated:

  • RC.1 announced that per-image protocol lists had stopped including imported
    protocols. RC.2 reverted that after it emptied UIKitCore and Foundation, so
    only RC.2's account survives.
  • The upgrade notes spell out that RC.3 users are prompted to reinstall the
    helper as well. That is new to this release, not carried over.

MARKETING_VERSION is already 2.1.0, so nothing there needs to move.

After merge

Tag v2.1.0 on main and push it; release.yml builds, notarizes, publishes
the GitHub Release, and opens the appcast PR. Channel is inferred as stable
from the tag, so this one reaches all users rather than only opt-in clients.

`RuntimeViewerServiceVersion` is the only signal that makes an installed
client replace its privileged helper: the launch-time check compares the
running daemon's reported version against this constant and reinstalls
only on a mismatch.

Three daemon-side changes have landed since the constant last moved to
1.4.0 — the sandbox probe gained the code-signing predicate, and both the
server and its entry point followed it — so the injection routing that
v2.1.0-RC.3 advertised has been sitting in the shipped binary without any
installed helper picking it up. Bumping to 1.5.0 is what delivers it.

Also record the pre-flight check in the release runbook, since nothing
enforces this the way ArchiveScript.sh enforces MARKETING_VERSION.
Consolidates the whole 2.1 line for stable-channel users coming from
v2.0.1, who have seen none of the nine betas or three release candidates.

Two places where the RC notes cannot simply be concatenated: RC.1
announced that per-image protocol lists had stopped including imported
protocols, which RC.2 then reverted after it emptied UIKitCore and
Foundation, so only RC.2's account survives here; and the upgrade notes
call out that RC.3 users are prompted to reinstall the helper too, which
is new to this release rather than carried over.
Copilot AI lite review requested due to automatic review settings August 12, 2026 02:41
@Mx-Iris
Mx-Iris merged commit 666ff49 into main Aug 12, 2026
1 check passed
@Mx-Iris
Mx-Iris deleted the release/v2.1.0 branch August 12, 2026 02:42

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

Prepares the v2.1.0 stable release by ensuring updated privileged-helper behavior is actually delivered to existing installations, and by documenting release checks + consolidating release notes for stable-channel users.

Changes:

  • Bumped RuntimeViewerServiceVersion from 1.4.01.5.0 so the app reinstalls the privileged helper daemon on launch after upgrade.
  • Added a Sparkle release runbook pre-flight checklist section to prevent future “daemon changes shipped but never installed” misses.
  • Added a consolidated Changelogs/v2.1.0.md covering the full 2.1 beta/RC line for stable-channel users.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
RuntimeViewerCore/Sources/RuntimeViewerCommunication/RuntimeRequestResponse.swift Bumps the app↔daemon protocol/version constant to trigger helper reinstall.
Documentations/SparkleRelease.md Documents a pre-flight diff procedure to validate whether the helper protocol version needs a bump before cutting a release.
Changelogs/v2.1.0.md Adds consolidated stable release notes for v2.1.0 including upgrade notes about helper reinstall.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants