Skip to content

fix: ship app store-safe apple artifacts - #265

Merged
hyochan merged 4 commits into
mainfrom
fix/maui-app-store-toolchain
Aug 1, 2026
Merged

hyochan merged 4 commits into
mainfrom
fix/maui-app-store-toolchain

Conversation

@hyochan

@hyochan hyochan commented Aug 1, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Fix App Store validation failures from MAUI NuGet packages that embedded an Xcode 27 / SDK 27.0 XCFramework.
  • Publish precompiled MAUI and Godot Apple artifacts with Xcode 26.6, SDK 26.5, and linker 1267.0 provenance checks.
  • Add release documentation for the OpenIap.Maui 2.0.1 and godot-iap 3.0.1 compatibility patches.

Closes #264.

Changes

MAUI release safety

  • Keep Xcode 27 as a source-compatibility CI lane.
  • Build stable NuGet Apple sidecars on macos-26 with Xcode 26.6.
  • Verify the active Xcode/SDK and every device, simulator, and Mac Catalyst Mach-O slice before packing or publishing.
  • Reject SDK drift, unexpected linker provenance, and coverage-instrumented release binaries.

Godot precompiled frameworks

  • Rebuild the tracked iOS frameworks with Xcode 26.6 / SDK 26.5.
  • Disable Swift and Clang coverage instrumentation for release framework builds.
  • Require exact stable SDK/linker metadata and reject coverage sections during CI and release packaging.

Documentation

  • Document the affected precompiled-framework scope and stable-toolchain policy.
  • Add the planned patch-release entry and migration guidance before deployment.

Test plan

  • MAUI Apple binding, shared library, contract tests, unit tests, and NuGet pack
  • MAUI simulator and device consumer application links
  • Stable XCFramework verifier accepts Xcode 26.6 / SDK 26.5 / LD 1267.0 output
  • Stable XCFramework verifier rejects the published OpenIap.Maui 2.0.0 SDK 27.0 artifact
  • Godot Swift tests and GDScript test suites
  • Godot iOS export, device archive, IPA creation, embedded-framework provenance, and code-sign verification
  • bun run audit:parity
  • bun run audit:docs and 38 docs audit tests
  • bun run audit:release-state and 18 release-policy tests
  • Docs typecheck and production build
  • Workflow YAML parsing and git diff --check

Preview

Watch the release-notes page preview. The primary behavior change is enforced in build and release pipelines; the test plan above records the artifact-level proof.

Build stable MAUI package artifacts with Xcode 26.6 and verify every embedded Apple slice before publication. Rebuild Godot's precompiled iOS frameworks with the accepted SDK, reject coverage-instrumented release binaries, and document the patch releases.
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@hyochan hyochan added cross-platform Cross-platform (both Android & iOS) godot-iap godot-iap library maui 💨 ci Cloud integration 📖 documentation Improvements or additions to documentation 📱 iOS Related to iOS 🛠 bugfix All kinds of bug fixes labels Aug 1, 2026
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@coderabbitai

coderabbitai Bot commented Aug 1, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@hyochan, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 33 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: af9d8b8f-bae1-4c25-ac2c-a7e235d56e8b

📥 Commits

Reviewing files that changed from the base of the PR and between 394e046 and c9e25a4.

⛔ Files ignored due to path filters (1)
  • .github/pr-previews/pr-265-app-store-toolchain.mp4 is excluded by !**/*.mp4
📒 Files selected for processing (11)
  • .github/workflows/ci-maui-iap.yml
  • .github/workflows/release-maui.yml
  • libraries/godot-iap/Makefile
  • libraries/godot-iap/README.md
  • libraries/godot-iap/addons/godot-iap/bin/ios/GodotIap.framework/GodotIap
  • libraries/godot-iap/addons/godot-iap/bin/ios/SwiftGodotRuntime.framework/SwiftGodotRuntime
  • libraries/godot-iap/scripts/verify-ios-toolchain.sh
  • libraries/maui-iap/README.md
  • packages/apple/scripts/verify-app-store-xcframework.sh
  • packages/docs/src/pages/docs/updates/releases.tsx
  • scripts/audit-non-godot-parity.mjs
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/maui-app-store-toolchain

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This pull request addresses App Store submission rejections caused by MAUI (and other framework) releases embedding Apple binaries built with a non–App Store accepted Xcode/SDK. It enforces a stable toolchain lane for producing distributable Apple artifacts while keeping an Xcode 27 compatibility lane for source validation, and updates documentation/release notes accordingly.

Changes:

  • Split MAUI CI/release workflows to build App Store–safe XCFramework sidecars on macos-26 with pinned Xcode/SDK/LD versions, while retaining xcode-27 validation lanes.
  • Add/extend toolchain provenance verification scripts to reject SDK drift, unexpected linker provenance, and coverage-instrumented binaries.
  • Add documentation updates and a release-note entry for the patch releases.

Reviewed changes

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

Show a summary per file
File Description
scripts/audit-non-godot-parity.mjs Adds parity/audit assertions ensuring MAUI/Godot pipelines pin the stable App Store toolchain and run provenance verification.
packages/docs/src/pages/docs/updates/releases.tsx Adds a release-note entry and links for the App Store toolchain patch releases.
packages/apple/scripts/verify-app-store-xcframework.sh New verifier script for MAUI-packaged XCFramework toolchain/SDK/linker provenance and coverage instrumentation.
libraries/maui-iap/README.md Updates MAUI docs to describe the stable-toolchain policy and Xcode 27 being validation-only.
libraries/godot-iap/scripts/verify-ios-toolchain.sh Updates Godot iOS framework provenance verification to enforce stable SDK/LD and reject coverage instrumentation.
libraries/godot-iap/README.md Updates Godot docs to reflect stable App Store toolchain requirements and behavior differences.
libraries/godot-iap/Makefile Disables Swift/Clang coverage instrumentation in release framework builds.
.github/workflows/release-maui.yml Pins stable App Store toolchain for publish artifacts and adds provenance verification.
.github/workflows/ci-maui-iap.yml Adds a dedicated stable App Store artifact job and broadens path filters to include new scripts.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/apple/scripts/verify-app-store-xcframework.sh Outdated
Comment thread libraries/godot-iap/scripts/verify-ios-toolchain.sh Outdated
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@coderabbitai

coderabbitai Bot commented Aug 1, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The head commit changed during the review from 294421e to c37d7c9.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/maui-app-store-toolchain

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 12 changed files in this pull request and generated no new comments.

Suppressed comments (1)

libraries/godot-iap/scripts/verify-ios-toolchain.sh:22

  • The SDK provenance check only verifies that some sdk line matches EXPECTED_SDK_VERSION. If the vtool -show-build output contains multiple SDK entries (e.g., multiple LC_BUILD_VERSION blocks/slices) and any of them drift, this can still pass. It should fail if any recorded SDK differs, and also fail if no SDK entry exists (consistent with the XCFramework verifier).
  if ! awk -v expected="$EXPECTED_SDK_VERSION" \
    '$1 == "sdk" && $2 == expected { found = 1 } END { exit found ? 0 : 1 }' \
    <<<"$build_info"; then

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 12 changed files in this pull request and generated no new comments.

@hyodotdev hyodotdev deleted a comment from coderabbitai Bot Aug 1, 2026
@hyodotdev hyodotdev deleted a comment from coderabbitai Bot Aug 1, 2026
@hyodotdev hyodotdev deleted a comment from coderabbitai Bot Aug 1, 2026
@hyochan
hyochan merged commit 98ecc7e into main Aug 1, 2026
18 checks passed
@hyochan
hyochan deleted the fix/maui-app-store-toolchain branch August 1, 2026 17:07
@hyochan

hyochan commented Aug 1, 2026 •

Copy link
Copy Markdown
Member Author

Release and deployment verification is complete.

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

Labels

🛠 bugfix All kinds of bug fixes 💨 ci Cloud integration cross-platform Cross-platform (both Android & iOS) 📖 documentation Improvements or additions to documentation godot-iap godot-iap library 📱 iOS Related to iOS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] maui-iap 2.0.0 uses a framework built with a beta version of xcode

2 participants