Android分享SDK接入流程

本文介绍如何使用钉钉Android分享SDK接入钉钉分享。

准备工作

在使用Android接入钉钉分享之前，你需要完成以下准备工作：

搭建Android开发环境。

下载Android SDK （版本号：1.2.0.3）。

安装钉钉客户端2.7.0及以上的版本。

说明

下载并使用本SDK，即表示您已阅读并同意《钉钉开放平台开发者服务协议》、《钉钉开放平台隐私权政策》。

步骤一：接入钉钉分享

登录开发者后台，打开应用列表页，点击应用进入应用详情页。

在应用信息页面，获取应用的AppKey。

在应用详情页，单击钉钉登录与分享，进入登录与分享页面。

在接入分享栏，单击右侧编辑。

单击开启Android 分享，然后依次填写Android包名称和Android签名，最后单击保存。

说明

签名获取方式请参考签名方法。

步骤二：搭建开发环境

使用以下任意一种方式搭建开发环境。

方式一：Gradle依赖

在模块的build.gradle的dependencies中添加compile 'com.alibaba.android:ddsharesdk:1.1.0'

方式二：jar包直接引入

新建一个名为DDShareDemo的Android工程，在工程中创建一个libs工程，将下载的jar包复制到该目录中，如下图所示：

将libs目录下的JAR包文件添加到工程依赖中。

步骤三：在代码中使用开发工具包

如果您的程序需要接收钉钉发送的请求，或者接收发送到钉钉的请求的响应结果，需要执行以下操作：

在您的包名相应目录下新建一个ddshare。

然后在AndroidManifest文件中添加exported属性，设置为true。

实现IDDAPIEventHandler接口，钉钉的响应结果将回调到onResp方法中。

onResp方法示例代码如下：

public void onResp(BaseResp baseResp) {
    int errCode = baseResp.mErrCode;
    Log.d("lzc" , "errorCode==========>"+errCode);
    String errMsg = baseResp.mErrStr;
    Log.d("lzc" , "errMsg==========>"+errMsg);
    if(baseResp.getType() == ShareConstant.COMMAND_SENDAUTH_V2 && (baseResp instanceof SendAuth.Resp)){
        SendAuth.Resp authResp = (SendAuth.Resp) baseResp;
        switch (errCode){
            case BaseResp.ErrCode.ERR_OK:
                Toast.makeText(this, "授权成功，授权码为:"+authResp.code, Toast.LENGTH_SHORT).show();
                break;
            case BaseResp.ErrCode.ERR_USER_CANCEL:
                Toast.makeText(this, "授权取消", Toast.LENGTH_SHORT).show();
                break;
            default:
                Toast.makeText(this, "授权异常"+baseResp.mErrStr, Toast.LENGTH_SHORT).show();
                break;
        }
    }else{
        switch (errCode){
            case BaseResp.ErrCode.ERR_OK:
                Toast.makeText(this, "分享成功", Toast.LENGTH_SHORT).show();
                break;
            case BaseResp.ErrCode.ERR_USER_CANCEL:
                Toast.makeText(this, "分享取消", Toast.LENGTH_SHORT).show();
                break;
            default:
                Toast.makeText(this, "分享失败"+baseResp.mErrStr, Toast.LENGTH_SHORT).show();
                break;
        }
    }
    finish();
}

在DDShareActivity类中，将接收到的intent和实现了IDDAPIEventHandler接口的对象传递给IDDShareApi接口的handleIntent方法。然后应用请求钉钉的响应结果，钉钉将会通过调用onResp方法的形式返回。

private IDDShareApi mIDDShareApi;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d("lzc" ,"onCreate==========>");
    try {
        //activity的export为true，try起来，防止第三方拒绝服务攻击。APP_ID指通过步骤一获取的应用的AppKey
        mIDDShareApi = DDShareApiFactory.createDDShareApi(this, Constant.APP_ID, false);
        mIDDShareApi.handleIntent(getIntent(), this);
    } catch (Exception e) {
        e.printStackTrace();
        Log.d("lzc" , "e===========>"+e.toString());
    }
}

判断当前设备是否支持分享。

判断当前设备是否已经安装钉钉。

findViewById(R.id.ding_install_check).setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        boolean isInstalled = iddShareApi.isDDAppInstalled();
        Toast.makeText(MainActivity.this, "是否安装===》" + isInstalled, Toast.LENGTH_SHORT).show();
    }
});

判断当前设备是否支持分享到钉钉（已经安装钉钉并且钉钉版本支持分享）。

findViewById(R.id.share_support_check).setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        boolean isSupport = iddShareApi.isDDSupportAPI();
        Toast.makeText(MainActivity.this ,"是否支持分享到好友===》"+isSupport ,Toast.LENGTH_SHORT ).show();
    }
});

支持的分享类型。

支持文本、图片、链接以及特殊的支付宝红包类型。具体使用请参考已下载的Android SDK示例。

Android分享SDK接入流程

准备工作#

步骤一：接入钉钉分享#

步骤二：搭建开发环境#

步骤三：在代码中使用开发工具包#

准备工作

步骤一：接入钉钉分享

步骤二：搭建开发环境

步骤三：在代码中使用开发工具包