Skip to content

docs: update GMA iOS plugin to v3.1.0 with version compatibility table#1029

Open
sunnywu wants to merge 1 commit into
mainfrom
syw-update-gma-ios-plugin-docs
Open

docs: update GMA iOS plugin to v3.1.0 with version compatibility table#1029
sunnywu wants to merge 1 commit into
mainfrom
syw-update-gma-ios-plugin-docs

Conversation

@sunnywu

@sunnywu sunnywu commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

The GMA iOS plugin documentation was last updated for v1.0.0 (October 2024). This PR brings it up to date with the v3.1.0 release (June 2026).

  • Bumps documented version from 1.0.0 → 3.1.0
  • Updates GMA SDK minimum requirement from v10.7.0 → v13.0.0
  • Updates installation examples (Package.swift, Xcode, CocoaPods) to reference v3.1.0
  • Adds a Version compatibility table showing which GMA Plugin version works with which GMA SDK and UID2 iOS SDK versions:
GMA Plugin Version GMA SDK Version UID2 SDK for iOS Version
3.1.0 (latest) 13.x 1.7.0 – 3.x
3.0.0 – 3.0.2 13.x 1.7.0 – 2.x
2.0.0 – 2.0.2 12.x 1.7.0 – 1.x
1.0.0 – 1.0.1 10.7.0 – 11.x 1.7.0 – 1.x
0.3.0 – 0.4.0 10.7.0 – 11.x 0.2.0 – 1.x
  • Same changes applied to the Japanese translation

Test plan

  • Verify rendered page at /docs/guides/mobile-plugin-gma-ios shows v3.1.0 and the compatibility table
  • Verify Japanese translation renders correctly
  • Confirm version numbers match latest release and Package.swift

🤖 Generated with Claude Code

- Bump documented version from 1.0.0 to 3.1.0 (latest)
- Update GMA SDK minimum requirement from v10.7.0 to v13.0.0
- Update installation examples (Package.swift, Xcode, CocoaPods) to v3.1.0
- Add version compatibility table showing GMA Plugin vs GMA SDK vs UID2 iOS SDK
- Update Japanese translation with same changes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

@BehnamMozafari BehnamMozafari left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the version claims against the plugin's actual releases and Package.swift at each tag. The v3.1.0 bump, the GMA v13.0.0 minimum, and the 3.1.0 / 1.0.x rows all check out. Three items below on the new compatibility table and the SPM directive change.

Note: all three findings apply identically to the Japanese translation (i18n/ja/.../guides/mobile-plugin-gma-ios.md) — please mirror the fixes there.

| GMA Plugin Version | GMA SDK Version | UID2 SDK for iOS Version |
| :--- | :--- | :--- |
| 3.1.0 (latest) | 13.x | 1.7.0 – 3.x |
| 3.0.0 – 3.0.2 | 13.x | 1.7.0 – 2.x |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Critical — 3.0.2 (and 3.0.1) don't exist. The only 3.0.x release is v3.0.0. The tag list has just v3.1.0, v3.0.0, v3.0.0-beta, v2.0.2, ..., and Package.swift?ref=v3.0.1 returns 404 ("No commit found for the ref v3.0.1"). This row tells readers to pin a version that was never published.

Suggest changing the label to just 3.0.0. The 13.x / 1.7.0 – 2.x columns are correct — Package.swift@v3.0.0 pins GMA 13.x and uid2-ios-sdk 1.7.0 ..< 3.0.0.

| :--- | :--- | :--- |
| 3.1.0 (latest) | 13.x | 1.7.0 – 3.x |
| 3.0.0 – 3.0.2 | 13.x | 1.7.0 – 2.x |
| 2.0.0 – 2.0.2 | 12.x | 1.7.0 – 1.x |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important — this understates the UID2 SDK range for 2.0.2. v2.0.0 and v2.0.1 do cap at UID2 SDK 1.x (Package.swift = 1.7.0 ..< 2.0.0), but Package.swift@v2.0.2 allows 1.7.0 ..< 3.0.0 (= 1.7.0 – 2.x). GMA is 12.x for all three. As written, a user on plugin 2.0.2 + UID2 SDK 2.x would be wrongly told the combination is unsupported.

Suggest widening the cell to 1.7.0 – 2.x, or splitting the row (2.0.0–2.0.1 → 1.x, 2.0.2 → 2.x).

```js
dependencies: [
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", exact: "1.0.0")
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", from: "3.1.0")

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important — exact:from: desyncs the three install methods. from: "3.1.0" resolves to >= 3.1.0, < 4.0.0 (auto-adopts any future 3.x), but the Xcode row below still says "Exact Version: 3.1.0" and CocoaPods still pins '3.1.0' exactly. Previously all three agreed (exact 1.0.0); now the SPM path floats while the other two are hard-pinned, so the documented methods no longer resolve equivalently.

Pick one intent: keep the exact-pin convention (exact: "3.1.0"), or float all three consistently (~> 3.1 for CocoaPods, "Up to Next Major" for Xcode).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants