开发者常希望为应用增添分享与创建活动的功能以推广产品,但自行开发耗时耗力。采用集成化方案更为高效,例如接入友推SDK的积分组件,既能实现分享传播,又能支持活动创建,大幅降低开发成本,提升推广效率。
1、 访问友推官网,进入SDK下载页面,找到积分分享组件并下载。
2、 申请应用的AppKey
3、 若已在友推添加应用并获取AppKey,可直接跳转至3.2步骤继续操作。
4、 登录友推官网后台,进入应用管理页面,点击添加新应用,填写相关信息并完成创建,成功后系统将生成对应App的AppKey,可用于集成友推功能。
5、 申请社交平台应用接口密钥
6、 集成前需先在各社交平台开放平台注册应用并通过审核,否则仅能使用系统分享功能,无法获取分享回调与统计数据。
7、 注册需分享的平台
8、 此信息需填写在下载包内的 youtui_sdk.xml 文件中。若需启用某个分享平台,可将对应平台的 Enable 属性设为 true。完成填写后,请将该文件放入项目的 asserts 目录下,切勿修改文件中任何标签结构,以免在解析 XML 时导致标签内容无法识别,进而引发授权信息读取错误。文件内容格式如下:请严格按照规定格式配置,确保各项参数准确无误,以保障功能正常运行。
9、 请务必填写在各平台注册的准确信息,否则应用无法完成授权,也将影响分享功能。通过设置enable属性为true或false,来决定是否启用该平台的分享功能。确保信息正确无误,以保障各项操作顺利进行。
10、 友推SDK注册请访问官网:http://youtui.mobi/,获取详细接入信息与技术支持服务。
11、 通过微信及朋友圈进行注册,可访问微信开放平台获取相关信息。相关功能由AppId标识控制,可根据需要启用或禁用。微信登录和分享至朋友圈的功能均需配置对应参数以实现集成,确保应用与微信生态的顺畅对接,提升用户使用体验与社交传播效果。
12、 新浪微博注册入口位于其开放平台官网,用户可前往该平台完成账号申请。通过填写必要信息并获取对应的AppKey与AppSecret,同时设置正确的回调地址,即可启用相关应用功能,实现与微博系统的对接与交互,便于后续开展授权登录及内容分享等操作。
13、 腾讯旗下QQ、QQ空间及腾讯微博的注册入口位于open.qq.com,用户可通过该网址完成账号注册与登录操作。
14、 人人网注册入口:http://dev.renren.com/
15、 启用更多功能,可用于尚未获取密钥时的系统分享操作。此方式不会累积积分,也无法计入统计数据中,适合临时使用场景,无需额外配置即可调用系统自带分享功能。
16、 在AndroidManifest.xml中声明并注册所需权限。
17、 检测当前网络连接是否正常
18、 获取设备的MAC地址,用作用户唯一标识的备用方案。
19、 获取手机IMEI以唯一标识用户设备信息。
20、 允许应用向外部存储设备写入数据的权限配置,用于实现文件保存等功能。该权限可使应用程序在用户设备的SD卡等外部存储空间中创建、修改或删除文件内容,确保数据存储与读取操作正常进行。
21、 启用或禁用访问SD卡的权限,允许应用程序挂载和卸载外部存储设备,以便读取或写入文件系统。该权限用于管理存储设备的连接状态,确保应用能正常操作外部存储中的数据,常用于需要频繁读写文件的应用场景。
22、 开启网络权限,确保连接正常。
23、 读取SD卡中的图片文件
24、 用于实现统一身份认证登录功能
25、 用于实现单点登录功能,允许应用使用凭证进行身份验证。需在安卓系统中声明相应权限,确保用户能够安全便捷地通过统一认证方式访问多个服务,提升用户体验与数据安全性。
26、 用于实现单点登录功能,需添加管理账户权限,允许应用访问和操作设备中的账户信息,确保用户能够顺利通过统一身份认证系统完成登录流程,提升使用便捷性与安全性。
27、 在 AndroidManifest.xml 文件中声明所需 Activity。
28、 用于微信分享功能的Activity需在应用中进行注册,具体配置如下:声明一个名为.wxapi.WXEntryActivity的组件,设置其可被外部调用,确保其他应用能够启动该界面。启动模式设定为单任务实例,避免重复创建,提升运行效率。同时,为其指定透明主题样式,使界面切换时视觉效果更自然流畅。该配置需完整写入应用的清单文件中,以保证微信SDK正常回调并完成分享流程。正确注册后,应用才能接收来自微信的响应结果,实现完整的分享与授权功能,是集成微信开放能力的重要步骤之一。
29、 用于QQ登录回调功能,需在应用配置中注册一个特定的活动组件。该组件的名称为com.tencent.connect.common.AssistActivity,主要用于支持第三方登录过程中的页面跳转与通信处理。为确保界面切换时的稳定性,已设置其配置变更属性,可响应屏幕方向及键盘显示状态的变化。该活动限定为竖屏显示模式,避免横屏切换带来的布局问题。同时,采用系统提供的透明无标题主题样式,使页面呈现时不会遮挡原有界面,提升用户体验。此配置需完整写入应用的清单文件中,并确保标签闭合正确,是实现QQ互联功能不可或缺的一部分,若缺少该注册项,可能导致登录流程中断或授权失败,影响用户正常登录操作。
30、 用于QQ授权登录功能,需在应用配置中注册一个特定的活动组件。该组件的类名为 com.tencent.tauth.AuthActivity,主要用于处理授权回调流程。为确保授权过程顺利进行并避免页面栈混乱,此活动的启动模式被设置为singleTask,即系统会复用已存在的实例,而不会创建新的任务栈。同时,通过设置noHistory属性为true,可使用户在完成授权操作后返回主界面时,该授权页面不会保留在导航历史记录中,从而提升用户体验并增强安全性。为支持外部浏览器或QQ客户端跳转至本应用,还需为此活动配置相应的意图过滤器。该过滤器声明了对android.intent.action.VIEW动作的响应能力,并包含两个必要类别:android.intent.category.DEFAULT用于匹配标准的隐式调用,android.intent.category.BROWSABLE则确保网页或其他应用可通过浏览器方式成功唤起此页面。整体配置保障了QQ第三方登录功能的正常运行,实现了从授权请求到回调处理的无缝衔接,是集成社交登录不可或缺的关键步骤之一。
31、 将其中的xxxxxx替换为你自己申请的appid,例如:,然后将其包含在标签内,并确保整个结构位于标签之中,以保证应用能正确识别和处理相关跳转请求。
32、 用于实现用户授权时需注册的界面功能,配置项指定了处理授权流程的Activity类名及相关的系统配置变更响应,包含屏幕方向变化、导航方式调整以及键盘隐藏状态的监听,确保在不同设备操作环境下均能正常执行授权流程并保持界面稳定性,适用于需要第三方登录或权限获取的应用场景。
33、 用于新浪微博分享功能的回调配置,需在应用组件中声明特定的意图过滤器。该过滤器用于接收来自微博SDK的请求,确保分享流程正常回调。具体实现方式是注册一个action,其值为com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY,同时添加默认类别,即android.intent.category.DEFAULT,以保证系统能正确识别并分发相关意图。此配置通常置于AndroidManifest.xml文件中的对应Activity节点内,是集成微博分享功能不可或缺的一部分。通过该设置,应用可与微博客户端进行通信,完成授权、分享内容发布等操作,并在操作结束后顺利返回原应用,提升用户体验。合理配置该项有助于保障社交分享功能的稳定运行。
34、 用于标识通过友推渠道下载的应用来源,需在Android配置中添加meta-data字段,其名称为YOUTUI_CHANNEL,值为应用名(英文或拼音)加下划线与yt组合,例如yourappname_yt。此项设置至关重要,务必准确填写实际应用名称,以便正确追踪和统计来自友推渠道的安装数据,若填写错误或未填,将导致无法识别用户来源,影响推广效果分析与数据归因。
35、 启动友推系统
36、 建议开发者在程序启动时进行友推SDK的初始化操作,最佳位置为MainActivity的onCreate方法中调用YouTui.init(activity)。只有完成初始化,后续各项功能才能正常使用,确保推送服务顺利运行。请务必在主界面创建时执行该步骤。
37、 初始化友推服务,加载YouTui模块功能。
38、 创建 ShareData 对象,通过其 set 方法传入待分享的内容。
39、 创建ShareData对象后,通过调用其set方法来配置要分享的内容,具体参数设置详见后续说明。若仅需分享应用信息,只需调用setIsAppShare(true),系统将自动分享在友推后台预先配置的应用介绍及下载地址,无需额外设置其他数据。
40、 ShareData 所含字段如下:
41、 判断当前应用是否为分享类应用
42、 分享一段文字:生活总有起落,保持乐观心态,勇敢面对挑战,努力前行。相信自己,未来可期。https://example.com
43、 待分享的本地图片路径,需在本地与网络图片中择一分享;若两者均存在,则优先选择本地图片进行分享。
44、 分享图片时可选择本地或网络图片,若两者均提供,则优先使用本地图片;imageUrl 表示待分享的网络图片地址。
45、 待分享内容的详细说明与具体描述信息
46、 目标链接为分享内容后跳转的网址地址
47、 创建类实例后,通过调用其set方法来设置相关参数。
48、 设置分享数据的描述为友推积分组件,用于标识功能模块。
49、 设置分享标题为友推分享
50、 通过友推积分组件,开发者仅需几行代码即可为应用快速集成分享获积分功能。组件提供完整的后台数据统计,便于精准分析用户行为。除完整分享功能外,积分系统还可独立接入已具备分享模块的应用中,灵活便捷。立即体验高效集成方案,提升用户互动与活跃度,详情请点击:http://youtui.mobi
51、 微信及朋友圈功能
52、 若需实现微信及朋友圈分享功能,需创建一个以应用包名加上.wxapi命名的包,并在该包内新建名为WXEntryActivity.java的文件。该类只需继承自cn.bidaround.youtui.wxapi.WXEntryActivity,无需额外编写代码即可实现分享功能的集成与调用。
53、 所示,请将com.xingxinglangtuoche替换为你的应用包名,此操作在微信回调时需要用到。
54、 调用友推分享功能组件
55、 调用友推分享组件,通过YouTuiViewType常量设置分享样式,当前支持白色列表与黑色网格两种展示模式。
56、 YouTui.show新功能需传入hasAct参数,true表示启用积分活动,false表示不启用积分活动。
57、 调用YouTui.show方法显示黑色网格样式弹窗,无需积分活动支持,适用于当前页面的特定展示需求。
58、 调用YouTui显示方法,选择白名单视图类型并启用积分活动功能。该样式需参与积分活动方可使用,适用于特定用户群体的展示需求。
59、 }
60、 }
61、 可设置后台分享得积分、积分换礼活动,鼓励用户主动分享应用,并支持查看分享推荐的详细数据。
62、 未配置分享获积分活动时,将不显示相关提示,仅保留基础分享功能。
63、 兼职猫接入后,用户可借助QQ将应用链接分享给好友,对方点击后直达下载页面。
64、 应用支持后台设置推广活动并查看用户分享的详细数据报表。
