简介

本文为 Android 终端开发工具的新手使用教程，涉及到支付宝 Android分享开发工具包的使用方法，默认读者已经熟悉应用开发 IDE 的基本使用方法（本文以 Android Studio 为例），以及具有一定的编程知识基础。

支付宝社交分享开放接口免费并默认向开发者开放，所以无需进行签约申请。

接入前请完成相关准备工作，详情可查看 接入准备。**
**

下载开发工具包

点击下载支付宝 Android分享SDK包和 Android分享DEMO 。集成分享到支付宝 Android SDK 前，请仔细阅读分享到支付宝 Android SDK 隐私说明。

开发工具包主要包含 3 部分内容（其中 libapshare.jar 是必须的）：

libapshare.jar：需要被第三方应用导入的 SDK 库，通过该库可以实现对支付宝社交分享能力接口的调用和通信。

APShareDemo.apk 和 APShareDemo-code.zip：DEMO 实例及源代码，供开发者参考开发。

GenSignature.apk：应用签名获取工具。

搭建开发环境

在 Android Studio 创建 Android 应用工程；

在工程中添加 Java 资源文件夹 resources\libs，将开发工具包中的 libapshare.jar 复制到该文件夹中；

右键 libapshare.jar 包，点击 Add As Library...，将 SDK JAR 包添加为工程依赖包。

使用开发工具包

发送请求调用支付宝社交分享能力

Android 应用要发送请求到支付宝，可以通过 IAPApi 的 sendReq 方法，发送包装好的分享消息请求对象给支付宝客户端来实现。发送分享消息会唤起支付宝客户端，并在用户完成分享操作后，可以选择回到 Android 应用界面。

示例说明

下面将通过一个简单的发送文本类分享信息给好友作为例子演示如何发送请求调用支付宝社交分享能力。

首先，使用到开发工具包中的如下类，来实现发送请求：

//社交分享开放工具接口类，便于对社交分享开放接口的调用
import com.alipay.share.sdk.openapi.IAPApi;
//社交分享开放工具工厂类，用于创建工具实例
import com.alipay.share.sdk.openapi.APAPIFactory;
//普通文本消息内容定义类
import com.alipay.share.sdk.openapi.APTextObject;
//分享消息定义类
import com.alipay.share.sdk.openapi.APMediaMessage;
//分享消息请求包装类
import com.alipay.share.sdk.openapi.SendMessageToZFB;

在事件触发代码中加入如下代码：

//创建工具对象实例，此处的APPID为上文提到的，申请应用生效后，在应用详情页中可以查到的支付宝应用唯一标识
IAPApi api = APAPIFactory.createZFBApi(getApplicationContext(),APPID,false);
//组装文本消息内容对象
APTextObject textObject = new APTextObject();
textObject.text = "需要发送的内容";
//组装分享消息对象
APMediaMessage mediaMessage = new APMediaMessage();
mediaMessage.mediaObject = textObject;
//将分享消息对象包装成请求对象
SendMessageToZFB.Req req = new SendMessageToZFB.Req();
req.message = mediaMessage;
//发送请求
api.sendReq(req);

完成后，生成 Android 安装文件到移动端。
注意：移动端需要安装好支付宝客户端。

接收和处理支付宝返回的响应消息

当应用成功将分享请求消息发送给支付宝客户端后，用户将在客户端完成分享操作，在用户完成操作后，支付宝将会把用户操作的结果消息返回给开发者的 Android 应用。当开发者需要处理该相应消息时，可以通过实现 IAPAPIEventHandler 接口的 onResp 方法来处理消息。

示例说明

下面将实现接收和处理上文中文本消息分享后支付宝返回的响应消息，来说明如何接收和处理支付宝返回的响应消息。

使用到开发工具包中的如下类，来实现接收和处理响应消息：

//社交分享应用工具通用事件处理接口
import com.alipay.share.sdk.openapi.IAPAPIEventHandler;
//社交分享应用工具接口类，便于对社交分享开放接口的调用
import com.alipay.share.sdk.openapi.IAPApi;
//社交分享应用工具工厂类，用于创建工具实例
import com.alipay.share.sdk.openapi.APAPIFactory;
//社交分享应用的通用请求对象
import com.alipay.share.sdk.openapi.BaseReq;
//社交分享应用的通用响应对象
import com.alipay.share.sdk.openapi.BaseResp;

在包名相应目录下新建一个 apshare 包，并在该 apshare 目录下新增一个 ShareEntryActivity 类，该类继承自 Activity（android.app.Activity；

在 AndroidManifest 文件里将 ShareEntryActivity 的 exported 属性设置为 true：

通过实现 IAPAPIEventHandler 接口，来定义如何处理返回的响应消息，要处理返回的响应消息，需要实现 onResp(BaseResp baseResp) 方法；
注意：本文为方便，直接让 ShareEntryActivity 实现 IAPAPIEventHandler 接口。

public class ShareEntryActivity extends Activity implements IAPAPIEventHandler

@Override
public void onResp(BaseResp baseResp) {
    //打印相应返回消息结果码
    Toast.makeText(this, "Result Code:" + baseResp.errCode, Toast.LENGTH_LONG).show();
}

在 ShareEntryActivity 中将接收到的 intent 及实现了 IAPAPIEventHandler 接口的对象传递给 IAPApi 接口的 handleIntent 方法，此方法最好在 Activity 的 onCreate 方法中完成调用。

//创建工具对象实例，此处的APPID为上文提到的，申请应用生效后，在应用详情页中可以查到的支付宝应用唯一标识
IAPApi api = APAPIFactory.createZFBApi(getApplicationContext(), APPID, false);
Intent intent = getIntent();
//通过调用工具实例提供的handleIntent方法，绑定消息处理对象实例，
api.handleIntent(intent, this);

完成后，生成 Android 安装文件到移动端。
注意：移动端需要安装好支付宝客户端。

常见问题

Q：IAPApi.isZFBAppInstalled() 返回 false 如何处理？

A：如果业务应用的 targetSdk ≥ 30，需要在 menifest 里申请权限，如：

<manifest>    
  <queries>  
        <!--   可查询支付宝，并与其交互     -->
        <package android:name="com.eg.android.AlipayGphone" />
    </queries>
</manifest>

Android 接入指南

简介#

下载开发工具包#

搭建开发环境#

使用开发工具包#

发送请求调用支付宝社交分享能力#

示例说明#

接收和处理支付宝返回的响应消息#

示例说明#

常见问题#

Q：IAPApi.isZFBAppInstalled() 返回 false 如何处理？#

简介

下载开发工具包

搭建开发环境

使用开发工具包

发送请求调用支付宝社交分享能力

示例说明

接收和处理支付宝返回的响应消息

示例说明

常见问题

Q：IAPApi.isZFBAppInstalled() 返回 false 如何处理？