---
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>

### 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.