Release 5.4.1

Author: mutumbakato

CHANGELOG.md

@@ -1,3 +1,8 @@
+## 5.4.1 - 22 Feb 2026
+
+- Updates to Nutrient iOS SDK 26.5.0. (#50888)
+- Fixes an iOS issue where the `AdapterBridge` couldn't retrieve the `PSPDFViewController` via FFI when using `NutrientView` with a platform adapter. (#50888)
+
 ## 5.4.0 - 18 Feb 2026
 
 - [**Beta**] Adds federated plugin architecture with platform-specific packages (`nutrient_flutter_platform_interface`, `nutrient_flutter_android`, `nutrient_flutter_ios`, `nutrient_flutter_web`) for native SDK bindings via JNI (Android), FFI (iOS), and `dart:js_interop` (Web). Refer to the [platform adapters](/guides/flutter/platform-adapters/) guide for details. (J#HYB-895)

android/src/main/java/com/pspdfkit/flutter/pspdfkit/util/DynamicColorResourcesHelper.kt

@@ -187,6 +187,7 @@ object DynamicColorResourcesHelper {
 
             val loader = ResourcesLoader()
             loader.addProvider(ResourcesProvider.loadFromTable(pfd, null))
+            pfd.close()
             return loader
         } catch (e: Exception) {
             Log.e(TAG, "Failed to create color ResourcesLoader", e)

example/ios/Runner.xcodeproj/project.pbxproj

@@ -191,7 +191,7 @@
 			);
 			mainGroup = 97C146E51CF9000F007C117D;
 			packageReferences = (
-				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */,
+				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */,
 			);
 			productRefGroup = 97C146EF1CF9000F007C117D /* Products */;
 			projectDirPath = "";
@@ -533,7 +533,7 @@
 /* End XCConfigurationList section */
 
 /* Begin XCLocalSwiftPackageReference section */
-		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */ = {
+		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */ = {
 			isa = XCLocalSwiftPackageReference;
 			relativePath = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage;
 		};

example/pubspec.yaml

@@ -1,6 +1,6 @@
 name: nutrient_example
 description: Demonstrates how to use the Nutrient Flutter plugin.
-version: 5.4.0
+version: 5.4.1
 homepage: https://nutrient.io/
 publish_to: 'none'  # Remove this line if you wish to publish to pub.dev
 environment:

ios/Classes/PspdfPlatformView.m

@@ -51,17 +51,27 @@ @interface PspdfPlatformView() <PSPDFViewControllerDelegate>
 @property (nonatomic, strong) UIColor *themeSeparatorColor;
 @end
 
-/// Parses a hex color string (e.g. "#FF0000" or "FF0000") into a UIColor.
+/// Parses a hex color string into a UIColor.
+/// Supports 6-character RGB ("#FF0000") and 8-character ARGB ("#80FF0000") formats.
 static UIColor *PSPDFColorFromHexString(NSString *hexString) {
     NSString *hex = [hexString stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
     if ([hex hasPrefix:@"#"]) {
         hex = [hex substringFromIndex:1];
     }
-    unsigned int rgb = 0;
-    [[NSScanner scannerWithString:hex] scanHexInt:&rgb];
-    CGFloat r = ((rgb & 0xFF0000) >> 16) / 255.0;
-    CGFloat g = ((rgb & 0x00FF00) >> 8) / 255.0;
-    CGFloat b = (rgb & 0x0000FF) / 255.0;
+    unsigned int hexValue = 0;
+    [[NSScanner scannerWithString:hex] scanHexInt:&hexValue];
+    if (hex.length == 8) {
+        // ARGB format: #AARRGGBB
+        CGFloat a = ((hexValue >> 24) & 0xFF) / 255.0;
+        CGFloat r = ((hexValue >> 16) & 0xFF) / 255.0;
+        CGFloat g = ((hexValue >> 8) & 0xFF) / 255.0;
+        CGFloat b = (hexValue & 0xFF) / 255.0;
+        return [UIColor colorWithRed:r green:g blue:b alpha:a];
+    }
+    // 6-character RGB format: #RRGGBB
+    CGFloat r = ((hexValue >> 16) & 0xFF) / 255.0;
+    CGFloat g = ((hexValue >> 8) & 0xFF) / 255.0;
+    CGFloat b = (hexValue & 0xFF) / 255.0;
     return [UIColor colorWithRed:r green:g blue:b alpha:1.0];
 }
 
@@ -380,6 +390,9 @@ - (instancetype)initWithFrame:(CGRect)frame viewIdentifier:(int64_t)viewId argum
 
         [_platformViewImpl setViewControllerWithController:_pdfViewController];
 
+        // Apply stored theme colors to PSPDFKit UI components
+        [self applyStoredThemeColors];
+
         [_channel setMethodCallHandler:^(FlutterMethodCall * _Nonnull call, FlutterResult  _Nonnull result) {
             [weakSelf handleMethodCall:call result:result];
         }];
@@ -479,6 +492,46 @@ - (void)cleanup {
     [self.navigationController removeFromParentViewController];
 }
 
+- (void)applyStoredThemeColors {
+    // Annotation toolbar colors
+    if (_themeSubToolbarBackgroundColor || _themeSubToolbarIconColor ||
+        _themeSubToolbarActiveIconColor || _themeSubToolbarActiveToolBackgroundColor) {
+        PSPDFAnnotationToolbar *annotationToolbar = _pdfViewController.annotationToolbarController.annotationToolbar;
+        if (annotationToolbar) {
+            if (_themeSubToolbarBackgroundColor) {
+                annotationToolbar.barTintColor = _themeSubToolbarBackgroundColor;
+            }
+            if (_themeSubToolbarIconColor) {
+                annotationToolbar.tintColor = _themeSubToolbarIconColor;
+            }
+            if (_themeSubToolbarActiveIconColor) {
+                annotationToolbar.selectedTintColor = _themeSubToolbarActiveIconColor;
+            }
+            if (_themeSubToolbarActiveToolBackgroundColor) {
+                annotationToolbar.selectedBackgroundColor = _themeSubToolbarActiveToolBackgroundColor;
+            }
+        }
+    }
+
+    // Search highlight color via UIAppearance
+    if (_themeSearchHighlightColor) {
+        [PSPDFSearchHighlightView appearance].selectionBackgroundColor = _themeSearchHighlightColor;
+    }
+
+    // Text selection highlight color
+    if (_themeSelectionTextHighlightColor) {
+        [PSPDFPageView appearance].highlightColor = _themeSelectionTextHighlightColor;
+    }
+
+    // Separator color
+    if (_themeSeparatorColor) {
+        _navigationController.navigationBar.standardAppearance.shadowColor = _themeSeparatorColor;
+        if (@available(iOS 15.0, *)) {
+            _navigationController.navigationBar.scrollEdgeAppearance.shadowColor = _themeSeparatorColor;
+        }
+    }
+}
+
 - (void)handleMethodCall:(FlutterMethodCall*)call result:(FlutterResult)result {
     [PspdfkitFlutterHelper processMethodCall:call result:result forViewController:self.pdfViewController];
 }

ios/nutrient_flutter.podspec

@@ -5,7 +5,7 @@
 #
 Pod::Spec.new do |s|
   s.name                  = "nutrient_flutter"
-  s.version               = "5.4.0"
+  s.version               = "5.4.1"
   s.homepage              = "https://nutrient.io"
   s.documentation_url     = "https://nutrient.io/guides/flutter"
   s.license               = { type: "Commercial", file: "../LICENSE" }
@@ -18,10 +18,10 @@ Pod::Spec.new do |s|
   s.source_files          = "Classes/**/*.{h,m,swift}"
   s.public_header_files   = "Classes/**/*.h"
   s.dependency("Flutter")
-  s.dependency("PSPDFKit", "26.3.0")
-  s.dependency("Instant", "26.3.0")
+  s.dependency("PSPDFKit", "26.5.0")
+  s.dependency("Instant", "26.5.0")
   s.swift_version         = "5.0"
   s.platform              = :ios, "16.0"
-  s.weak_frameworks       = ['PencilKit']
+  s.weak_frameworks       = ["PencilKit"]
   s.pod_target_xcconfig = { "DEFINES_MODULE" => "YES", "SWIFT_INSTALL_OBJC_HEADER" => "NO" }
 end

lib/src/widgets/adapter_bridge_native.dart

@@ -266,18 +266,11 @@ class AdapterBridge {
   /// Returns null if the view controller is not registered or FFI fails.
   PSPDFViewController? _getPSPDFViewControllerFromNative() {
     try {
-      // Load the iOS bindings to access the nutrient_get_view_controller function.
+      // Call the FFI function to get the view controller pointer.
       // This function is defined in nutrient_flutter's PspdfPlatformView.m
       // and declared in nutrient_flutter_ios's NutrientFFI.h header.
-      final iosBindings = ios_bindings.NutrientIOSBindings(
-        ffi.DynamicLibrary.process(),
-      );
-
-      // Call the FFI function to get the view controller pointer.
-      // Note: This requires the iOS FFI bindings to be regenerated after
-      // the nutrient_get_view_controller function was added to NutrientFFI.h.
       final viewControllerPointer =
-          iosBindings.nutrient_get_view_controller(_viewId);
+          ios_bindings.nutrient_get_view_controller(_viewId);
 
       if (viewControllerPointer == ffi.nullptr) {
         debugPrint(

pubspec.yaml

@@ -1,6 +1,6 @@
 name: nutrient_flutter
 description: A Flutter plugin providing a feature-rich PDF viewing and editing experience to your users with the powerful Nutrient PDF SDK.
-version: 5.4.0
+version: 5.4.1
 homepage: https://nutrient.io/
 repository: https://github.com/PSPDFKit/pspdfkit-flutter
 issue_tracker: https://support.nutrient.io/hc/en-us/requests/new
@@ -19,7 +19,7 @@ dependencies:
   # Platform interface and adapters for native SDK access
   nutrient_flutter_platform_interface: ^1.0.0
   nutrient_flutter_android: ^1.0.0
-  nutrient_flutter_ios: ^1.0.0
+  nutrient_flutter_ios: ^1.0.1
   nutrient_flutter_web: ^1.0.0
 
 
@@ -44,7 +44,5 @@ dev_dependencies:
   build_runner: ^2.2.1
   mockito: ^5.3.1
 
-
-# Ignore false positives for security scanning
 false_secrets:
   - example/lib/utils/jwt_util.dart

pubspec.yaml.overrides.backup

@@ -1,4 +1,3 @@
-# For local development until packages are published to pub.dev
 dependency_overrides:
   nutrient_flutter_platform_interface:
     path: ../nutrient_flutter_platform_interface
@@ -8,3 +7,6 @@ dependency_overrides:
     path: ../nutrient_flutter_ios
   nutrient_flutter_web:
     path: ../nutrient_flutter_web
+
+
+# Ignore false positives for security scanning