feat: Adopt AGP v9

[hurali97]

Description

This PR is rasied following the second phase of the RFC around AGP v9 adoption:

RFC: react-native-community/discussions-and-proposals#1006

The gist of this PR is to make Gesture Handler AGP v9 compliant with backward compatibility. The main scope of changes is the react-native-gesture-handler/android/build.gradle. The rest of the changes can be considered temporary.

The rest changes include:

• Making Basic Example App AGP9 compliant
• Upgrade Gradle to v9.4.1
• Use proguard-android-optimize proguard file
• Enable opt outs in the gradle.properties

Ideally, we should not enable the opt outs and leverage the AGP 9 built-in kotlin and newDSL. However, if we do not do it, then other libraries which are not yet AGP v9 compliant starts to fail. Hence, we need to keep the opt outs enabled for a while. For the context, react-native starting from 0.87.x will ship with AGP v9 and opt outs enabled by default for the new apps, which is the first phase of AGP v9 adoption.

With the second phase when the libraries starts adoption AGP v9, we can eventually remove the opt outs from Basic Example.

Test plan

To test this PR, we need to do a few steps:

• Set the agp version to 9.2.1 and kotlin to 2.2.0 in react-native-gradle-plugin

--- a/node_modules/@react-native/gradle-plugin/gradle/libs.versions.toml
+++ b/node_modules/@react-native/gradle-plugin/gradle/libs.versions.toml
@@ -1,10 +1,10 @@
 [versions]
-agp = "8.12.0"
+agp = "9.2.1"
 gson = "2.8.9"

-kotlin = "2.1.20"
+kotlin = "2.2.0"
 assertj = "3.25.1"

• Comment out the following functions in react-native-gradle-plugin

--- a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/ReactPlugin.kt
+++ b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/ReactPlugin.kt
@@ -1,10 +1,10 @@
      configureBuildTypesForApp(project)
    }

    // Library Only Configuration
-    configureBuildConfigFieldsForLibraries(project)
-    configureNamespaceForLibraries(project)
+    // configureBuildConfigFieldsForLibraries(project)
+    // configureNamespaceForLibraries(project)
    project.pluginManager.withPlugin("com.android.library") {

This step is only required because we have RN version on 0.85.2 and AGP + kotlin bump will be shipped with 0.87.x.

Verified by locally patching Reanimated and Worklet, making those AGP v9 compliant and removing the opt outs to test the changes in the PR

agp-9.mp4

Verified these changes work with AGP 8

agp-8.mov

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates Android build tooling and adjusts React Native Gesture Handler’s Android Gradle configuration to work across newer AGP/Kotlin setups.

Changes:

• Bump Gradle wrapper to 9.4.1 in the library package and the basic example app.
• Add AGP-version/property-based fallback to apply kotlin-android only when needed.
• Rework sourceSets.main configuration to use a Kotlin-specific source set API.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/react-native-gesture-handler/android/gradle/wrapper/gradle-wrapper.properties	Updates Gradle wrapper version for the gesture handler Android project.
packages/react-native-gesture-handler/android/build.gradle	Adds AGP/Kotlin fallback logic and changes source set configuration.
apps/basic-example/android/gradle/wrapper/gradle-wrapper.properties	Updates Gradle wrapper version for the example app.
apps/basic-example/android/gradle.properties	Adds properties to opt out of AGP built-in Kotlin and new DSL behavior.
apps/basic-example/android/app/build.gradle	Switches default ProGuard config to the optimized variant for release builds.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.