[Android] Add breaking changes page on default ABI filters

[camsim99]

Description of what this PR is changing or adding, and why:
Adds a breaking change for flutter/flutter#168293 which landed in 3.35. TLDR: To set custom Android ABI filters, you must clear the defaults that Flutter sets or use the Flutter-provided flag for doing so.

Issues fixed by this PR (if any):
Fixes flutter/flutter#174004

PRs or commits this PR depends on (if any):
N/A

Presubmit checklist

• 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.
• If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
• This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
• This PR uses semantic line breaks
  of 80 characters or fewer.

[flutter-website-bot]

Visit the preview URL for this PR (updated for commit e82fe86):

https://flutter-docs-prod--pr12350-abi-filters-w5bhno49.web.app

[sfshaza2]

I know this is in draft, but I reviewed it anyway. ;). I have a few tweaks over the word "may" but otherwise it looks great!

https://developers.google.com/style/word-list#may

[camsim99]

@gmackall Can you take a look to make sure this is right? Made this change instead of attempting to put it in the blog because this feels moreso like the right place, but let me know if you disagree. Thanks!

[gmackall]

This is not exactly correct - the configuration happens before. It just breaks those who were depending on the set to be empty.

Previously, it would be. Now we add elements to it during configuration that happens before the user's build.gradle file. This is why clearing still works (otherwise it wouldn't matter what they wrote in their build.gradle at all).

[camsim99]

Ahhh I see I see. Corrected "after" to "before"!

[gmackall]

@gmackall Can you take a look to make sure this is right? Made this change instead of attempting to put it in the blog because this feels moreso like the right place, but let me know if you disagree. Thanks!

I think this is the right place as well, mostly looks good but one comment on the ordering of gradle configuration.

[angcyo]

Why does the flutter/flutter#174004 issue still exist on version 3.35.2

Flutter is already up to date on channel [user-branch]
Flutter 3.35.2 • channel [user-branch] • https://github.com/flutter/flutter.git
Framework • revision 05db968908 (9 小时前) • 2025-08-25 10:21:35 -0700
Engine • hash abb725c9a5211af2a862b83f74b7eaf2652db083 (revision a8bfdfc394) (3 days ago) • 2025-08-22 23:51:12.000Z
Tools • Dart 3.9.0 • DevTools 2.48.0

[camsim99]

Why does the flutter/flutter#174004 issue still exist on version 3.35.2

Flutter is already up to date on channel [user-branch]
Flutter 3.35.2 • channel [user-branch] • https://github.com/flutter/flutter.git
Framework • revision 05db968908 (9 小时前) • 2025-08-25 10:21:35 -0700
Engine • hash abb725c9a5211af2a862b83f74b7eaf2652db083 (revision a8bfdfc394) (3 days ago) • 2025-08-22 23:51:12.000Z
Tools • Dart 3.9.0 • DevTools 2.48.0

@angcyo are you saying that the fix detailed here does not work for you on the latest stable?

[gmackall]

nit: I would just say something more explicitly like this:

Suggested change

	Because this automatic configuration happens before your `build.gradle` files
	are processed, it might override custom `abiFilters` settings.
	Because this automatic configuration happens before your `build.gradle` files
	are processed, it might break custom `abiFilters` settings that depend on the set being empty.

I think the current structure could be confusing, as one would wonder something that happens before would override settings.

[gmackall]

Left a nit for how I would prefer it but LGTM either way now

[angcyo]

Why does the flutter/flutter#174004 issue still exist on version 3.35.2

Flutter is already up to date on channel [user-branch]
Flutter 3.35.2 • channel [user-branch] • https://github.com/flutter/flutter.git
Framework • revision 05db968908 (9 小时前) • 2025-08-25 10:21:35 -0700
Engine • hash abb725c9a5211af2a862b83f74b7eaf2652db083 (revision a8bfdfc394) (3 days ago) • 2025-08-22 23:51:12.000Z
Tools • Dart 3.9.0 • DevTools 2.48.0

@angcyo are you saying that the fix detailed here does not work for you on the latest stable?

Yes, I updated to 3.35.2, but it still didn't work.

I use flutter build apk --release to generate the apk.

Here is a minimum verification problem project : https://github.com/angcyo/flutter_abi_filters_demo

build.gradle.kts configuration as follows:

android {
    ...

    defaultConfig {
        ...
        ndk {
            //abiFilters.clear()
            //abiFilters.add("arm64-v8a")
            //abiFilters.add("armeabi-v7a")
            abiFilters.addAll(listOf("arm64-v8a", "armeabi-v7a"))
        }
    }
}

Is it a problem with the .kts file?

Is there no problem if build.gradle is used instead of build.gradle.kts?

I tried build.gradle, but there were also problems.

Should I reconsider merging my PR : flutter/flutter#174008

[camsim99]

@angcyo Have you tried using abiFilters.clear()? That's part of the solution, but it's commented out in your code.

[angcyo]

@angcyo Have you tried using abiFilters.clear()? That's part of the solution, but it's commented out in your code.

I've tried everything, but the problem still exists.

[camsim99]

@gmackall Do you know why this solution may not work in some cases? I took a look at the build.gradle files in https://github.com/angcyo/flutter_abi_filters_demo and nothing jumps out to me.

[angcyo]

@gmackall Do you know why this solution may not work in some cases? I took a look at the build.gradle files in https://github.com/angcyo/flutter_abi_filters_demo and nothing jumps out to me.

is there any progress?

[angcyo]

What's the situation now?

[RaadShariat]

@angcyo Have you tried using abiFilters.clear()? That's part of the solution, but it's commented out in your code.

I've tried everything, but the problem still exists.

@angcyo The migration guide is saying to set ABI filters in buildTypes, but you are doing it in defaultConfig. Maybe that's why?

[RaadShariat]

By the way, this migration guide here doesn't link to any pages.

[camsim99]

@RaadShariat thank you so much for pointing this out! Putting up a fix now: #12379