Skip to content

docs: add CNAME initialization examples for iOS and Android#87

Open
rmi22186 wants to merge 1 commit into
mainfrom
feat/cname-support
Open

docs: add CNAME initialization examples for iOS and Android#87
rmi22186 wants to merge 1 commit into
mainfrom
feat/cname-support

Conversation

@rmi22186
Copy link
Copy Markdown
Member

@rmi22186 rmi22186 commented May 20, 2026

Background

mParticle Flutter PR #73 added README examples for configuring a custom CNAME endpoint without any new Dart API — Flutter consumers initialise the mParticle SDK natively from their AppDelegate / Application class and wire MPNetworkOptions.customBaseURL / NetworkOptions.withNetworkOptions directly. React Native takes the same approach (no runtime JS bridge; only an Expo config plugin for build-time codegen). Cordova consumers initialise the same way, so a docs-only change matches.

What's changed

  • README iOS section: MPNetworkOptions.customBaseURL snippet (Swift + Objective-C) inserted after the standard init example.
  • README Android section: NetworkOptions.withNetworkOptions snippet (Java + Kotlin) inserted after the standard init example.
  • CHANGELOG.md [Unreleased] entry under Added.

No JS API, no native bridge changes, no dependency bumps.

🤖 Generated with Claude Code

@rmi22186 rmi22186 requested a review from a team as a code owner May 20, 2026 14:02
@cursor
Copy link
Copy Markdown

cursor Bot commented May 20, 2026

PR Summary

Low Risk
Documentation-only changes with no runtime, bridge, or dependency updates in this diff.

Overview
Documents how Cordova apps can point the native mParticle SDK at a custom CNAME during startup (still done in AppDelegate / Application.onCreate, not via JavaScript).

The README gains optional snippets after the existing iOS and Android init examples: Swift and Objective-C set MPNetworkOptions.customBaseURL on mParticleOptions, and Java/Kotlin use NetworkOptions.withNetworkOptions(...). CHANGELOG.md records the new README examples under [Unreleased].

Reviewed by Cursor Bugbot for commit 50e1573. Bugbot is set up for automated code reviews on this repo. Configure here.

Cordova consumers initialise the mParticle SDK natively from their
AppDelegate / Application class, so a custom CNAME endpoint is
configured the same way as in any non-Cordova app — via
`MPNetworkOptions.customBaseURL` on iOS or
`NetworkOptions.withNetworkOptions` on Android. No JS bridge needed.

Mirrors the docs portion of mParticle/mparticle-flutter-sdk#73.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rmi22186 rmi22186 force-pushed the feat/cname-support branch from 53c6af4 to 50e1573 Compare May 29, 2026 14:07
@rmi22186 rmi22186 changed the title docs: align native dependency versions for CNAME updates docs: add CNAME initialization examples for iOS and Android May 29, 2026
@rmi22186 rmi22186 changed the base branch from shoppable-ads to main May 29, 2026 14:10
@rmi22186
Copy link
Copy Markdown
Member Author

Docs only change, so build/test failure is not an issue - this should be fixed in shoppable-ads branch.

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.

2 participants