Flutter条码扫描插件lono_scan的使用

欢迎使用lono_scan插件来实现Flutter应用中的条码扫描功能。以下是详细的使用指南。

准备工作

iOS

在Info.plist文件中添加以下配置：

<key>NSCameraUsageDescription</key>
<string>您的描述</string>

<key>io.flutter.embedded_views_preview</key>
<string>YES</string>

Android

在AndroidManifest.xml文件中添加以下配置：

<uses-permission android:name="android.permission.CAMERA" />

<application>
  <meta-data
    android:name="flutterEmbedding"
    android:value="2" />
</application>

在pubspec.yaml文件中添加lono_scan依赖：

dependencies:
  lono_scan: ^最新版本

导入包：

import 'package:lono_scan/lono_scan.dart';

使用方法

在widget中展示扫描视图

你可以通过LonoScanView来展示扫描界面，并自定义扫描区域和其他参数。

LonoScanController controller = LonoScanController();
String qrcode = '';

Container(
  width: 350, // 自定义包裹大小
  height: 350,
  child: LonoScanView(
    controller: controller,
    // 自定义扫描区域，如果设置为1.0，则会扫描整个区域
    scanAreaScale: .8,
    scanLineColor: Colors.green.shade400,
    onCapture: (data) {
      // 执行某些操作
    },
  ),
),

控制相机

你可以使用controller.resume()和controller.pause()方法来控制相机的开启和暂停。

controller.resume();
controller.pause();

从图片路径解析二维码

你可以通过LonoScan.parse方法从图片路径中获取二维码字符串。

String result = await LonoScan.parse(imagePath);

切换手电筒模式

你可以通过controller.toggleTorchMode()方法来切换手电筒模式。

controller.toggleTorchMode();

销毁控制器

使用完后，记得调用controller.dispose()来释放资源。

controller.dispose();

ProGuard规则

为了确保插件正常运行，你可能需要在proguard-rules.pro文件中添加以下规则：

-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.huawei.hianalytics.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}

致谢

lono_scan插件是在scan插件的基础上进行更新的。 原始插件链接：https://pub.dev/packages/scan

许可证

该插件采用MIT许可证。

完整示例代码

下面是完整的示例代码，展示了如何使用lono_scan插件来实现条码扫描功能。

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutter/services.dart';
import 'package:image_picker/image_picker.dart';
import 'package:lono_scan/lono_scan.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  String qrcode = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await LonoScan.platformVersion;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: '/',
      routes: {
        '/': (context) => Scaffold(
          backgroundColor: Colors.white,
          appBar: AppBar(
            backgroundColor: Colors.orange,
            centerTitle: true,
            title: const Text('Lono scan example app'),
          ),
          body: Center(
            child: Padding(
              padding: const EdgeInsets.all(16.0),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.center,
                children: [
                  Text(
                    'Running on: $_platformVersion',
                    style: TextStyle(fontSize: 18, fontWeight: FontWeight.w500),
                  ),
                  const SizedBox(height: 20),
                  Row(
                    children: [
                      _buildActionButton(
                        label: 'Scan from Image',
                        icon: Icons.image,
                        onPressed: () async {
                          ImagePicker picker = ImagePicker();
                          final XFile? res = await picker.pickImage(source: ImageSource.gallery);

                          if (res != null) {
                            String? str = await LonoScan.parse(res.path);
                            if (str != null) {
                              setState(() {
                                qrcode = str;
                              });
                            } else {
                              setState(() {
                                qrcode = 'Null';
                              });
                            }
                          }
                        },
                      ),
                      const SizedBox(width: 16),
                      _buildActionButton(
                        label: 'Scan Page',
                        icon: Icons.qr_code_scanner,
                        onPressed: () {
                          Navigator.push(
                            context,
                            MaterialPageRoute(builder: (context) => LonoScanPage()),
                          );
                        },
                      ),
                    ],
                  ),
                  const SizedBox(height: 30),
                  Container(
                    width: double.infinity,
                    padding: const EdgeInsets.all(12),
                    decoration: BoxDecoration(
                      color: Colors.orange.shade50,
                      borderRadius: BorderRadius.circular(10),
                      border: Border.all(color: Colors.orange.shade300),
                    ),
                    child: Column(
                      children: [
                        Text(
                          'Scan result:',
                          style: TextStyle(fontSize: 16, fontWeight: FontWeight.w500, color: Colors.orange.shade700),
                        ),
                        const SizedBox(height: 8),
                        Text(
                          qrcode.isNotEmpty ? qrcode : 'No result',
                          style: TextStyle(fontSize: 16, color: Colors.black87),
                          textAlign: TextAlign.center,
                        ),
                      ],
                    ),
                  ),
                ],
              ),
            ),
          ),
        ),
      },
    );
  }

  Widget _buildActionButton({
    required String label,
    required IconData icon,
    required VoidCallback onPressed,
  }) {
    return Expanded(
      child: ElevatedButton.icon(
        onPressed: onPressed,
        icon: Icon(
          icon,
          size: 20,
          color: Colors.white,
        ),
        label: Text(label),
        style: ElevatedButton.styleFrom(
          backgroundColor: Colors.orange,
          foregroundColor: Colors.white,
          padding: const EdgeInsets.symmetric(vertical: 16),
          shape: RoundedRectangleBorder(
            borderRadius: BorderRadius.circular(12),
          ),
          elevation: 4,
        ),
      ),
    );
  }
}