⚠️ BREAKING TOOLING CHANGES

• Support for FCM 12.x is added which requires a minimum iOS deployment target of 15. If you’re using FCM module, ensure your deployment target and tooling are up to date. Or lock Firebase to 11.x to avoid compatibility issues (#938) (3a417ec)

Bug Fixes

• Fixed build issue by adding a default implementation for an internal SPI method in DeepLinkUtil, preventing conformance errors with BUILD_LIBRARY_FOR_DISTRIBUTION = YES (#936) (c7ba900)

Bug Fixes

• Preserve numeric types when doing sanitization for JSON (#935) (cbf95fd)

Internal

• Added base classes around Inline views to support communication of inline view with Wrapper SDKs (#933) (2a4dbb9)

Bug Fixes

• Sanitize unsupported numeric values (#930) (2a848e4)

Bug Fixes

• Fix in-app messages not overlaying safe area top and bottom (#925) (8ed7d7b)

Bug Fixes

• Fixed an issue where the SDK enforced a strict version of firebase messaging, preventing integration with newer versions. (#929) (a0211d3)

Bug Fixes

• premature deallocation of the rich push http client (1edb75c)
• premature deallocation of the rich push http client (#924) (9a985c1)

Bug Fixes

• Fixes the bug where multi screen in-app messages might dismiss earlier (#920) (0426e06)

Bug Fixes

• Fixed an issue that caused duplicate internal calls for setting device tokens (#922) (0f5d7f0)
• Improved detection of UNUserNotificationCenterDelegate method implementations by explicitly tracking completion handler calls, ensuring more reliable notification handling across different integration scenarios (#922) (0f5d7f0)

⚠ BREAKING TOOLING CHANGES

• Support for FCM 11.12.0 (#918) (dcc21e0) is added which requires Xcode 16.2 or later, so you will need to update xcode if you are utilizing the FCM module.

Improvements

• Swizzling replacement:
  • We’ve replaced the old “swizzling” method for handling push notifications with a clearer, more reliable system.
  • New AppDelegate classes (CioAppDelegate and CioAppDelegateWrapper) make integration easier, more explicit, and more maintainable.
• Deep Linking:
  • Added a new deepLinkingCallback to fix issues with some libraries (like Firebase) that don’t properly handle application(_:continue:restorationHandler:).
  • This ensures deep links work more consistently across different setups.
• Sample Applications:
  • Updated to show how to implement the new AppDelegate setup and deep linking — making it easier to follow and integrate.

Deprecations

• The old swizzling-based push notification setup is now deprecated. It still works, but we recommend switching to the new method as it will be removed in a future release.
• The previous deep-linking approach is also deprecated, replaced by the new deepLinkingCallback.

Bug Fixes

• Parse region leniently and fall back to default region if parsing fails instead of blocking initialization (#879)
• Hardcoded the upper limit of FCM version to avoid the issues with compilation of Cocoapods SDK (#880)

Bug Fixes

• Fixed an issue where the “Application Installed” event was incorrectly triggered on every app launch instead of only after the initial installation.

Improvement

• Updated libraries to the latest versions to improve stability.

Features

• Added support for inline in-app messages. Inline in-app messages act like a part of the content on your page. They let you dynamically populate parts of your app and talk to your customers without interrupting their experience. (#864) (35fba9b)

Fixes

• Incorrectly scrolling content for in-app modal messages positioned top/bottom. #858

Bug Fixes

• Fixes in-app messages overlay background color being ignored from in-app message payload (#843)

Bug Fixes

• Fixes the intermittent crash with in-app messages when triggered on background thread (#840) (93200a4)

Features

• Added ability to disable forwarding screen events to destinations/servers. Apps can still send screen events for local processing and use them for page rules in in-app messages by just updating SDK configuration during initialization. (#844) (486e228)

Fixes

• Handle fragments (#) when you open a web page from in-app via “Open the web” action. #842

Features

• This release introduces support for displaying larger in-app messages. (#831) (3731f68)

Fixes

• Resolve an issue that prevented push metrics from being reported for customers who set the region to the EU region. (https://github.com/customerio/customerio-ios/pull/836)

Improvement

• Updated our SDK to use the v2 version of our in-app messages API. This will provide a more reliable experience for in-app messages. (https://github.com/customerio/customerio-ios/pull/834)

Bug Fixes

• This fix dismisses keyboard when an in-app message appears to allow uninterrupted user interaction (#828) (faad28a)

Improvement

• This release includes changes needed to support for data pipelines in the our React Native SDK. There are no new features for customers utilizing our native Android SDK only. (#819) (171dfdc)

Features

• This update extends support to newer Firebase SDK versions. (#792)

Bug Fixes

• Fixes an edge case where the in-app queue would not maintain its integrity when autoScreenTracking is turned on and screens are frequently changed. (#820) (62268a4)

Features

• Revamped the in-app messaging module to enhance performance by optimizing local processing, accelerating message loading during page transitions, and implementing a state-driven architecture for better responsiveness and control. [#815] (5cd651b)
• We highly recommend upgrading to the new in-app editor to ensure optimal performance.

Fixes

• We reduced the chance of duplicate in-app messages by keeping a local store of messages already displayed.

Bug Fixes

• Resolved issue for customers who use the tool, Tuist, to install the Customer.io iOS SDK. (#791) (cd1346a)

Bug Fixes

• This release addresses a compatibility issue for apps that have installed two or more third-party SDKs (besides Customer.io SDK) that handle push notifications. While this issue was primarily reported by our Flutter customers, it could also affect native iOS and React Native applications. (#751) (ca5abb3)

Bug Fixes

• This release resolves a scenario where in-app messages with page rules enabled are sent to a device but is never shown if the app is killed and re-opened. (#746) (cfae57d)

Features

• When using page rules and when an in-app messages need a second to load, the in-app message might appear after a user navigates to another page. We made changes to ensure the page-rules are checked after the message is loaded and immediately before it’s displayed in order to resolve this issue. (#731) (cb1d014)

Bug Fixes

• For users of our Flutter SDK and React Native SDK, this resolves a compatibility issue with 3rd party FCM Flutter and React Native SDKs. In some cases, the issue prevented push notifications from showing while the app was in the foreground when the 3rd party SDK and CIO SDK were both installed. (#736) (ccb0f47)

Bug Fixes

• Resolves an issue that prevented actions from being tracked for in-app messages. (#728) (c1f69c1)

Bug Fixes

• Resolves an issue that caused a crash on the emulator while in developing. (#725) (7ca2dc2)

Features

• Segment compatibility (#685) (7298783)

Bug Fixes

• update segment internal SPM dependencies with fixed version (#708) (c02742e)

Bug Fixes

• track bq migration for identify profile events with no attributes (2fb4827)

Bug Fixes

• added alias for Region (#693) (1619c72)

Features

• privacy manifest files (#677) (e5c6dc7)

Bug Fixes

• [visionos] Minor project cleanup (#688) (d2934fe)

Bug Fixes

• install 3.0 with Swift Package Manager from Xcode (#660) (45b0367)

⚠ BREAKING CHANGES

• iOS as a source for Data Pipelines (#659)

Features

• iOS as a source for Data Pipelines (#659) (0a68373)
• migration module to cater to all migration tasks (#530) (2feb1d4)

Bug Fixes

• add attributes to properties (#649) (4b02e92)
• all sdk modules can only be initialized once (ae46c7f)
• app crash on identify method (#458) (13e9862)
• compilation for test (f14b773)
• compilation issue (420a61e)
• eventbus handler ref (#469) (8c8ef91)
• journey id in migration payload (#653) (3b649c9)
• prevent duplicate automatic screenview events from being tracked (fea9ec5)
• pushEventHandler test (dc80fc2)
• remove occurrence of autoTrackDeviceAttributes from all push modules (#505) (8dc6507)
• removed last_used from properties (#477) (b0b9631)
• sample app issues (#551) (05544b3)
• use git commit instead of git branch for segment dependency (d245015)

Features

• This update extends support to the newer versions of the Firebase SDK (>11), ensuring compatibility with the latest Firebase features and improvements. (#822) (ab53cf6)

Bug Fixes

• Explicitly switched threads to avoid forcing identify calls to be made on main thread. The SDK now automatically switches to appropriate thread, regardless of the thread used to make identify calls. (#795) (9fc527b)

Features

• Reduced the time for first in-app message to be shown for newly identified profiles. For new profiles, in-app messages are now fetched as soon as the profile is identified. (#794) (13032c6)

Bug Fixes

• This release addresses a compatibility issue for apps that have installed two or more third-party SDKs (besides Customer.io SDK) that handle push notifications. While this issue was primarily reported by our Flutter customers, it could also affect native iOS and React Native applications. (#743) (c3573fc)

Bug Fixes

• For users of our Flutter SDK and React Native SDK, this resolves a compatibility issue with 3rd party FCM Flutter and React Native SDKs. In some cases, the issue prevented push notifications from showing while the app was in the foreground when the 3rd party SDK and CIO SDK were both installed.(#735) (b0a7772)

Features

• privacy manifest files (#679) (c801004)

Bug Fixes

• do not bundle .md files in cocoapods deployments (15dbb48)

Bug Fixes

• call completionHandler if push handler does not implement optional function (9996872)
• forward push received app in foreground events to 3rd party callbacks (bd55e2b)
• forward push response events to 3rd party callback functions, for CIO push (121b157)
• open deep link from main thread as required by UIKit (7d7867f)

Bug Fixes

• expo users reported app crash on didFailToRegisterForRemoteNotificationsWithError (#575) (ac70292)

Bug Fixes

• rich push image downloading path conflict when its already downloaded (#561) (67cbfd6)

Bug Fixes

• fixes an issue with multiple timers being scheduled (#529) (ec383f1)

Features

• use new header to set polling interval (#519) (05a1ebd)

Bug Fixes

• enable logging for gist (#524) (c786897)

Features

• automatic push click handling (#403) (47e94c4)

Bug Fixes

• ensure messages are only shown once (#468) (5cc6625)

Bug Fixes

• cocoapods APN customers app not compiling (#414) (e7aaa23)

Features

• auto fetch device token and auto register device (apns) (#391) (2fce84d)

Bug Fixes

• memory exception during SDK initialization async tasks (#399) (3404523)

Bug Fixes

• add priority field to message and sorting by priority within local store (#401) (8315118)

Features

• get currently registered device token (#398) (cdedab0)

Bug Fixes

• when queue cannot find task, expect queue runs next task (#397) (01ea7a6)

Bug Fixes

• in-app positioning and persistence (#393) (b5a2f18)

Bug Fixes

• prevent registering device with empty identifier existing BQ tasks (#392) (867619f)

Bug Fixes

• reduce memory and cpu usage while running background queue (#379) (87a7eed)

Bug Fixes

• added url path encoding (#376) (fbfa384)

Features

• filter automatic screenview tracking events (#367) (1a535f9)

Bug Fixes

• cache queue inventory for lower CPU usage while running queue (#368) (fdcb24c)

Bug Fixes

• support json array in attributes (#358) (a634358)

Bug Fixes

• apps initializing sdk multiple times in short amount of time may make SDK ignore requests (#360) (09829e0)

Bug Fixes

• deinit cleanup repo bad memory access (#356) (0483fb0)

Bug Fixes

• save device token in SDK even if no profile identified (#354) (a49f72c)

Bug Fixes

• prevent api calls when identifier is empty (#353) (10b5db7)

Bug Fixes

• gist migration to CIO (#338) (#351) (5520a7c)

Bug Fixes

• bad memory access crash (#342) (b83e6bd)

Features

• include FCM SDK as a dependency to make FCM push setup easier (#333) (233fc22)

Bug Fixes

• internal module Common clashing with other Common modules in customers app (#328) (817dd56)

Features

• in-app dismiss message (#320) (e067001)

Bug Fixes

• in-app universal link redirection support (#329) (51470e8)

Bug Fixes

• exact version for gist (#321) (4b75cc5)

Bug Fixes

• sdk wrappers not having device token registered because of application lifecycle (#285) (da7fc51)

Features

• expose current SDK config options for reference (#298) (6ac739b)

Bug Fixes

• auto update gist in CocoaPods (#303) (6096d17)

Features

• get the version of the SDK (#299) (38a6b00)

Features

• in app click tracking (#284) (4ed8edb)

Features

• ui for new sample app with apns (#282) (06e4a6b)

Bug Fixes

• delete tasks that returns http 400 (#276) (aabfe9e)

Bug Fixes

• cocoapods app extension targets able to compile (#277) (8dbca8f)

Features

• add in-app event listener (#211) (737d43b)
• in-app feature no longer requires orgId (#252) (acd12da)

Bug Fixes

• access modifier for metric (#263) (e641982)
• added reusable code for wrapper SDKs (#247) (36adf15)
• in-app missing event (#259) (43b3e97)
• modify in-app event listener action parameters to new name (#255) (b46528a)
• region visibility modifier to be used by wrappers (#260) (f0edfbc)
• update the gist version in podspec (#256) (5451488)

Bug Fixes

• universal links deep links open host app (#268) (29c95b5)

Bug Fixes

• universal links when touch a push notification open host app (#265) (7dcaf73)

Bug Fixes

• async running BQ operations in loop (#250) (f0a3d9c)

Bug Fixes

• revert 2.0.2 as it was found unstable (#249) (51b5831)

It’s recommended to avoid installing this version of the iOS SDK as issues have been reported with it. Until a newer release is out, it’s recommended to use 2.0.1

Bug Fixes

• prevent stackoverflow while executing background queue with lots of tasks in it (#245) (ef0c428)

Bug Fixes

• download rich push images from CDN (#237) (b30cf02)

⚠ BREAKING CHANGES

• make delivered push metric more reliable (0478e52)
• remove FCM dependency from cocoapods (#210)
• singleton API only way to use SDK now (#209)
• SDK should not modify custom attributes casing (#234) (8160fdf)

Bug Fixes

• add sdkwrapperconfig to rich push SDK config (#226) (e43b4cf)
• fix compile time errors notification service extensions (#214) (bd5911b)
• sdk not able to compile in ios app (#225) (e4d1b3f)
• make delivered push metric more reliable (0478e52)
• SDK should not modify custom attributes casing (#234) (8160fdf)

Code Refactoring

• remove FCM dependency from cocoapods (#210) (3547076)
• singleton API only way to use SDK now (#209) (72b7477)

1.2.7 (2022-12-06)

Bug Fixes

• push images and processing simple push (#230) (f109f04)