https://github.com/devzwy/socialhelper
SocialHelper 可以帮你快速完成国内以及国外很多平台的授权登录、分享功能。全部采用三方平台最新的Api实现；平台太多需要慢慢迭代上去，个人精力有限，已停更。需要更新SDK的需要自己fork一下去更新。
https://github.com/devzwy/socialhelper
alipay android google wechat
Last synced: 8 months ago
JSON representation
SocialHelper 可以帮你快速完成国内以及国外很多平台的授权登录、分享功能。全部采用三方平台最新的Api实现；平台太多需要慢慢迭代上去，个人精力有限，已停更。需要更新SDK的需要自己fork一下去更新。
- Host: GitHub
- URL: https://github.com/devzwy/socialhelper
- Owner: devzwy
- License: apache-2.0
- Archived: true
- Created: 2022-05-17T10:36:57.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-06-08T12:45:17.000Z (about 4 years ago)
- Last Synced: 2025-01-31T03:31:38.513Z (over 1 year ago)
- Topics: alipay, android, google, wechat
- Language: Kotlin
- Homepage:
- Size: 4.14 MB
- Stars: 12
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SocialHelper
[SocialHelper](https://github.com/devzwy/SocialHelper) 可以帮你快速完成国内以及国外很多平台的授权登录、分享功能。全部采用三方平台最新的Api实现；平台太多需要慢慢迭代上去，我会一直维护这个库。
由于该类型库的测试太麻烦，欢迎小伙伴们与我一起维护该库，**wdsf.top@gmail.com**与我联系，帮忙测试自己拥有的平台。
Visit Count（from 2022/05/22）
## 致谢参与测试的用户
[ailala](https://github.com/ailalay/ailalay.github.io)
## 待办
- [x] 🎉 微信平台 **授权**、**获取用户资料**、**分享**[支持文本、图片、音乐、视频、网页、小程序]
- [x] 🎉 支付宝平台 **授权**、**分享**[支持文本、图片、网页]
- [x] 💃🏻 Google **授权**、**获取用户资料**
- [x] 🚑 Line **授权**、**获取用户资料**
- [ ] 📝 钉钉
- [ ] 📝 企业微信
- [ ] 📝 QQ
- [ ] 📝 微博
## demo效果图
[演示效果](https://download.wdsf.top/dev/video/show.mp4)
[点击下载已签名demo](https://download.wdsf.top/dev/apk/socialhelper.apk)
## 如何使用
**注意**：__由于该类SDK二次封装的特殊性，Demo是无法直接运行看到结果的，具体请参考Api说明。或者下载打包好的Apk测试__
#### 1.引入依赖 [](https://github.com/devzwy/SocialHelper)
> 下面的版本号(1.0.0)换成上面图片中的最新版本(**去掉v**)
> 点击Sync Now
```
//必选
implementation("io.github.devzwy:socialhelper:1.0.7")
//微信平台 可选 需要时集成
implementation('com.tencent.mm.opensdk:wechat-sdk-android:6.8.0')
implementation("io.github.devzwy:socialhelper.wechat:1.0.7"){
transitive = false
}
//支付宝平台 可选 需要时集成
implementation("io.github.devzwy:socialhelper.alipay:1.0.7"){
transitive = false
}
//Google平台 可选 需要时集成
implementation("com.google.android.gms:play-services-auth:20.2.0")
implementation("io.github.devzwy:socialhelper.google:1.0.7"){
transitive = false
}
//Line平台 可选 需要时集成
implementation("com.linecorp.linesdk:linesdk:5.8.0")
implementation("io.github.devzwy:socialhelper.line:1.0.7"){
transitive = false
}
```
#### 2.初始化
> 别忘了在AndroidManifest.xml注册自己的Application~
```
class MyApplication:Application() {
override fun onCreate() {
super.onCreate()
SocialHelper.init(SocialConfig.buildSocialConfig(this) {
enableLog()
enableWeChatPlatform("微信AppId", "微信secretKey(可选)")
enableAlipayPlatform("支付宝AppId", "支付宝商户号", "支付宝应用私钥")
enableGooglePlatform("Google客户端Id clientId")
enableLinePlatform("Line AppId")
..
})
}
}
```
#### 3.[各平台还需要完成的必须工作](https://github.com/devzwy/SocialHelper/blob/main/PlatformInfo.md)
## Api列表
#### 微信
- 获取微信accessToken
```
SocialHelper.reqWeChatAuth()
```
- 获取微信用户资料
```
SocialHelper.getWeChatUserInfo()
```
- 分享到微信
```
//分享文本 其他分享参考该Api
SocialHelper.shareTextToWeChat(
weChatShareType: WeChatShareType, //WeChatShareType.SCENE_SESSION WeChatShareType.SCENE_TIMELINE WeChatShareType.SCENE_FAVORITE
text: String, //内容
description: String, //描述
onShareSuccess: (() -> Unit)? = null,
onShareError: ((String) -> Unit)? = null
)
//分享图片
SocialHelper.shareImageToWeChat()
//分享音乐
SocialHelper.shareMusicToWeChat()
//分享视频
SocialHelper.shareVideoToWeChat()
//分享网页
SocialHelper.shareWebPageToWeChat()
//分享小程序
SocialHelper.shareMiniProgramToWeChat()
```
#### 支付宝
- 获取支付宝授权码
```
SocialHelper.reqAliPayAuth(this, true, {
appendLog(it)
}, {
alipayResultSubData->
alipayResultSubData.auth_code
appendLog(it.toJsonStr())
})
```
- 分享到支付宝
```
//分享文本 其他分享参考该Api
SocialHelper.shareTextToAlipay(
text: String,//内容
onShareSuccess: (() -> Unit)? = null,
onShareError: ((String) -> Unit)? = null
)
//分享图片
SocialHelper.shareImageToAlipay()
//分享网页 会自动出现生活圈选项
SocialHelper.shareWebPageToAlipay()
```
#### Google
- 获取Google授权码
```
SocialHelper.reqGoogleAuth(this, {
appendLog(it)
}, {
//你要的东西应该在这个里面
this.mGoogleSignInAccount = it
appendLog(it.toJsonStr())
btGetUserInfo.isEnabled = true
})
```
- 获取用户资料(授权返回数据读取)
```
this.mGoogleSignInAccount?.let {
//演示 从对象取出对应用户资料
appendLog("personName:${it.displayName}")
appendLog("personGivenName:${it.givenName}")
appendLog("personFamilyName:${it.familyName}")
appendLog("personEmail:${it.email}")
appendLog("personId:${it.id}")
appendLog("personPhoto:${it.photoUrl}")
}
```
- 退出google登录并作废获取的signInAccount
```
SocialHelper.signOut()
```
#### Line
- 获取授权
```
SocialHelper.reqLineAuth(this, {
appendLog(it)
}, {
//你要的东西应该在这个里面
this.mLineLoginResult = it
appendLog(it.toJsonStr())
btGetUserInfo.isEnabled = true
})
```
- 获取用户资料(授权返回数据读取)
```
this.mLineLoginResult?.lineProfile?.let {
//演示 从对象取出对应用户资料
appendLog("displayName:${it.displayName}")
appendLog("userId:${it.userId}")
appendLog("pictureUrl:${it.pictureUrl}")
}
```