docs(build-distribution): Add Install Groups documentation#16529
Merged
runningcode merged 3 commits intomasterfrom Feb 26, 2026
Merged
docs(build-distribution): Add Install Groups documentation#16529runningcode merged 3 commits intomasterfrom
runningcode merged 3 commits intomasterfrom
Conversation
Add documentation for the Install Groups feature which lets users tag builds with group names to control update visibility. Includes platform-specific guides for Android (CLI, Gradle, Fastlane) and iOS (CLI, Fastlane), product-level explanation, and upload metadata table update. Co-Authored-By: Claude <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
noahsmartin
reviewed
Feb 24, 2026
noahsmartin
reviewed
Feb 24, 2026
Instead of referencing the "currently installed build", describe install groups as a list provided by the caller when checking for updates. This is more accurate since there is no reliable way to automatically detect the current build across platforms. Co-Authored-By: Claude <noreply@anthropic.com>
noahsmartin
reviewed
Feb 26, 2026
noahsmartin
reviewed
Feb 26, 2026
noahsmartin
approved these changes
Feb 26, 2026
Simplify "How It Works" section per review feedback: remove the numbered list about app/build configuration (which doesn't reflect actual behavior) and reframe matching as set intersection rather than OR logic. Co-Authored-By: Claude <noreply@anthropic.com>
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
Comment on lines
+38
to
+40
| Matching requires two builds to have a non-empty intersection of their install groups. For example, a build tagged `["alpha", "staging"]` will see updates from a build tagged `["alpha", "beta"]` because both share `alpha`. | ||
|
|
||
| ### Use Cases |
There was a problem hiding this comment.
Bug: The documentation states users can provide install groups when checking for updates, but the Android and iOS SDK examples show no such parameter, creating a contradiction.
Severity: MEDIUM
Suggested Fix
Align the documentation with the actual SDK functionality. If the SDKs support passing install groups, update the Android and iOS documentation and code examples to show how. If they do not, remove the statement from docs/product/build-distribution/index.mdx that claims users can provide install groups when checking for updates.
Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.
Location: docs/product/build-distribution/index.mdx#L38-L40
Potential issue: The product documentation at
`docs/product/build-distribution/index.mdx` states that when a device checks for
updates, a developer "can provide a list of install groups". However, the corresponding
SDK documentation for both Android and iOS does not show a way to pass this list. The
Android example uses `checkForUpdateBlocking()` with no parameters, and the iOS
`CheckForUpdateParams` object does not include a field for install groups. This
discrepancy will lead developers to believe a feature is available when the SDKs do not
expose it, causing confusion and incorrect implementation attempts.
Did we get this right? 👍 / 👎 to inform future reviews.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DESCRIBE YOUR PR
Add documentation for the new Install Groups feature in Build Distribution. Install groups let users tag builds with group names to control which builds are offered as over-the-air updates.
install-groupfieldIS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes:
EME-864
Co-Authored-By: Claude noreply@anthropic.com