Fix Dokka 1.x compatibility with AGP 8.7.3#115
Merged
Conversation
Dokka 1.x crashes with a NPE when auto-discovering source sets on AGP 8.7+ due to androidTest source set builder creation failing. Bump Dokka to 1.9.20 and manually register source sets instead of using configureEach, which avoids the problematic auto-discovery. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dokka 1.x crashes with a NPE when auto-discovering androidTest source sets on AGP 8.7+. Work around it by clearing auto-discovered source sets and manually registering only the variant being documented. Also bump Dokka from 1.9.10 to 1.9.20. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
mdelolmo
approved these changes
Jul 2, 2026
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 join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
What changed
Dokka 1.x crashes with a
NullPointerExceptionwhen trying to create aGradleDokkaSourceSetBuilderforandroidTestAuthDebugon AGP 8.7+. This is a known Dokka 1.x limitation — the auto-discovery of Android source sets calls AGP APIs that returnnullin newer AGP versions.The fix clears the auto-discovered source sets and manually registers only the variant being documented. This preserves the existing per-flavor documentation (separate docs for
authandstoreartifacts).Dokka 2.x was evaluated but doesn't support per-flavor documentation natively, which this project needs since the
authandstoreflavors expose different public classes.Test plan
./gradlew :auth-lib:authReleaseDokkasucceeds./gradlew :auth-lib:storeReleaseDokkasucceeds./gradlew buildpasses (290 tasks)🤖 Generated with Claude Code