最近自己封装一个三方登录和分享功能模块,现在算是写一篇总结吧。本片博文主要讲解 QQ 登录 和 微信登录 的功能封装,如有错误,恳请斧正!
功能和要求
- 实现三方登录和三方分享功能,封装成一个独立模块
- 支持微信/QQ账号登陆
- 支持分享到 微信好友/微信朋友圈/QQ好友/QQ空间
- 接口统一, 简单易用
- 易于扩展,日后方便接入其他平台
前期准备
- 在 AS 新建一个module,填写 module 名称和最小 sdk。
- QQ登录和分享,获取 APP ID 和 APP KEY ,若未有腾讯开发者账号,需要先注册账号再获取,获取网址
- 微信登录和分享,获取 APP ID 和 AppSecret,获取地址
导入 sdk
下载 QQ sdk,下载地址
选择 Android 基础包,解压后可以看到基础包和全包说明文档,我们使用基础包即可。
将 jar 包拷贝到项目 libs 目录下
添加依赖,选择 File–>Project Structure –>Dependencies,点击右侧加号,选择 Jar dependency ,选中我们添加进来的 jar 包,选择 OK 。
- 获取微信 sdk,只需要在build.gradle文件中,添加如下依赖即可:
compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'
- 接收微信的请求和返回值
- 在你的包名相应目录下新建一个wxapi目录,并在该wxapi目录下新增一个WXEntryActivity类,该类继承自Activity(例如应用程序的包名为net.sourceforge.simcpux,则新添加的类如下图所示), 并在manifest文件里面加上exported属性,设置为true,如下所示:
- 在你的包名相应目录下新建一个wxapi目录,并在该wxapi目录下新增一个WXEntryActivity类,该类继承自Activity(例如应用程序的包名为net.sourceforge.simcpux,则新添加的类如下图所示), 并在manifest文件里面加上exported属性,设置为true,如下所示:
- 实现IWXAPIEventHandler接口,微信发送的请求将回调到onReq方法,发送到微信请求的响应结果将回调到onResp方法,在WXEntryActivity中将接收到的intent及实现了IWXAPIEventHandler接口的对象传递给IWXAPI接口的handleIntent方法。
public class WXEntryActivity extends Activity implements IWXAPIEventHandler {
private static final String TAG = "WXEntryActivity";
// IWXAPI 是第三方app和微信通信的openapi接口
private IWXAPI api;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
api = WXAPIFactory.createWXAPI(this, Constant.WX_APP_ID, false);
//注意:
//第三方开发者如果使用透明界面来实现WXEntryActivity,需要判断handleIntent的返回值,如果返回值为false,
// 则说明入参不合法未被SDK处理,应finish当前透明界面,避免外部通过传递非法参数的Intent导致停留在透明界面,引起用户的疑惑
try {
boolean handleIntent = api.handleIntent(getIntent(), this);
Log.i(TAG,"onCreate handleIntent:" + handleIntent);
if(!handleIntent){
finish();
}
} catch (Exception e) {
e.printStackTrace();
}
}
实现思路
QQ 登录
QQ 登录结构如下所示
QQ 登录结构说明
- 对于 ThirdPlatformLoginController 使用者来说,他们不关心登录走到哪一步骤,只需要知道调用登录接口方法和登录结果。
- 在我们新建 module 新建ThirdPlatformLoginUtil 工具类,它只对外界提供登录接口,使用者无需知道登录操作细节。
- 获取 Token 信息必须依赖 Activity,新建 UiControlActivity ,重写 onActivityResult( ) 方法,否则无法收到 QQ 回调信息。