1.产品概述
友盟社会化组件,可让移动利用快速具有社会化分享、登录、评论、喜欢等功能,并提供实时、全面的社会化数据统计分析服务。
指南将会手把手教你使用社会化组件SDK,用5分钟为APP增加新浪微博、腾讯微博、人人网分享功能。
注意:本文示例代码均针对最新版SDK,如果你所用SDK的类名或方法名与此文不符合,请使用你所用SDK的随包文档、或下载使用最新版SDK。
2.获得友盟Appkey
如果你之前已在友盟注册了利用,并获得到了Appkey,可以继续使用它.
如果你还没有在友盟注册开发者账号,需要先注册,注册以后登录你的账号,点击**添加新利用**,填写完利用基本信息后,将进入"下载SDK并添加代码"页面,此页面便可得到Appkey。
3.下载并安装SDK
下载SDK最新版
添加代码和资源援用
jar文件对应列表
平台
|
jar文件
|
腾讯微博
|
SocialSDK_TencentWB_1.jar,SocialSDK_TencentWB_2.jar
|
QQ空间QQ好友
|
SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar,SocialSDK_QQZone_3.jar
|
微信好友
|
SocialSDK_WeiXin_1.jar,SocialSDK_WeiXin_2.jar
|
注意
1:QQ和QQ Zone SSO(免登录)援用的jar文件相同。当需要同时支持QQ和QQ Zone的时候,只需添加1次SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件便可.
2:由于我们对微信的包名做了修改(libammsdk.jar -> SocialSDK_WeiXin.jar),如出现"Unable to execute dex: Multiple dex files define "问题,请删除libammsdk.jar或SocialSDK_WeiXin.jar中的1个便可解决问题。
3.1添加资源文件和jar文件有3种方式,请根据您的需求进行选择
3.2方法A:快速集成工具 ( 推荐 )
1:解压SDK下载包,双击运行SDK根目录下的SDKIntegration.jar或在命令行下输入java -jar SDKIntegration.jar运行集成工具;
2:选择Android工程的根目录,并且填写您的友盟App Key;
3:勾选所需平台和组件,点击"快速集成";
4:检查AndroidManifest.xml、jar文件是不是正确。如果集成了QQ或QZone,请修改相应地appid。以下图所示:
3.3方法B:添加工程援用(升级方便,推荐)
解压SDK紧缩包,将文件夹中的social_sdk_library_project文件夹导入Eclipse,并在您的工程中添加对此项目的援用便可。
3.3.1方法C:添加资源到现有项目中
解压SDK紧缩包,将文件夹中的温@良@顺main/libs温@良@顺和温@良@顺main/res温@良@顺文件夹复制到你的项目工程根目录下(如使用温@良@顺ADT 17温@良@顺以下用户需要手动添加温@良@顺libs温@良@顺下的jar文件到工程Path中):
|
|
SDK紧缩包目录
|
3.4** Manifest配置,添加友盟Appkey/Activity/权限**
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.umeng.example" android:versionCode="1" android:versionName="1.0" > <application android:debuggable="true" android:icon="@drawable/icon" android:label="@string/app_name" android:theme="@android:style/Theme.Black.NoTitleBar" > <activity android:name="com.umeng.socialize.view.ShareActivity" android:configChanges="orientation|keyboard" android:launchMode="singleTask" android:noHistory="true" android:theme="@style/Theme.UMDialog" android:windowSoftInputMode="stateVisible|adjustResize" > <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" /> <meta-data android:name="UMENG_APPKEY" android:value="xxxxxxxxxxxxxxxxxxxxxx" > <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.GET_TASKS" /> Add to Build Path。
3 将解压目录中platforms/weixin/res拷贝至你工程的res目录。
6.3添加以下集成代码
String appID = "wx967daebe835fbeac"; String appSecret = "5fa9e68ca3970e87a1f83e563c8dcbce"; // 添加微信平台 UMWXHandler wxHandler = new UMWXHandler(getActivity(),appId,appSecret);wxHandler.addToSocialSDK(); // 添加微信朋友圈 UMWXHandler wxCircleHandler = new UMWXHandler(getActivity(),appId,appSecret);wxCircleHandler.setToCircle(true);wxCircleHandler.addToSocialSDK();
微信和朋友圈支持纯文字,纯图片(点击查看大图),图文,音乐,视频分享。
注意
此版本兼容了微信支付的功能,请更新SocialSDK_WeiXin_1.jar文件。
6.4微信和微信朋友圈的回调
如果在您的项目中集成了微信或微信朋友圈,并且您需要准确的分享回调,则需要在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文件夹拷贝到您的工程的包目录下, 然后修改WXEntryActivity的完全路径便可。
例如social_sdk_example的包名为com.umeng.soexample,因此将wxapi文件夹拷贝到com.umeng.soexample下,终究WXEntryActivity的 完全路径为com.umeng.soexample.wxapi.WXEntryActivity。
其中分享的回调接口SnsPostListener的onComplete方法的第2个参数代表分享的状态码,当值为200时表示分享成功;其余的值则为分享失败。
微信集成相干说明
微信集成注意以下几点
正确填写AppID。工程的包名必须同申请利用的包名1致。在微信开放平台填写你App的的签名,测试、发布时要保证App的签名跟微信开放平台的签名1致。开发者的利用需要通过审核。开发者在申请利用必须要通过微信官网的审核才能进行调试。