♻️ Break ForegroundBuilder (#100)

Author: AlexV525

CHANGELOG.md

@@ -4,13 +4,16 @@ that can be found in the LICENSE file. -->
 
 # Changelog
 
-## 3.2.1
+## 3.3.0
 
-### Improvements
+### Breaking Changes
 
 - Allow the foreground builder to be used all the time (#97) .
   The signature of the `ForegroundBuilder` has changed
   but can be easily migrated.
+
+### Improvements
+
 - Allow text delegates to be obtained by `Locale`. (#99)
 
 ## 3.2.0+1

example/pubspec.yaml

@@ -1,6 +1,6 @@
 name: wechat_camera_picker_demo
 description: A new Flutter project.
-version: 3.2.1+11
+version: 3.3.0+11
 publish_to: none
 
 environment:

lib/src/constants/type_defs.dart

@@ -44,12 +44,12 @@ typedef CameraErrorHandler = void Function(
 /// Build the foreground/overlay widget with the given [CameraValue].
 /// 根据给定的 [CameraValue] 构建自定义的前景 widget
 ///
-/// The `cameraValue` will be null until the [CameraController] initialized.
-/// 在 [CameraController] 完成初始化前，`cameraValue` 将为空。
+/// The `controller` will be null until initialized.
+/// 在 [CameraController] 完成初始化前，`controller` 将为空。
 /// {@endtemplate}
 typedef ForegroundBuilder = Widget Function(
   BuildContext context,
-  CameraValue? cameraValue,
+  CameraController? controller,
 );
 
 /// {@template wechat_camera_picker.PreviewTransformBuilder}

lib/src/widgets/camera_picker.dart

@@ -18,7 +18,6 @@ import '../constants/config.dart';
 import '../constants/constants.dart';
 import '../constants/enums.dart';
 import '../constants/styles.dart';
-import '../constants/type_defs.dart';
 import '../delegates/camera_picker_text_delegate.dart';
 import '../internals/extensions.dart';
 import '../internals/methods.dart';
@@ -1388,17 +1387,6 @@ class CameraPickerState extends State<CameraPicker>
     );
   }
 
-  Widget _foregroundBuilder(BuildContext context) {
-    final ForegroundBuilder builder = config.foregroundBuilder!;
-    if (_controller == null) {
-      return builder(context, null);
-    }
-    return ValueListenableBuilder<CameraValue>(
-      valueListenable: _controller!,
-      builder: (BuildContext c, CameraValue v, __) => builder(c, v),
-    );
-  }
-
   @override
   Widget build(BuildContext context) {
     return AnnotatedRegion<SystemUiOverlayStyle>(
@@ -1430,7 +1418,9 @@ class CameraPickerState extends State<CameraPicker>
                   ),
                   _contentBuilder(constraints),
                   if (config.foregroundBuilder != null)
-                    Positioned.fill(child: _foregroundBuilder(context)),
+                    Positioned.fill(
+                      child: config.foregroundBuilder!(context, _controller),
+                    ),
                 ],
               ),
             ),

pubspec.yaml

@@ -1,6 +1,6 @@
 name: wechat_camera_picker
 description: A camera picker which is an extension to wechat_assets_picker, but can be run separately.
-version: 3.2.1
+version: 3.3.0
 homepage: https://github.com/fluttercandies/flutter_wechat_camera_picker
 
 environment: