Flutter苹果钱包集成插件apple_passkit的使用

Apple PassKit

这是一个Flutter绑定，用于Apple的PassKit。该库允许你向用户的Wallet添加PkPass文件，并读取用户Wallet中可用的PkPass文件。

如果你需要在代码中处理PkPass文件，可以考虑使用passkit和passkit_ui，它们不依赖于iOS/macOS，且大部分是跨平台的。

什么是PassKit？

Passes 是信息的一种数字表示形式，这些信息可能会打印在小纸片或塑料卡片上。它们让用户可以在物理世界中采取行动。Passes 可以包含图片和条形码，并且你可以通过iOS上的推送通知更新Passes。

一个PkPass文件渲染后看起来像这样：

如何使用？

final passKit = ApplePassKit();
// 首先检查PassKit是否可用
bool isAvailable = await passKit.isPassLibraryAvailable();
// 然后检查是否可以实际添加passes
bool canAddPasses = await passKit.canAddPasses();

// 当这两个条件都为真时，你可以添加一个pass。
if(isAvailable && canAddPasses) {
    await passKit.addPass(pass);
}

要查看所有方法，请参阅API文档。

查看你的应用程序的passes

按照Xcode项目设置文档中的说明进行设置。

之后，使用await ApplePassKit().passes()加载已安装的passes。

Apple Wallet PassKit 文档

• Wallet Human Interface Guidelines
• Wallet Passes
• Loyalty passes
• Wallet Developer Guide

添加passes失败

如果你遇到将pass添加到wallet的问题，可以尝试使用passkit，它可能提供更具体的错误消息供你参考。

示例Demo

以下是一个完整的示例demo，展示了如何使用apple_passkit插件来与Apple Wallet进行交互：

// ignore_for_file: use_build_context_synchronously

import 'package:flutter/material.dart';
import 'package:apple_passkit/apple_passkit.dart';
import 'package:flutter/services.dart';

final _applePasskitPlugin = ApplePassKit();

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: const _Body(),
      ),
    );
  }
}

class _Body extends StatelessWidget {
  const _Body();

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          ElevatedButton(
            onPressed: () async {
              final isAvailable =
                  await _applePasskitPlugin.isPassLibraryAvailable();
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(
                  content: Text('Is library available: $isAvailable'),
                ),
              );
            },
            child: const Text('Is library available?'),
          ),
          ElevatedButton(
            onPressed: () async {
              final canAdd = await _applePasskitPlugin.canAddPasses();
              ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Can add passes: $canAdd')));
            },
            child: const Text('Can add passes?'),
          ),
          ElevatedButton(
            onPressed: () async {
              await _applePasskitPlugin.addPass(await getFlightPass());
            },
            child: const Text('Add pass variant 1'),
          ),
          ElevatedButton(
            onPressed: () async {
              await _applePasskitPlugin
                  .addPassesWithoutUI(await getMultiplePasses());
            },
            child: const Text('Add multiple passes via popup'),
          ),
          ElevatedButton(
            onPressed: () async {
              await _applePasskitPlugin.addPasses(await getMultiplePasses());
            },
            child: const Text('Add multiple passes via ViewController'),
          ),
          ElevatedButton(
            onPressed: () async {
              final passes = await _applePasskitPlugin.passes();
              ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Passes: ${passes.join(', ')}')));
            },
            child: const Text('Passes'),
          ),
        ],
      ),
    );
  }
}

Future<List<Uint8List>> getMultiplePasses() async {
  return [await getFlightPass()];
}

Future<Uint8List> getFlightPass() async {
  final pkPass = await rootBundle.load('assets/coupon.pkpass');
  return pkPass.buffer.asUint8List(pkPass.offsetInBytes, pkPass.lengthInBytes);
}

以上代码展示了如何创建一个简单的Flutter应用，该应用可以通过按钮与Apple Wallet进行交互，包括检查PassKit库是否可用、是否可以添加passes、添加单个或多个passes以及查看已安装的passes。