没有ShareSDK你一样可以分享

如今的App十个有九个会集成定向分享的功能,当提到分享你可能第一直觉就是ShareSDK,可能很多人都不愿意自己一个一个去接各个第三方分享,因为每个第三方分享的对接方式都不一样,主要包括:

  1. 入参不一样;
  2. 返回参数不一样;
  3. 唤起分享方式不一样;

因为它们的千差万别,每接入一个分享还要兼容现有的,想想就头大,因此遇到很赶的项目很少人沉下心来去了解它们,所以ShareSDK就是首选,曾经我也是曾经一员,但一次特别的经历后我退出了,随后iOS团队也遇到一次另外的经历也随后退出了,从此走上自己写分享SDK的路,我所谓的经历就是遇到了通过ShareSDK微信分享失败但没有任何反馈,通过单独接微信分享却是可以的。
其实,ShareSDK并没有做多少工作,无非就是做了一个资源整合的工作,自己实现也能锻炼自己的设计能力,再者遇到问题无需等待第三方解决。总之,如果是一个长期开发维护的项目,自己的项目自己做主,尽可能减少第三方的过度依赖有利于项目良性发展。

自己设计分享SDK,要满足以下几个主要功能:

  1. 支持文本、网页、图片、视频、小程序等内容分享;
  2. 支持QQ好友、QQ空间、微信好友、微信朋友圈、新浪微博等分享平台;
  3. 支持一次弹出的分享框里分享出去的内容不一样,如:通过微信好友分享出去的是小程序,通过QQ分享出去的是网页。
  4. 支持直接唤起某一个第三方分享;
  5. 权限管理(遇到超大的byte[]图片通过Intent传递会导致分享失败,只能先存储,再以存储的图片路径分享出去);
  6. 支持统一的分享回调结果;
  7. 统一的管理第三方分享SDK的app id;
  8. 最重要的是可灵活增加分享内容类型和分享平台;

分享内部的组成部分:

  1. ShareTo:即分享平台,支持的分享目标,包括QQ、QZone、Sms、Timeline、WeChat等,ShareTo的子类主要作用是实现抽象方法用于提供分享弹框里的图标和文字、在分享框里的排序、判断分享目标app是否安装、提供appId以及告知支持哪些内容的分享, 下面以“微信好友”作为示例:
public class WeChat extends ShareTo {
    public static final int ID = 1;

    public WeChat(ShareContent shareContent) {
        super(shareContent);
    }

    @Override
    public int getShareLogo() {
        return R.drawable.logo_wechat;
    }

    @Override
    public int getShareName() {
        return R.string.share_wechat;
    }

    @Override
    public int getSortId() {
        return ID;
    }

    @Override
    public boolean installed(Context context) {
        if (isAppNotInstalled(context, "com.tencent.mm")) {
            Toast.makeText(context, R.string.share_we_chat_not_installed_warning, Toast.LENGTH_SHORT).show();
            return false;
        }
        return true;
    }

    @Override
    public String getAppId(Context context) {
        return getPropertyValue(context, "wechat_app_id");
    }

    @Override
    public boolean isSupportToShare() {
        return mShareContent instanceof AudioUrl
                || mShareContent instanceof ImageBytes
                || mShareContent instanceof ImagePath
                || mShareContent instanceof ImageUrl
                || mShareContent instanceof MiniProgram
                || mShareContent instanceof Text
                || mShareContent instanceof VideoPath
                || mShareContent instanceof VideoUrl
                || mShareContent instanceof WebUrl;
    }
}
  1. ShareContent:即分享出去的内容类型,包括AudioUrl、ImageBytes、ImagePath、ImageUrl、MiniProgram、Text、WebUrl、VideoPath、VideoUrl、WebUrl等,ShareContent的子类主要作用是提供构造其必要参数的入口、内部参数校验以及各个平台的具体分享实现,下面“视频链接”分享作为示例:
public class VideoUrl extends ShareContent implements Serializable {
    @NotBlank
    private final String videoUrl;
    private String title;
    private String summary;
    private Thumbnail thumbnail;

    public VideoUrl(@NonNull String videoUrl){
        this.videoUrl = videoUrl;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public void setSummary(String summary) {
        this.summary = summary;
    }

    public void setThumbnail(Thumbnail thumbnail) {
        this.thumbnail = thumbnail;
    }

    @Override
    public boolean validate(Context context) {
        return Validator.validate(context, this);
    }

    @Override
    public void qqShare(Context context, ShareTo shareTo) {
        // not support
    }

    @Override
    public void qzoneShare(Context context, ShareTo shareTo) {
        // not support
    }

    @Override
    public void wechatShare(Context context, ShareTo shareTo) {
        WXVideoObject object = new WXVideoObject();
        object.videoUrl = videoUrl;
        WeChatShareBuilder.buildAndSent(context,
                shareTo.getAppId(context),
                SendMessageToWX.Req.WXSceneSession,
                object, title, summary, thumbnail);
    }

    @Override
    public void timelineShare(Context context, ShareTo shareTo) {
        WXVideoObject object = new WXVideoObject();
        object.videoUrl = videoUrl;
        WeChatShareBuilder.buildAndSent(context,
                shareTo.getAppId(context),
                SendMessageToWX.Req.WXSceneTimeline,
                object, title, summary, thumbnail);
    }

    @Override
    public void smsShare(Context context, ShareTo shareTo) {
        Text.sendSms(context, videoUrl);
    }
}

所有ShareContent子类都继承ShareContent,ShareContent又实现了ShareSupport,其包含了此SDK支持的分享方式接口定义,其接口方法对应每一个ShareTo,如果支持对应的分享则在ShareContent的子类实现它即可,不支持的留空或者不复写也可以,因为最终调不调用它是由ShareTo里的isSupportToShare()决定的;
构造函数传入的参数都是必要参数,其余通过setXX()提供的为非必要参数,一律如此;

  1. SDK的API入口:Share
// 弹出分享框并显示指定shareContent所支持的所有分享图标
WebUrl webUrl = new WebUrl("https://www.qq.com", "百度首页");
Share.with(Activity.this|Fragment.this).shareAll(webUrl);

// 弹出分享框并显示指定数量的ShareTo对应的分享图标
MiniProgram miniProgram = new MiniProgram("https://m.chebada.com", userName, path, thumbnail));
miniProgram.setTitle(resBody.grabShareItem.shareDescription);
miniProgram.setSummary(context.getString(R.string.train_detail_share_des));
WeChat weChat = new WeChat(miniProgram);

QQ qq = new QQ(webUrl);
Share.with(Activity.this|Fragment.this).share(weChat, qq);

// 类似share(ShareTo... shareTos)
Share.with(Activity.this|Fragment.this).share(List<ShareTo> shareTos);

// 直接唤醒第三方分享(无分享框显示)
WeChat weChat = new WeChat(webUrl);
webChat.share(context);

分享内容类型的扩充:

上面已经介绍过ShareContent的作用,也示例了其中一个子类:VideoUrl,如果要扩充其他分享内容类型,只要创建新的类并继承ShareContent即可。

分享目标类型的扩充:

上面已经介绍过ShareTo的作用,也示例了其中一个子类:WeChat,如果要扩充其他分享目标类型,只要创建新类并继承ShareTo,同时维护ShareSupport增加对应的share接口方法定义,然后在每一个ShareContent的子类中尝试实现此平台的分享。

代码实现细节参考这里

猜你喜欢

转载自blog.csdn.net/weixin_33704591/article/details/87061249