[Android]: BREAKING - Native Android build fails 16 KB page size check due to bundled Linux assets (xclip)

[Egilan]

Have you checked for an existing issue?

• I have searched the existing issues

Flutter Quill Version

11.4.2

Steps to Reproduce

1. Create a new Flutter project (flutter create new_project)
2. Add flutter_quill: ^11.4.2 to pubspec,
3. Run flutter pub get.
4. Run the android.app from Android Studio (not main.dart!)

Expected results

Obviously "no warning".
But flutter run or flutter build apk --release don't raise this warning. - But this is just another "bug" probably, or something that I don't yet understand about development. So the issue is still there, just no warning.

Actual results

A pop up in the right bottom corner:

APK app-debug.apk is not compatible with 16 KB devices. Some libraries have LOAD segments not aligned at 16 KB boundaries:
assets/flutter_assets/packages/quill_native_bridge_linux/assets/xclip
Starting November 1st, 2025, all new apps and updates to existing apps submitted to Google Play and targeting Android 15+ devices must support 16 KB page sizes. For more information about compatibility with 16 KB devices, visit developer.android.com/16kb-page-size.

Additional Context

EDIT: This IS a major issue - flutter build does similarly include it in the final APK:
build\app\outputs\apk\debug\app-debug.apk\assets\flutter_assets\packages\quill_native_bridge_linux\assets\xclip

So this WILL cause issues for ALL Android builds.

(((This was wrong: This doesn't seem like a major issue, since flutter build seems to work just fine.)))

[realth000]

This is caused by saving platform specified assets on all platforms targets. Quill native bridge package has xclip and js file that are only used on linux and web, but they are packaged on all platforms.

It is safe to remove xclip and js file when targeting Android.

(Additionally, these assets also blocks reproducible build when publishing to F-Droid, same root cause though off topic.)

[vishnunew]

What is timeline to fix this issue ? Is there any other way to exclude that file from build ?

[hensi-elaunch]

I have face same issue. how can i resolve this?

[ppamorim]

Same issue

[utkudenis]

waiting for solution.

[ppamorim]

@utkudenis @vishnunew @realth000 I was able to fix this issue by using our fork. You need to add this to your project:

(I really don't know why I had to add a dependency overwrite for win32, but since I don't target to it and Linux I really don't care)

dependencies:
  flutter_quill:
    git: 
      url: https://github.com/T-Pro/flutter-quill.git
      ref: feature/removeXclip

dependency_overrides:
  win32: ^5.14.0
  quill_native_bridge:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge
  quill_native_bridge_platform_interface:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_platform_interface
  quill_native_bridge_android:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_android
  quill_native_bridge_ios:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_ios
  quill_native_bridge_linux:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_linux
  quill_native_bridge_macos:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_macos
  quill_native_bridge_web:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_web
  quill_native_bridge_windows:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip
      path: quill_native_bridge_windows

In our fork we modified quill-native-bridge to not embed xclip anymore, if you want to use it you must embed manually or have it installed on the system.

This is a temporary solution until the the Quill team finds a proper solution outside of my fork. Once it gets fixed I will revert those changes.

@singerdmx Since asset aren't plataform dependent, I don't think it's possible to prevent the xclip file from being embedded in the project at compile time. I would suggest in total removal of this library and find a similar, if not equals, solution of what you can find on my fork.

[nurullahturkoglu]

after all can't we disable the embed xclip asset for those other than the linux platform?

[ppamorim]

after all can't we disable the embed xclip asset for those other than the linux platform?

No

[Egilan]

after all can't we disable the embed xclip asset for those other than the linux platform?

The real solution seems to be fully removing xclip from pubspec assets and adding it otherwise to Linux builds. Like @ppamorim said, ALL pubspec assets are included for all platforms.

But can CONFIRM that the solution by @ppamorim works as a temporary solution - many thanks!

[kostadin-damyanov-prime]

Just to make it clear - this issue will prevent all users of the flutter-quill package from releasing updates or new applicatons to the Play Store after November 1st, 2025.

[ppamorim]

@Egilan Thank you, I am currently facing a issue with the native bridge when running the application in a UI test suite:

══╡ EXCEPTION CAUGHT BY FLUTTER TEST FRAMEWORK ╞═════════════════
The following UnimplementedError was thrown running a test (but
after the test had completed):
isIOSSimulator() has not been implemented.

When the exception was thrown, this was the stack:
#0      QuillNativeBridgePlatform.isIOSSimulator (package:quill_native_bridge_platform_interface/quill_native_bridge_platform_interface.dart:72:7)
#1      QuillNativeBridge.isIOSSimulator (package:quill_native_bridge/quill_native_bridge.dart:53:46)
#2      isIOSSimulator (package:flutter_quill/src/common/utils/platform.dart:30:45)
#3      QuillRawEditorState.initState (package:flutter_quill/src/editor/raw_editor/raw_editor_state.dart:837:7)
#4      StatefulElement._firstBuild (package:flutter/src/widgets/framework.dart:5852:55)
#5      ComponentElement.mount (package:flutter/src/widgets/framework.dart:5699:5)
...     Normal element mounting (37 frames)
#42     Element.inflateWidget (package:flutter/src/widgets/framework.dart:4548:16)
#43     Element.updateChild (package:flutter/src/widgets/framework.dart:4004:18)
#44     _LayoutBuilderElement._rebuildWithConstraints.updateChildCallback (package:flutter/src/widgets/layout_builder.dart:248:18)
#45     BuildOwner.buildScope (package:flutter/src/widgets/framework.dart:3046:19)
#46     _LayoutBuilderElement._rebuildWithConstraints (package:flutter/src/widgets/layout_builder.dart:271:12)
#47     RenderAbstractLayoutBuilderMixin.layoutCallback (package:flutter/src/widgets/layout_builder.dart:334:38)
#48     RenderObjectWithLayoutCallbackMixin.runLayoutCallback.<anonymous closure> (package:flutter/src/rendering/object.dart:4156:33)
#49     RenderObject.invokeLayoutCallback.<anonymous closure> (package:flutter/src/rendering/object.dart:2881:17)
#50     PipelineOwner._enableMutationsToDirtySubtrees (package:flutter/src/rendering/object.dart:1206:15)
#51     RenderObject.invokeLayoutCallback (package:flutter/src/rendering/object.dart:2880:14)
#52     RenderObjectWithLayoutCallbackMixin.runLayoutCallback (package:flutter/src/rendering/object.dart:4156:5)
#53     _RenderLayoutBuilder.performLayout (package:flutter/src/widgets/layout_builder.dart:448:5)
#54     RenderObject.layout (package:flutter/src/rendering/object.dart:2762:7)
#55     ChildLayoutHelper.layoutChild (package:flutter/src/rendering/layout_helper.dart:62:11)
///...

This is possibly related to the changes I have done to the fork, it seems that the QuillNativeBridgePlatform for iOS is not being correctly selected by the simulator, causing the app to crash.

---

Correction: It also happens outside the test scope, but the application doesn't crash.

---

I fixed this issue by adding quill_native_bridge just after flutter_quill:

dependencies:
  flutter_quill:
    git: 
      url: https://github.com/T-Pro/flutter-quill.git
      ref: feature/removeXclip
  quill_native_bridge:
    git:
      url: https://github.com/T-Pro/quill-native-bridge.git
      ref: feature/removeXclip

[lwy121810]

same issue!!!

[lwy121810]

@ppamorim my project uses Flutter 3.27.4. and if I use your solution, an error will occur:

The current Dart SDK version is 3.6.2.

Because win32 >=5.14.0 depends on ffi >=2.1.4 which requires SDK version >=3.7.0 <4.0.0, win32 >=5.14.0 is forbidden.
So, because halar_app depends on win32 ^5.14.0, version solving failed.