flutter_pdfview

1.5.0-beta.6

• Fix #175: getScreenshot no longer returns a white image under hybrid composition (#356)
• Includes everything in 1.5.0-beta.5

dependencies:
  flutter_pdfview: 1.5.0-beta.6

Note: pub.dev upload may lag briefly due to rate limiting; version is tagged and on migrate/kotlin-swift.

1.5.0-beta.5

• Fix load flash / first-layout size / iOS blank open (#355):
  • #40
  • #127
  • #190
• Includes everything in 1.5.0-beta.4

dependencies:
  flutter_pdfview: 1.5.0-beta.5

1.5.0-beta.4

• Document Android AcroForm / fillable form field rendering limits (#303, #354)
• Includes everything in 1.5.0-beta.3

dependencies:
  flutter_pdfview: 1.5.0-beta.4

1.5.0-beta.3

• Add first-class onTap callback (Dart + Android + iOS) so single taps are reported from the native PDF view; prefer this over gestureRecognizers + TapGestureRecognizer (#133, #353)
• Includes everything in 1.5.0-beta.2

dependencies:
  flutter_pdfview: 1.5.0-beta.3

1.5.0-beta.2

• Document iOS platform-view composition limits for ColorFiltered / ShaderMask / BackdropFilter over PDFView, with official Flutter evidence and workarounds (#213, #352)
• Includes everything in 1.5.0-beta.1 (Kotlin + Swift native migration)

Install

dependencies:
  flutter_pdfview: 1.5.0-beta.2

pub.dev: https://pub.dev/packages/flutter_pdfview/versions/1.5.0-beta.2

Feedback: #351

Co-Authored-By: Claude Opus 5 (1M context) noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01XKmmG2v9eJSWFDLy6mRe8F

Stable release of the 1.4.5-beta.1 → 1.4.5-beta.5 line; no code changes since 1.4.5-beta.5.

Highlights since 1.4.4 (see the beta sections below for the full list):

• BREAKING: minimum Flutter 3.32.0 / Dart 3.8.0
• BREAKING: Android platform views now use true hybrid composition (initExpensiveAndroidView) — fixes surface lock #263, EGL_NO_DISPLAY crash #280, blanking on rotation #9 / dialogs #182 / load #298, and GPU glitches #306
• BREAKING: Android external PDF links only auto-launch http/https; other schemes are reported through onLinkHandler instead
• iOS: fitPolicy (WIDTH / HEIGHT / BOTH) implemented for Android parity, page fit decoupled from autoSpacing #150, onError on bad passwords/documents #211, white background and continuous scrolling #204, Privacy Manifest #271
• Android: Java 17 toolchain #334, dispose/memory-leak fixes #261, absolute-path loading #266, libc++_shared.so packaging #287
• New API: minZoom / maxZoom #296, showScrollIndicators #337, onLoadComplete / onDraw, getCurrentPageSize(), getScreenshot(), getPosition() / setPosition(), getScale() / setScale(), reload(), setZoomLimits() #333
• Document remount when filePath / pdfData changes #181

Migration from 1.4.4

1. Raise your app to Flutter ≥ 3.32 and Dart ≥ 3.8.
2. Android PDF views now use expensive hybrid composition (true platform views); re-check layout and gesture behavior if you embed PDFView in complex widget trees.
3. Non-http(s) PDF links no longer auto-open — handle them yourself in onLinkHandler.

• Fix #150: iOS initial page fit no longer depends on autoSpacing (spacing vs zoom decoupled); re-fit after placeholder→real bounds and on rotation while preserving user zoom
• Implement fitPolicy (WIDTH / HEIGHT / BOTH) on iOS for parity with Android (iOS previously ignored the flag and always auto-fit the full page; default FitPolicy.WIDTH now matches Android)
• Add regression tests for #150 creation-param independence (Dart iOS/Android + Android Robolectric) and iOS fit-scale formula oracle
• Make standalone Android unit tests runnable: compileOnly Flutter embedding jar, fix android/settings.gradle, add scripts/run_android_unit_tests.sh

• BREAKING: Raise minimum Flutter version to 3.32.0 and Dart SDK to 3.8.0 (aligns with flutter_lints 6 and formatter.page_width)
• Android: switch platform views from texture hybrid composition (initSurfaceAndroidView) to true hybrid composition (initExpensiveAndroidView) — fixes Surface was already locked! #263, EGL_NO_DISPLAY quick-open crash #280, blank on rotation #9, blank after dialogs #182, blank on load #298, and GPU glitches #306
• Fix Android layout direction to follow ambient Directionality (was hardcoded RTL)
• Fix #181: remount platform view when filePath / pdfData changes so a new PDF can load
• Fix #261: release Pdfium/PDFKit resources on dispose (Android recycle race + iOS observers/document/channel)
• Restrict Android external PDF link auto-launch to http/https (avoids file:// crashes and unsafe schemes); still reports all schemes via onLinkHandler
• Serialize concurrent setPosition/setScale through a queue for any number of overlapping callers; null platform replies return false
• Compare pdfData via cached digests instead of a full per-byte scan on every rebuild
• Fix #268: avoid NaN CoreGraphics errors by initializing iOS PDFView with a non-zero frame
• Fix #204: iOS white background (not grey) and continuous vertical page scroll parity with Android
• Fix #266: load absolute filesystem paths via fromFile on Android (No content provider)
• Fix #287: pickFirst packaging for libc++_shared.so native merge conflicts
• Defer Android PDF load until the view has non-zero size; safer dispose before surface draw races
• Propagate nightMode setting updates to native Android view
• Document EagerGestureRecognizer for PDFView inside scrollables #265
• Fix Android external PDF links silently failing on API 30+ package visibility (resolveActivity pre-check)
• Fix controller deadlock: a failed setPosition/setScale call permanently hung all later position/scale calls
• Fix iOS silently showing a blank view for wrong/missing passwords — now fires onError (parity with Android)
• Fix iOS getCurrentPage/onPageChanged reporting a garbage index (NSNotFound) before a page is loaded
• Validate thumbnailRatio to (0, 1] (Dart assert + Android clamp) — out-of-range values crashed rendering
• Restructure Dart library into lib/src/ part files; public API unchanged
• Adopt flutter_lints 6.0 with zero analyzer issues; dartdoc for the entire public API
• Expand unit tests: controller method channel, native→Dart callbacks, document remount, creation settings
• Add 64 Android native unit tests (Robolectric/JUnit): URI handling, param parsing, link handler, thumbnail clamp
• Replace broken example widget test with home-screen / PDFScreen chrome coverage
• Fix Android setPage resolving before the jump executes; reload pages when nightMode changes; handle unescaped file: URIs on iOS

• Fixed issue #337: Added showScrollIndicators option to control native scroll indicator visibility.

• Fix iOS PDF view reporting not ready when it is on initial load
• Add minZoom and maxZoom to the README.md
• Fix Android memory leak by recycling PDFView on dispose

• Upgrade Java source/target compatibility from 1.8 to 17 #334
• Add iOS Privacy Manifest (PrivacyInfo.xcprivacy) #271
• Fix iOS onError callback not firing for invalid documents #211
• Fix iOS onPageChanged not triggered on first load #66
• Fix iOS landscape PDF wrong initial zoom by preserving user-configured max scale factor #247
• Add configurable maxZoom and minZoom parameters #296
• BREAKING: Raise minimum Flutter version to 3.27.0 and Dart SDK to 3.6.0
• Migrate backgroundColor serialization from deprecated Color.value to Color.toARGB32()
• Update iOS deployment target to 13.0 in podspec and Package.swift (aligns with Flutter's own iOS 13.0+ requirement)
• Fix example app build error with undefined nightModeBackgroundColor parameter
• Add onLoadComplete callback triggered when the PDFView has loaded its document #333 @JaseElder
• Add onDraw callback triggered on each draw within the PDFView #333 @JaseElder
• Add getCurrentPageSize() controller method returning width and height of the loaded page #333 @JaseElder
• Add getScreenshot(String fileName) controller method to save a PNG of the PDFView contents #333 @JaseElder
• Add getPosition() and setPosition(Offset position) controller methods for the PDF top-left offset #333 @JaseElder
• Add getScale() and setScale(double scale) controller methods for PDF zoom #333 @JaseElder
• Add reload() controller method to reload the PDF document #333 @JaseElder
• Add setZoomLimits(double minZoom, double midZoom, double maxZoom) controller method #333 @JaseElder
• Add safe unboxing and completers for get/set viewport position to avoid contention and race conditions #333 @JaseElder
• Upgrade AndroidPdfViewer to 3.2.8 #333 @JaseElder
• Fix deprecated color .value usage #333 @JaseElder

• Fixes an Android rendering #330 @TimelessLin

• Stable Android 16KB page size support
• Fix iPad scroll direction crash issue #325
  • Add defensive scroll view configuration for iPad devices
  • Implement gesture conflict resolution to prevent "Failed to determine navigation direction for scroll" errors
  • Add safe layout updates during scrolling animations
  • Use more conservative scroll settings on iPad to improve compatibility
• Add iPad Safe Mode example in demo app for recommended PDF configurations on iPad

• Add Android 16KB page size support #321 @opsenes
• Update Android PDF viewer library to io.github.oothp:android-pdf-viewer:3.2.0-beta05
• Upgrade Android Gradle Plugin to 8.11.1
• Upgrade Gradle wrapper to 8.14.3
• Enable AndroidX support

• Fixed memory leak on iOS #315 @flbaue

• Revert .toARGB32() to depricated .value

• Add support for Swift Package Manager

• Add error handling on background color in iOS

• Add support for background color 278 @bobbybun

• hotfix: Crash on iOS 18

• build.gradle namespace #253 @DrBu7cher

• Upgrade compileSdkVersion to 33
• Upgrade sdk

• Upgrade android-pdf-viewer to beta.3

• Deprecate fitEachPage

• Add documentation on properties

• Downgrade android-pdf-viewer from beta.3 to beta.2
• Upgrade Gradle to 7.3.0

• Fixed defaultPage not working on iOS #227 @wmatusiak

• Fixed invalid frame of PDFView on IOS #201 @wmatusiak

• Change dependency for AndroidPdfViewer #202 @oorfalimak

• Fixed the Initial Zoom bug in IOS #192 @moazelsawaf

• Updated onDoubleTap on ios #174 @The-Redhat

• Updated dependencies to be newest with latest flutter version.
• Update minimal version of flutter to 2.2.0
• Updated compileSdkVersion in Android gradle to 30 because in future new apps on Google Play will have to set at least compile version to 30
• Updated README #148 @PcolBP

• Migration Android V2 Embedding & jCenter to mavenCentral #147 @PcolBP

• Migrate to nullsafety, add compatible to Flutter 2.0 #130 @stijnie2210

• Add support for reading PDF from byte data #122 @tvh, @deakjahn

• Add default proguard-rules.
• Closes #87

• #81 add support for handle url navigation on flutter.

• Remove print statement #95 @krispypen
• Close #94 @macitkaraca

• Enable annotation on android #103 @soul

• iOS proper scaling for PDF with pages on landscape-orientation #104 @andresath

• Upgrade Android SDK version to 29 #114 @miguelslemos

• Fixed setPage return value from int to bool on iOS #118 @daisuke310vvv

• Fixed setPage return value from int to bool on iOS #120 @daisuke310vvv

• Format lib/flutter_pdfview.dart

• pod_target_xcconfig suggested by @zhenpeng0hou

• Close #67

• Close #20
• Add support tap on link inside the pdf

• Close #72
• Fix internal page links

• #78 fix unlimited zoom out in iOS. @daanporon

• Add support on FitPolicy on android

• Initial Release
• Works better

• Update pub description

• Set correct scale in iOS

• Support enableSwipe in iOS

• Add controller functions description in document