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

 友推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

}