feat(android)!: upgrade Intercom Android SDK to 18.0.1 (#411)

* feat(android)!: upgrade Intercom Android SDK to 18.0.0

Upgrade the Android SDK from 17.4.7 to 18.0.0, a major release that
removes the `handlePushMessage()` API — the SDK now automatically opens
conversations when push notifications are tapped.

Breaking changes:
- Remove `handlePushMessage()` from native modules, TurboModule spec,
  and public JS API
- Raise compileSdk/targetSdk to 36 and buildToolsVersion to 36.0.0
- Upgrade AGP to 8.9.0 and Gradle to 8.11.1

Cleanup:
- Remove dead HANDLE_PUSH_MESSAGE error code constant
- Remove unused Toast and ReadableArray imports from both arch modules
- Migrate deprecated lintOptions to lint block in build.gradle
- Update README to remove handlePushMessage docs and fix SDK versions
- Remove handlePushMessage AppState listeners from all example apps

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix(lint): fix prettier formatting in HomeScreen import

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat(android)!: upgrade Intercom Android SDK to 18.0.1

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore(example): remove orphan comment left after handlePushMessage removal

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: bump version to 10.0.0 for Android SDK 18.0.1 breaking change

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: imSzukala

README.md

@@ -111,16 +111,16 @@ public void onCreate() {
 }
 ```
 
-- Open `android/build.gradle` and change `minSdkVersion` to **23**, `compileSdkVersion` and `targetSdkVersion` to **35**
+- Open `android/build.gradle` and change `minSdkVersion` to **23**, `compileSdkVersion` and `targetSdkVersion` to **36**
 
 ```Gradle
 buildscript {
     // ...
     ext {
-        buildToolsVersion = "35.0.0"
+        buildToolsVersion = "36.0.0"
         minSdkVersion = 23 // <-- Here
-        compileSdkVersion = 35 // <-- Here
-        targetSdkVersion = 35 // <-- Here
+        compileSdkVersion = 36 // <-- Here
+        targetSdkVersion = 36 // <-- Here
     }
     // ...
 }
@@ -275,22 +275,6 @@ apply from: file("../../node_modules/@react-native-community/cli-platform-androi
 </manifest>
 ```
 
-- Add below code to your React Native app
-
-```jsx
-useEffect(() => {
-  /**
-   * Handle PushNotification
-   */
-  const appStateListener = AppState.addEventListener(
-    'change',
-    (nextAppState) => nextAppState === 'active' && Intercom.handlePushMessage()
-  );
-  return () => AppState.removeEventListener('change', () => true); // <- for RN < 0.65
-  return () => appStateListener.remove(); // <- for RN >= 0.65
-}, []);
-```
-
 #### Android: Push notification deep links support
 
 - Add below code to `<activity>` inside `AndroidManifest.xml`
@@ -996,31 +980,6 @@ Gets the number of unread conversations for a user.
 
 ---
 
-### `Intercom.handlePushMessage()`
-
-Handles the opening of an Intercom push message. This will retrieve the URI from the last Intercom push message.
-
-```javascript
-useEffect(() => {
-  /**
-   * Handle PushNotification Open
-   */
-  const appStateListener = AppState.addEventListener(
-    'change',
-    (nextAppState) => nextAppState === 'active' && Intercom.handlePushMessage()
-  );
-
-  return () => AppState.removeEventListener('change', () => {}); // <- for RN < 0.65
-  return () => appStateListener.remove(); // <- for RN >= 0.65
-}, []);
-```
-
-### Returns
-
-`Promise<boolean>`
-
----
-
 ### `Intercom.present()`
 
 Opens the Intercom Messenger automatically to the best place for your users.

android/build.gradle

@@ -5,10 +5,10 @@ def packageVersion = '"' + packageJson.version + '"'
 
 buildscript {
   ext {
-    buildToolsVersion = "35.0.0"
+    buildToolsVersion = "36.0.0"
     minSdkVersion = 23
-    compileSdkVersion = 35
-    targetSdkVersion = 35
+    compileSdkVersion = 36
+    targetSdkVersion = 36
     ndkVersion = "26.1.10909125"
     kotlinVersion = "1.9.22"
   }
@@ -19,7 +19,7 @@ buildscript {
     }
 
     dependencies {
-      classpath("com.android.tools.build:gradle:8.6.1")
+      classpath("com.android.tools.build:gradle:8.9.0")
       classpath("org.jetbrains.kotlin:kotlin-gradle-plugin")
     }
   }
@@ -53,7 +53,7 @@ android {
       minifyEnabled false
     }
   }
-  lintOptions {
+  lint {
     disable 'GradleCompatible'
   }
   buildFeatures {
@@ -84,6 +84,6 @@ dependencies {
   //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-native:+"  // From node_modules
   implementation "com.google.firebase:firebase-messaging:24.1.2"
-  implementation 'io.intercom.android:intercom-sdk:17.4.7'
-  implementation 'io.intercom.android:intercom-sdk-ui:17.4.7'
+  implementation 'io.intercom.android:intercom-sdk:18.0.1'
+  implementation 'io.intercom.android:intercom-sdk-ui:18.0.1'
 }

android/gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

android/src/main/java/com/intercom/reactnative/IntercomErrorCodes.java

@@ -20,7 +20,6 @@ public class IntercomErrorCodes {
   public static final String SET_LAUNCHER_VISIBILITY = "208";
   public static final String SET_BOTTOM_PADDING = "209";
   public static final String SET_THEME_MODE = "210";
-  public static final String HANDLE_PUSH_MESSAGE = "301";
   public static final String SEND_TOKEN_TO_INTERCOM = "302";
   public static final String FETCH_HELP_CENTER_COLLECTIONS = "901";
   public static final String FETCH_HELP_CENTER_COLLECTION = "902";

android/src/newarch/IntercomModule.java

@@ -4,16 +4,13 @@
 import android.app.Application;
 import android.content.Intent;
 import android.util.Log;
-import android.widget.Toast;
-
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
-import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.module.annotations.ReactModule;
 import com.google.firebase.messaging.RemoteMessage;
@@ -115,19 +112,6 @@ public static void sendTokenToIntercom(Application application, @NonNull String
     }
   }
 
-  @ReactMethod
-  public void handlePushMessage(Promise promise) {
-    try {
-      Intercom.client().handlePushMessage();
-      promise.resolve(true);
-      Log.d(NAME, "handlePushMessage");
-    } catch (Exception err) {
-      Log.e(NAME, "handlePushMessage error:");
-      Log.e(NAME, err.toString());
-      promise.reject(IntercomErrorCodes.HANDLE_PUSH_MESSAGE, err.toString());
-    }
-  }
-
   @ReactMethod
   public void sendTokenToIntercom(@NonNull String token, Promise promise) {
     try {

android/src/oldarch/IntercomModule.java

@@ -4,16 +4,13 @@
 import android.app.Application;
 import android.content.Intent;
 import android.util.Log;
-import android.widget.Toast;
-
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
-import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.module.annotations.ReactModule;
 import com.google.firebase.messaging.RemoteMessage;
@@ -98,19 +95,6 @@ public static void sendTokenToIntercom(Application application, @NonNull String
     Log.d(NAME, "sendTokenToIntercom");
   }
 
-  @ReactMethod
-  public void handlePushMessage(Promise promise) {
-    try {
-      Intercom.client().handlePushMessage();
-      promise.resolve(true);
-      Log.d(NAME, "handlePushMessage");
-    } catch (Exception err) {
-      Log.e(NAME, "handlePushMessage error:");
-      Log.e(NAME, err.toString());
-      promise.reject(IntercomErrorCodes.HANDLE_PUSH_MESSAGE, err.toString());
-    }
-  }
-
   @ReactMethod
   public void sendTokenToIntercom(@NonNull String token, Promise promise) {
     try {

examples/example/src/App.tsx

@@ -2,7 +2,6 @@ import * as React from 'react';
 import { useEffect, useState } from 'react';
 import {
   Alert,
-  AppState,
   Image,
   Linking,
   NativeEventEmitter,
@@ -131,15 +130,6 @@ export default function App() {
       }
     });
 
-    /**
-     * Handle PushNotification
-     */
-    const appChangeListener = AppState.addEventListener(
-      'change',
-      (nextAppState) =>
-        nextAppState === 'active' && Intercom.handlePushMessage()
-    );
-
     /**
      * Handle Push Notification deep links
      */
@@ -184,10 +174,6 @@ export default function App() {
       // @ts-ignore - type definitions haven't been updated to 0.65 yet
       urlListener.remove(); // <- for RN 0.65+
       // Linking.removeEventListener('url', () => {}); <- for RN < 0.65
-
-      // @ts-ignore - type definitions haven't been updated to 0.65 yet
-      appChangeListener.remove(); // <- for RN 0.65+
-      //AppState.removeEventListener('change', () => {}); <- for RN < 0.65
     };
   }, []);
 

examples/expo-example/app/_layout.tsx

@@ -4,23 +4,15 @@ import { useFonts } from 'expo-font';
 import { Stack } from 'expo-router';
 import { StatusBar } from 'expo-status-bar';
 import React, { useEffect } from 'react';
-import { Alert, AppState, Linking } from 'react-native';
+import { Alert, Linking } from 'react-native';
 import 'react-native-reanimated';
 
-import Intercom from '@intercom/intercom-react-native';
-
 export default function RootLayout() {
   const [loaded] = useFonts({
     SpaceMono: require('../assets/fonts/SpaceMono-Regular.ttf'),
   });
 
   useEffect(() => {
-    // Handle push notifications when app is active
-    const subscription = AppState.addEventListener(
-      'change',
-      (nextStatus) => nextStatus === 'active' && Intercom.handlePushMessage()
-    );
-
     // Handle deep links
     const urlListener = Linking.addEventListener('url', (event) => {
       if (event) {
@@ -29,7 +21,6 @@ export default function RootLayout() {
     });
 
     return () => {
-      subscription.remove();
       urlListener.remove();
     };
   }, []);

examples/with-notifications/src/screens/HomeScreen.tsx

@@ -1,25 +1,11 @@
 import React, { useEffect } from 'react';
-import {
-  AppState,
-  Text,
-  TextInput,
-  TouchableOpacity,
-  View,
-} from 'react-native';
+import { Text, TextInput, TouchableOpacity, View } from 'react-native';
 import Intercom, { Visibility } from '@intercom/intercom-react-native';
 import { requestNotifications } from 'react-native-permissions';
 import { useIntercom } from '../hooks/useIntercom';
 import { styles } from '../styles/App.styles';
 
 export function HomeScreen(): React.JSX.Element {
-  useEffect(() => {
-    const subscription = AppState.addEventListener(
-      'change',
-      nextStatus => nextStatus === 'active' && Intercom?.handlePushMessage()
-    );
-    return subscription.remove;
-  }, []);
-
   useEffect(() => {
     (async () => {
       // Request permissions

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/intercom-react-native",
-  "version": "9.8.1",
+  "version": "10.0.0",
   "description": "React Native wrapper to bridge our iOS and Android SDK",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",