Android- 友盟社会化分享【5.0版本集成文档】

前言：
之前有写过一篇友盟社会化分享的文章，是基于4.3版本SDK的。昨天在APP里面加入友盟的社会化分享功能， 去友盟官网查了一下， 发现最新版本的SDK已经更新到5.0，而且相对于之前4.3版本有了很大的改变，所以就想简单的做个总结。

友盟官方文档：http://dev.umeng.com/social/android/android-update

1. 产品概述【简单阐述一下新版本的特性】

关于分享和授权的sdk接口，我们在v5.0做出了巨大的改变，精简了接口调用的代码。并将分享授权，与评论等功能做出了隔离，使结构更加清晰。所以本版本的功能也只有分享与授权并无其他功能，请开发者注意。

注意：本文示例代码只有分享与授权功能，并对接口进行了调整，如需要原功能的开发者，请继续使用v4.3.0版本。

2. 获取友盟Appkey
如果你之前已经在友盟注册了应用，并获取到了Appkey，可以继续使用它.

如果你尚未在友盟注册开发者账号，需要先注册，注册之后登录你的账号，点击添加新应用，填写完应用基本信息后，将进入”下载SDK并添加代码”页面，此页面即可得到Appkey。

3. 下载并安装SDK
下载SDK最新版
添加代码和资源引用,我们提供了添加资源文件和jar文件的两种方式，可以根据需求选择
解压SDK压缩包，将文件夹中的’main/libs’和’main/res’文件夹复制到你的项目工程根目录下（如使用’ADT 17’以下用户需要手动添加’libs’下的jar文件到工程Path中）

解压SDK压缩包，将文件夹中的social_sdk_library_project文件夹导入Eclipse，并在您的工程中添加对此项目的引用即可。

（1）AndroidManifest配置

android:name="com.umeng.socialize.editorpage.ShareActivity"
android:theme="@style/Theme.UMDefault"
android:excludeFromRecents="true"/>

（2）设置友盟App_id

data
android:name="UMENG_APPKEY"
android:value="4eaee02c527015373b000003" >
data>

（3）增加相对应权限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.SET_DEBUG_APP" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />

（4）针对不同平台的添加相对于的配置信息
微信平台

<activity
            android:name="com.umeng.soexample.wxapi.WXEntryActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:exported="true"
            android:screenOrientation="portrait"
            android:theme="@android:style/Theme.Translucent.NoTitleBar" />

新浪微博

<activity
            android:name=".WBShareActivity"
            android:configChanges="keyboardHidden|orientation"
            android:screenOrientation="portrait" >
            <intent-filter>
                <action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
                <category android:name="android.intent.category.DEFAULT" />
            intent-filter>
        activity> 
<activity
            android:name="com.sina.weibo.sdk.component.WeiboSdkBrowser"
            android:configChanges="keyboardHidden|orientation"
            android:windowSoftInputMode="adjustResize"
            android:exported="false" >
        activity>
        <service 
            android:name="com.sina.weibo.sdk.net.DownloadService"
            android:exported="false">
        service>

QQ、Qzone

<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" />
<data android:scheme="tencent100424468" />
intent-filter>
activity>
<activity          
    android:name="com.tencent.connect.common.AssistActivity"
    android:screenOrientation="portrait"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" />

注：我目前只是集成了主流的平台，根据个人项目需求添加其他平台的配置。

4. 初始化配置
各个平台的配置，建议放在全局Application或者程序入口

PlatformConfig.setWeixin("wx967daebe835fbeac", "5bb696d9ccd75a38c8a0bfe0675559b3");
       //微信 appid appsecret
PlatformConfig.setSinaWeibo("3921700954","04b48b094faeb16683c32669824ebdad");
       //新浪微博 appkey appsecret
PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba"); 
        // QQ和Qzone appid appkey     
PlatformConfig.setAlipay("2015111700822536");
        //支付宝 appid
PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
        //易信 appkey      
PlatformConfig.setRenren("201874","28401c0964f04a72a14c812d6132fcef","3bf66e42db1e4fa9829b955cc300b737");
        //人人 appid appkey appsecret
PlatformConfig.setTwitter("3aIN7fuF685MuZ7jtXkQxalyi", "MK6FEYG63eWcpDFgRYw4w9puJhzDl0tyuqWjZ3M7XJuuG7mMbO");
        //Twitter appid appkey
PlatformConfig.setPinterest("1439206");
        //Pinterest appid 
PlatformConfig.setLaiwang("laiwangd497e70d4", "d497e70d4c3e4efeab1381476bac4c5e");
        //来往 appid appkey

说明：有些平台的分享时通过调起本地客户端的形式完成的，因此，并不需要appid，但是诸如需要使用第三方公司api的平台，新浪，腾讯等，是需要去申请appkey的。其实新浪微博，人人网可以把appid等配置在代码中，也可在友盟后台中设置，豆瓣只能在友盟后台设置。其它需要配置appid的平台，如qq，微信，易信,twitter等都需要在代码中设置。还有一部分平台需要在mainfest中配置，前面已经提到过。

5.第三方登录
目前友盟社会化组件支持的第三方登录平台为：新浪微博、腾讯微博、QQ、QQ空间、微信、人人网、豆瓣、Facebook、Twitter。
（1） 授权
首先获取UMShareAPI

mShareAPI = UMShareAPI.get(this);

选取需要授权的平台，并进行授权，其中umAuthLisrener是回调监听器，需要开发者根据需求重新定义

SHARE_MEDIA platform = SHARE_MEDIA.SINA; 
mShareAPI.doOauthVerify(this, platform, umAuthListener)

private UMAuthListener umAuthListener = new UMAuthListener() {
        @Override
        public void onComplete(SHARE_MEDIA platform, int action, Map data) {
            Toast.makeText( getApplicationContext(), "Authorize succeed", Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onError(SHARE_MEDIA platform, int action, Throwable t) {
            Toast.makeText( getApplicationContext(), "Authorize fail", Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onCancel(SHARE_MEDIA platform, int action) {
            Toast.makeText( getApplicationContext(), "Authorize cancel", Toast.LENGTH_SHORT).show();
        }
    };

对于删除授权使用的接口是

mShareAPI.deleteOauth(AuthActivity.this, platform, umdelAuthListener);

不难看出与授权的参数是一样的。

注意要重写

onActivityResult()

     @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        mShareAPI.onActivityResult(requestCode, resultCode, data);
    } 

获取客户端安装信息：

mShareAPI.isInstall(this, SHARE_MEDIA.WEIXIN)

（２）微信登录

＜１＞签名设置
注意打包后的apk文件签名必须与微信平台设置一致，微信平台签名设置位置如下图

apk签名可以直接安装微信签名工具，获取签名后与上图所示位置比对，如果不一致，则无法进入微信授权确认页面．

＜２＞回调类的实现
在AndroidManifest.xml中下注册下面的回调Activity。

<activity
   android:name=".wxapi.WXEntryActivity"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"
   android:configChanges="keyboardHidden|orientation|screenSize"
   android:exported="true"
   android:screenOrientation="portrait" />

然后将SDK包中platforms/weixin目录下的wxapi文件夹拷贝到您AndroidMainFest.xml文件application标签里配置的包目录下,然后修改WXEntryActivity的完整路径即可
［注意WXEntryActivity.java的完整路径必须正确，否则微信登录会无法返回相关用户数据，也无法正常执行回调］

＜３＞QQ及Qzone登录
实现方法同样如上，注意下面几点：

QQ及Qzone登录都必须安装QQ客户端，并且只能跳转QQ客户端实现登录，无法跳转到Qzone客户端
QQ及Qzone登录需要确保在腾讯平台通过审核或添加测试账号，否则会报错110406
QQ及Qzone登录必须确保apk签名与腾讯平台上传的apk签名匹配，否则会报错100044，出现此错误请联系腾讯平台人员（QQ：800013811 ）修改apk签名
注意将Android manifest xml里的 腾讯平台APPID替换为自己申请的APPID，注意tencent前缀不要修改，否则无法正常实现QQ及Qzone登录

平台授权，是需要安装对应的客户端的。新浪微博，豆瓣网，人人网除外，新浪和人人如果本地安装了对应平台是走本地授权，如果没有安装，需要走网络授权

４，分享
分享分为两种样式，使用默认分享面板选择页面和自定义分享样式
（１）默认shareboard：

final SHARE_MEDIA[] displaylist = new SHARE_MEDIA[]
                        {
                            SHARE_MEDIA.WEIXIN, SHARE_MEDIA.WEIXIN_CIRCLE,SHARE_MEDIA.SINA,
                            SHARE_MEDIA.QQ, SHARE_MEDIA.QZONE,SHARE_MEDIA.DOUBAN
                        };
                new ShareAction(this).setDisplayList( displaylist )
                        .withText( "呵呵" )
                        .withTitle("title")
                        .withTargetUrl("http://www.baidu.com")
                        .withMedia( image )
                        .setListenerList(umShareListener,umShareListener)
                        .setShareboardclickCallback(shareBoardlistener)
                        .open();

【title参数对新浪、人人、豆瓣不生效】

修改默认shareboard中的分享平台，只需要传入自己需要的平台参数，放入shareaction中，并执行open方法即可。 shareboard点击响应回调方法如下：

private ShareBoardlistener shareBoardlistener = new ShareBoardlistener() {

        @Override
        public void onclick(SHARE_MEDIA share_media) {

        }
    };

（2）自定义分享样式
对于需要自己定义分享UI样式的开发者，可以自行绘制分享模块的整个UI，在对应的分享按钮中实现下面的方法

new ShareAction(this)
.setPlatform(SHARE_MEDIA.SINA)
.setCallback(umShareListener)
.withText("hello umeng video")
.withTargetUrl("http://www.baidu.com")
.withMedia(image)
.share();

选取分享的平台，设定分享回调接口和内容，并执行share方法。 回调接口如下：

new UMShareListener() {
        @Override
        public void onResult(SHARE_MEDIA platform) {
            Toast.makeText(ShareActivity.this,platform + " 分享成功啦", Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onError(SHARE_MEDIA platform, Throwable t) {
            Toast.makeText(ShareActivity.this,platform + " 分享失败啦", Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onCancel(SHARE_MEDIA platform) {
            Toast.makeText(ShareActivity.this,platform + " 分享取消了", Toast.LENGTH_SHORT).show();
        }
    };

值得注意的是，分享也应该重写

onActivityResult()
        @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        UMShareAPI.get( this ).onActivityResult( requestCode, resultCode, data);
    }

（3）设置分享内容
目前支持文本、图片（本地及URL）、音频及视频URL的分享

图片(url)

UMImage image = new UMImage(ShareActivity.this, "http://www.umeng.com/images/pic/social/integrated_3.png");

图片(本地资源引用)

UMImage image = new UMImage(ShareActivity.this,
                BitmapFactory.decodeResource(getResources(), R.drawable.image));

图片(本地绝对路径)

UMImage image = new UMImage(ShareActivity.this, 
                            BitmapFactory.decodeFile("/mnt/sdcard/icon.png")));

URL音频及图片

UMusic music = new UMusic("http://music.huoxing.com/upload/20130330/1364651263157_1085.mp3");
music.setTitle("sdasdasd");
music.setThumb(new UMImage(ShareActivity.this,"http://www.umeng.com/images/pic/social/chart_1.png"));

url视频

UMVideo video = new UMVideo("http://video.sina.com.cn/p/sports/cba/v/2013-10-22/144463050817.html");

6.高级功能

对于以上介绍的基本功能已经可以实现一般用户的需求，对于特殊要求，我们进行了特别处理： 针对分享面板，我们进行了如下的处理：

1 . 针对不同平台使用不同监听器，以及分享不同内容
根据前面的介绍可以知道，使用ShareAction(this).setDisplayList( displaylist)

可以进行分享面板的平台设置。同时使用setContentList(),

可以进行不同分享内容的处理，使用setListenerList()

进行不同回调的处理。

参考下面的代码：

 new ShareAction(this).setDisplayList(SHARE_MEDIA.SINA,SHARE_MEDIA.QQ,SHARE_MEDIA.QZONE)
                       .setContentList(new ShareContent(),new ShareContent())
                       .withMedia(image)
                       .setListenerList(umShareListener,umShareListener)
                       .open();

1. 分享面板点击回调
   使用setShareboardclickCallback() 可以进行分享面板不同按钮的点击回调，方便开发者进行特殊处理。

3 . 分享面板增加自定义按钮

如果需要对分享面板增加自定义的按钮，可以通过 ShareAction(this).addButton(String showword,String Keyword,String icon,String Grayicon,int index) 进行设置其中第一个参数是显示的名字，第二个参数是平台名称， 注意着两个参数需要先声明 ，第三个参数是按钮图标的图片名字，第四个按钮是置灰情况下按钮图标的图片名字， 注意图片直接写路径即可，不要.png等后缀 最后一个变量是数标（功能保留）。 对于自定义平台的监听需要使用上面提到的分享面板点击回调，如下：

private ShareBoardlistener shareBoardlistener = new  ShareBoardlistener() {

        @Override
        public void onclick(SnsPlatform snsPlatform,SHARE_MEDIA share_media) {
            if (share_media==null){
                if (snsPlatform.mKeyword.equals("11")){
                    Toast.makeText(ShareActivity.this,"add button success",Toast.LENGTH_LONG).show();
                }

            }
            else {
                new ShareAction(ShareActivity.this).setPlatform(share_media).setCallback(umShareListener)
                        .withText("多平台分享")
                        .share();
            }
        }
    };

是新增按钮的回调监听是通过判断当获取平台为空时，keyword的值来进行确定的，并在对应的条件中进行处理即可。

7. QQ、Qzone分享集成说明

注意将Android manifest xml里的 腾讯平台APPID替换为自己申请的APPID，注意tencent前缀不要修改，否则会在分享后提示40000或分享取消。

8. 微信集成相关说明

1 微信和微信朋友圈的回调
如果在您的项目中集成了微信或者微信朋友圈，并且您需要准确的分享回调，则需要在AndroidManifest.xml中下注册下面的回调Activity。

<activity
   android:name=".wxapi.WXEntryActivity"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"
   android:configChanges="keyboardHidden|orientation|screenSize"
   android:exported="true"
   android:screenOrientation="portrait" />

注意这里不需要修改，否则可能引起微信回调执行不正确，影响微信登录及分享功能

然后将SDK包中platforms/weixin目录下的wxapi文件夹拷贝到您AndroidMainFest.xml文件application标签里配置的包目录下,然后修改WXEntryActivity的完整路径即可

以我们的Demo工程为例
social_sdk_example的包名为com.umeng.soexample,因此将wxapi文件夹拷贝到com.umeng.soexample下,最终WXEntryActivity的完整路径为com.umeng.soexample.wxapi.WXEntryActivity

注意WXEntryActivity.java的完整路径必须正确，否则微信分享回调无法正常执行,微信登录功能也无法正常实现

其中分享的回调接口SnsPostListener的onComplete方法的第二个参数代表分享的状态码，当值为200时表示分享成功;其余的值则为分享失败。

1. 新浪集成的说明重点内容
   1 添加配置文件
   在Android manifest xml中添加相关配置， 参考文档

在你的工程应用包名的相应目录下新增一个WBShareActivity类，该类继承自Activity，预留空类即可

以我们的Demo工程为例
social_sdk_example的包名为com.umeng.soexample,最终WBShareActivity的完整路径为com.umeng.soexample.WBShareActivity

WBShareActivity内部实现如下

package com.umeng.soexample;

import com.umeng.socialize.media.WBShareCallBackActivity;

/**
 * Created by wangfei on 15/12/3.
 */
public class WBShareActivity extends WBShareCallBackActivity{
}

 <service 
            android:name="com.sina.weibo.sdk.net.DownloadService"
            android:exported="false">
        service>

9.不同平台的分享内容要求

10. 混淆
为了保证引用友盟Social SDK jar文件以及腾讯jar文件被混淆，请在proguard.cfg文件中添加以下代码避免被混淆.

-dontshrink
-dontoptimize
-dontwarn com.google.android.maps.**
-dontwarn android.webkit.WebView
-dontwarn com.umeng.**
-dontwarn com.tencent.weibo.sdk.**
-dontwarn com.facebook.**


-keep enum com.facebook.**
-keepattributes Exceptions,InnerClasses,Signature
-keepattributes *Annotation*
-keepattributes SourceFile,LineNumberTable

-keep public interface com.facebook.**
-keep public interface com.tencent.**
-keep public interface com.umeng.socialize.**
-keep public interface com.umeng.socialize.sensor.**
-keep public interface com.umeng.scrshot.**

-keep public class com.umeng.socialize.* {*;}
-keep public class javax.**
-keep public class android.webkit.**

-keep class com.facebook.**
-keep class com.facebook.** { *; }
-keep class com.umeng.scrshot.**
-keep public class com.tencent.** {*;}
-keep class com.umeng.socialize.sensor.**
-keep class com.umeng.socialize.handler.**
-keep class com.umeng.socialize.handler.*
-keep class com.tencent.mm.sdk.modelmsg.WXMediaMessage {*;}
-keep class com.tencent.mm.sdk.modelmsg.** implements com.tencent.mm.sdk.modelmsg.WXMediaMessage$IMediaObject {*;}

-keep class im.yixin.sdk.api.YXMessage {*;}
-keep class im.yixin.sdk.api.** implements im.yixin.sdk.api.YXMessage$YXMessageData{*;}

-dontwarn twitter4j.**
-keep class twitter4j.** { *; }

-keep class com.tencent.** {*;}
-dontwarn com.tencent.**
-keep public class com.umeng.soexample.R$*{
    public static final int *;
}
-keep public class com.umeng.soexample.R$*{
    public static final int *;
}
-keep class com.tencent.open.TDialog$*
-keep class com.tencent.open.TDialog$* {*;}
-keep class com.tencent.open.PKDialog
-keep class com.tencent.open.PKDialog {*;}
-keep class com.tencent.open.PKDialog$*
-keep class com.tencent.open.PKDialog$* {*;}

-keep class com.sina.** {*;}
-dontwarn com.sina.**
-keep class  com.alipay.share.sdk.** {
   *;
}
-keepnames class * implements android.os.Parcelable {
    public static final ** CREATOR;
}
-keep class com.linkedin.** { *; }
-keepattributes Signature