快速接入 微信微博QQ钉钉 原生登陆分享

使用 微博、QQ、微信、钉钉 原生 SDK 接入，提供这些平台的登陆、分享功能支持。针对业务逻辑对各个平台的接口进行封装，对外提供一致的表现，在减轻接入压力的同时，又能得到原生 SDK 最大的灵活性。

考虑到每一个平台的 SDK 也在不断的更新，且每一个项目的需求差别比较大，如可能只须要支持部分平台，所以没有对类库进行发布，请下载 GitHub 上的 module 自行依赖，在类库设计的过程当中，每一个平台都是独立的，若是只须要支持部分平台，只须要删除 platform 包下面对应的实现便可，不会对其余平台形成影响。

项目地址 : GitHub - SocialSdkLibrary

本文地址 ：快速接入微信微博QQ钉钉原生登陆分享

🎉 2017.12.12 对代码进行简单重构并测试，发布第一个稳定版本 1.0.0

🎉 2018.2.12 支持钉钉分享

优势

还在优化中...

🔥 简单：只须要关注几个管理类和相关数据的构造便可实现所需功能，不须要考虑复杂的受权和分享逻辑。

🔥 轻量：除了必须的第三方 sdk 以外，本项目只依赖了一个简单的异步任务的框架 bolts (38k)，后续会考虑也剔除掉，不引入无用依赖，保证与宿主项目高度统一。

🔥 全面：内部存储受权 token，避免屡次受权；对 qq、微信、微博 作了完善的支持；

🔥 扩展性：

• 平台独立，项目以平台进行划分，各个平台之间彻底独立，若是想仅支持部分平台，只须要删除 platform 包下该平台的具体实现便可。
• 请求、JSON 解析等功能可从外部注入代理，对一些功能进行自定义的扩展。
• 能够继承 AbsPlatform 接入其余平台分享，自定义扩展。

🔥 功能性：针对实际项目需求进行扩展，例如在分享前统一对分享数据提供一次从新构造的机会。

🔥 兼容性：

• 为多个平台提供外观一致的分享接口，若不支持，使用 web 分享兼容。
• 支持直接使用网络图片分享，内置自动下载功能。
• 使用 Intent 兼容不支持的数据模式，如支持本地视频分享，qq 的纯文字分享等等。

主要类文件

使用 SocialSdk 只须要关注如下几个文件：

👉️ SocialSdk.java 结合 SocialConfig.java 用来进行受权信息的配置。

👉️ Target.java 类是单独分离出来的常量类，指向了登陆和分享的具体目标。

👉️ LoginManager.java 用来实现 qq、微信、微博第三方受权登陆，内部存储 accessToken，无需屡次受权，只要调用 LoginManager.login() 方法。

👉️️ ShareManager.java 用来实现 8 种数据类型、4 个平台、8 个渠道的分享，只要调用 ShareManager.share() 方法。

gradle 配置

针对多方 SDK 的要求，对权限、和必要的界面、服务都已经在类库中进行了配置，当依赖该类库时，会自动合并，不过仍然还须要在项目的 app/build.gradle 中配置对应的 qqId 的 manifestPlaceholders，代码以下：

defaultConfig {
	manifestPlaceholders = [qq_id: "11049xxxxx"]
}
复制代码

关于 manifestPlaceholders 的使用

当使用 manifestPlaceholders = [qq_id: "11049xxxxx"] 的方式时，以前声明的全部 manifestPlaceholders 都会被替换掉，只保留最后的。

当使用 manifestPlaceholders.qq_id = "11049xxxxx" 的方式时，会在原来的 manifestPlaceholders 中追加新的，同时也保留之前的。

建议的方式是，在 defaultConfig 中使用直接赋值的方式，而在 buildTypes 和 Favors 中使用追加的方式，避免将以前的覆盖掉。
复制代码

初始化

你须要在使用 SDK 以前进行初始化操做，建议放在 Applicaton 中进行。

String qqAppId = getString(R.string.QQ_APPID);
String wxAppId = getString(R.string.WEICHAT_APPID);
String wxSecretKey = getString(R.string.WEICHAT_APPKEY);
String sinaAppId = getString(R.string.SINA_APPKEY);
String ddAppId = getString(R.string.DD_APPID);
SocialSdkConfig config = new SocialSdkConfig(this)
        .dd(ddAppId)
        // 配置qq
        .qq(qqAppId)
        // 配置wx
        .wechat(wxAppId, wxSecretKey)
        // 配置sina
        .sina(sinaAppId)
        // 配置Sina的RedirectUrl，有默认值，若是是官网默认的不须要设置
        .sinaRedirectUrl("http://open.manfenmm.com/bbpp/app/weibo/common.php")
        // 配置Sina受权scope,有默认值，默认值 all
        .sinaScope(SocialConstants.SCOPE);
// 👮 添加 config 数据，必须
SocialSdk.init(config);
// 👮 添加自定义的 json 解析，必须
SocialSdk.setJsonAdapter(new GsonJsonAdapter());
复制代码

adapter

使用 adapter 这种模式主要参照了一些成熟的类库，目的是为了对外提供更好的扩展性，这部份内容能够关注 SocialSdk.java.

• IJsonAdapter，负责 Json 解析，为了保持和宿主项目 json 解析框架的统一，是必须自定义添加的（没有内置一个实现是由于使用自带的 JsonObject 解析实在麻烦，又不想内置一个三方库进来，采起的这种折衷方案），提供一个 Gson 下的实现仅供参考 - GsonJsonAdapter.java

• IRequestAdapter，负责请求数据，目前微信的 OAuth2 受权和图片下载的相关请求都是使用 IRequestAdapter 代理，已经使用 URLConnection 内置了一个实现，若是你有本身的需求能够重写这部分，注意 https 请求的兼容，能够参考 - RequestAdapterImpl.java

登陆功能

登录功能支持三个平台，qq，微信，微博；

// 3个平台
Target.LOGIN_QQ;
Target.LOGIN_WX;
Target.LOGIN_WB;
复制代码

使用 OnLoginListener 监听登陆返回结果，返回的 LoginResult 中主要包括登陆类型，基本用户信息，令牌信息 3 部分。

public class LoginResult {
    // 登录的类型，对应 Target.LOGIN_QQ 等。。。
    private int             type;
    // 返回的基本用户信息
    // 针对登陆类型可强转为 WbUser,WxUser,QQUser 来获取更加丰富的信息
    private BaseUser        mBaseUser;
    // 本次登录的 token 信息，openid,unionid,token,expires_in
    private BaseAccessToken mBaseToken;
}

// 登录结果监听
mOnLoginListener = new OnLoginListener() {
    @Override
    public void onLoginSucceed(LoginResult loginResult) {
        Log.e(TAG, loginResult.toString());
    }
    @Override
    public void onCancel() {
        toast("登陆取消");
    }
    @Override
    public void onException(PlatformException e) {
        toast("登陆失败 " + e.toString());
    }
};

// 3个平台
Target.LOGIN_QQ;
Target.LOGIN_WX;
Target.LOGIN_WB;

// 唤醒登录
LoginManager.login(mActivity, Target.LOGIN_QQ, mOnLoginListener);
复制代码

清除受权 token，为了不每次登陆都要求用户打开受权界面从新点击受权的很差体验，类库里面对 token 进行了持久化的存储，当本地 token 没有过时时，直接使用这个 token 去请求用户信息，同时提供了清除本地 token 的方法。

LoginManager.java

// 清除所有平台的 token
public static void clearAllToken(Context context) // 清除指定平台的 token public static void clearToken(Context context, @Target.LoginTarget int loginTarget) 复制代码

分享功能

扩展支持

// 发短信
ShareManager.sendSms(mActivity,"13612391817","msg body");
// 发邮件
ShareManager.sendEmail(mActivity,"1101873740@qq.com","subject","msg body");
// 打开渠道对应应用
ShareManager.openApp(mActivity,Target.SHARE_QQ_FRIENDS);
复制代码

8 种数据支持

分享支持 8 种类型的数据；若是某个平台不兼容某种类型的分享，将会使用 web 分享的方式代替；好比微信不支持 app 分享，分享出去以后时 web 分享的模式。支持的 8 种类型分别是：

1. 开启渠道对用的 app。
2. 分享文字。
3. 分享图片( jpg , png , gif )。
4. 分享 app。
5. 分享 web。
6. 分享 music。
7. 分享 video。
8. 分享本地 video，使用 Intent 方式唤醒。

8 个分享渠道

// 支持的分享渠道
Target.SHARE_DD; // 钉钉好友
Target.SHARE_QQ_FRIENDS; // qq好友
Target.SHARE_QQ_ZONE; // qq空间
Target.SHARE_WX_FRIENDS; // 微信好友
Target.SHARE_WX_ZONE; // 微信朋友圈
Target.SHARE_WX_FAVORITE; // 微信收藏
Target.SHARE_WB_NORMAL; // 新浪微博
Target.SHARE_WB_OPENAPI; // 新浪微博openApi分享，使用该方法分享图片时微博后面会带一个小尾巴，能够点击进入官微
复制代码

建立分享数据

分享时，咱们首先要构造分享用的数据，ShareObj 对象提供了多种静态方法用来快速建立对应分享的类型的对象。

// 测试用的路径
localImagePath = new File(Environment.getExternalStorageDirectory(), "1.jpg").getAbsolutePath();
localVideoPath = new File(Environment.getExternalStorageDirectory(), "video.mp4").getAbsolutePath();
localGifPath = new File(Environment.getExternalStorageDirectory(), "3.gif").getAbsolutePath();
netVideoPath = "http://7xtjec.com1.z0.glb.clouddn.com/export.mp4";
netImagePath = "http://7xtjec.com1.z0.glb.clouddn.com/token.png";
netMusicPath = "http://7xtjec.com1.z0.glb.clouddn.com/test_music.mp3";
netMusicPath = "http://mp3.haoduoge.com/sSocialSdkConfig/2017-05-19/1495207225.mp3";
targetUrl = "http://bbs.csdn.net/topics/391545021";


// 打开渠道对应app
ShareObj shareMediaObj = ShareObj.buildOpenAppObj();
// 分享文字
ShareObj textObj = ShareObj.buildTextObj("分享文字", "summary");
// 分享图片
ShareObj imageObj = ShareObj.buildImageObj("分享图片", "summary", localImagePath);
// 分享gif
ShareObj imageGifObj = ShareObj.buildImageObj("分享图片", "summary", localGifPath);
// 分享app
ShareObj appObj = ShareObj.buildAppObj("分享app", "summary", localImagePath, targetUrl);
// 分享web
ShareObj webObj = ShareObj.buildWebObj("分享web", "summary", localImagePath, targetUrl);
// 分享视频
ShareObj videoObj = ShareObj.buildVideoObj("分享视频", "summary", localImagePath, targetUrl, localVideoPath, 10);
// 分享本地视频，使用 Intent 方式唤醒，支持 qq、微信 好友分享
ShareObj videoLocalObj = ShareObj.buildVideoObjByLocalPath(localVideoPath);
// 分享音乐
ShareObj musicObj = ShareObj.buildMusicObj("分享音乐", "summary", localImagePath, targetUrl, netMusicPath, 10);
复制代码

分享监听

分享结果，使用 OnShareListener 进行检测。OnShareListener 提供了丰富的方法来支持分享的各个阶段，关于分享对象重构的操做，在下一部分说明。

public class SimpleShareListener implements OnShareListener{
    @Override
    public void onStart(int shareTarget, ShareObj obj) {
        // 分享开始
    }
    @Override
    public ShareObj onPrepareInBackground(int shareTarget, ShareObj obj) {
        // 重构分享对象，不须要时返回 null 便可
        return null;
    }
    @Override
    public void onSuccess() {
        // 分享成功
    }
    @Override
    public void onFailure(SocialException e) {
        // 分享失败
    }
    @Override
    public void onCancel() {
        // 分享取消
    }
}
复制代码

发起分享

// 唤醒分享
ShareManager.share(mActivity, Target.SHARE_QQ_FRIENDS, imageObj, mOnShareListener);
复制代码

重写分享对象

关于重写分享对象，其实提供一种能在分享以前对须要分享的 ShareObj 进行统一处理的机会，相似中间插一道自定义工序，好比能够用来解决网络图片没法分享，咱们须要将它下载到本地，在进行分享，又好比图片分享出去以前加上 app 水印等操做。

主要是重写 OnShareListener 的 onPrepareInBackground 方法，这个方法会在分享以前首先执行，若是返回不是 null，将会使用新建立的 ShareObj 进行分享，另外因为考虑到可能进行耗时操做，这个方法是在子线程执行的。

@Override
public ShareObj onPrepareInBackground(int shareTarget,ShareObj obj) {
    // 重构分享对象，不须要时返回 null 便可
    return null;
}
复制代码

看一个基本的实例，主要功能是在分享以前用来将网络图下载到本地而后更新 ShareObj 指向的图片地址，这样就能够支持网络图片的直接分享，固然，这个功能已经内置在类库中。

public class MyShareListener extends SimpleShareListener {

    public static final String TAG = MyShareListener.class.getSimpleName();

    private Context       mContext;
    private LoadingDialog mLoadingDialog;

    public MyShareListener(Context context) {
        mContext = context;
        mLoadingDialog = new LoadingDialog(mContext);
    }

    @Override
    public void onStart(int shareTarget, ShareObj obj) {
        if (mLoadingDialog != null)
            mLoadingDialog.show();
    }

    @Override
    public ShareObj onPrepareInBackground(int shareTarget, ShareObj obj) throws Exception{
        // 网络路径，先进行文件下载进行文件下载
        ShareObjHelper.prepareThumbImagePath(obj);
        // 分享照片且不是gif时加水印
        if (obj.getShareObjType() == ShareObj.SHARE_TYPE_IMAGE
                && !FileHelper.isGifFile(obj.getThumbImagePath())) {
            File thumbImageFile = new File(obj.getThumbImagePath());
            File saveFile = new File(Constants.THUMB_IMAGE_PATH, thumbImageFile.getName());
            if (!FileUtil.fileIsExist(saveFile.getAbsolutePath())) {
                ImageUtils.drawWaterMarkSync(mContext, obj.getThumbImagePath(), saveFile.getAbsolutePath(), false, false);
            }
            obj.setThumbImagePath(saveFile.getAbsolutePath());
        }
        return obj;
    }

    @Override
    public void onSuccess() {
        ToastUtil.show("分享成功");
    }

    @Override
    public void onFailure(SocialException e) {
        switch (e.getErrorCode()) {
            case SocialException.CODE_NOT_INSTALL:
                ToastUtil.show("应用未安装");
                break;
        }
        L.e(TAG, "分享失败" + e.toString());
    }

    @Override
    public void onCancel() {
        ToastUtil.show("分享取消");
    }
}
复制代码