---
title: Prerequisites & platform requirements
description: Platform requirements and compatibility notes before installing React Native Google Mobile Ads.
---

Before installing, confirm your project meets the platform baseline. The New Architecture is
**required** — native installation fails when it is explicitly disabled. See
[Migrating to v17](/migrating-to-v17) for the full v17 upgrade checklist.

## Supported baseline

| Requirement             | Floor                                                             |
| ----------------------- | ----------------------------------------------------------------- |
| React Native            | **0.86.0** or newer (`peerDependencies`: `react-native >=0.86.0`) |
| New Architecture        | **Required** — Legacy Architecture is not supported               |
| iOS deployment target   | **15.1** (`RNGoogleMobileAds.podspec`)                            |
| Android `minSdkVersion` | **24** (`sdkVersions.android.minSdk` in package metadata)         |

### New Architecture (required)

v17 ships Turbo Modules and Fabric components only. If New Architecture is turned off,
native install fails:

- **iOS:** CocoaPods raises when `RCT_NEW_ARCH_ENABLED=0`.
- **Android:** Gradle throws when `newArchEnabled` is set and is not `true` in
  `android/gradle.properties`.

Enable New Architecture in your app (or remove an explicit old-architecture opt-out) before
installing pods / building Android.

<Info>
  React Native 0.82 and newer may ignore `newArchEnabled=false` for its own build, but this module's
  Gradle build still fails whenever `newArchEnabled` is present and not `true`. Treat New
  Architecture as mandatory on both platforms — do not rely on the Legacy Architecture path.
</Info>

### iOS CocoaPods deployment targets

Xcode 27 rejects `IPHONEOS_DEPLOYMENT_TARGET` values below **15.0**. This package's podspec
floor is **15.1**, but Google Mobile Ads / UMP resource-bundle targets can still inherit
`platforms.ios` **12.0** from those pods. Clamp every pod target in your app `Podfile`
`post_install` so nothing stays below 15.1:

```ruby
post_install do |installer|
  # ...existing post_install hooks...

  min_ios = '15.1'
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      current = config.build_settings['IPHONEOS_DEPLOYMENT_TARGET']
      next if current && current.to_f >= min_ios.to_f

      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = min_ios
    end
  end
end
```

React Native's `updateOSDeploymentTarget` only rewrites pod _native_ target configs; the
resource-bundle targets still need this clamp. The example app's `Podfile` applies the same
pattern.

### Android host notes

The supported and tested Android host baseline uses compile / target API level **36** and Build
Tools **36.0.0**. Standalone package builds use Android Gradle Plugin 8.6.0; the library does
not enforce the host application's Android Gradle Plugin version.

<Info>
  On Android, before releasing your app, you must select "Yes, my app contains ads" in the Google
  Play Console under "Policy and programmes" > "App content" > "Manage".
</Info>

### Android Kotlin compatibility

Google Mobile Ads Android SDK 25.4 ships Kotlin 2.3 metadata. This library supports
Kotlin 1.9.25 and newer:

- With Kotlin 1.9.25 through versions earlier than 2.3, the library adds
  `-Xskip-metadata-version-check` only to its own Kotlin compile tasks.
- With Kotlin 2.3 or newer, no metadata skip is added.

The scoped compiler flag is safe here because this module consumes the Google Mobile
Ads public Java API. It is a compiler compatibility setting, not a dependency exclusion.
If Kotlin code in your app or another module directly consumes an affected dependency,
upgrade that module to Kotlin 2.3+ or configure its compile tasks separately.