3

5.x -> 6.0.0

Version 6.0.0 of the Customer.io React Native SDK requires the React Native new architecture.

What changed?

Version 6.0.0 removes support for React Native’s legacy architecture. This aligns with React Native’s move to exclusively support their new architecture. You must migrate your app to use React Native’s new architecture to use this and future versions of the SDK.

Do you need to update to this version?

We recommend updating to the latest SDK version. However, if your app uses the old React Native architecture and you’re not ready to migrate, you can continue using version 5.x until you’re ready to adopt the new architecture.

Prerequisites

Before updating to SDK version 6.0.0, your app must use React Native’s new architecture. See React Native’s documentation for more information.

Update process

If your app already uses React Native’s new architecture, updating to Customer.io SDK version 6.0.0 is straightforward. There are no public API changes.

1. Migrate to the new React Native architecture

If you haven’t migrated to React Native’s new architecture yet, see the React Native documentation for instructions. When your app is successfully running on the new architecture, you can update to Customer.io SDK version 6.0.0.

2. Update the SDK version

Update your package.json to use version 6.0.0:

npm install customerio-reactnative@6.0.0
# or
yarn add customerio-reactnative@6.0.0

3. Install dependencies

For a clean installation to ensure codegen works properly:

# Clean install
rm -rf node_modules
npm install

# iOS
cd ios && rm -rf Pods Podfile.lock && pod install && cd ..

# Rebuild your app
npm run ios
# or
npm run android

4. Test your integration

Since there are no public API changes, your existing Customer.io SDK calls will continue to work. However, you should test your app after updating to ensure everything works as expected.

Troubleshooting

If you encounter build errors after updating, perform a clean build:

# Clean install
rm -rf node_modules
npm install

# iOS
cd ios && rm -rf Pods Podfile.lock && pod install && cd ..

# Android
cd android && ./gradlew clean && cd ..

# Rebuild
npm run ios
npm run android

If issues persist, ensure your app is properly configured for the React Native new architecture and that all dependencies support it.