SocialSdkLibrary
1.2.0
Neueste Version (1.2.0) Einfacher, leichter, geschäftsorientierter
Mit dem Designziel, einfacher, leichter und stärker auf Geschäftsanforderungen ausgerichtet zu sein, bietet es Unterstützung für Anmelde- und Freigabefunktionen für Weibo , WeChat , QQ , Tim , die QQ-Chat-Version und DingTalk .
Projektadresse: GitHub – SocialSdkLibrary
Blog-Adresse: Schneller Zugriff auf die native Anmeldung und Freigabe von WeChat, Weibo, QQ und DingTalk
? Die WeChatQQWeibo SDK-Version kann aktualisiert werden. Wenn die nächste Version aktualisiert wird, wird Weibo größere Änderungen erfahren.
?362 am 21.01.2020, veröffentlichte Version 1.2.0 , Plug-in-Update, unterstützt die neueste Version von Gradle , verwendet Gradle + APT + ASM um Platform automatisch zu erkennen, registriert den Initialisierungscode automatisch json -Analyse und http Anforderungen, Initialisierungskonfiguration ist einfacher;
? 2019.6.13 WeChat-Scancode-Anmeldung unterstützen
?Am 28. Mai 2019 erhielt das Projekt den 329.?, verwaltete automatisch den Lebenszyklus, vereinheitlichte die Rückrufparameter und veröffentlichte die stabile Version 1.0.1 ❤️,
? 2019.3.28 Verwenden Sie gradle plugin , um Abhängigkeiten automatisch zu verwalten, die Versionsnummer neu zu gestalten, stabile Version 0.1.1 ❤️
27.12.2018 Abgeschlossenes gradle -Plugin, geteilte Plattform, automatisierte Abhängigkeiten, ein neues Level?
? 21.12.2018 Bereits 225?, ich bereite mich auf die Aufteilung in verschiedene Plattformbibliotheken vor, um einen flexiblen Zugriff zu ermöglichen⛽️
?Am 26. September 2018 erhielt das Projekt den 202. Stern. Danke an die neuen Kollegen für die Ergänzung um 2 Sterne.
?Am 7. Juni 2018 erhielt das Projekt den 100. Stein?, und der letzte war der, um den ich meine Kollegen gebeten habe?
? 2018.5.12 Speicherproblem behoben und Funktion auf stabile Version 1.1.0 erweitert ❤️
? 2018.2.12 DingTalk-Freigabe unterstützen?
? 12.12.2017 Einfaches Refactoring des Codes und Testen der stabilen Version 1.0.0 ❤️
Open Source: keine Ostereier, keine Ostereier, keine Ostereier;
Ganz einfach: Sie müssen nur auf die Anmeldung, die Freigabeverwaltungsklasse und ein Datenstrukturobjekt achten und müssen nicht auf die Unterschiede zwischen den Plattformen achten.
Leichtgewichtig: Es enthält nur SDK von Drittanbietern und ein einfaches asynchrones Framework (38 KB). Netzwerkanforderungen und JSON Analyse werden von außen eingefügt, wodurch redundante Abhängigkeiten reduziert und ein hohes Maß an Einheit mit dem Hostprojekt sichergestellt werden.
Umfassend: Teilen von Miniprogrammen, Kopieren von Links, Scannen von QR-Codes zum Anmelden, Förderung des intermodalen Transports usw.;
Bedarfsgerechte Gestaltung:
code nur lokal und der Server erhält token ?wxOnlyAuthCode -Parameter.web Sharing.Intent , um die gemeinsame Nutzung zu aktivieren, z. B. die Unterstützung der lokalen Videofreigabe, qq Nur-Text-Freigabe usw.;token dauerhaft, um Mehrfachautorisierungen zu vermeiden. Bei der nächsten Autorisierung können die Daten jedoch nicht geändert werden Der Zeitaufwand sollte sorgfältig abgewogen werden;SocialSdk . SCHRITT 1 : Plugin-Abhängigkeitspfad hinzufügen
project/build.gradle
buildscript {
repositories {
maven { url "https://dl.bintray.com/zfy/maven" }
}
dependencies {
// 请查看文初最新版本，这边可能忘记更新！！！
classpath 'com.zfy.social:social-sdk-plugin:1.2.0'
}
}
allprojects {
repositories {
maven { url "https://dl.bintray.com/zfy/maven" }
}
}SCHRITT 2 : Konfigurationsparameter
app/build.gralde
Aus Sicherheitsgründen wird empfohlen, es in local.properties zu konfigurieren, um eine Übermittlung an das Remote-Ende zu vermeiden;
// 在顶部引用插件
apply plugin: 'socialsdk'
// android 配置模块
android {
...
}
// socialsdk 配置模块
socialsdk {
wx {
appId = '111xxx2222'
appSecret = '111xxx2222'
// 微信授权是否只返回 code, 用于服务端授权的场景
onlyAuthCode = false
}
qq {
appId = '111xxx2222'
appSecret = '111xxx2222'
}
wb {
appId = '111xxx2222'
url = '111xxx2222'
}
dd {
appId = '111xxx2222'
}
}Das Obige ist die einfachste Konfiguration. Weitere Konfigurationsparameter finden Sie in der Standardkonfiguration:
socialsdk {
// 调试模式，默认 false, 可以在代码中开启
debug = true
// 分享：选择停留在微信时自动返回成功，默认返回失败
shareSuccessIfStay = true
// 登录：token 过期时间，单位小时，默认立即过期，有效期内可以不需要再次唤醒第三方 app，但是二次登录也没办法切换账号，这会引发问题，所以默认立即过期
tokenExpiresHours = 100
// 使用 gson 作为数据解析，默认 true，你如果不用 gson 就需要自己编写 JSONAdapter
useGson = true
// 使用 okHttp 发送请求，默认 true,你如果不用 okhttp 就需要自己编写 RequestAdapter
useOkHttp = true
// 配置 app 名称，默认使用 R.string.app_name
appName = "哈哈哈"
// 唤醒过程中的 loading 颜色
color = "#FF0000"
wx { }
qq { }
wb { }
dd { }
}SCHRITT 3 : Initialisierung
SocialOptions options = new SocialOptions . Builder ( this )
// 调试模式，开启 log 输出
. debug ( true )
// 加载缩略图失败时，降级使用资源图
. failImgRes ( R . drawable . share_default_img )
// 添加分享拦截器，重新处理分享的数据
. addShareInterceptor (( context , obj ) -> {
obj . setSummary ( "被重新组装" + obj . getSummary ());
return obj ;
})
// 构建
. build ();
// 初始化
SocialSdk . init ( options );Die Anmeldefunktion unterstützt drei Plattformen: QQ, WeChat und Weibo;
// 3个平台
Target . LOGIN_QQ ; // QQ 登录
Target . LOGIN_WX ; // 微信 登录
Target . LOGIN_WX_SCAN ; // 微信扫码 登录
Target . LOGIN_WB ; // 微博 登录Bei der Anmeldung wird LoginResult zurückgegeben, das hauptsächlich aus drei Teilen besteht: Anmeldetyp, grundlegende Benutzerinformationen und Token-Informationen.
LoginResult {
// 状态，成功，失败，取消等
public int state ;
// 目标平台
public int target ;
// 发生错误时使用
public SocialError error ;
// 针对登录类型可强转为 WbUser,WxUser,QQUser 来获取更加丰富的信息
public SocialUser socialUser ;
// 本次登陆的 token 信息，openId, unionId,token,expires_in
public AccessToken accessToken ;
// 授权码，如果 onlyAuthCode 为 true, 将会返回它
public String wxAuthCode ;
// 扫码登录二维码文件路径
public String wxCodePath ;
}Beim Anmelden müssen Sie einen Login-Rückruf festlegen:
new OnLoginStateListener () {
@ Override
public void onState ( Activity act , LoginResult result ) {
switch ( result . state ) {
case LoginResult . STATE_START :
// 登录开始
break ;
case LoginResult . STATE_COMPLETE :
// 登录完成
break ;
case LoginResult . STATE_ACTIVE :
// 透明 Activity 开启
break ;
case LoginResult . STATE_SUCCESS :
// 登录成功
break ;
case LoginResult . STATE_FAIL :
// 登录失败
result . error
break ;
case LoginResult . STATE_CANCEL :
// 登录取消
break ;
case LoginResult . STATE_WX_CODE_RECEIVE :
// 获取到微信登录二维码
break ;
case LoginResult . STATE_WX_CODE_SCANNED :
// 微信登录二维码被扫描
break ;
}
}
};Weitere Benutzerinformationen erhalten Sie:
SocialUser socialUser = loginResult . socialUser ;
// 基本信息可以从 SocialUser 在获取到
String userNickName = socialUser . getUserNickName ();
// 获取 openId
String openId = socialUser . getOpenId ();
// 微信获取 unionId，其他平台仍旧返回 openId
String unionId = socialUser . getUnionId ();
// 获取 userId，微信返回 unionId, 其他平台返回 openId
String userId = socialUser . getUserId ();
// 强转为平台用户，可以拿到更多信息
int target = result . getTarget ();
switch ( target ) {
case Target . LOGIN_QQ :
QQUser qqUser = ( QQUser ) socialUser ;
break ;
case Target . LOGIN_WB :
WbUser wbUser = ( WbUser ) socialUser ;
break ;
case Target . LOGIN_WX :
WxUser wxUser = ( WxUser ) socialUser ;
break ;
}Anmeldung einleiten:
LoginManager . login ( mActivity , Target . LOGIN_QQ , listener );Melden Sie sich mit Parametern an, z. B. dem Scannen des WeChat-QR-Codes, um sich anzumelden:
LoginObj obj = new LoginObj ();
// 根据文档要求，以下数据应在服务端缓存获取
// 如果不设置，将会使用配置时设置的 secret
obj . setAppSecret ( "0a3cb00******ee3654f499171" );
obj . setNonceStr ( "3611cdc33b******a49ca45bdfab2d" );
obj . setTimestamp ( "15604******6904" );
obj . setSignature ( "b28f69426******18c8ba792caa4a0a1bcc" );
// 如果不设置，将会使用 SocialValues.WX_SCOPE
obj . setScope ( SocialValues . WX_SCOPE );
LoginManager . login ( mActivity , Target . LOGIN_WX_SCAN , obj , listener ); Bezüglich token Alterung können Sie tokenExpiresHours während der Initialisierung festlegen, um dies zu steuern. Es bietet auch eine Methode zum Löschen des token .
// 清除全部平台的 token
LoginManager . clearAllToken ( context );
// 清除指定平台的 token
LoginManager . clearToken ( context , Target . LOGIN_QQ );Wichtig: Bitte prüfen Sie sorgfältig die Unterstützungsmöglichkeiten zwischen Plattformen und Datentypen
Wenn Weibo openApi zum Teilen verwendet, kann es zu einer langen Verzögerung kommen. Es wird empfohlen, im Lebenszyklus eine Fortschrittsbalkenanzeige hinzuzufügen, um zu vermeiden, dass Benutzer lange warten, ohne zu antworten.
Für die Geschäftslogik und SDK Design werden gemeinsam genutzte Datentypen in sieben Typen unterteilt, die die meisten Geschäftsszenarien abdecken können, nämlich:
开启 App 类型，打开渠道应用；
文字类型，纯文本分享；
图片类型(jpg, png, gif(要求能动))；
App 推广类型；
网页链接类型；
音频分享类型；
视频分享类型； Um sicherzustellen, dass jede Plattform ein geschlossenes und einheitliches Erscheinungsbild hat, wird stattdessen web Sharing verwendet, wenn eine Plattform nicht mit einer bestimmten Art des Teilens kompatibel ist. WeChat unterstützt beispielsweise kein app -Sharing, der web -Sharing-Modus jedoch nach dem Teilen verwendet werden.
// 支持的分享渠道
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 ; // 新浪微博
Target . SHARE_SMS ; // 短信分享
Target . SHARE_EMAIL ; // 邮件分享
Target . SHARE_CLIPBOARD ; // 粘贴板分享 Bei der Freigabe müssen wir zunächst die Daten für die Freigabe erstellen. Das ShareObj -Objekt bietet eine Vielzahl statischer Methoden, um schnell Objekte zu erstellen, die der Art der Freigabe entsprechen.
// 测试用的路径
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/test/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 );
// 本地视频分享、部分平台支持
ShareObj videoLocalObj = ShareObj . buildVideoObj ( "分享本地视频" , "summary" , localImagePath , targetUrl , localVideoPath , 0 );
// 分享音乐
ShareObj musicObj = ShareObj . buildMusicObj ( "分享音乐" , "summary" , localImagePath , targetUrl , netMusicPath , 10 );Verwenden Sie die erweiterte Parameterunterstützung für einige Parameter, die nicht vereinheitlicht werden können:
// 使 ShareObj 支持短信分享
webObj . setSmsParams ( "13611301719" , "说啥呢" );
// 使 ShareObj 支持粘贴板分享
webObj . setClipboardParams ( "复制的内容" );
// 使 ShareObj 支持邮件分享
webObj . setEMailParams ( "[email protected]" , "主题" , "内容" );
// 使 ShareObj 在微信平台优先使用小程序分享
webObj . setWxMiniParams ( "51299u9**q31" , SocialValues . WX_MINI_TYPE_RELEASE , "/page/path" ); Verwenden Sie OnShareStateListener als Listening-Sharing-Rückruf.
new OnShareStateListener () {
@ Override
public void onState ( Activity act , ShareResult result ) {
switch ( result . state ) {
case LoginResult . STATE_START :
// 分享开始
break ;
case LoginResult . STATE_COMPLETE :
// 分享完成
break ;
case LoginResult . STATE_ACTIVE :
// 透明 Activity 开启
break ;
case ShareResult . STATE_SUCCESS :
// 分享成功
break ;
case ShareResult . STATE_FAIL :
SocialError e = result . error ;
// 分享失败
break ;
case ShareResult . STATE_CANCEL :
// 分享取消
break ;
}
}
}; // 唤醒分享
ShareManager . share ( mActivity , Target . SHARE_QQ_FRIENDS , imageObj , mOnShareListener ); In Bezug auf das Umschreiben des Freigabeobjekts bietet es tatsächlich die Möglichkeit, ShareObj , das vor der Freigabe freigegeben werden muss, einheitlich zu verarbeiten, was einem Aspekt der Freigabefunktion ähnelt, wie zum Beispiel dem folgenden Szenario:
app Wasserzeichen muss dem Bild hinzugefügt werden, bevor es geteilt werden kann.url enthält öffentliche Parameter wie shareId usw. und Zugriffsstatistiken werden in H5 erstellt. Um gemeinsam genutzte Objekte neu zu schreiben, verwenden wir Interceptoren, wenn SDK initialisiert wird. Es werden mehrere Interceptoren unterstützt, und alle Interceptoren werden nacheinander aufgerufen.
UI müssen Sie ihn im Hauptthread ausführen.
SocialOptions options = new SocialOptions . Builder ( this )
// ... 其他初始化代码
// 添加分享拦截器
. addShareInterceptor (( context , target , obj ) -> {
obj . setSummary ( "描述加前缀" + obj . getSummary ());
return obj ;
})
. addShareInterceptor (( context , target , obj ) -> {
obj . setTargetUrl ( obj . getTargetUrl ()+ "?id=100" );
return obj ;
})
// 构建
. build ();
// 初始化
SocialSdk . init ( options ); Beim Teilen stoßen wir normalerweise auf Anforderungen, z. B. das Kopieren in das Pasteboard/die Unterstützung der SMS-Freigabe/die Unterstützung der E-Mail-Freigabe usw. SocialSdk verfügt über integrierte Funktionen, und nach der Erstellung ShareObj müssen zusätzliche Parameter hinzugefügt werden, um sie zu implementieren.
shareObj . setSmsParams ( "13611301719" , "说啥呢" ); shareObj . setEMailParams ( "[email protected]" , "主题" , "内容" ); shareObj . setClipboardParams ( "复制的内容" );Unterstützen Sie die WeChat-Applet-Freigabe, auch unter Verwendung zusätzlicher Parameter
shareObj . setWxMiniParams ( "51299u9**q31" , SocialValues . WX_MINI_TYPE_RELEASE , "/page/path" ); Um die bei Fehlern zurückgegebenen Ausnahmen besser zu vereinheitlichen und zu teilen, verfügen alle zurückgegebenen Ausnahmen über einen code , der Probleme lokalisieren und benutzerfreundlichere Eingabeaufforderungen basierend auf unterschiedlichen code geben kann.
int CODE_COMMON_ERROR = 101 ; // 通用错误，未归类
int CODE_NOT_INSTALL = 102 ; // 没有安装应用
int CODE_VERSION_LOW = 103 ; // 版本过低，不支持
int CODE_SHARE_BY_INTENT_FAIL = 105 ; // 使用 Intent 分享失败
int CODE_STORAGE_READ_ERROR = 106 ; // 没有读存储的权限，获取分享缩略图将会失败
int CODE_STORAGE_WRITE_ERROR = 107 ; // 没有写存储的权限，微博分享视频copy操作将会失败
int CODE_FILE_NOT_FOUND = 108 ; // 文件不存在
int CODE_SDK_ERROR = 109 ; // sdk 返回错误
int CODE_REQUEST_ERROR = 110 ; // 网络请求发生错误
int CODE_CANNOT_OPEN_ERROR = 111 ; // 无法启动 app
int CODE_PARSE_ERROR = 112 ; // 数据解析错误
int CODE_IMAGE_COMPRESS_ERROR = 113 ; // 图片压缩失败
int CODE_PARAM_ERROR = 114 ; // 参数错误
int CODE_SDK_INIT_ERROR = 115 ; // SocialSdk 初始化错误
int CODE_PREPARE_BG_ERROR = 116 ; // 执行 prepareOnBackground 时错误
int CODE_NOT_SUPPORT = 117 ; // 不支持Sie können zum Beispiel Folgendes tun:
listener = new OnShareStateListener () {
@ Override
public void onState ( Activity act , ShareResult result ) {
switch ( result . state ) {
case ShareResult . STATE_FAIL :
SocialError e = result . error ;
showMsg ( "分享失败 " + e . toString ());
// 如下因为没有存储权限导致失败，请求权限
if ( Build . VERSION . SDK_INT >= Build . VERSION_CODES . M ) {
if ( e . getCode () == SocialError . CODE_STORAGE_READ_ERROR ) {
requestPermissions ( new String []{ Manifest . permission . READ_EXTERNAL_STORAGE }, 100 );
} else if ( e . getCode () == SocialError . CODE_STORAGE_WRITE_ERROR ) {
requestPermissions ( new String []{ Manifest . permission . WRITE_EXTERNAL_STORAGE }, 100 );
}
}
break ;
}
}
}; public class HuaweiPlatform extends AbsPlatform {
// 工厂函数
public static class Factory implements PlatformFactory {
@ Override
public IPlatform create ( Context context , int target ) {
return new HuaweiPlatform ( context , null , null , target );
}
@ Override
public int getPlatformTarget () {
return PLATFORM_HUAWEI ;
}
@ Override
public boolean checkShareTarget ( int shareTarget ) {
return false ;
}
@ Override
public boolean checkLoginTarget ( int loginTarget ) {
return loginTarget == LOGIN_HUAWEI ;
}
}
public HuaweiPlatform ( Context context , String appId , String appName , int target ) {
super ( context , appId , appName , target );
}
}Das Wichtigste ist, die Werksfunktion der Plattform zu schreiben. Das Framework erkennt sie automatisch und registriert sie im System. Eine manuelle Registrierung ist nicht erforderlich.
SocialSdk verwaltet den Lebenszyklus intern automatisch. Nach Abschluss Activity Anmeldefreigabe wird empfohlen, LifecycleOwner AppCompatActivity direkt zu verwenden und den Lebenszyklus zu binden intern, um das Auftreten von Speicherlecks zu vermeiden;
FQ:
libs/open_sdk_r2973327_lite.jar aktualisiert mit 2019.12WeChat:
com.tencent.mm.opensdk:wechat-sdk-android-without-mta:5.5.8 aktualisiert mit 2020.1.22Weibo:
com.sina.weibo.sdk:core:4.3.7:openDefaultRelease@aarDingTalk:
com.alibaba.android:ddsharesdk:1.1.0
