跳转到内容

Android 接入

从旧的 JAR SDK 迁移到 AAR SDK(若未集成过直接忽略)

支付宝 SDK 从 15.5.7 开始,打包方式更换为 AAR,替代之前的 JAR 打包,SDK 支付接口部分不变。

如果您已经在应用中接入了之前的 alipaySdk-xxx.jar 包,请先按照下面的步骤,移除旧的 JAR 配置:

1.在项目中 App Module(而非整个项目)的 build.gradle 文件中,移除对支付宝 SDK JAR 包的依赖,示例代码如下:

!FILENAME 删除旧 SDK 依赖

groovy
dependencies {
    ... ...
    // 删除下面的依赖项
    compile files('libs/alipaySdk-20170725.jar')
    ... ... 
}

2.从 libs 目录删除旧的 alipaySdk-xxx.jar 文件,如:

删除旧的alipaySdk-xxx.jar

3.从 AndroidManifest.xml 中移除对以下 Activity 的注册(更换为 AAR 后无需手动注册):

xml
<!-- 删除以下内容 -->
<activity
    android:name="com.alipay.sdk.app.H5PayActivity"
    android:configChanges="orientation|keyboardHidden|navigation|screenSize"
    android:exported="false"
    android:screenOrientation="behind"
    android:windowSoftInputMode="adjustResize|stateHidden" >
</activity>
<activity
    android:name="com.alipay.sdk.app.H5AuthActivity"
    android:configChanges="orientation|keyboardHidden|navigation"
    android:exported="false"
    android:screenOrientation="behind"
    android:windowSoftInputMode="adjustResize|stateHidden" >
</activity>
<!-- 删除以上内容 -->

之后,请按照下面的章节导入 AAR 格式的支付宝 SDK 包。

导入支付宝 SDK

以下内容可参考 alipay_demo 的实现。

1.将 alipaySdk-15.5.7-20181023110917.aar 包放在您的应用工程的 libs 目录下(图片中文件名仅做示例,请以实际 SDK 文件名为准):

![加入aar文件]](https://cdn.nlark.com/lark/0/2018/png/42748/1540210090569-56435ed4-88ac-47c0-8118-28c5b3765d54.png#align=left&display=inline&height=305&originHeight=504&originWidth=792&status=done&width=480)

2.在主项目的 build.gradle 中,添加下面的内容,将 libs 目录作为依赖仓库:

修改 gradle

allprojects {
    repositories {

        // 添加下面的内容
        flatDir {
            dirs 'libs'
        }

        // ... jcenter() 等其他仓库
    }
}

3.在您 App Module 的 build.gradle 中,添加下面的内容,将支付宝 SDK 作为项目依赖:

添加依赖

groovy
dependencies {

    // 添加下面的内容
    compile (name: 'alipaySdk-15.5.7-20181023110917', ext: 'aar')

    // ... 其他依赖项
}

至此,支付宝 SDK 开发资源导入完成。

运行权限

为正常完成良好的支付流程体验,支付宝 SDK 需要使用下面这些权限:

android.permission.INTERNET
android.permission.ACCESS_NETWORK_STATE
android.permission.ACCESS_WIFI_STATE

您需要在 AndroidManifest 里配置以上 3 个权限,支付宝 SDK 在运行时需要进行网络连接,并在必要的时候判断网络连接的状态(4G/Wi-Fi)等来进行支付体验的优化。

支付接口调用

需要在新线程中调用支付接口下载 Demo

PayTask 对象主要为商户提供订单支付、查询功能,及获取当前开发包版本号。 获取 PayTask 支付对象调用支付(支付行为需要在独立的非ui线程中执行),代码示例:

java
    final String orderInfo = info;   // 订单信息

    Runnable payRunnable = new Runnable() {

        @Override
        public void run() {
            PayTask alipay = new PayTask(DemoActivity.this);
            Map <String,String> result = alipay.payV2(orderInfo,true);

            Message msg = new Message();
            msg.what = SDK_PAY_FLAG;
            msg.obj = result;
            mHandler.sendMessage(msg);
        }
    };

    // 必须异步调用
    Thread payThread = new Thread(payRunnable);
    payThread.start();

参数说明:

String orderInfo:app支付请求参数字符串,主要包含商户的订单信息,key=value形式,以&连接。

boolean isShowPayLoading:用户在商户app内部点击付款,是否需要一个 loading 做为在钱包唤起之前的过渡,这个值设置为 true,将会在调用 pay 接口的时候直接唤起一个 loading,直到唤起H5支付页面或者唤起外部的钱包付款页面 loading 才消失。(建议将该值设置为 true,优化点击付款到支付唤起支付页面的过渡过程。)

orderInfo 示例如下,orderInfo 的获取必须来源于服务端(注意:并非所有的 SDK 订单字符串都一个格式,以下是来自闲鱼的 SDK 格式)

app_id=2015052600090779&biz_content=%7B%22timeout_express%22%3A%2230m%22%2C%22seller_id%22%3A%22%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22total_amount%22%3A%220.02%22%2C%22subject%22%3A%221%22%2C%22body%22%3A%22%E6%88%91%E6%98%AF%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%22%2C%22out_trade_no%22%3A%22314VYGIAGG7ZOYY%22%7D&charset=utf-8&method=alipay.trade.app.pay&sign_type=RSA2&timestamp=2016-08-15%2012%3A12%3A15&version=1.0&sign=MsbylYkCzlfYLy9PeRwUUIg9nZPeN9SfXPNavUCroGKR5Kqvx0nEnd3eRmKxJuthNUx4ERCXe552EV9PfwexqW%2B1wbKOdYtDIb4%2B7PL3Pc94RZL0zKaWcaY3tSL89%2FuAVUsQuFqEJdhIukuKygrXucvejOUgTCfoUdwTi7z%2BZzQ%3D

支付结果获取和处理(若非直接对接支付宝官方接口,请忽略此步骤,等待上游通知)

调用 pay 方法支付后,将通过2种途径获得支付结果:

1、同步返回

商户应用客户端通过当前调用支付的Activity的Handler对象,通过它的回调函数获取支付结果。(可参考 alipay_demo 实现) 代码示例:

java
private Handler mHandler = new Handler() {
    public void handleMessage(Message msg) {
        Result result = new Result((String) msg.obj);
        Toast.makeText(DemoActivity.this, result.getResult(),
                    Toast.LENGTH_LONG).show();
    };
};

异步通知 商户需要提供一个 http 协议的接口,包含在请求支付的入参中,其 key 对应 notify_url。支付宝服务器在支付完成后,会以 POST 方式调用 notify_url 传输数据。

获取当前开发包版本号

调用 PayTask 对象的 getVersion() 方法查询。 代码示例:

PayTask payTask = new PayTask(activity);
String version = payTask.getVersion();

更多详情参见支付宝官方文档

Released under the MIT License.