nutrient_flutter_android

Releases

1. ▸▾2.0.029 Jul 2026

   First pub.dev published version.

   • First pub.dev published version. (#28157)
   • Updates the minimum required Flutter SDK version to 1.12.0. (#28157)

   Open source →

   Additional notes

   Changed

   First pub.dev published version. ( #28157 )

   Changed

   Updates the minimum required Flutter SDK version to 1.12.0. ( #28157 )

   Open source →

   Additional notes

   • Updates to Nutrient Android SDK 11.6.1 and regenerates the JNI bindings against it. Raises the plugin's minSdkVersion to 24 (Nougat) to match the SDK's new minimum.
   • Populates PageInfo.label from PdfDocument.getPageLabel(int, boolean) on Android (was previously always null). Falls back to null when the PDF has no explicit label dictionary entry. (J#HYB-951)
   • BREAKING: io.flutter.embedding.android.FlutterAppCompatActivity moved from nutrient_flutter to nutrient_flutter_android, and the class is re-synced with upstream FlutterFragmentActivity at flutter/flutter@0541913d8. The Nutrient-specific deltas are now limited to (a) extending androidx.appcompat.app.AppCompatActivity instead of androidx.fragment.app.FragmentActivity, and (b) the class rename. The previous AiAssistantProvider integration that delegated to PSPDFKitView.Companion.getAiAssistant() has been removed because it required reaching into the legacy nutrient_flutter Android module. Apps that need the legacy AI Assistant binding can subclass FlutterAppCompatActivity in their own module, implements io.nutrient.domain.ai.AiAssistantProvider, and register the subclass in their AndroidManifest.xml instead. See nutrient_flutter's migration notes for details. (J#HYB-951)
   • Implements seven view-scoped methods on AndroidAdapter via JNI (the PdfFragment and ViewProjection Kotlin SDK classes): getVisibleRect, zoomToRect, getZoomScale, enterAnnotationCreationMode, exitAnnotationCreationMode, convertViewPointToPdfPoint, convertPdfPointToViewPoint. (J#HYB-952)
   • Adds utils/annotation_tool_android_mapping.dart with androidAnnotationToolNameFor (testable, JNI-free) and toAndroidAnnotationTool (FFI-touching) helpers, mapping the platform-interface AnnotationTool enum to the JNI-bound Java enum. (J#HYB-952)
   • Adds utils/jni_rect_f.dart, a small raw-JNI helper that constructs and reads back android.graphics.RectF instances since jnigen does not bind it. (J#HYB-952)
   • Wires AndroidAdapter to drive the cross-platform events stream via JNI listeners on PdfFragment: DocumentListener for load/save/page/zoom/click, AnnotationProvider$OnAnnotationUpdatedListener for annotation CRUD, OnAnnotationSelectedListener for selection/deselection, FormManager$OnFormElementUpdatedListener for form field updates, and TextSelectionManager$OnTextSelectionChangeListener for text selection. Listener wiring runs in onPdfFragmentReady before the new onFragmentReady subclass hook. (J#HYB-957)
   • Adds AndroidNutrientEvent sealed class and androidEvents broadcast stream on AndroidAdapter for events that don't have a cross-platform equivalent: AndroidAnnotationZOrderChangedEvent, AndroidDocumentZoomedEvent, AndroidDocumentSaveFailedEvent, AndroidDocumentSaveCancelledEvent, AndroidActivityPausedEvent, AndroidFragmentAddedEvent, AndroidFormEditingModeChangedEvent, AndroidAnnotationCreationModeChangedEvent. Subclasses can call the protected emitAndroidEvent(...) helper to push their own platform-specific events. (J#HYB-957)
   • Splits the onPdfFragmentReady lifecycle hook: the SDK now wires its built-in listeners in onPdfFragmentReady and calls a new @protected onFragmentReady(PdfFragment) hook for subclasses. Subclasses that previously overrode onPdfFragmentReady should switch to overriding onFragmentReady so the SDK's listeners stay registered. (J#HYB-957)
   • Implements NutrientDocumentInterface.exportPdf on the federated Android plugin via the synchronous PdfProcessor.processDocument(task, file, saveOptions) JNI overload. Honours DocumentSaveOptions.flatten and DocumentSaveOptions.excludeAnnotations via PdfProcessorTask.changeAllAnnotations(FLATTEN | DELETE), and DocumentSaveOptions.optimize via DocumentSaveOptions.setRewriteAndOptimizeFileSize. The processor writes to a JVM temp file (via java.io.File.createTempFile), the Dart side reads it back as bytes and best-effort-deletes it. Password / permissions / pdf-version mapping is still defaults-only — track richer save-options support as a follow-up. (J#HYB-951)
   • Adds utils/jni_file.dart, a small raw-JNI helper for java.io.File (constructor from path, createTempFile, getAbsolutePath, delete). jnigen doesn't bind java.io.File since it isn't part of the Nutrient SDK surface, but the sync PdfProcessor.processDocument(...) overload needs one. (J#HYB-951)

• nutrient_flutterpub.devA Flutter plugin providing a feature-rich PDF viewing and editing experience to your users with the powerful Nutrient PDF SDK.
• nutrient_flutter_platform_interfacepub.devA common platform interface for the nutrient_flutter plugin.
• nutrient_flutter_webpub.devWeb implementation of the nutrient_flutter plugin.
• nutrient_flutter_iospub.deviOS implementation of the nutrient_flutter plugin.