友推-为应用集成分享功能安装手册

 友推SDK是一款是面向移动应用的SDK组件，提供给开发者集成使用。 经过友推，开发者几行代码就能够为应用添加分享送积分功能，并提供详尽的统计报表，除了自己具有的分享功能 外，开发者也可将积分功能单独集成在已有分享组件的app上，让您的应用更好地经过用户的主动推荐触达新用户。 

下载地址：http://youtui.mobi/download/index.htm 

开发文档：http://youtui.mobi/doc/index.htm

功能：

 

1.支持微信,QQ,新浪微博,QQ空间,短信,邮件等多家大型社交媒体平台一键分享

2.支持积分抽奖活动在线活动建立,让用户更主动推广您的应用,提高用户的体验性和互动性

3.支持后台各类营销数据统计功能

4,集成简单，几行代码轻松搞定

5.支持APP第三方登陆

集成案例：

 

 

 

 

 

 

 

 

 

集成方法：

 

[1].[代码] 申请应用 AppKey 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

1	/*若是您已经在友推添加过App并已生成AppKey，可跳过本步骤直接进入3.2继续。

2

3	申请方法：访问友推网站后台，登陆后进入应用列表，添加须要集成友推组件的 App，以下图，添加成功后可获取应用的 AppKey。*/

 

[2].[代码] 申请社交平台appkey 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	/*集成前您须要为您的应用在各大社交网站的开放平台申请帐号并经过审核，不然只能调用系统的分享菜单，没法跟踪分享的回调事件及统计*/

02

03	平台                 网址

04	微信                  http://open.weixin.qq.com

05	新浪微博              http://open.weibo.com

06	腾讯微博              http://dev.t.qq.com

07	QQ空间、QQ            http://open.qq.com/

08	微信好友              http://open.weixin.qq.com

09	人人                  http://dev.renren.com

10	豆瓣(暂未支持)        http://developers.douban.com/

11	FaceBook(暂未支持)    https://developers.facebook.com

12	Twitter(暂未支持)     https://dev.twitter.com

 

[3].[代码] SDK 集成使用流程 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

1	/*1.引用友推库项目-> 2.注册须要分享的平台 -> 3.AndroidManifest.xml注册权限、activity ->4.初始化友推并调用

2

3

引用友推库项目

4

5	将youtui-lib项目库和应用工程放在同一个目录下

6

7	在 Package Explorer 中右键点击工程的根目录，选择 Properties(属性)，而后点击，在Android选项点击Add添加youtui-lib*/

 

[4].[代码] 注册须要分享的平台 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	/*1.配置各分享平台key，该配置文件为youtui_sdk.xml,配置完放入工程的assets文件夹。

02

03	2.若是须要分享到哪一个平台就将该平台的Enable属性设置为true.

04

05	3.若是须要将某个平台排列到前面，只须要改变它在youtui_sdk.xml文件中的位置便可。*/

06

07	<?xml version="1.0" encoding="utf-8"?>

08

<KeyInfo>

09	<!-- 分享平台的注册信息，必定要填入在相应平台注册的正确信息，否则应用没法完成受权，  也没法进行分享，enable填写true或者false属性决定是否分享该平台-->

10	<!-- 友推sdk注册地址 : http://youtui.mobi/ -->

11	<YouTui AppKey="" />

12

13	<!-- 微信和朋友圈注册:https://open.weixin.qq.com/ -->

14	<Wechat AppId="" Enable="" />

15	<WechatMoments AppId="" Enable="" />

16

17	<!-- 新浪微博注册地址:http://open.weibo.com/ -->

18	<SinaWeibo AppKey="" AppSecret="" Enable="" RedirectUrl="" />

19

20	<!-- QQ,QQ空间,腾讯微博注册地址:http://open.qq.com/ -->

21	<QQ AppId="" AppKey="" Enable="" />

22	<QZone AppId="" AppKey="" Enable="" />

23	<TencentWeibo AppId="" AppKey="" Enable="" />

24

25	<!-- 人人注册地址: http://dev.renren.com/ -->

26	<Renren AppKey="" AppId="" Enable="" SecretKey="" />

27	<ShortMessage Enable="" />

28	<Email Enable="" />

29	<!-- 调用系统分享，适用于暂时没有申请到key的分享，该分享不会得到积分，也不会被统计到 -->

30	<More Enable="true"/>

31	</KeyInfo>

 

[5].[代码] 注册权限 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	/*在AndroidManifest.xml 注册权限*/

02	<!-- 检测网络状态 -->

03	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

04

05	<!-- 获取mac地址做为用户的备用惟一标识 -->

06	<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

07

08	<!-- 获取用户手机的IMEI，用来惟一的标识用户。 -->

09	<uses-permission android:name="android.permission.READ_PHONE_STATE" />

10

11	<!-- 写入SDcard权限 -->

12	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

13

14	<!--打开关闭sd卡权限--!>

15	<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />

16

17	<!--网络权限--!>

18	<uses-permission android:name="android.permission.INTERNET" />

19

20	<!-- 用于读取sd卡图片 -->

21	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

22

23	<!-- 用于人人SSO登录 -->

24	<uses-permission android:name="android.permission.GET_ACCOUNTS" />

25

26	<!-- 用于人人SSO登录 -->

27	<uses-permission android:name="android.permission.USE_CREDENTIALS" />

28

29	<!-- 用于人人SSO登录 -->

30	<uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />

 

[6].[代码] 在 AndroidManifest.xml 注册须要的Activity 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	<!-- 微信分享须要注册该activity -->

02

<activity

03	android:name=".wxapi.WXEntryActivity"

04	android:exported="true"

05	android:launchMode="singleTask"

06	android:theme="@android :style/Theme.Translucent" >

07	</activity>

08

09	<!-- qq回调须要注册该activity -->

10

<activity

11	android:name="com.tencent.connect.common.AssistActivity"

12	android:configChanges="orientation|keyboardHidden"

13	android:screenOrientation="portrait"

14	android:theme="@android :style/Theme.Translucent.NoTitleBar" />

15

16	<!-- qq受权须要注册该activity -->

17

<activity

18	android:name="com.tencent.tauth.AuthActivity"

19	android:launchMode="singleTask"

20	android:noHistory="true" >

21	<intent-filter>

22	<action android:name="android.intent.action.VIEW" />

23	<category android:name="android.intent.category.DEFAULT" />

24	<category android:name="android.intent.category.BROWSABLE" />

25

26	<!-- 请将1101255276换成开发者本身应用的腾讯开放平台 Appid-->

27	<data android:scheme="tencent1101255276" />

28	</intent-filter>

29	</activity>

30

31	<!-- 人人受权须要注册的activity -->

32

<activity

33	android:name="com.renn.rennsdk.oauth.OAuthActivity"

34	android:configChanges="orientation|navigation|keyboardHidden" />

35

36	<!-- 新浪微博分享回调须要设置 -->

37	<intent-filter>

38	<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />

39	<category android:name="android.intent.category.DEFAULT" />

40	</intent-filter>

41	</activity>

42

43	<!-- 分享界面 -->

44

<activity

45	android:name="cn.bidaround.ytcore.activity.ShareActivity"

46	android:exported="true"

47	android:launchMode="singleTop"

48	android:theme="@android :style/Theme.Translucent.NoTitleBar" />

49	<!-- 应用受权 activity-->

50

<activity

51	android:name="cn.bidaround.ytcore.login.AuthActivity"

52	android:theme="@android :style/Theme.Translucent.NoTitleBar" />

53	<!-- 友推积分activity -->

54

<activity

55	android:name="cn.bidaround.point.PointActivity" />

56	<!-- 友推渠道号，应用名(英文或拼音)+"_yt"，如：“jd_yt”，用于识别经过友推下载的应用，请正确填写不然没法正确统计 -->

57	<meta-data

58	android:name="YOUTUI_CHANNEL"

59	android:value="yourappname_yt" >

60	</meta-data>

 

[7].[代码] 微信和朋友圈回调设置 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

1	/*若是须要分享微信和朋友圈，必需建一个 应用包名+ .wxapi 的包，在该包下建 WXEntryActivity.java，将该类继承cn.bidaround.youtui.wxapi.WXEntryActivity便可(里面不用写代码)*/

2

3	public class WXEntryActivity extends cn.bidaround.youtui.wxapi.WXEntryActivity {

4

}

 

[8].[代码] 初始化友推 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	/*开发者请在本身的程序开始，最好是在MainActivity的onCreate方法调用YtTemplate.init(this)初始化友推sdk，这样友推sdk才能进行后续调用(不然分享等操做会出现空指针异常),例如:*/

02

03	protected void onCreate(Bundle savedInstanceState) {

04	super.onCreate(savedInstanceState);

05	setContentView(R.layout.activity_main);

06	YtTemplate.init(this);/*初始化友推*/

07	initView();

08

}

09

/*应用退出时：

10

11	在您项目的出口Activity的 onDestroy 方法的第一行插入下面的代码 YtTemplate.release(this); 此方法用于释放内存，统计用户使用状况，一旦调用了release，就必须从新调用init才能使用友推的功能，不然会出现空指针异常;*/

 

[9].[代码] 建立ShareData实例 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

01	调用该实例的set方法设置本身须要分享的数据，关于该实例具体内容见下文，若是只是分享应用则只须要设置 setIsAppShare(true) 就能够分享应用在友推后台填写的信息和下载连接。

02

03	ShareData 包含的字段：

04

05	"isAppShare"

06

"text"

07	"imagePath"

08	"imageUrl"

09	"description"

10

"title"

11	"target_url"

12

13	/*判断是否为分享应用

14	待分享的文字，短信要小于70个字符，微博要小于140个字符，若是须要分享连接，最好将连接url放在最后

15	待分享的本地图片地址，分享图片的话须要在本地和网络图片中选一，若是都有则优先分享本地图片

16	待分享网络图片url，分享图片的话须要在本地和网络图片中选一，若是都有则优先分享本地图片

17

待分享内容的描述

18

待分享内容的标题

19	待分享内容的跳转连接*/

20

21	经过建立该类实例，调用实例的set方法设置这些参数，例如:

22

23	ShareData shareData = new ShareData();

24

25	shareData.isAppShare = false;/*设置为true则分享的信息从友推后台填写的应用信息中读取，可动态更新，后面的值不用设置。*/

26

27	shareData.setDescription("友推积分组件");

28

29	shareData.setTitle("友推分享");

30

31	shareData.setText("经过友推积分组件，开发者几行代码就能够为应用添加分享送积分功能，并提供详尽的

32

33	后台统计数据，除了自己具有的分享功能外，开发者也可将积分功能单独集成在已有分享组件的app上，快来试试吧 http://youtui.mobi");

34

36

37	shareData.setTarget_url("http://youtui.mobi");

38

39	shareData.setImageUrl("http://youtui.mobi/media/image/youtui.png");

40

41	shareData.setImagePath("http://cdnup.b0.upaiyun.com/media/image/default.png");

 

[10].[代码] 调用友推分享推荐组件 跳至 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

view source

 

prin

01	public void onClick(View v) {

02	if(v.getId()==R.id.popup_bt){

03	/*调用友推分享推荐组件,YouTuiViewType类的常量为分享样式参数，目前支持白色列表和黑色网格两种*/

04	/*建立分享的模板，第一个参数为activity,第二个参数为分享窗口样式，第三个参数为是否须要积分*/

05	YtTemplate blackTemp = new YtTemplate(this, YouTuiViewType.BLACK_POPUP,false);  //黑色网格样式不须要积分活动

06	/*YtTemplate blackTemp = new YtTemplate(this, YouTuiViewType.WHITE_LIST,ture);*/ //白色列表样式须要积分活动

07

08	ShareData shareData = new ShareData();

09	shareData.isAppShare = false;//设置为true则分享的信息从友推后台填写的应用信息中读取,可动态更新后面的值不用设置。

10	shareData.setDescription("友推积分组件");

11	shareData.setTitle("友推分享");

12	shareData.setText("经过友推积分组件，开发者几行代码就能够为应用添加分享送积分功能，并提供详尽的后台统计数据，除了自己具有的分享功能外，开发者也可将积分功能单独集成在已有分享组件的app上，快来试试吧 http://youtui.mobi");

13	shareData.setTarget_url("http://youtui.mobi");

14	shareData.setImageUrl("http://youtui.mobi/media/image/youtui.png");

15	shareData.setImagePath("http://cdnup.b0.upaiyun.com/media/image/default.png");

16

17	blackTemp.setShareData(shareData);//设置默认的分享数据;shareData 设置参看4.6

18	//**若是要为某个平台设置不同的分享信息。则单独设置*/

19	//blackTemp.addData(YtPlatform.PLATFORM_QQ, shareData);

20

//调出分享窗口

21	blackTemp.show();

22

23	//若是须要自定义分享事件，能够建立监听事件，而后在回调中处理

24	YtShareListener listener1 = new YtShareListener() {

25

@Override

26	public void onSuccess(ErrorInfo arg0) {

27

28

}

29

30

@Override

31	public void onPreShare() {

32

33

}

34

35

@Override

36	public void onError(ErrorInfo arg0) {

37

38

}

39

40

@Override

41	public void onCancel() {

42

43

}

44

};

45	//给新浪微博添加分享监听

46	blackTemp.addListener(YtPlatform.PLATFORM_SINAWEIBO, listener1);

47	//给QQ添加分享监听

48	//blackTemp.addListener(YtPlatform.PLATFORM_QQ, listener2);

49

50

}

51

}