Upgrade from 4.x to 5.0.0

Version 5.0.0 of the Android SDK requires Android 7.0 (API level 24) or later and updates the Firebase, Google Play services, and WorkManager libraries that the SDK uses.

What changed?

Version 5.0.0 changes the versions your app needs to build with. You don’t need to change your code.

• Android 7.0 (API level 24) or later: The SDK’s minSdk is now 24. If your app needs to support API levels 21 to 23, stay on version 4.x.
• Newer libraries: The SDK now brings in firebase-messaging 26.0.0, play-services-base 18.11.1, and WorkManager (androidx.work) 2.12.0.

Upgrade process

1. Update every Customer.io dependency in your app’s build.gradle file to version 5.0.0 or later.

   GROOVY

   Copy

   implementation "io.customer.android:datapipelines:5.0.0"
   implementation "io.customer.android:messaging-push-fcm:5.0.0"
   implementation "io.customer.android:messaging-in-app:5.0.0"

2. Set your app’s minSdk to 24 or higher:

   GROOVY

   Copy

   android {
       defaultConfig {
           minSdk 24
       }
   }

3. Make sure your app builds with compileSdk 36 or later and Android Gradle plugin (AGP) 8.9.1 or later. The AndroidX libraries that the SDK uses require these versions.

4. If your app pins older versions of firebase-messaging, play-services-base, or WorkManager, update them to at least 26.0.0, 18.11.1, and 2.12.0.

WorkManager 2.12 also changes its default executors and worker parallelism. If your app schedules its own work with WorkManager’s default configuration, check WorkManager’s release notes ↗ for details.