Flutter功能未定义插件another_brother的使用

Flutter功能未定义插件another_brother的使用

another_brother 简介

another_brother 是一个用于 Flutter 的 Brother SDK 库，支持通过蓝牙、Wi-Fi 和 USB 与 Brother 打印机进行通信。它提供了对 Android 和 iOS 平台的支持，并且可以用于开发需要与 Brother 打印机交互的应用程序。

支持平台

• Android 支持：
  • Bluetooth/BLE
  • Wi-Fi
  • USB
• iOS 支持：
  • Bluetooth/BLE
  • Wi-Fi

Android 最低 SDK 版本

• 需要 minSdkVersion 19

iOS Info.plist 配置

为了使 another_brother 在 iOS 上正常工作，你需要在 Info.plist 文件中添加以下配置：

<!-- Another Brother Section -->
<key>NSLocalNetworkUsageDescription</key>
<string>查找本地 TCP Bonjour 服务</string>
<key>NSBonjourServices</key>
<array>
    <string>_ipp._tcp</string>
    <string>_printer._tcp</string>
    <string>_pdl-datastream._tcp</string>
</array>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>remote-notifications</string>
</array>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要 BLE 权限</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>需要 BLE 权限</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要位置权限</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>需要位置权限</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要位置权限</string>
<key>UISupportedExternalAccessoryProtocols</key>
<array>
    <string>com.brother.ptcbp</string>
    <!-- 仅在与 TypeB 打印机配合使用时需要。重要：如果计划发布到 Apple App Store，请勿使用此配置，否则会导致应用被拒 -->
    <string>com.issc.datapath</string>
</array>
<!-- End Another Brother Section -->

iOS 设置注意事项

• 在 Xcode 中，确保将 Allow non-modular includes 设置为 yes。
• 将 libBROTHERSDK.a 标记为属于 another_brother。

提交到 Apple App Store

当你提交应用程序到 Apple App Store 时，需要从 Brother 获取 PPID（Product Part ID）。你可以通过访问 Brother 的官方网站申请 PPID。如果没有 PPID，你的应用程序可能会收到类似以下的拒绝消息：

应用程序未获得配件制造商的授权，无法与 MFi 配件一起使用

使用示例代码

以下是一个完整的示例应用程序，展示了如何使用 another_brother 插件与 Brother 打印机进行交互。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Brother Printer Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: PrinterPage(),
    );
  }
}

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

class _PrinterPageState extends State<PrinterPage> {
  List<BTPrinter> _printers = [];
  String _status = "未连接";

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

  Future<void> _searchPrinters() async {
    try {
      // 搜索附近的 Brother 打印机
      final printers = await BTPrinter.searchPrinters();
      setState(() {
        _printers = printers;
      });
    } catch (e) {
      print("搜索打印机时出错: $e");
    }
  }

  Future<void> _connectToPrinter(BTPrinter printer) async {
    try {
      // 连接到选定的打印机
      await printer.connect();
      setState(() {
        _status = "已连接";
      });

      // 打印测试内容
      await _printTest(printer);

      // 断开连接
      await printer.disconnect();
      setState(() {
        _status = "已断开连接";
      });
    } catch (e) {
      print("连接或打印时出错: $e");
      setState(() {
        _status = "连接失败";
      });
    }
  }

  Future<void> _printTest(BTPrinter printer) async {
    try {
      // 创建打印任务
      final job = PrintJob();
      job.addText("Hello, Brother Printer!");
      job.addFeed(2);
      job.addCut(CutType.full);

      // 发送打印任务
      await printer.print(job);
    } catch (e) {
      print("打印时出错: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Brother Printer Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(
              '状态: $_status',
              style: TextStyle(fontSize: 18),
            ),
            SizedBox(height: 20),
            Text(
              '附近打印机:',
              style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 10),
            Expanded(
              child: ListView.builder(
                itemCount: _printers.length,
                itemBuilder: (context, index) {
                  final printer = _printers[index];
                  return ListTile(
                    title: Text(printer.model ?? "未知型号"),
                    subtitle: Text(printer.macAddress ?? "未知 MAC 地址"),
                    trailing: ElevatedButton(
                      onPressed: () => _connectToPrinter(printer),
                      child: Text('连接并打印'),
                    ),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}