仿京东商城系列16------支付SDK集成

本项目来自菜鸟窝，有兴趣者点击http://www.cniao5.com/course/

项目已经做完，
https://github.com/15829238397/CN5E-shop

前言

本文给大家介绍一个支付SDK以及集成方式。讲道理，很简单，然而有一个猪脑子的我却在一个小问题上卡了很久，本文就把它记录下来。希望能帮到大家！
此处给出官方SDK集成文档地址。想了解详情，点击

支付SDK简介

Ping++ 是为移动端应用以及 PC 网页量身打造的下一代支付系统，通过一个 SDK 便可以同时支持移动端以及 PC 端网页的多种主流支付渠道，你只需要一次接入即可完成多个渠道的接入。 Ping++ SDK 包括 Client SDK 和 Server SDK 两部分，支持主流的七种后端开发语言，适配了 Android，iOS 和 HTML5 三种移动端平台以及 PC 端网页。

SDK客户端集成

Android Studio在你的项目里选择 Import Module...，Source directory 定位到 pingpp-android目录，也就是SDK 的根目录。取消勾选 :example，将 :lib:pingpp和 :lib:bdwallet_pay_sdk导入。将 :lib:pingpp添加到你的项目的 Dependencies。或者直接在 build.gradle 的 dependencies 区块添加代码：compiproject(':lib:pingpp')

import-03

权限声明

<!-- 通用权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- 银联需要的权限 -->
<uses-permission android:name="android.permission.NFC" />

<!-- Ping++ SDK -->
<activity
android:name="com.pingplusplus.android.PaymentActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"
android:launchMode="singleTop"
android:theme="@android:style/Theme.Translucent.NoTitleBar" >

<!-- 不使用QQ钱包,可删除此部分代码 -->
<!-- scheme 填写规则建议：qwallet + QQ钱包中的app_id -->
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.BROWSABLE"/>
<category android:name="android.intent.category.DEFAULT"/>
<data android:scheme="qwalletXXXXXXXX"/>
</intent-filter>

</activity>

<!-- 微信支付 -->
<!-- 1.需要将以下"替换成自己 APK 的包名"换成在微信平台上注册填写的包名 -->
<!-- 2.WxPayEntryActivity 这个类在 SDK 内部实现，开发者不需要额外实现该类 -->
<activity-alias
android:name="替换成自己APK的包名.wxapi.WXPayEntryActivity"
android:exported="true"
android:targetActivity="com.pingplusplus.android.PaymentActivity" />

<!-- 支付宝 -->
<activity
android:name="com.alipay.sdk.app.H5PayActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"
android:exported="false"
android:screenOrientation="behind" >
</activity>
<activity
android:name="com.alipay.sdk.auth.AuthActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"
android:exported="false"
android:screenOrientation="behind" >
</activity>

<!-- 银联支付 -->
<activity
android:name="com.unionpay.uppay.PayActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"/>

<!-- 招行一网通（非混淆加密方式） -->
<!-- 招行一网通在非混淆加密方式下同时需要配置 cmbkb_publickey字段，详见本页面最下方"注意事项" -->
<service android:name="cmb.pb.cmbsafe.CmbService" android:exported="false"/>
<activity
android:name="cmb.pb.ui.PBKeyboardActivity"
android:theme="@style/CmbDialogStyleBottom" />

代码接入

一、获得 Charge/Order 对象
Charge/Order 对象是一个包含支付信息的 JSON 对象，是 Ping++ SDK 发起支付的必要参数。该参数需要请求用户服务器获得，服务端生成 charge 或 Order 的方式参考服务端接入简介。SDK 中的 demo 里面提供了如何获取 Charge/Order 的实例方法，供用户参考。
二、发起支付
因为 Ping++ 已经封装好了相应的调用方法，所以只需要调用支付方法即可调起支付控件： (注：该调用方法需要在主线程(UI线程)完成)
//除QQ钱包外，其他渠道调起支付方式：
//参数一：Activity 表示当前调起支付的Activity
//参数二：data 表示获取到的charge或order的JSON字符串
Pingpp.createPayment(YourActivity.this, data);

//QQ钱包调用方式(注：调起支付时，需要签名打包成apk)
//“qwalletXXXXXXX”需与AndroidManifest.xml中的data值一致
//建议填写规则:qwallet + APP_ID
Pingpp.createPayment(YourActivity.this, data, "qwalletXXXXXXX");

三、获取支付状态
从 Activity 的 onActivityResult 方法中获得支付结果。支付成功后，用户服务器也会收到 Ping++ 服务器发送的异步通知。最终支付成功请根据服务端异步通知为准。

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
//支付页面返回处理
if (requestCode == Pingpp.REQUEST_CODE_PAYMENT) {
if (resultCode == Activity.RESULT_OK) {
String result = data.getExtras().getString("pay_result");
/* 处理返回值
* "success" - 支付成功
* "fail" - 支付失败
* "cancel" - 取消支付
* "invalid" - 支付插件未安装（一般是微信客户端未安装的情况）
* "unknown" - app进程异常被杀死(一般是低内存状态下,app进程被杀死)
*/
String errorMsg = data.getExtras().getString("error_msg"); // 错误信息
String extraMsg = data.getExtras().getString("extra_msg"); // 错误信息
showMsg(result, errorMsg, extraMsg);
}
}
}

代码混淆

用户进行 apk 混淆打包的时候，为了不影响 Ping++ SDK 以及渠道 SDK 的使用，请在主 module 以及该 SDK 依赖所在的 module 中添加以下混淆规则。

# Ping++ 混淆过滤
-dontwarn com.pingplusplus.**
-keep class com.pingplusplus.** {*;}
 
# 支付宝混淆过滤
-dontwarn com.alipay.**
-keep class com.alipay.** {*;}
 
# 微信或QQ钱包混淆过滤
-dontwarn  com.tencent.**
-keep class com.tencent.** {*;}
 
# 银联支付混淆过滤
-dontwarn  com.unionpay.**
-keep class com.unionpay.** {*;}
 
# 招行一网通混淆过滤
-keepclasseswithmembers class cmb.pb.util.CMBKeyboardFunc {
    public <init>(android.app.Activity);
    public boolean HandleUrlCall(android.webkit.WebView,java.lang.String);
    public void callKeyBoardActivity();
}
 
# 内部WebView混淆过滤
-keepclassmembers class * {
    @android.webkit.JavascriptInterface <methods>;
}

关于定制

用户可以根据需求自行定制一个或者多个支付渠道，但是定制 SDK 的时候需要注意以下几点：
libpingpp-xxxx.jar 和 libpingpp.so 对于任何渠道是必须的。
PaymentActivity 必须在 AndroidManifest.xml 文件里面声明。

<!-- Ping++ SDK 注册 -->
<activity
android:name="com.pingplusplus.android.PaymentActivity"
android:launchMode="singleTop"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />

权限

微信支付渠道是通过向“微信”客户端发起请求进行支付的，要求手机必须安装微信。如果没有安装微信，Ping++ SDK 会在支付结果中给予通知。
支付宝、银联等渠道，需要的权限为

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

依赖微信支付依赖包：libammsdk.jar

银联支付依赖：UPPayAssisEx.jar、UPPayPluginExPro.jar、android-support-v4.jar、pingpp/libs目录下的 .so文件和 pingpp/assets目录下的 data.bin文件支付宝支付依赖包：alipayxxxxxxxx.jar

用户如果选择不使用某种渠道，可以把该渠道相关的 Activity 从 AndroidManifest.xml 删除。
关于招行一网通的额外配置：请参考Android SDK 招行使用说明。

日志开关

SDK 提供了日志功能，默认日志为关闭状态。开发者可以通过下面设置打开日志开关。通过 PING++
来对日志进行筛选。
//开启调试模式
Pingpp.DEBUG = true;

注意事项

Android 不允许在 UI 线程中进行网络请求，所以请求 Charge 对象的时候请使用 thread+handler 或者使用 AsyncTask 。example 里面的示例程序使用的就是 AsyncTask 方式请求 Charge 对象。
wx
渠道是通过向微信客户端发起请求进行支付的，要求： 手机必须安装微信。应用包名和签名必须与填写在微信开放平台上的一致，微信平台上的签名需是 MD5 且不带冒号的格式。调试的时候必须打包出来测试，否则无法调用微信支付控件。
使用招行一网通需配置 cmbkb_publickey
字段(配置方法如下)

方法一: 在自己项目中res/values/string.xml下配置该字段
方法二: 在pingpp/res/values/cmbkb_strings.xml下替换该字段
<string name="cmbkb_publickey">填写自己的publickey</string>

错误实例

我用的androidStudio，导入第三方包，配置完manifest，之后编译报错。如下图：

image.png

经过痛苦的查找过程，终于被我解决了。
报错的原因是，由于导入第三方包导致其文件的方法引用超过了65535个方法限制,。

解决方式
给项目进行分包操作,然后对其虚拟机堆分配内存大小在app的gradler配置文件中,添加 multiDexEnabled true 开启分包,然后添加

    dexOptions {
        javaMaxHeapSize "4g"
    }

大致代码如下：