Skip to content

INTER-2592: docs: explain when Android apps must declare the Fingerprint Maven repository - #207

Merged
JuroUhlar merged 2 commits into
mainfrom
docs/android-settings-repositories
Oct 5, 2026
Merged

JuroUhlar merged 2 commits into
mainfrom
docs/android-settings-repositories

Conversation

@JuroUhlar

@JuroUhlar JuroUhlar commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Part of INTER-2592.

  • Add an "Android repositories" note to the README install section

The plugin adds maven.fpregistry.io to the app's project repositories (android/build.gradle). With repositoriesMode = PREFER_SETTINGS, Gradle ignores project repositories, so the app must declare it in settings. The default Flutter template doesn't set this mode.

Tested with the example app (Flutter 3.49, AGP 9)

  • FAIL_ON_PROJECT_REPOS: fails in dev.flutter.flutter-gradle-plugin itself, so it isn't usable with Flutter at all. Not documented.
  • PREFER_SETTINGS + google(), mavenCentral(), Flutter engine repo: fails with Could not find any matches for com.fingerprint.android:sdk:[4.1.0, 4.2.0).
  • Same + maven.fpregistry.io: builds.

Discussion point: Kotlin DSL only

The snippet uses settings.gradle.kts, the default for new Flutter apps. Groovy users can translate the one line.

…pository

The plugin adds the repository to the project. Gradle ignores or rejects
project repositories when settings use PREFER_SETTINGS or
FAIL_ON_PROJECT_REPOS.

https://docs.gradle.org/current/userguide/centralizing_repositories.html
Tested with the example app on Flutter 3.49 and AGP 9:
- FAIL_ON_PROJECT_REPOS fails in the Flutter Gradle plugin itself,
  so no Flutter app can use it
- PREFER_SETTINGS with the Flutter engine repository fails to resolve
  com.fingerprint.android:sdk until the Fingerprint repository is added
@github-actions

github-actions Bot commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

⚠️ This PR doesn't contain any changesets. If there are user-facing changes, don't forget to run:

pnpm exec changeset

to create a changeset.

@JuroUhlar
JuroUhlar merged commit 2c90e98 into main Oct 5, 2026
14 checks passed
@JuroUhlar
JuroUhlar deleted the docs/android-settings-repositories branch October 5, 2026 12:15
@JuroUhlar JuroUhlar changed the title docs: explain when Android apps must declare the Fingerprint Maven repository INTER-2592: docs: explain when Android apps must declare the Fingerprint Maven repository Oct 6, 2026
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.

2 participants