本文只是做记录和梳理流程,建议到mob官网查看最新文档,毕竟配置和API会更新
基本配置
1.申请各平台账号,获取各自的key和secret
-
mob平台注册账号,获取key、secret
这个比较容易,登录mob官网就知道怎么做了 -
项目需要接入的第三方登录平台注册账号,获取key、secret
如果是国外平台,需要翻墙;
需要注意的是,有些平台是把developer和产品使用平台分开的,不要登录错网站,然后找半天找不到key和secret,比如Facebook,不是Facebook网站,而是Facebook-developer网站;
大多数平台的流程基本一样,先创建一个app项目,指定app的一些属性 -
第三方平台的一些配置
主要是配置一些和mob平台相互关联的属性,比如配置callbackUrl,用于使用Web(也就是使用手机浏览器打开的登录授权)时的地址,比如Twitter:
其他平台属性也可以参考mob官网和各个平台自己的配置说明
2.添加依赖
在根目录,也就是项目文件直属下的build.gradle文件添加MobSdk依赖:
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
classpath "com.mob.sdk:MobSDK:2018.0319.1724"
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
3.添加插件
如果项目是组件化、模块化的,就到需要使用到mod登录功能的模块下的build.gradle文件中的头部添加:
apply plugin: 'com.mob.sdk'
4.配置MobSdk
在需要使用到mod登录功能的模块下的build.gradle文件中,与android标签同级的位置添加配置:
MobSDK {
appKey "your mob key"
appSecret "your mob secret"
ShareSDK {}
}
5.配置平台
在上述4中的ShareSDK标签中添加平台配置,将1中的获得的平台key和secret配置进来:
ShareSDK {
//平台配置信息
devInfo {
Twitter {
appKey "your Twitter key"
appSecret "your Twitter secret"
callbackUri "http://mob.com/" //使用Web登录(也就是网页登录)时的地址,需要在对应平台的后台配置,必须完全一致(包含末尾斜杠),尤其是twitter
}
Facebook {
appKey "your Facebook key" //小编试过使用appId标签,发现不行
appSecret "your Facebook secret"
callbackUri "https://mob.com" //Facebook后台有个https开关,打开的话这里必须使用https
}
}
}
这里踩过2个坑,一个是twitter平台的callbackUri,必须和后台完全一致,包括末尾斜杠;另一个是,Facebook官方配置里,key为appId,而mob刚好也有这个字段,不过这里需要使用appKey标签。
其他字段参考下面:
6.mob在项目中的初始化
和其他的开源库或第三方一样,mob选择在application中初始化。
如果没有在Manifest中设置过application的类名,则直接修改类名为 com.mob.MobApplication:
<application
android:name="com.mob.MobApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
如果有自己的application,则在自己的application的onCreate方法添加
MobSDK.init(this);
#项目中的接入
##代码:
Platform platform = ShareSDK.getPlatform(Twitter.NAME); //平台名称和上述5中的devInfo里的一样,后面接NAME,只有配置里有才会有对应的类
if (platform.isAuthValid()){ //如果需要每次使用第三方登录时清除授权状态,则加入这段代码,否则一旦登录过后,就会在后续使用时直接授权登录
platform.removeAccount(true);
}
platform.SSOSetting(false); //设置为false时,有客户端的话会直接使用客户端,否则使用Web登录授权,第一次需要用户输入账号密码
platform.setPlatformActionListener(new PlatformActionListener() { //不设置监听的话会使用普通的Toast提示登录授权结果,自己设置监听的话可以做其他操作,或者使用自己app风格的Toast来提示结果
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
//hashMap中储存很多相关的信息,不过建议使用PlatformDb,里面的信息更全,包含Token
PlatformDb platformDb = platform.getDb();
platformDb.getToken();
platformDb.getUserId();
platformDb.getUserName();
platformDb.getUserIcon();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
}
@Override
public void onCancel(Platform platform, int i) {
}
});
platform.showUser(null); //触发方法
##Facebook的特殊情况
使用Facebook登录,一旦用户授权,那么在后续的再次登录时,哪怕使用了:
if (platform.isAuthValid()){
platform.removeAccount(true);
}
程序都会直接授权登录,经过和mob官方技术人员交流后,发现Facebook官方已经做出过修改,现在一旦用户的Facebook账号授权过,那么以后都会默认对某个app授权,那么如何撤除呢?目前根据官方的答案是,用户需要到自己的Facebook账号(不是Facebook-developer)的设置处,移除已经授权的app,比较麻烦。
##混淆
ShareSDK已经做了混淆处理,再次混淆会导致不可预期的错误,请在您的混淆脚本中添加如下的配置,跳过对ShareSDK的混淆操作:
-keep class cn.sharesdk.**{*;}
-keep class com.sina.**{*;}
-keep class **.R$* {*;}
-keep class **.R{*;}
-keep class com.mob.**{*;}
-keep class m.framework.**{*;}
-keep class com.bytedance.**{*;}
-dontwarn cn.sharesdk.**
-dontwarn com.sina.**
-dontwarn com.mob.**
-dontwarn **.R$*
#结尾
后续如果有其他补充会继续更新这篇文章;
后续有时间会分享一篇使用mob进行分享的文章