ShareSdk

一款快速接入三方登录与分享的插件，旨在解决繁杂的接入流程，使用简单方便。目前已支持QQ、TIM、QQ轻聊版、微信、微博、支付宝、钉钉等

背景

之前一直在使用Mob的ShareSdk，无论是在eclipse时代还是目前的AS。但在AS上时常出现问题，它经常更新而且还下载失败，导致我每次都要用离线模式，影响使用体验。于是ShareSDK插件应运而生。

更新日志

支持微信、微博、QQ、支付宝、钉钉登录与分享

接入使用

1、project build.gradle

dependencies {
    //添加插件
     classpath "gradle.plugin.com.charles.share.sdk:share-sdk:0.0.1"
}

2、app或lib buil.gradle

apply plugin: 'com.charles.sharesdk'

shareSdk {
    debug {
        qq {
            appId = ""
            appSecret = ""
        }
        wechat {
            appId = ""
            appSecret = ""
        }
        weibo {
            appId = ""
            appSecret = ""
            url = ""
        }
        alipay {
            appId = ""
        }
        dingtalk {
            appId = ""
        }
    }
    release {
        qq {
            appId = ""
            appSecret = ""
        }
        wechat {
            appId = ""
            appSecret = ""
        }
        weibo {
            appId = ""
            appSecret = ""
            url = ""
        }
        alipay {
            appId = ""
        }
        dingtalk {
            appId = ""
        }
    }
}

需要什么平台就添加相应的配置信息，插件会自动依赖相应的aar包

3、Application

 override fun onCreate() {
    super.onCreate()
    val options = ShareOptions.Builder(this).build()
    SocialSdkApi.get().init(this, options)
}

平台的配置信息也可以通过 ShareOptions.Builder实现，提供了相应的api

如何使用

只需要很少的代码即可实现分享或登录功能,主要使用PlatformManager提供的authorize、share、shareProgram等api，详细使用可参看相应Demo

 PlatformManager.authorize(this, PlatformType.QQ, object :IAuthListener{
    override fun onComplete(platformType: String?, map: Map<String?, String?>?) {
                  
    }

    override fun onCancel(platformType: String?) {
                
    }

    override fun onError(platformType: String?, msg: String?) {
                   
    }
})

微信登录支持仅获取authCode,由后端通过code获取 access_token，只需配置onlyAuthCode为ture即可，默认false即返回access_token。微信code获取token相关文档
支付宝与钉钉只返回authCode，获取access_token 涉及参数签名检验，建议放到后端获取。支付宝登录与钉钉登录

图片分享

 PlatformManager.share(this, PlatformType.QQ, null, "/storage/emulated/0/Download/screenshot_20210107_180826.png", object :IShareListener{
    override fun onComplete(formType: String) {
                   
    }

    override fun onCancel(formType: String) {
                  
    }

    override fun onError(formType: String, errorCode: Int?, errorMsg: String?) {
                    
    }
})

网页分享

PlatformManager.share(this, PlatformType.QQ_ZONE, "哈哈", "https://www.baidu.com", "", "/storage/emulated/0/Download/screenshot_20210107_180826.png", object :IShareListener{
    override fun onComplete(formType: String) {
                   
    }

    override fun onCancel(formType: String) {
                    
    }

    override fun onError(formType: String, errorCode: Int?, errorMsg: String?) {
                    
    }
})

微信小程序

PlatformManager.shareProgram(
    this,
    PlatformType.WECHAT,
    "https://m.yxzq.com/mini/guess-stock/index.html",
    "gh_a116b4c8b2c6",
    "pages/index/index?invitationCode=84zq&nickName=***&avatar=http://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTLGqibUOngLiboAlmObZJarzDaiaU1LFoIKz5enIic05nUibsSJMwmhWXWmibianhKxwsElVbOhhlrC1cib4g/132",
    false,
    0,
    "***邀你玩热股猜涨跌，冲榜赢现金股票豪礼",
    "10万港币现金/iPhone 12 Pro / 特斯拉股票 等赛季大奖等你来抽",
    "https://jy-common-prd-1257884527.cos.ap-guangzhou.myqcloud.com/mini/guess-stock/share.png",
    object :IShareListener{
        override fun onComplete(formType: String) {
                       
        }

        override fun onCancel(formType: String) {
                       
        }

        override fun onError(formType: String, errorCode: Int?, errorMsg: String?) {
                        
        }
    }
)

自定义平台

支持自定义平台如接入手机厂商登录，只需2步

继承AbsSharePlatform

class PlatformHuaWei private constructor(context: Context?, appId: String?, platform: String) : AbsSharePlatform(context, appId, platform) {
    
    override fun authorize(activity: Activity?, authListener: IAuthListener?) {
        super.authorize(activity, authListener)
    }

    override fun share(activity: Activity?, shareMedia: IShareMedia?, shareListener: IShareListener?) {
        super.share(activity, shareMedia, shareListener)
    }

    override fun onActivityResult(activity: Activity?, requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(activity, requestCode, resultCode, data)
    }

    override fun handleIntent(intent: Activity?) {
        super.handleIntent(intent)
    }

    override fun onResp(resp: Any?) {
        super.onResp(resp)
    }

    override fun getUICallBackClass(): Class<*>? {
        return super.getUICallBackClass()
    }
}

getUICallBackClass 返回用于实现分享的透明Activity 或者需要实现回调的activity

根据实际情况重写相应方法 2. 实现IShareFactory

class PlatformHuaWei private constructor(context: Context?, appId: String?, platform: String) : AbsSharePlatform(context, appId, platform) {

    class HuaWeiShareFactory : IShareFactory {
        override fun create(context: Context?, target: String): AbsSharePlatform {
            return PlatformHuaWei(context, "appId", target)
        }

        override fun getTargetPlatform(): String {
            return "HuaWei"
        }

    }
    //其他...
}

使用静态内部类调用私有构造
插件会自动寻找实现IShareFactory的类，无需特别处理
targetform建议使用注解类

调用PlatformManager的authorize方法

PlatformManager.authorize(this, "HuaWei", object :IAuthListener{
    override fun onComplete(platformType: String?, map: Map<String?, String?>?) {
                  
    }

    override fun onCancel(platformType: String?) {
                
    }

    override fun onError(platformType: String?, msg: String?) {
                   
    }
})

混淆设置

SDK已支持混淆，不需要特别设置

License

Apache License 2.0

a741762308/ShareSdk