[SDK-237] Set up embedded for iOS #795

lposen · 2026-01-11T05:26:28Z

🔹 JIRA Ticket(s) if any

SDK-237

✏️ Description

Adds ability to enable embedded from iOS
Adds entitlements needed for webview to example
Added workaround for weird iOS login issue

Testing

Run the setup
Login and then click on the "Embedded" tab
The app should successfully log in the the embedded tab should successfully show.
- IMPORTANT: None of the buttons in there will work correctly at this point.

Setup

cd into root and run yarn install
cd into example and run yarn install
cd into ios and run bundle exec pod install
open two separate terminals.
In Terminal 1
- run watchman watch-del-all
- run yarn start --reset-cache
In Terminal 2
- cd into ios
- run open ReactNativeSdkExample.xcworkspace
- Once Xcode opens the project, choose an emulator then click the play button to run it.

…ialization

…ities

github-actions · 2026-01-11T05:26:59Z

Lines	Statements	Branches	Functions
	62.72% (392/625)	38.64% (97/251)	61.5% (139/226)

qltysh · 2026-01-11T05:27:12Z

Coverage Impact

This PR will not change total coverage.

🚦 See full report on Qlty Cloud »

🛟 Help

Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.
Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.
File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)
- Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

qltysh · 2026-01-11T05:28:07Z

2 new issues

Tool	Category	Rule	Count
qlty	Structure	High total complexity (count = 55)	1
qlty	Structure	Function with many returns (count = 10): IterableAppProvider	1

Copilot

Pull request overview

This PR adds embedded messaging support for iOS in the React Native SDK. The changes enable the enableEmbeddedMessaging configuration flag on iOS to match the existing Android implementation, add necessary WebView entitlements to the example app, and include a workaround for an iOS login initialization issue.

Changes:

Added iOS support for the enableEmbeddedMessaging configuration flag in the native Swift code
Added web-browser entitlements to the example iOS app to support WebView functionality
Implemented a workaround in the example app for an iOS initialization issue

Reviewed changes

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

File	Description
ios/RNIterableAPI/Serialization.swift	Added deserialization of `enableEmbeddedMessaging` flag from config dictionary
example/src/hooks/useIterableApp.tsx	Added Platform import and iOS-specific error handling workaround for initialization
example/ios/ReactNativeSdkExample/ReactNativeSdkExample.entitlements	Created new entitlements file with web-browser capability
example/ios/ReactNativeSdkExample.xcodeproj/project.pbxproj	Added entitlements file reference and build configuration, plus formatting changes

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

Copilot · 2026-01-12T01:24:45Z

example/src/hooks/useIterableApp.tsx

+          if (Platform.OS === 'ios' && getUserId()) {
+            setIsInitialized(true);
+            return login();
+          }


This workaround silently swallows initialization errors on iOS and proceeds with login regardless of the actual error. This could mask legitimate initialization failures (such as network issues, invalid configuration, or API key problems) and lead to unpredictable behavior in production.

Instead of catching all errors and assuming initialization succeeded, consider:

Logging the specific error for debugging purposes

Only applying this workaround for the specific iOS initialization issue mentioned in the PR description

Adding a comment explaining what "weird iOS login issue" this addresses

Investigating and properly fixing the underlying iOS initialization issue rather than working around it

Copilot · 2026-01-12T01:24:45Z

example/ios/ReactNativeSdkExample.xcodeproj/project.pbxproj

-				OTHER_LDFLAGS = "$(inherited)  ";
+				OTHER_LDFLAGS = (
+					"$(inherited)",
+					" ",


The change from a string to an array with just a space character seems unusual. This formatting change appears to be converting OTHER_LDFLAGS = "$(inherited) "; to an array format with a space element.

Consider verifying if this change is intentional and necessary, or if it's an artifact from Xcode auto-formatting. If the space is not needed for linking, it would be cleaner to use just "$(inherited)" without the extra space element.

Suggested change

" ",

Copilot · 2026-01-12T01:24:46Z

example/ios/ReactNativeSdkExample.xcodeproj/project.pbxproj

-				OTHER_LDFLAGS = "$(inherited)  ";
+				OTHER_LDFLAGS = (
+					"$(inherited)",
+					" ",


The change from a string to an array with just a space character seems unusual. This formatting change appears to be converting OTHER_LDFLAGS = "$(inherited) "; to an array format with a space element.

Consider verifying if this change is intentional and necessary, or if it's an artifact from Xcode auto-formatting. If the space is not needed for linking, it would be cleaner to use just "$(inherited)" without the extra space element.

Suggested change

" ",

Copilot · 2026-01-12T01:24:46Z

example/src/hooks/useIterableApp.tsx

+          if (Platform.OS === 'ios' && getUserId()) {
+            setIsInitialized(true);
+            return login();
+          }


This change adds a missing documentation comment explaining what the workaround addresses. The PR description mentions "weird iOS login issue" but doesn't provide specifics about what the issue is or why this workaround is needed.

Add a comment here explaining:

What specific iOS initialization issue this addresses

Whether this is a known bug in the Iterable iOS SDK or a React Native bridge issue

Any relevant ticket numbers or references for tracking the root cause

lposen added 3 commits January 10, 2026 21:09

feat: add enableEmbeddedMessaging configuration option to IterableConfig

9fe7c51

feat: enhance IterableAppProvider to handle iOS user login after init…

4407ece

…ialization

feat: add entitlements file for iOS app to enable web browser capabil…

0894bad

…ities

lposen added the embedded Issues/PRs related to Embedded Messages label Jan 12, 2026

lposen requested review from Ayyanchira and Copilot January 12, 2026 01:21

Copilot started reviewing on behalf of lposen January 12, 2026 01:22 View session

Copilot AI reviewed Jan 12, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[SDK-237] Set up embedded for iOS #795

[SDK-237] Set up embedded for iOS #795

Uh oh!

lposen commented Jan 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 11, 2026

Uh oh!

qltysh bot commented Jan 11, 2026

Uh oh!

qltysh bot commented Jan 11, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 12, 2026

Uh oh!

Copilot AI Jan 12, 2026

Uh oh!

Copilot AI Jan 12, 2026

Uh oh!

Copilot AI Jan 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

[SDK-237] Set up embedded for iOS #795

Are you sure you want to change the base?

[SDK-237] Set up embedded for iOS #795

Uh oh!

Conversation

lposen commented Jan 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔹 JIRA Ticket(s) if any

✏️ Description

Testing

Setup

Uh oh!

github-actions bot commented Jan 11, 2026

Uh oh!

qltysh bot commented Jan 11, 2026

Uh oh!

qltysh bot commented Jan 11, 2026

2 new issues

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

lposen commented Jan 11, 2026 •

edited

Loading