Skip to content

fix(native): avoid a missing WebKit runtime library on older OS versions - #526

Merged
markbang merged 2 commits into
mainfrom
codex/apple-webkit-compat
Nov 18, 2026
Merged

markbang merged 2 commits into
mainfrom
codex/apple-webkit-compat

Conversation

@markbang

Copy link
Copy Markdown
Collaborator

Summary

The clients crash before launching on supported older OS runtimes because the Swift callAsyncJavaScript wrapper adds a required dependency on /usr/lib/swift/libswiftWebKit.dylib. Call the same public Objective-C WebKit method directly, preserving structured arguments, the page content world and asynchronous delivery.

-webView.callAsyncJavaScript(..., in: nil, in: .page, completionHandler: nil)
+webView.__callAsyncJavaScript(..., inFrame: nil, in: .page, completionHandler: nil)

__callAsyncJavaScript is the public method refined for Swift, not a private API; WebKit's wrapper calls this entry point itself. This change applies to iOS and macOS.

Evidence

  • Before: iPad acceptance crashes in dyld on iOS 18.5: Library not loaded: /usr/lib/swift/libswiftWebKit.dylib. The production IPA 1.0.0 (15.1) contains the same required library and one undefined wrapper symbol.
    After: simulator and Mac store builds now check the produced binaries for this runtime dependency. Native acceptance is running against the corrected code in test(native): capture store screenshots and verify Apple clients #523.
  • No domain, signing or user-data behavior is changed. The original typed argument passing is retained.

Merge Danger

Door: two-way

Blast Radius: native

Rebuild both store artifacts after merging; the already-generated binaries still contain the incompatible library dependency. Full TestFlight acceptance remains separate from compilation checks.

@github-actions

Copy link
Copy Markdown
Contributor

Desktop build

0.295.1 · dev · 923e7da

Platform Download
macOS, Apple silicon Workflow artifacts, unsigned
macOS, Intel Workflow artifacts, unsigned
Windows x64 Workflow artifacts, unsigned
Linux x64 Cohub-0.295.1-dev-x64.AppImage · SHA-256

@markbang
markbang merged commit 1a82596 into main Nov 18, 2026
16 checks passed
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.

1 participant