本項目來自菜鳥窩,有興趣者點擊http://www.cniao5.com/course/
項目已經做完,
https://github.com/15829238397/CN5E-shop
仿京東商城系列0------項目簡介
仿京東商城系列1------fragmentTabHost實現底部導航欄
仿京東商城系列2------自定義toolbar
仿京東商城系列3------封裝Okhttp
仿京東商城系列4------輪播廣告條
仿京東商城系列5------商品推薦欄
仿京東商城系列6------下拉刷新上拉加載的商品列表
仿京東商城系列7------商品分類頁面
仿京東商城系列8------自定義的數量控制器
仿京東商城系列9------購物車數據存儲器實現
仿京東商城系列10------添加購物車,管理購物車功能實現
仿京東商城系列11------商品排序功能以及布局切換實現(Tablayout)
仿京東商城系列12------商品詳細信息展示(nativie與html交互)
仿京東商城系列13------商品分享(shareSDK)
仿京東商城系列14------用戶登錄以及app登錄攔截
仿京東長城系列15------用戶注冊,SMSSDK集成
仿京東商城系列16------支付SDK集成
仿京東商城系列17------支付功能實現
仿京東商城系列18------xml文件讀取(地址選擇器)
仿京東商城系列19------九宮格訂單展示
仿京東商城系列20------終章
前言
本文給大家介紹一個支付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')
權限聲明
<!-- 通用權限 -->
<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" />
注冊 activity
<!-- 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,之后編譯報錯。如下圖:
經過痛苦的查找過程,終于被我解決了。
報錯的原因是,由于導入第三方包導致其文件的方法引用超過了65535個方法限制,。
- 解決方式
給項目進行分包操作,然后對其虛擬機堆分配內存大小 在app的gradler配置文件中,添加 multiDexEnabled true 開啟分包,然后添加
dexOptions {
javaMaxHeapSize "4g"
}
大致代碼如下:
配置完畢,重新編譯,編譯成功。