Flutter支付插件ippo_pay的使用

本指南将帮助你了解如何在Flutter项目中集成并使用ippo_pay支付插件。该插件支持Android和iOS平台。

安装

首先，你需要在pubspec.yaml文件中添加ippo_pay插件依赖。具体步骤如下：

dependencies:
  ippo_pay: ^x.y.z

替换x.y.z为最新版本号。

接下来，在你的项目根目录下的pubspec.yaml文件中添加以下内容：

environment:
  sdk: ">=2.12.0 <3.0.0"

Android需求

设置Android build.gradle (android/app/build.gradle)

确保在android/app/build.gradle文件中添加以下内容：

android {
    defaultConfig {
        minSdkVersion 21
    }
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            ...
        }
    }
    dependencies {
        implementation 'com.ippopay:IppoPaySDK:2.1.3'
        implementation 'com.google.code.gson:gson:2.8.9'
    }
}

ProGuard规则

如果你使用ProGuard进行构建，请修改ProGuard规则文件：

-keepclassmembers class * {
    @android.webkit.JavascriptInterface <methods>;
}

-keepattributes JavascriptInterface
-keepattributes *Annotation*

-dontwarn com.ippopay.**
-keep class com.ippopay.** {*;}

-optimizations !method/inlining/*

注意事项

• 设置build.gradle需要4.1.0或更高版本。
• Kotlin版本需要1.4.30或更高版本。

iOS需求

iOS部署目标

确保iOS的部署目标为11及以上版本（适用于iPhone和iPad）。

SDK属性注意

如果你在Flutter中直接使用Ippopay的密钥和商户ID字符串，请记得转义美元符号（$）。建议从后端加载这些值以提高安全性。

示例代码

以下是完整的示例代码，展示了如何在Flutter项目中集成和使用ippo_pay插件。

import 'dart:async';
import 'dart:convert';

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

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

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

class _MyAppState extends State<MyApp> {
  TextEditingController orderIdTextField = new TextEditingController();
  final key = new GlobalKey<ScaffoldState>();
  GlobalKey<ScaffoldMessengerState> rootScaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化插件
  }

  // 平台消息异步初始化
  Future<void> initPlatformState() async {
    if (orderIdTextField.text.trim().isNotEmpty) {
      try {
        // 初始化IppoPay SDK
        IppoPay.initSdk("LIVE_KEY");
        IppoPay.setLogVisible(true);

        // 执行支付操作
        var result = await IppoPay.makePayment(json.encode({"order_id": orderIdTextField.text}));
        print(result);
      } on Exception catch (exception) {
        print(exception);
      }
    } else {
      // 显示提示信息
      WidgetsBinding.instance.addPostFrameCallback(
        (_) => rootScaffoldMessengerKey.currentState?.showSnackBar(
          new SnackBar(
            content: new Text("Please enter order id"),
          ),
        ),
      );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      scaffoldMessengerKey: rootScaffoldMessengerKey,
      home: Scaffold(
        key: key,
        appBar: AppBar(
          title: const Text('Ippopay Example'),
        ),
        body: Container(
          child: Center(
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.center,
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Container(
                  margin: EdgeInsets.all(20),
                  child: TextField(
                    controller: orderIdTextField,
                    decoration: InputDecoration(hintText: "Enter the Order id"),
                  ),
                ),
                InkWell(
                  onTap: () {
                    initPlatformState();
                  },
                  child: Container(
                    margin: EdgeInsets.all(20),
                    height: 50,
                    color: Colors.blue,
                    child: Center(
                      child: Text(
                        "Proceed Payment",
                        style: TextStyle(color: Colors.white, fontSize: 18),
                      ),
                    ),
                  ),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}