Skip to content

docs: consolidate framework patch notes #266

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hyochan merged 2 commits into from
Aug 1, 2026
Merged

docs: consolidate framework patch notes #266

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
85be102
docs: consolidate framework patch notes
hyochan Aug 1, 2026
11edf58
docs: preserve consolidated release aliases
hyochan Aug 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/pr-previews/pr-consolidated-framework-patches.mp4
View file
Open in desktop
Binary file not shown.
219 changes: 79 additions & 140 deletions packages/docs/src/pages/docs/updates/releases.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,15 @@ interface Note {
element: React.ReactNode;
}

const appStoreToolchainPatchReleases = [
const frameworkIosPatchReleases = [
['react-native-iap 16.0.1', 'react-native-iap-16.0.1'],
['godot-iap 3.0.1', 'godot-iap-3.0.1'],
['OpenIap.Maui 2.0.1', 'maui-iap-2.0.1'],
] as const;

const reactNativeListenerLifecycleReleases = [
['react-native-iap 16.0.1', 'react-native-iap-16.0.1'],
const frameworkIosPatchAliases = [
'react-native-iap-ios-listener-lifecycle-2026-08-01',
'app-store-toolchain-compatibility-2026-08-02',
] as const;
Comment thread
hyochan marked this conversation as resolved.

const androidOfferCodeReleases = [
Expand Down Expand Up @@ -143,20 +145,24 @@ function Releases() {
useScrollToHash();

const allNotes: Note[] = [
// August 2, 2026 - App Store toolchain compatibility patch
// August 2, 2026 - Apple framework compatibility patches
{
id: 'app-store-toolchain-compatibility-2026-08-02',
id: 'apple-framework-compatibility-patches-2026-08-02',
aliases: frameworkIosPatchAliases,
date: new Date('2026-08-02'),
element: (
<div
key="app-store-toolchain-compatibility-2026-08-02"
key="apple-framework-compatibility-patches-2026-08-02"
style={noteCardStyle}
>
{frameworkIosPatchAliases.map((alias) => (
<span key={alias} id={alias} aria-hidden="true" />
))}
<AnchorLink
id="app-store-toolchain-compatibility-2026-08-02"
id="apple-framework-compatibility-patches-2026-08-02"
level="h4"
>
August 2, 2026 - App Store toolchain compatibility patch
August 2, 2026 - Apple framework compatibility patches
</AnchorLink>

<p
Expand All @@ -165,9 +171,30 @@ function Releases() {
color: 'var(--text-secondary)',
}}
>
Publishes stable-toolchain rebuilds for the framework packages that
distribute precompiled Apple binaries. This fixes the App Store
validation failure reported in{' '}
Publishes coordinated framework patches for iOS listener stability
and App Store-compatible precompiled Apple binaries.{' '}
<strong>react-native-iap 16.0.1</strong> includes the listener
cleanup fix from{' '}
<a
href="https://github.com/hyodotdev/openiap/pull/262"
target="_blank"
rel="noopener noreferrer"
className="external-link"
>
PR #262
</a>
, while <strong>OpenIap.Maui 2.0.1</strong> and{' '}
<strong>godot-iap 3.0.1</strong> ship the stable-toolchain rebuilds
from{' '}
<a
href="https://github.com/hyodotdev/openiap/pull/265"
target="_blank"
rel="noopener noreferrer"
className="external-link"
>
PR #265
</a>{' '}
for the App Store validation failure reported in{' '}
<a
href="https://github.com/hyodotdev/openiap/issues/264"
target="_blank"
Expand All @@ -176,13 +203,10 @@ function Releases() {
>
issue #264
</a>
{', where '}
<code>OpenIap.Maui 2.0.0</code> embedded an Xcode 27 beta
XCFramework whose <code>LC_BUILD_VERSION</code> recorded SDK 27.0,
above the App Store maximum of 26.5.
.
</p>

<h5 style={{ margin: '0 0 0.5rem 0' }}>MAUI</h5>
<h5 style={{ margin: '0 0 0.5rem 0' }}>React Native</h5>
<ul
style={{
marginBottom: '1rem',
Expand All @@ -191,41 +215,27 @@ function Releases() {
}}
>
<li>
<strong>OpenIap.Maui 2.0.1</strong> rebuilds the Apple XCFramework
packed into NuGet with Xcode 26.6 and iPhoneOS SDK 26.5. Device,
simulator, and Mac Catalyst slices now carry the App
Store-accepted SDK metadata.
On iOS, the singleton native purchase and purchase-error listeners
now stay attached for the connection session. Removing a
JavaScript subscription still detaches its callback, so an
unmounted screen does not receive new purchase or error events.
</li>
<li>
The release pipeline verifies the selected Xcode and SDK before
packing, then inspects every packaged Mach-O slice so an Xcode 27
linker signature or a mismatched SDK fails the release before it
reaches NuGet.
</li>
</ul>

<h5 style={{ margin: '0 0 0.5rem 0' }}>Godot</h5>
<ul
style={{
marginBottom: '1rem',
paddingLeft: '1.25rem',
fontSize: '0.9rem',
}}
>
<li>
<strong>godot-iap 3.0.1</strong> rebuilds its precompiled iOS
GDExtension frameworks with the same App Store-accepted Xcode 26.6
/ SDK 26.5 toolchain and rejects unaccepted toolchain provenance
during CI and release packaging.
A purchase event that entered before unmount can still deliver a
late <code>onPurchaseSuccess</code> after its asynchronous refresh
completes, preserving the documented{' '}
<code>finishTransaction</code> path. Internal hook state updates
remain mount-guarded.
</li>
<li>
Source-based Apple integrations and framework packages that do not
distribute a precompiled OpenIAP Apple framework require no
release for this fix.
Re-mounted screens reuse the retained iOS native listeners and
receive newly registered JavaScript callbacks without duplicate
native subscriptions. Android listener removal and reattachment
behavior is unchanged.
</li>
</ul>

<h5 style={{ margin: '0 0 0.5rem 0' }}>Integration notes</h5>
<h5 style={{ margin: '0 0 0.5rem 0' }}>MAUI</h5>
<ul
style={{
marginBottom: '1rem',
Expand All @@ -234,89 +244,19 @@ function Releases() {
}}
>
<li>
No API migration is required. MAUI applications rejected with the
SDK 27.0 validation message should upgrade to{' '}
<code>OpenIap.Maui 2.0.1</code> and rebuild the archive before
resubmitting it.
<strong>OpenIap.Maui 2.0.1</strong> rebuilds the Apple XCFramework
packed into NuGet with Xcode 26.6 and iPhoneOS SDK 26.5. Device,
simulator, and Mac Catalyst slices now carry the App
Store-accepted SDK metadata.
</li>
<li>
Xcode 27 remains a source-compatibility CI lane until Apple
accepts it for App Store submissions. Compiler-gated StoreKit 27
behavior is therefore not included in these stable precompiled
artifacts yet.
The release pipeline inspects every packaged Mach-O slice so an
Xcode 27 linker signature, a mismatched SDK, or coverage
instrumentation fails the release before it reaches NuGet.
</li>
</ul>

<div
style={{
paddingTop: '1rem',
borderTop: '1px solid var(--border-color)',
}}
>
<h5 style={{ margin: '0 0 0.5rem 0' }}>Package Releases</h5>
<ul
style={{
margin: 0,
paddingLeft: '1.25rem',
fontSize: '0.9rem',
}}
>
{appStoreToolchainPatchReleases.map(([label, tag]) => (
<li key={tag}>
<a
href={`https://github.com/hyodotdev/openiap/releases/tag/${tag}`}
target="_blank"
rel="noopener noreferrer"
>
{label}
</a>
</li>
))}
</ul>
</div>
</div>
),
},

// August 1, 2026 - React Native iOS listener lifecycle patch
{
id: 'react-native-iap-ios-listener-lifecycle-2026-08-01',
date: new Date('2026-08-01'),
element: (
<div
key="react-native-iap-ios-listener-lifecycle-2026-08-01"
style={noteCardStyle}
>
<AnchorLink
id="react-native-iap-ios-listener-lifecycle-2026-08-01"
level="h4"
>
August 1, 2026 - React Native iOS listener lifecycle patch
</AnchorLink>

<p
style={{
marginBottom: '1rem',
color: 'var(--text-secondary)',
}}
>
Publishes <strong>react-native-iap 16.0.1</strong> with the iOS
listener cleanup fix from{' '}
<a
href="https://github.com/hyodotdev/openiap/pull/262"
target="_blank"
rel="noopener noreferrer"
className="external-link"
>
PR #262
</a>
. Dismissing a plans or paywall screen while StoreKit and Nitro
listener work is still in flight no longer tears down the final
native listener during the transition, avoiding the release-build
abort reported by consumer apps.
</p>

<h5 style={{ margin: '0 0 0.5rem 0' }}>React Native</h5>
<h5 style={{ margin: '0 0 0.5rem 0' }}>Godot</h5>
<ul
style={{
marginBottom: '1rem',
Expand All @@ -325,23 +265,15 @@ function Releases() {
}}
>
<li>
On iOS, the singleton native purchase and purchase-error listeners
now stay attached for the connection session. Removing a
JavaScript subscription still detaches its callback, so an
unmounted screen does not receive new purchase or error events.
</li>
<li>
A purchase event that entered before unmount can still deliver a
late <code>onPurchaseSuccess</code> after its asynchronous refresh
completes, preserving the documented{' '}
<code>finishTransaction</code> path. Internal hook state updates
remain mount-guarded.
<strong>godot-iap 3.0.1</strong> rebuilds its precompiled iOS
GDExtension frameworks with the same App Store-accepted Xcode 26.6
/ SDK 26.5 toolchain and rejects unaccepted toolchain provenance
during CI and release packaging.
</li>
<li>
Re-mounted screens reuse the retained iOS native listeners and
receive newly registered JavaScript callbacks without duplicate
native subscriptions. Android listener removal and reattachment
behavior is unchanged.
Source-based Apple integrations and framework packages that do not
distribute a precompiled OpenIAP Apple framework require no
release for this fix.
</li>
</ul>

Expand All @@ -360,8 +292,15 @@ function Releases() {
<code>finishTransaction</code>.
</li>
<li>
The OpenIAP Spec, native Apple and Google packages, and other
framework libraries are unchanged by this React Native-only patch.
MAUI applications rejected with the SDK 27.0 validation message
should upgrade to <code>OpenIap.Maui 2.0.1</code>, rebuild the
archive, and resubmit it.
</li>
<li>
Xcode 27 remains a source-compatibility CI lane until Apple
accepts it for App Store submissions. Compiler-gated StoreKit 27
behavior is not included in these stable precompiled artifacts
yet.
</li>
</ul>

Expand All @@ -379,7 +318,7 @@ function Releases() {
fontSize: '0.9rem',
}}
>
{reactNativeListenerLifecycleReleases.map(([label, tag]) => (
{frameworkIosPatchReleases.map(([label, tag]) => (
<li key={tag}>
<a
href={`https://github.com/hyodotdev/openiap/releases/tag/${tag}`}
Expand Down