Flutter三星钱包集成插件samsung_wallet的使用

Flutter三星钱包集成插件samsung_wallet的使用

Samsung Wallet 1.1.0

Samsung Wallet for Flutter

要求

支持 flutter >= 3.0, dart >= 2.17.0, < 4.0.0
compileSdkVersion 34

更多信息

您可以获取更多信息在 Samsung Wallet 文档。

参考

此包基于 Samsung Wallet 的提供的 Android 示例代码。如果您需要参考代码，可以点击 这里 访问它。

使用方法

1. 添加依赖

   • 在您的 pubspec.yaml 文件中添加依赖。

   dependencies:
     samsung_wallet: newest_version
   

2. 添加权限

   • 在您的 AndroidManifest.xml 文件中添加权限。

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

3. 设置主页面

   • 请在 main.dart 文件中的 main 函数中添加 'WidgetsFlutterBinding.ensureInitialized();' 代码。

   void main() {
     WidgetsFlutterBinding.ensureInitialized();
     runApp(MyApp());
   }
   

4. 初始化 SamsungWallet

   • 初始化 SamsungWallet 对象。

   final samsungWalletPlugin = SamsungWallet(
       countryCode: countryCode,
       partnerCode: partnerCode,
       impressionURL: impressionUrl);
   

   如果初始化了 SamsungWallet 对象，它会自动检查 SamsungWallet 是否支持。结果可以在调试控制台查看。

5. 创建 onTapMethod 以添加卡片

   • 如果 Samsung 钱包受支持，可以添加卡片。

   function onTap(){
     samsungWalletPlugin.addCardToSamsungWallet(
         cardID: cardId, cData: cdata, clickURL: clickUrl);
   }
   

6. 添加 Samsung Wallet 按钮组件

   AddToSamsungWalletButton(onTapAddCard: onTap)
   

更多

1. 添加到钱包测试工具
   • 如果您想使用 ‘Add to Wallet Test Tool’，尝试此组件。

   AddToSamsungWalletButton.testTool()
   

如何制作 Cdata

• 您可以使用 JWT Generator 制作 Cdata。 请参阅 这里 关于 JWT Generator。

问题

请将任何问题、错误或功能请求作为 GitHub 页面上的问题提交。

import 'dart:developer';

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:samsung_wallet/samsung_wallet.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

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

  /// mandatory
  ///
  /// URL for logging a button impression event.
  /// Value granted from the Partners Portal.
  ///
  /// Check your Wallet Cards in Manage Wallet Cards which you want add Wallet Card App Integration
  static const String impressionUrl = "[ Impression Url ]";

  /// optional
  ///
  /// Country code
  static const String countryCode = "[ CountryCode ]";

  /// mandatory
  ///
  /// Partner code obtained from Partners Portal
  /// Value granted from the Partners portal.
  ///
  /// Check your Wallet Cards in Samsung Wallet Partners
  static const String partnerCode = "[ Partner Code ]";

  /// mandatory
  ///
  /// Wallet card identifier obtained from Partners Portal
  /// Value granted from the Partners Portal.
  ///
  /// Check your Wallet Cards in Manage Wallet Cards which you want add Wallet Card App Integration
  static const String cardId = "[ Card Id ]";

  /// mandatory
  /// You can get cdata to JWT Generator
  static const String cdata = "[ CData ]";

  /// mandatory
  ///
  /// Encrypted card object (JSON).
  /// This field needs to be encrypted.
  ///
  /// Refer to [Security](https://developer.samsung.com/wallet/api/security.html)
  /// for more details.
  ///
  /// Check your Wallet Cards in Manage Wallet Cards which you want add Wallet Card App Integration
  static const String clickUrl = "[ Click Url ]";

  final _samsungWalletPlugin = SamsungWallet(
      countryCode: countryCode,
      partnerCode: partnerCode,
      impressionURL: impressionUrl);

  Future<void> checkSamsungWalletSupported() async {
    try {
      await _samsungWalletPlugin.checkSamsungWalletSupported(
              partnerCode: partnerCode, countryCode: 'KR') ??
          false;
    } catch (e) {
      log("ERROR : $e");
    }
  }

  addCard() async {
    await _samsungWalletPlugin.addCardToSamsungWallet(
        cardID: cardId, cData: cdata, clickURL: clickUrl);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Samsung Wallet Demo'),
        ),
        body: Center(
          child: Column(
            children: [
              const Text('Hello Samsung Wallet!'),
              const SizedBox(
                height: 50,
              ),
              AddToSamsungWalletButton(
                onTapAddCard: addCard,
                buttonDesignType: ButtonDesignType.iconBasic,
                buttonTextPositionType: ButtonTextPositionType.hor,
                buttonThemeType: ButtonThemeType.pos,
              ),
              const SizedBox(
                height: 50,
              ),
              AddToSamsungWalletButton.testTool(),
            ],
          ),
        ),
      ),
    );
  }
}