搜索插件、代码仓与 APP 分类

qr_code_scanner_plus 封面
插件详情v2.4.1

qr_code_scanner_plus

可嵌入 Flutter 的二维码扫描器。Android 使用 zxing,iOS 使用 AVFoundation。

AndroidiOSWeb
近 30 天下载
9.9万
喜欢数
131
Pub 分数
160

安装插件

flutter pub add qr_code_scanner_plus

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个用于在应用程序中嵌入二维码扫描功能的 Flutter 包,利用原生库:Android 上的 zxing 和 iOS 上的 AVFoundation。它支持跨 Android、iOS 和 Web 平台的实时扫描,并实现流畅集成。专为寻求可靠、高性能二维码扫描且无需复杂设置的开发者设计。该包由 vespr.xyz 维护,并可通过 pub.dev 获取。

适合场景

  • 应用内二维码扫描支付
  • 通过二维码进行用户身份验证
  • 产品信息检索
  • 活动门票验证
  • 设备间的数据共享
  • 库存管理

主要特点

  • 原生性能,适用于 Android 和 iOS
  • 跨平台支持(Android、iOS、Web)
  • 与 Flutter 小部件的简单集成
  • 实时扫描功能
  • 轻便高效
  • 开源且公开仓库

适合对象

  • 移动应用开发者
  • 支付和金融科技应用
  • 活动和票务平台
  • 零售和库存系统
  • 需要安全数据交换的应用程序

使用建议

  • Web 支持可能具有有限的摄像头访问权限
  • 需要移动设备上的相机权限
  • 性能取决于设备硬件
  • 可能需要额外的配置才能进行网络部署
  • 扫描界面的自定义选项有限

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

pub package

⚠️ If you are starting a new project, or your project requires new features or long-term stability, use an actively maintained alternative such as mobile_scanner.


⚠️ Maintenance-only fork (no new features)

This package is a maintenance-only fork of the original qr_code_scanner package.

Its sole purpose is to keep existing projects compiling and running on newer versions of Flutter, the Android Gradle Plugin, and related tooling after the upstream package became unmaintained. It exists to allow existing users to postpone migration, not to provide an actively developed QR scanning solution.

New feature PRs will be rejected.
This includes (but is not limited to):

  • New functionality
  • Feature extensions
  • API changes or expansions
  • Behavior changes beyond minimal fixes required for compatibility

If you need additional functionality, this package is not the right choice.


Scope and limitations

  • I maintain only the Flutter-facing code in this repository.
  • The underlying native scanning is handled by:
    • Android: zxing
    • iOS: Native AVFoundation (Swift Package Manager and CocoaPods supported)

The original qr_code_scanner package used MTBBarcodeScanner on iOS, which has been archived and unmaintained since 2021. This fork replaced it with a native AVFoundation implementation to enable Swift Package Manager support and remove the only third-party iOS dependency.

The Android native library (zxing) is outdated and unmaintained. There are known issues and limitations in that native package that will not be fixed here.

As a result:

  • Native-level bugs should be expected.
  • This package is not a good foundation for adding or extending features.
  • Only minimal fixes required to keep the package usable on current Flutter toolchains will be considered.

Projects that require new functionality, reliability, or long-term maintenance of both Flutter and native code should migrate to a fully maintained alternative such as mobile_scanner.


QR Code Scanner Plus

A QR code scanner for iOS, Android, and Web that embeds platform views in Flutter.

This description is retained for historical context only and does not imply ongoing feature development.


Screenshots

Android

iOS

Get Scanned QR Code

When a QR code is recognized, the text identified will be set in 'result' of type Barcode, which contains the output text as property 'code' of type String and scanned code type as property 'format' which is an enum BarcodeFormat, defined in the library.

class _QRViewExampleState extends State<QRViewExample> {
  final GlobalKey qrKey = GlobalKey(debugLabel: 'QR');
  Barcode? result;
  QRViewController? controller;

  // In order to get hot reload to work we need to pause the camera if the platform
  // is android, or resume the camera if the platform is iOS.
  @override
  void reassemble() {
    super.reassemble();
    if (Platform.isAndroid) {
      controller!.pauseCamera();
    } else if (Platform.isIOS) {
      controller!.resumeCamera();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: <Widget>[
          Expanded(
            flex: 5,
            child: QRView(
              key: qrKey,
              onQRViewCreated: _onQRViewCreated,
            ),
          ),
          Expanded(
            flex: 1,
            child: Center(
              child: (result != null)
                  ? Text(
                      'Barcode Type: ${describeEnum(result!.format)}   Data: ${result!.code}')
                  : Text('Scan a code'),
            ),
          )
        ],
      ),
    );
  }

  void _onQRViewCreated(QRViewController controller) {
    this.controller = controller;
    controller.scannedDataStream.listen((scanData) {
      setState(() {
        result = scanData;
      });
    });
  }
}

Android Integration

In order to use this plugin, please make sure to add the Camera permissions in android/app/src/main/AndroidManifest.xml

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

iOS Integration

In order to use this plugin, add the following to your Info.plist file:

<key>NSCameraUsageDescription</key>
<string>This app needs camera access to scan QR codes</string>
UIScene lifecycle

The iOS plugin supports both the UIScene lifecycle and the legacy application lifecycle. No plugin-specific SceneDelegate or camera lifecycle changes are required.

The host app must still adopt UIScene; updating this package alone does not migrate your app. Follow Flutter's UIScene migration guide to configure UIApplicationSceneManifest in Info.plist and register plugins in didInitializeImplicitFlutterEngine using engineBridge.pluginRegistry. The example AppDelegate and example Info.plist already use this setup.

Web Integration

Add this to web/index.html:

<script src="https://cdn.jsdelivr.net/npm/jsqr@1.3.1/dist/jsQR.min.js"></script>

Please note: on web, only QR codes are supported. Other barcodes and 2D codes cannot be scanned.

Web support is in very early stage. Features such as flash, pause or resume are not implemented. Moreover, the camera preview does not respect the surrounding constraints. This is not at last due to Flutter's early state of platform views on web.

Flip Camera (Back/Front)

The default camera is the back camera.

await controller.flipCamera();

Flash (Off/On)

By default, flash is OFF.

await controller.toggleFlash();

Resume/Pause

Pause camera stream and scanner.

await controller.pauseCamera();

Resume camera stream and scanner.

await controller.resumeCamera();

Credits

  • Android: https://github.com/zxing/zxing
  • Original qr_code_scanner contributors

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目