search

whilu / TPShareLogin

集微博、微信及 QQ 三方登录/分享功能的“轻量”库(已停止更新)
80 stars 18 forks source link

readme

TPShareLogin Build Status

集微博、微信和QQ第三方登录及分享功能的轻量库

截图

shareloginlog.png

开始

引入库

Gradle
dependencies {
    compile 'co.lujun:tpsharelogin:1.1.1'
}
本地导入
  1. 导入tpsharelogin
  2. 在项目下的 settings.gradle 文件中添加include ':tpsharelogin'
  3. 在使用该库的 module 的 build.gradle 文件中添加依赖compile project(':tpsharelogin')

配置

权限配置
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
第三方平台信息配置
<!--QQ-->
<activity
    android:name="com.tencent.tauth.AuthActivity"
    android:launchMode="singleTask"
    android:noHistory="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 需要改写此处的appId，将tencent后面xxx的改为自己申请的appId，如tencent129068312-->
        <data android:scheme="tencentxxx" />
    </intent-filter>
</activity>

<!-- Weixin-->
<activity android:name=".wxapi.WXEntryActivity"
    android:exported="true"
    android:screenOrientation="portrait"
    android:theme="@android:style/Theme.NoDisplay"/>

<!-- Weibo-->

其中WXEntryActivity位于程序包名.wxapi下，继承自co.lujun.tpsharelogin.platform.weixin.AssistActivity，如下：

package co.lujun.sample.wxapi;
import co.lujun.tpsharelogin.platform.weixin.AssistActivity;

public class WXEntryActivity extends AssistActivity {
}

使用

初始化 TPManager
TPManager.getInstance().initAppConfig("", "", "", "", "", "", "");

参数分别为微博回调地址、微博APP KEY、微博APP SECRET、QQAPPID、QQAPPSECRET、微信APPID、微信APPSECRET

登录及分享

分别提供了QQManager、WXManager和WBManager用于 QQ、微信及微博的登录与分享。设置StateListener<T>（必须）用于登录/分享回调

QQ登录及分享
QQManager qqManager = new QQManager(this);
StateListener<String> qqStateListener = new StateListener<String>() {
    @Override
    public void onComplete(String s) {
        Log.d(TAG, s);
    }

    @Override
    public void onError(String err) {
        Log.d(TAG, err);
    }

    @Override
    public void onCancel() {
        Log.d(TAG, "onCancel()");
    }
};
qqManager.setListener(qqStateListener);
//QQ登录
qqManager.onLoginWithQQ();
//QQ分享
QQShareContent contentQQ = new QQShareContent();
contentQQ.setShareType(QQShare.SHARE_TO_QQ_TYPE_DEFAULT)
        .setShareExt(QQShare.SHARE_TO_QQ_FLAG_QZONE_AUTO_OPEN);
        .setTitle("TPShareLogin Test")
        .setTarget_url("http://lujun.co")
        .setImage_url("http://lujun-wordpress.stor.sinaapp.com/uploads/2014/09/lujun-375x500.jpg")
        .setSummary("This is TPShareLogin test, 4 qq!");
qqManager.share(contentQQ);

setShareType(int param)方法:

setShareExt(int param)方法，默认对话列表且显示QZone按钮:

微信登录及分享
WXManager wxManager = new WXManager(this);
wxManager.setListener(StateListener<String> wxStateListener);
//微信登录
wxManager.onLoginWithWX();
//微信分享
WXShareContent contentWX = new WXShareContent();
contentWX.setScene(WXShareContent.WXSession)
        .setWeb_url("http://lujun.co")
        .setTitle("WebTitle")
        .setDescription("Web description, description, description")
        .setImage_url("http://lujun-wordpress.stor.sinaapp.com/uploads/2014/09/lujun-375x500.jpg")
        .setType(WXShareContent.share_type.WebPage);
wxManager.share(contentWX);

setScene(int param)方法:

微博登录及分享
WBManager wbManager = new WBManager(this);
wbManager.setListener(StateListener<String> wbStateListener);
//微博登录
wbManager.onLoginWithWB();
//微博分享
WBShareContent contentWB = new WBShareContent();
contentWB.setShare_method(WBShareContent.COMMON_SHARE)
        .setContent_type(WBShareContent.WEBPAGE)
        .setShare_type(Config.SHARE_CLIENT)
        .setStatus("This is TPShareLogin test, 4 weibo!@whilu ")
        .setImage_url("http://lujun-wordpress.stor.sinaapp.com/uploads/2014/09/lujun-375x500.jpg")
        .setTitle("title")
        .setDescription("description")
        .setActionUrl("http://lujun.co")
        .setDataUrl("http://lujun.co")
        .setDadtaHdUrl("http://lujun.co")
        .setDefaultText("default action");
wbManager.share(contentWB);

setShare_method(int param)方法，一般使用客户端进行分享:

setShare_type(int param)方法，一般不需要特别指定:

注意授权登录第三方平台返回的信息，返回的数据格式为json字符串，如下：

{
  "user_data":{
       //这里面是返回的用户数据信息
  },
  "verify_data":{
       //这里面是返回的认证信息，包括可能有的access_token、openid等(各个平台根据实际情况而定)
  }
}

更多详细使用请见Sample示例。

注意事项

依赖库冲突问题

本库使用了Retrofit v1.9.0、RxAndroid v1.0.1及RxJava v1.0.14等库，若你的项目中也使用了这些依赖库并发生了冲突，请在添加本库依赖时进行操作：

dependencies {
    compile ('co.lujun:tpsharelogin:1.0.3'){
        exclude module:'retrofit'
        exclude module:'rxjava'
        exclude module:'rxandroid'
    }
}
混淆
-keep class com.tencent.mm.opensdk.** {*;}
-keep class com.sina.**{*;}
-keep class * extends android.app.Dialog
-keep class retrofit.** { *; }
-keepattributes Signature
-keepattributes Exceptions

感谢

Change logs

1.1.1(2017-5-18)

1.1.0(2017-3-11)

1.0.4(2016-5-22)

关于

如您有任何问题，请联系我：lujun.byte#gmail.com.

License

Copyright 2015 lujun

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.