commit a294a0259a9688103b19119365dc888f8dc37656
parent 82efc7e5ac2c74d65c591a01a8a7b3154ae643fd
Author: Jan-Erik Rediger <jrediger@mozilla.com>
Date: Mon, 8 Dec 2025 14:59:23 +0000
Bug 2004677 - Update steps to update the Glean SDK in app-services r=chutten DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D275428
Diffstat:
1 file changed, 10 insertions(+), 17 deletions(-)
diff --git a/toolkit/components/glean/docs/dev/updating_sdk.md b/toolkit/components/glean/docs/dev/updating_sdk.md
@@ -64,31 +64,24 @@ To update the Glean SDK version used by `application-services`:
[Setting yourself up to build and test `application-services`][as-contributing]
is straightforward, but non-trivial.
You may find it easier to ask them to do it.
-2) Update the Glean SDK git submodule to the latest release's tag. e.g.
- * `cd components/external/glean`
- * `git checkout tags/v62.0.0`
-3) Update the `glean-build` crate dependency for codegen:
- * `cargo update -p glean-build`
-4) Update Gradle's version of the Glean dependency for Android support:
+2) Update Gradle's version of the Glean dependency for Android support:
* Edit `gradle/libs.versions.toml` to specify e.g. `glean = "62.0.0"`
-5) Update Xcode's version of its Glean dependency for iOS support:
- * Edit `megazords/ios-rust/MozillaTestServices/MozillaTestServices.xcodeproj/project.pbxproj`
- to specify e.g. `minimumVersion = 62.0.0;` for the `glean-swift` package reference.
- * Xcode also has a lockfile. If you do not have Xcode, or just don't want to run it, edit
- `megazords/ios-rust/MozillaTestServices/MozillaTestServices.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved`
- to specify the new version plus the git SHA of the new release of [mozilla/glean-swift][glean-swift]
+3) Update the `glean-swift` version used:
+ * Edit `megazords/ios-rust/Package.swift` to specify the correct version for `https://github.com/mozilla/glean-swift`
+ * Xcode also has a lockfile. If you do not have Xcode, or just don't want to run it,
+ edit `megazords/ios-rust/Package.resolved` to specify the new version plus the git SHA of the new release of [mozilla/glean-swift][glean-swift]
e.g. `"revision" : "5c614b4af5a1f1ffe23b46bd03696086d8ce9d0d",` and `"version": "62.0.0"`
-6) Run `cargo test` to make sure nothing obvious is broken.
-7) Submit your PR for review and have it merged.
-8) Make your `mozilla-central` changes depend on the patch the auto-update bot created to update
+4) Run `cargo test` to make sure nothing obvious is broken.
+5) Submit your PR for review and have it merged.
+6) Make your `mozilla-central` changes depend on the patch the auto-update bot created to update
`mozilla-central` to the new `application-services` version that contains your changes.
* This will happen if you wait a day. Look for
an automatically-filed bug
([e.g.](https://bugzilla.mozilla.org/show_bug.cgi?id=1893248)).
* If you need to operate faster, you can ask `application-services`
folks to trigger a build for you, then write the patch yourself.
-9) Push the whole stack to `try` to make sure the tree works together.
-10) When everything's green, supply the whole stack to Lando to land it.
+7) Push the whole stack to `try` to make sure the tree works together.
+8) When everything's green, supply the whole stack to Lando to land it.
[sdk_generator.sh]: https://github.com/mozilla/glean/blob/main/glean-core/ios/sdk_generator.sh#L28
[glean-bug]: https://bugzilla.mozilla.org/enter_bug.cgi?product=Data+Platform+and+Tools&component=Glean%3A+SDK&priority=P3&status_whiteboard=%5Btelemetry%3Aglean-rs%3Am%3F%5D
