Skip to content

feat(ios): update for 4.16.1 #236

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
dcrawbuck merged 2 commits into from
Jul 1, 2026
Merged

feat(ios): update for 4.16.1 #236

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
6585cee
feat(ios): update for 4.16.1
Jul 1, 2026
ed6319d
docs(ios): clarify OneSignal integration attribute
dcrawbuck Jul 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
10 changes: 10 additions & 0 deletions content/docs/ios/changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,16 @@ description: "Release notes for the Superwall iOS SDK"

The changelog for `SuperwallKit`. Also see the [releases](https://github.com/superwall/Superwall-iOS/releases) on GitHub.

## 4.16.1

### Enhancements

- Clarifies that `IntegrationAttribute.onesignalId` should be set to the OneSignal User ID used by the OneSignal integration.

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 1, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Document the OneSignal ID guidance

This release note is still the only iOS docs mention of OneSignal; content/docs/ios/sdk-reference/setIntegrationAttributes.mdx omits .onesignalId from the IntegrationAttribute types, and a repo-wide search for onesignal|OneSignal in the iOS/shared docs only finds this changelog entry. Because the 4.16.1 upstream change is specifically a customer-facing clarification that the value must be the OneSignal User ID, users looking up how to set integration attributes still will not see the corrected guidance outside the changelog.

Useful? React with 👍 / 👎.


### Fixes

- Makes sure that the compiler directive is correct for billing plan types so that the SDK builds in Xcode version 26.4.

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 1, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Guard the billing-plan sample for older compilers

The 4.16.1 release note calls out fixing the compiler directive for billing plan types, but the docs sample in content/docs/ios/sdk-reference/PurchaseController.mdx still references StoreKit.Product.SubscriptionInfo.BillingPlanType under only a runtime #available check (lines 159-170). Apps compiling that snippet with a compiler/SDK that does not know the 26.4 StoreKit symbols will fail before the availability check can help; wrap the billing-plan block in the same #if compiler(...) guard used by the SDK or show an older-compiler fallback.

Useful? React with 👍 / 👎.


## 4.16.0

### Enhancements
Expand Down
2 changes: 1 addition & 1 deletion content/docs/ios/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,6 @@ If you have feedback on any of our docs, please leave a rating and message at th
If you have any issues with the SDK, please [open an issue on GitHub](https://github.com/superwall/superwall-ios/issues).

<SdkLatestVersion
version="4.15.4"
version="4.16.1"
repoUrl="https://github.com/superwall/Superwall-iOS"
/>
2 changes: 1 addition & 1 deletion content/docs/ios/sdk-reference/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,6 @@ If you have feedback on any of our docs, please leave a rating and message at th
If you have any issues with the SDK, please [open an issue on GitHub](https://github.com/superwall/superwall-ios/issues).

<SdkLatestVersion
version="4.15.4"
version="4.16.1"

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 1, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Document the new attribution event

Bumping the SDK reference to 4.16.1 brings in the 4.16.0 public install-attribution API, but content/docs/ios/sdk-reference/SuperwallEvent.mdx still has no attributionMatch/AttributionMatchInfo entry; a repo-wide search for AttributionMatch|attribution_match only finds the changelog/options note. Users forwarding handleSuperwallEvent(withInfo:) will not know about the new event case or payload shape even though this page now advertises the newer SDK version.

Useful? React with 👍 / 👎.

repoUrl="https://github.com/superwall/Superwall-iOS"
/>
2 changes: 2 additions & 0 deletions content/docs/ios/sdk-reference/setIntegrationAttributes.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,7 @@ Superwall.shared.setIntegrationAttributes([
.amplitudeUserId: "user123",
.mixpanelDistinctId: "distinct456",
.firebaseInstallationId: "abc123",
.onesignalId: "onesignal-user-id",
.custom("myCustomKey"): "customValue"
])
```
Expand All @@ -149,6 +150,7 @@ Common integration attributes include:
- `.firebaseInstallationId` - Firebase installation ID (4.10.8+)
- `.appstackId` - Appstack identifier (4.12.11+)
- `.singularDeviceId` - Singular device identifier (SDID) (4.15.4+)
- `.onesignalId` - OneSignal User ID (`onesignal_id`) for the user. Do not use the legacy OneSignal Player ID.
- `.custom(String)` - Custom attribute key

## Related
Expand Down
Loading