Skip to content

Commit 2a267c6

Browse files
authored
Update abiFiltering documentation with new flag to disable (#12670)
A new flag has been added that will allow Android developers to disable FlutterPlugin.kt code that adds abiFilters to buildTypes. This should only be used when the developer knows what they are doing. This is specifically for developers that want to set abiFilters in [Product Flavors](flutter/flutter#175845) Depends on: flutter/flutter#177753 ## Presubmit checklist - [X] If you are unwilling, or unable, to sign the CLA, even for a _tiny_, one-word PR, please file an issue instead of a PR. - [X] If this PR is not meant to land until a future stable release, mark it as draft with an explanation. - [X] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style)—for example, it doesn't use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person pronouns). - [X] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer.
1 parent 7f7690e commit 2a267c6

File tree

2 files changed

+12
-0
lines changed

2 files changed

+12
-0
lines changed

src/content/deployment/flavors.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -349,6 +349,12 @@ If you have additional build settings that you would like to
349349
configure for a specific Android product flavor, see
350350
Android's [Configure build variants][].
351351
352+
While it is possible to set `abiFilters` in product flavors, it is not
353+
recommended. Instead, favor `abiFilters` in build types. When setting
354+
`abiFilters` in product flavors, one must use the
355+
`-Pdisable-abi-filtering` flag when running `flutter build` or
356+
`flutter run`.
357+
352358
[Configure build variants]: https://developer.android.com/build/build-variants
353359
354360
## More information

src/content/release/breaking-changes/default-abi-filters-android.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,10 @@ android {
7676
}
7777
```
7878

79+
### Disabling abiFIlters ###
80+
It is possible, but not recommended, to disable this abi filtering. Pass the `-Pdisable-abi-filtering`flag when running `flutter build`
81+
or `flutter run`.
82+
7983
## Timeline
8084

8185
Landed in version: 3.35.0<br>
@@ -84,8 +88,10 @@ In stable release: 3.35
8488
Relevant issues:
8589
* [Issue #174004]({{site.repo.flutter}}/issues/174004)
8690
* [Issue #153476]({{site.repo.flutter}}/issues/153476)
91+
* [Issue #175845]({{site.repo.flutter}}/issues/175845)
8792

8893
Relevant PRs:
8994
* [PR #168293]({{site.repo.flutter}}/pull/168293)
95+
* [PR #177753]({{site.repo.flutter}}/pull/177753)
9096

9197
[`abiFilters`]: https://developer.android.com/reference/tools/gradle-api/8.7/com/android/build/api/dsl/Ndk#abiFilters()

0 commit comments

Comments
 (0)