flu-cli-core 1.0.5 → 1.1.1

package/templates/helper_examples/image_picker_example_page.dart.template

@@ -0,0 +1,289 @@
+import 'package:flutter/material.dart';
+
+import 'package:{{projectName}}/helpers/image_picker/index.dart';
+
+/// 图片选择示例页。
+///
+/// 示例页只控制首页入口和交互演示；图片选择能力本体位于 lib/helpers/image_picker。
+class ImagePickerExamplePage extends StatefulWidget {
+  const ImagePickerExamplePage({super.key});
+
+  @override
+  State<ImagePickerExamplePage> createState() => _ImagePickerExamplePageState();
+}
+
+class _ImagePickerExamplePageState extends State<ImagePickerExamplePage> {
+  final _helper = ImagePickerHelper();
+  PickedImageAsset? _selectedAsset;
+  ImagePickerSource? _lastSource;
+  bool _isPicking = false;
+  String? _lastFeedback;
+
+  Future<void> _pick(ImagePickerSource source) async {
+    setState(() {
+      _isPicking = true;
+      _lastSource = source;
+    });
+
+    try {
+      final assets = await _helper.pick(
+        ImagePickerRequest(
+          source: source,
+          compressQuality: 90,
+        ),
+      );
+      if (!mounted) return;
+      setState(() {
+        _isPicking = false;
+        _selectedAsset = assets.isEmpty ? null : assets.first;
+        _lastFeedback = assets.isEmpty
+            ? '本次没有选中图片。'
+            : '已从${source == ImagePickerSource.gallery ? '相册' : '相机'}获取图片，可继续扩展裁剪、上传或表单回填。';
+      });
+    } catch (error) {
+      if (!mounted) return;
+      setState(() {
+        _isPicking = false;
+        _lastFeedback = '图片选择失败，请检查平台权限、模拟器照片库或插件状态。';
+      });
+    }
+  }
+
+  String _formatBytes(int? bytes) {
+    if (bytes == null || bytes <= 0) return '未知大小';
+    if (bytes < 1024) return '$bytes B';
+    if (bytes < 1024 * 1024) return '${(bytes / 1024).toStringAsFixed(1)} KB';
+    return '${(bytes / (1024 * 1024)).toStringAsFixed(1)} MB';
+  }
+
+  Widget _buildActionItem({
+    required IconData icon,
+    required String title,
+    required String subtitle,
+    required String buttonLabel,
+    required VoidCallback onPressed,
+    bool outlined = false,
+  }) {
+    final button = outlined
+        ? OutlinedButton.icon(
+            onPressed: _isPicking ? null : onPressed,
+            icon: Icon(icon),
+            label: Text(buttonLabel),
+          )
+        : FilledButton.icon(
+            onPressed: _isPicking ? null : onPressed,
+            icon: Icon(icon),
+            label: Text(buttonLabel),
+          );
+
+    return Container(
+      margin: const EdgeInsets.only(bottom: 14),
+      padding: const EdgeInsets.all(16),
+      decoration: BoxDecoration(
+        color: Colors.white,
+        borderRadius: BorderRadius.circular(18),
+        border: Border.all(color: const Color(0xFFE5E7EB)),
+        boxShadow: const [
+          BoxShadow(
+            color: Color(0x080F172A),
+            blurRadius: 16,
+            offset: Offset(0, 8),
+          ),
+        ],
+      ),
+      child: Row(
+        children: [
+          Container(
+            width: 44,
+            height: 44,
+            decoration: BoxDecoration(
+              color: const Color(0xFF3B82F6).withOpacity(0.12),
+              borderRadius: BorderRadius.circular(14),
+            ),
+            child: Icon(icon, color: const Color(0xFF2563EB)),
+          ),
+          const SizedBox(width: 14),
+          Expanded(
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text(
+                  title,
+                  style: const TextStyle(fontSize: 16, fontWeight: FontWeight.w700),
+                ),
+                const SizedBox(height: 4),
+                Text(
+                  subtitle,
+                  style: const TextStyle(
+                    fontSize: 13,
+                    height: 1.45,
+                    color: Color(0xFF475569),
+                  ),
+                ),
+              ],
+            ),
+          ),
+          const SizedBox(width: 12),
+          button,
+        ],
+      ),
+    );
+  }
+
+  Widget _buildPreviewCard() {
+    final asset = _selectedAsset;
+    if (asset == null) {
+      return Container(
+        padding: const EdgeInsets.all(22),
+        decoration: BoxDecoration(
+          color: const Color(0xFFF8FAFC),
+          borderRadius: BorderRadius.circular(20),
+        ),
+        child: const Column(
+          children: [
+            Icon(Icons.image_outlined, size: 40, color: Color(0xFF94A3B8)),
+            SizedBox(height: 10),
+            Text(
+              '尚未选择图片',
+              style: TextStyle(fontSize: 16, fontWeight: FontWeight.w700),
+            ),
+            SizedBox(height: 6),
+            Text(
+              '从相册选择或拍照后，这里会直接展示预览和结果信息。',
+              textAlign: TextAlign.center,
+              style: TextStyle(fontSize: 13, height: 1.5, color: Color(0xFF64748B)),
+            ),
+          ],
+        ),
+      );
+    }
+
+    return Container(
+      padding: const EdgeInsets.all(16),
+      decoration: BoxDecoration(
+        color: Colors.white,
+        borderRadius: BorderRadius.circular(20),
+        border: Border.all(color: const Color(0xFFE5E7EB)),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          if (asset.bytes != null)
+            ClipRRect(
+              borderRadius: BorderRadius.circular(16),
+              child: Image.memory(
+                asset.bytes!,
+                height: 220,
+                width: double.infinity,
+                fit: BoxFit.cover,
+              ),
+            )
+          else
+            Container(
+              height: 180,
+              decoration: BoxDecoration(
+                color: const Color(0xFFF8FAFC),
+                borderRadius: BorderRadius.circular(16),
+              ),
+              alignment: Alignment.center,
+              child: const Icon(Icons.broken_image_outlined, size: 42, color: Color(0xFF94A3B8)),
+            ),
+          const SizedBox(height: 14),
+          Row(
+            children: [
+              const Expanded(
+                child: Text(
+                  '当前已选择图片',
+                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.w700),
+                ),
+              ),
+              Container(
+                padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 6),
+                decoration: BoxDecoration(
+                  color: const Color(0xFFDBEAFE),
+                  borderRadius: BorderRadius.circular(999),
+                ),
+                child: Text(
+                  _lastSource == ImagePickerSource.camera ? '拍照结果' : '相册结果',
+                  style: const TextStyle(
+                    fontSize: 12,
+                    fontWeight: FontWeight.w700,
+                    color: Color(0xFF1D4ED8),
+                  ),
+                ),
+              ),
+            ],
+          ),
+          const SizedBox(height: 10),
+          Text(
+            asset.name ?? '未命名图片',
+            style: const TextStyle(fontSize: 14, fontWeight: FontWeight.w600),
+          ),
+          const SizedBox(height: 6),
+          Text(
+            '大小：${_formatBytes(asset.size)}',
+            style: const TextStyle(fontSize: 13, color: Color(0xFF475569)),
+          ),
+        ],
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('图片选择示例')),
+      body: ListView(
+        padding: const EdgeInsets.all(20),
+        children: [
+          Container(
+            padding: const EdgeInsets.all(18),
+            decoration: BoxDecoration(
+              color: const Color(0xFFF8FAFC),
+              borderRadius: BorderRadius.circular(20),
+            ),
+            child: const Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text(
+                  '图片选择最小闭环',
+                  style: TextStyle(fontSize: 22, fontWeight: FontWeight.w800),
+                ),
+                SizedBox(height: 10),
+                Text(
+                  '示例会直接展示选中的图片预览、来源和大小，业务项目可在 helper 基础上继续扩展裁剪、多选、上传和表单绑定。',
+                  style: TextStyle(fontSize: 14, height: 1.55, color: Color(0xFF475569)),
+                ),
+              ],
+            ),
+          ),
+          const SizedBox(height: 20),
+          _buildActionItem(
+            icon: Icons.photo_library_outlined,
+            title: '从相册选择',
+            subtitle: '适合头像、封面或资料图片上传前的选择场景。',
+            buttonLabel: _isPicking && _lastSource == ImagePickerSource.gallery ? '选择中...' : '选择',
+            onPressed: () => _pick(ImagePickerSource.gallery),
+          ),
+          _buildActionItem(
+            icon: Icons.photo_camera_outlined,
+            title: '拍照',
+            subtitle: '适合即时拍摄票据、实物或扫码拍照等场景。',
+            buttonLabel: _isPicking && _lastSource == ImagePickerSource.camera ? '拍摄中...' : '拍照',
+            onPressed: () => _pick(ImagePickerSource.camera),
+            outlined: true,
+          ),
+          const SizedBox(height: 6),
+          _buildPreviewCard(),
+          if (_lastFeedback != null) ...[
+            const SizedBox(height: 14),
+            Text(
+              _lastFeedback!,
+              style: const TextStyle(fontSize: 13, height: 1.5, color: Color(0xFF475569)),
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+}

package/templates/helper_examples/index.dart.template

@@ -0,0 +1,4 @@
+export 'image_picker_example_page.dart';
+export 'payment_shell_example_page.dart';
+export 'permission_example_page.dart';
+export 'webview_example_page.dart';

package/templates/helper_examples/payment_shell_example_page.dart.template

@@ -0,0 +1,67 @@
+import 'package:flutter/material.dart';
+
+import 'package:{{projectName}}/helpers/payment/index.dart';
+
+/// 支付协议壳示例页。
+///
+/// Payment 是明确例外：这里只展示统一协议与模拟 executor，不内置真实支付 SDK。
+class PaymentShellExamplePage extends StatefulWidget {
+  const PaymentShellExamplePage({super.key});
+
+  @override
+  State<PaymentShellExamplePage> createState() => _PaymentShellExamplePageState();
+}
+
+class _PaymentShellExamplePageState extends State<PaymentShellExamplePage> {
+  PaymentResult? _result;
+
+  Future<void> _simulatePayment() async {
+    final helper = PaymentHelper(
+      executor: (request) async {
+        return PaymentResult(
+          status: PaymentStatus.cancelled,
+          message: '当前只是协议壳示例，请接入真实支付 SDK 后替换 executor。',
+          raw: request.payload,
+        );
+      },
+    );
+    final result = await helper.pay(
+      const PaymentRequest(
+        channel: PaymentChannel.custom,
+        orderId: 'demo_order_001',
+        payload: <String, Object?>{'amount': 1},
+      ),
+    );
+    if (!mounted) return;
+    setState(() => _result = result);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('支付协议壳示例')),
+      body: ListView(
+        padding: const EdgeInsets.all(20),
+        children: [
+          const Text(
+            'Payment 只生成统一协议壳。',
+            style: TextStyle(fontSize: 18, fontWeight: FontWeight.w700),
+          ),
+          const SizedBox(height: 12),
+          const Text('真实支付 SDK、渠道签名和订单校验需要由业务项目按渠道接入。'),
+          const SizedBox(height: 20),
+          FilledButton.icon(
+            onPressed: _simulatePayment,
+            icon: const Icon(Icons.payments_outlined),
+            label: const Text('运行协议壳示例'),
+          ),
+          if (_result != null) ...[
+            const SizedBox(height: 16),
+            Text('模拟结果：${_result!.status.name}'),
+            if (_result!.message != null) Text(_result!.message!),
+          ],
+        ],
+      ),
+    );
+  }
+}