fix(android): Report missing properties file or keys when flavorAware is enabled

[antonis]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

When flavorAware is set in project.ext.sentryCli and the per-variant properties file is missing, or required keys are absent, sentry.gradle previously swallowed the FileNotFoundException (logging at info) and passed null values to sentry-cli. Gradle then failed with an opaque:

Illegal null value provided in this collection: [..., --url, null, --auth-token, null, ..., --org, null, --project, null]

This PR makes the error actionable:

• Throws a GradleException naming the expected sentry-${variant}.properties path when the file is missing (flavor-aware only).
• Collects missing required keys (auth.token / SENTRY_AUTH_TOKEN, defaults.org, defaults.project) and throws a single error listing them all alongside the file path.
• Only appends --url when defaults.url is set, so sentry-cli falls back to its default instead of being handed null.
• Non-flavor-aware path (the SENTRY_PROPERTIES env flow) is unchanged.

💡 Motivation and Context

Users hitting this flow today (see #2837 as an example of the cryptic surface error) have no indication of which file was expected or which key was missing. This change surfaces both directly.

Fixes #2839.

💚 How did you test it?

Parse check — ./gradlew :app:help on samples/react-native/android with the updated sentry.gradle symlinked via the yarn workspace: builds the task graph without errors.

Validation harness — built a standalone Gradle project that copies the exact validation block (same message strings, same control flow) and drives 8 scenarios. All pass:

#	Scenario	Expectation	Result
A	flavorAware=true, properties file missing	GradleException naming the expected path and flavorAware	PASS
B	flavorAware=true, file present, only defaults.org missing	GradleException reporting only that key, with file path	PASS
C	flavorAware=true, file fully populated	Args contain --url, --auth-token, --org, --project with no nulls	PASS
D	flavorAware=true, auth.token absent but SENTRY_AUTH_TOKEN set	Succeeds; --auth-token uses env value	PASS
E	flavorAware=true, all three required keys missing	Single GradleException listing all three keys	PASS
F	flavorAware=true, defaults.url empty string	--url flag omitted; required args still present	PASS
G	flavorAware=false, properties file missing	No exception (existing silent behavior preserved)	PASS
H	flavorAware=false, file present	No flavor-specific args added	PASS

Not run locally: a full :app:bundleRelease against real Sentry infrastructure. The change is isolated to the doLast block inside the _SentryUpload_ task, and the scenarios above cover every branch touched. No Gradle/Groovy test harness exists in this repo to check these in automatically.

📝 Checklist

• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
• I updated the docs if needed.
• I updated the wizard if needed.
• All tests passing
• No breaking changes

🔮 Next steps

🤖 Generated with Claude Code

[github-actions]

	Fails
🚫	Pull request is not ready for merge, please add the "ready-to-merge" label to the pull request

Generated by 🚫 dangerJS against 8458b0a

[antonis]

@sentry review

[antonis]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 8458b0a. Configure here.}