概述
ShareLoginLib是一个可以使用第三方登录以及分享的库，以下解决几个关于源码的问题。
本文解决以下问题
- 代码执行的流程，如何进行的分享或登录。
- 需要分享得内容有很多种，他是如何兼顾的。
- 初始化的时候干了什么
- 分享过程中干了什么
- 分享成功还是失败如何知道
- 整个代码的流程以及框架
先来一张流程图了解一下大致的使用：
流程图.png
-
ShareContent接口
分享的内容接口，所有的分享内容类都需要实现该接口，然后通过type来说明具体是什么类型
int TEXT = 1, PIC = 2, WEBPAGE = 3, MUSIC = 4;
public interface ShareContent {
int NO_CONTENT = 31415926;
/**
* @return 分享的方式
*/
@ShareContentType
int getType();
/**
* 分享的描述信息(摘要)
*/
default String getSummary() {
return null;
}
/**
* 分享的标题
*/
default String getTitle() {
return null;
}
/**
* 获取跳转的链接
*/
default String getURL() {
return null;
}
/**
* 分享的缩略图片
*/
default byte[] getThumbBmpBytes() {
return null;
}
/**
* 分享的大图地址
*/
default String getLargeBmpPath() {
return null;
}
/**
* 音频url
*/
default String getMusicUrl() {
return null;
}
}
-
OAuthUserInfo:
字段：nickName，sex，headImgUrl，userId -
ShareListener/LoginListener implements IBaseListener
处理分享后的回调，具体实现登录以及分享的方法中需要传入ShareListener/LoginListener的实例，由业务层实现相应失败或成功等状态需要做的处理。 -
ShareLoginLib
核心分享类，起到调度作用，个人理解使用了外观模式
构造时需要传入Map<String , String> mValueMap以及List<Class<? Extends Iplatform>> supportPlatforms;
public static void initPlatforms(Map<String, String> keyValue, List<Class<? extends IPlatform>> platforms) {
sValueMap = keyValue;
supportPlatforms = platforms;
}
核心操作doShare和doLog方法都由doAction（）方法实现
doAction（）方法会传入当前Activity，判断是否是登陆操作的flag，分享的目标String type ， 分享的内容ShareContent，以及LoginListener和ShareListener。
doAction（）方法中
-
首先会创建ArrayList包含目前支持的平台，
-
然后根据传入的type在supportPlatforms中遍历匹配一个目标平台。
-
之后会调用各个平台类xxxxPlatform.checkEnvironment()检测当前运行环境查看是否正常。
-
启动辅助的Activity执行最终的具体操作，会调用具体的xxxxPlatform.doLogin或doShare方法
private static void doAction(Activity activity, boolean isLoginAction, @NonNull String type, @Nullable ShareContent content,
LoginListener loginListener, ShareListener shareListener) {
// 1. 得到目前支持的平台列表
ArrayList<IPlatform> platforms = new ArrayList<>();
for (Class<? extends IPlatform> platformClz : supportPlatforms) {
platforms.add(SlUtils.createPlatform(platformClz));
}
// 2. 根据type匹配出一个目标平台，最终调用这个具体平台的方法
@Nullable IPlatform curPlatform = null;
for (IPlatform platform : platforms) {
for (String s : platform.getSupportedTypes()) {
if (s.equals(type)) {
curPlatform = platform;
break;
}
}
}
// 3. 初始化监听器
if (loginListener == null) {
loginListener = new LoginListener();
}
if (shareListener == null) {
shareListener = new ShareListener();
}
// 4. 检测当前运行环境，看是否正常
try {
if (curPlatform == null) {
throw new UnsupportedOperationException("未找到支持该操作的平台，当前的操作类型为：" + type);
} else {
curPlatform.checkEnvironment(activity, type, content != null ? content.getType() : ShareContent.NO_CONTENT);
}
} catch (Throwable throwable) {
if (isLoginAction) {
loginListener.onError(throwable.getMessage());
} else {
shareListener.onError(throwable.getMessage());
}
return;
}
// 5. 启动辅助的activity，最终执行具体的操作
final LoginListener finalLoginListener = loginListener;
final ShareListener finalShareListener = shareListener;
final IPlatform finalCurPlatform = curPlatform;
ShareLoginLib.onCreateListener = eventActivity -> {
if (isLoginAction) {
finalCurPlatform.doLogin(eventActivity, finalLoginListener);
} else {
assert content != null;
finalCurPlatform.doShare(eventActivity, type, content, finalShareListener);
}
};
activity.startActivity(new Intent(activity, EventHandlerActivity.class));
activity.overridePendingTransition(android.R.anim.fade_in, android.R.anim.fade_out);
wrPlatform = new WeakReference<>(curPlatform);
}
-
IPlatForm接口
定义平台特性，需要实现doShare，doLogin以及onResponse，getUserInfo，checkEnviroment，isAppInstalled等方法。官方已经实现了微博，QQ，微信三个常用平台，如果还需要再添加平台的话需要自己创建Platform类实现IPlatForm接口。
不同的平台对应三个类，一个platform类实现IPlatForm，一个LoginHelper类和一个ShareHelper类。
Platform类 中实现实际的share和login操作如下代码：
@Override
public void doShare(Activity activity, String shareType, @NonNull ShareContent shareContent, @NonNull ShareListener listener) {
uiListener = new LoginHelper.AbsUiListener(listener) {
@Override
public void onComplete(Object o) {
listener.onSuccess();
}
};
Tencent tencent = getTencent(activity);
if (shareType.equals(FRIEND)) {
tencent.shareToQQ(activity, ShareHelper.qqFriendBundle(shareContent), uiListener);
} else {
// 因为空间不支持分享单个文字和图片，在这里对于单个图片做了额外的处理，让其走发布说说的api
if (shareContent.getType() == ShareContentType.TEXT || shareContent.getType() == ShareContentType.PIC) {
tencent.publishToQzone(activity, ShareHelper.publishToQzoneBundle(shareContent), uiListener);
} else {
tencent.shareToQzone(activity, ShareHelper.zoneBundle(shareContent), uiListener);
}
}
}
LoginHelper类
主要的作用就是想服务器发送给等登录请求，对服务器返回的信息做解析，具体的网络请求由Utils包中的类来实现。提供GetUserInfo等方法获取用户信息。
ShareHelper类
通过构建Bundle、Intent或具体要分享得平台所提供的信息体来将要传输的数据包裹，然后在对应的platform类中通过腾讯或者微博等平台提供的方法发送数据。
网友评论