Skip to content

docs(e2e/android): document --include-sources for mapping uploads#692

Open
abelonogov-ld wants to merge 1 commit into
mainfrom
andrey/android-source
Open

docs(e2e/android): document --include-sources for mapping uploads#692
abelonogov-ld wants to merge 1 commit into
mainfrom
andrey/android-source

Conversation

@abelonogov-ld

Copy link
Copy Markdown
Contributor

Documents the --include-sources / --source-path flags added in launchdarkly/ldcli#758, which upload your .java/.kt files so the errors page can show the code around each retraced frame.

Explains why Android needs --source-path at all (an R8 mapping records no file paths, unlike a dSYM's DWARF), how files are keyed by their declared package so a Kotlin file in a directory that doesn't mirror its package still resolves, the skipped directories and size limits, and that the flag is off by default because it stores your source in LaunchDarkly.

Also notes the side benefit: R8's SourceFile placeholder forces the backend to guess .java for every frame, and a resolved source replaces that guess with the real path — so Kotlin frames finally show .kt.

Made with Cursor

Explains why Android needs --source-path at all (an R8 mapping records no
file paths, unlike a dSYM's DWARF), how files are keyed by their declared
package so a Kotlin file in a mismatched directory still resolves, the
skipped directories and size limits, and that the flag is off by default
because it stores source in LaunchDarkly.

Also notes the side benefit: R8's 'SourceFile' placeholder forces the backend
to guess .java, and a resolved source replaces that guess with the real path,
so Kotlin frames finally show .kt.

Co-authored-by: Cursor <cursoragent@cursor.com>
@abelonogov-ld
abelonogov-ld requested a review from a team as a code owner July 24, 2026 20:51
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.

1 participant