Flutter文档扫描插件document_scanner_kit的使用

Flutter文档扫描插件document_scanner_kit的使用

Document Scanner Kit

由Very Good CLI 🤖生成。

插件正在开发中。

这是一个使用MLKit（Android）和VisionKit（iOS）进行文档扫描的Flutter插件。

项目设置

请遵循以下步骤在Android和iOS上设置您的Flutter项目。

Android

要求

• minSdkVersion: 21
• targetSdkVersion: 33
• compileSdkVersion: 34

iOS

最低版本配置

确保您的应用满足在iOS设备上运行的最低版本要求。在ios/Podfile文件中，确保iOS平台版本至少为13.0：

platform :ios, '13.0'

权限配置

在应用的Info.plist文件中添加一个带有键NSCameraUsageDescription的字符串属性，并将值设置为描述您的应用为什么需要相机访问的原因。

<key>NSCameraUsageDescription</key>
<string>相机使用是必需的</string>

使用

import 'package:document_scanner_kit/document_scanner_kit.dart' as DocumentScanner;

// 在iOS上检查权限，Android不需要相机使用权限。

try {
    final result = await DocumentScanner.scan();
    if(result != null) {
        // 对路径进行处理。
    } else {
        // 扫描过程已取消
    }
} catch (e) {
    // 处理错误
}

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用document_scanner_kit插件进行文档扫描。

import 'dart:io';

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

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(home: HomePage());
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  List<String>? _scannedImages;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('DocumentScannerKit 示例')),
      body: Center(
        child: SingleChildScrollView(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            mainAxisSize: MainAxisSize.min,
            children: [
              if (_scannedImages == null)
                const SizedBox.shrink()
              else
                Column(
                  children: [
                    for (final path in _scannedImages!) Image.file(File(path)),
                  ],
                ),
              const SizedBox(height: 16),
              ElevatedButton(
                  onPressed: () async {
                    if (!context.mounted) return;
                    try {
                      final result = await DocumentScanner.scan();
                      setState(() => _scannedImages = result);
                    } catch (error) {
                      if (!context.mounted) return;
                      ScaffoldMessenger.of(context).showSnackBar(
                        SnackBar(
                          backgroundColor: Theme.of(context).primaryColor,
                          content: Text('$error'),
                        ),
                      );
                    }
                  },
                  child: const Text('扫描文档')),
            ],
          ),
        ),
      ),
    );
  }
}