# Google Mobile Ads Android Migrate To Next Gen

Migrates Android applications from the old, legacy Google Mobile Ads (GMA) SDK...

- Repository: https://github.com/google/skills (21764 stars)
- Category: Mobile
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen -g -a claude-code -y`
Codex: `npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen -g -a codex -y`
Cursor: `npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen -g -a cursor -y`
Gemini CLI: `npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add google/skills`

## Description

Migrates Android applications from the old, legacy Google Mobile Ads (GMA) SDK (com.google.android.gms:play-services-ads) to the new GMA Next-Gen SDK (com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk). Provides comprehensive mapping tables for imports, classes, and method signatures to help determine migration steps. Use when migrating an existing Android codebase from the old, legacy GMA SDK to GMA Next-Gen SDK.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Migration Agent Instructions for the Google Mobile Ads SDK

## Migration Workflow

Use this checklist to track your migration progress:

*   **Configure Gradle**:
    -   [ ] Replace `com.google.android.gms:play-services-ads` with the latest
        stable version of
        `com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk`. If you
        cannot access Maven directly, run the following command to fetch the
        latest version. The version returned in the `latest` tag is the latest
        version of the GMA Next-Gen SDK:

        ```bash
        curl -sS https://dl.google.com/dl/android/maven2/com/google/android/libraries/ads/mobile/sdk/ads-mobile-sdk/maven-metadata.xml | sed -n 's/.*<latest>\(.*\)<\/latest>.*/\1/p'
        ```

    -   [ ] Update `minSdk` (24+) and `compileSdk` (34+).
    -   [ ] Exclude `play-services-ads` and `play-services-ads-lite` from all
        dependencies globally in the app-level build file to avoid duplicate
        symbol errors.
    -   [ ] Sync Gradle before moving on to the next step.
*   **Per-File Migration**:
    -   [ ] Refactor the codebase following the API Mapping and Method Mapping
        tables to migrate imports, class names, and method signature to GMA
        Next-Gen SDK.
*   **Verify and Build**:
    -   [ ] Run `gradle build -x test` to confirm a successful clean build.
        Resolve any GMA SDK related compile errors.

## Core Migration Rules

The rest: https://github.com/google/skills/blob/HEAD/skills/ads/google-mobile-ads-android-migrate-to-next-gen/SKILL.md