Flutter条码扫描插件zebra_scanner_plugin的使用

zebra_scanner_plugin 是一个用于通过Zebra扫描设备扫描条形码的新Flutter插件。以下是该插件的基本使用指南和示例代码。

开始使用

第一步：添加依赖

首先，运行以下命令来添加 zebra_scanner_plugin 到你的项目中：

flutter pub add zebra_scanner_plugin

这将在你的 pubspec.yaml 文件中添加如下依赖项：

dependencies:
  zebra_scanner_plugin: ^latest_version

然后运行 flutter pub get 来下载库源到你的本地缓存。

第二步：复制BarcodeScannerLibrary

将 example/android/zebra_scanner_plugin/BarcodeScannerLibrary 文件夹从插件示例代码源复制到你将要使用此插件的Android项目模块中。这是必要的步骤，因为 BarcodeScannerLibrary 数据收集Android库是一个 .aar 包，需要作为项目库引用。

第三步：修改 settings.gradle

在你的Android项目的 settings.gradle 文件中添加以下内容：

include ':BarcodeScannerLibrary'

这允许插件定位 barcode_scanner_library.aar 库。

第四步：修改 AndroidManifest.xml

在你的 AndroidManifest.xml 文件中的 <application> 标签内添加 tools:replace="android:label" 属性，这是因为 barcode_scanner_library.aar 库定义了一个 android:label="@string/app_name"，它与你的项目的标签冲突，导致“Manifest merger failed”错误。

示例代码

下面是一个完整的示例应用程序，展示了如何使用 zebra_scanner_plugin 进行条形码扫描：

import 'package:flutter/material.dart';
import 'package:zebra_scanner_plugin/zebra_scanner_plugin.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<Barcode> scannedCodes = [];
  ScrollController listScrollController = ScrollController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Zebra Scanner Plugin example app'),
          actions: [
            PopupMenuButton<int>(
              itemBuilder: (context) => [
                PopupMenuItem(
                  child: const Text("Scan and connect"),
                  onTap: () async {
                    await ZebraScannerPlugin.initScanner;
                    await ZebraScannerPlugin.connect();
                  },
                  value: 1,
                ),
              ],
            )
          ],
        ),
        body: StreamBuilder<Barcode>(
          stream: ZebraScannerPlugin.barcodeStream,
          builder: (context, snapshot) {
            Barcode? data;
            if (snapshot.hasData) {
              data = snapshot.data;
              scannedCodes.add(data!);
              if (listScrollController.hasClients) {
                final position = listScrollController.position.maxScrollExtent;
                listScrollController.jumpTo(position);
              }
            } else if (snapshot.hasError) {
              print(snapshot.error);
            }
            return Padding(
              padding: const EdgeInsets.all(10.0),
              child: ListView.builder(
                controller: listScrollController,
                itemCount: scannedCodes.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text(scannedCodes[index].data),
                    leading: const Icon(Icons.qr_code),
                    trailing: Text(scannedCodes[index].type),
                  );
                },
              ),
            );
          },
        ),
      ),
    );
  }
}