docs: update GMA iOS plugin to v3.1.0 with version compatibility table#1029
docs: update GMA iOS plugin to v3.1.0 with version compatibility table#1029sunnywu wants to merge 1 commit into
Conversation
- 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
left a comment
There was a problem hiding this comment.
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 | |
There was a problem hiding this comment.
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 | |
There was a problem hiding this comment.
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") |
There was a problem hiding this comment.
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).
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).
Test plan
/docs/guides/mobile-plugin-gma-iosshows v3.1.0 and the compatibility table🤖 Generated with Claude Code