开发者学堂课程【阿里云移动用户反馈系统使用教程:移动用户反馈-安卓接入】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/421/detail/5322
移动用户反馈-安卓接入
内容介绍:
一、安卓接入的步骤
二、 Android SDK 手册
一、安卓接入的步骤
1. 进入控制台,显示已创建的应用,在 SDK 下载中勾选所需下载的 SDK 进行对应的下载。
2. 点击进入 Android SDK 手册
二、Android SDK 手册
1. SOK下载
进入MHub控制台下载 SDK :
https://mhub.console.allyun.com/#/download.
2. 准备工作
(1)Android Studio 开发(推荐方式)。
复制下载 SDK 文件夹下的 aar 和 jar 到 libs 目录下,
在 buildgradle 文件中添加如下配置:添加本地 libs 地址,以便可以找到放置在libs 中的 aar 文件:
repositories{
flatDir{
dirs 'libs'
}
}
添加本地依赖:
dependencies{
compile(name:"alicloud-android-feedback-3.0.0,ext:*aar')
compilefiles('libs/alicloud-android-monitor-2.5.1.1for bc_proguard.jar)
compile files('libs/utdid4al1-1.1.5.3 proguard.jar')
compile files(libs/alicloud-android-utils-1.0.3.jar)
//自行依赖 support-v4
}
不要忘记添加 support-v4 的依赖
Eclipse 开发
解压前面下载的 SDK,可以发现三个 jar 和一个 aar 分别做如下处理: jar 包的处理
① jar 包直接复制到项目的 libs 目录下
② 自行添加 support-v4ar 到 libs 目录下
alicioud-android-feedback-XXXaar 的迁移
① 解压 aliclouokandroid-feedback-xxx.aar 到本地
② 解压得到的目录里创建一个 libs 文件夹,然后将 classesjar 重命名为任何你想要的 ar 名称(比如: alsdk-feedbackian ),然后复制到 libs 目录下
③ 复制AndroidManifestxml文件中所有的权限声明以及所有的组件(ActivityServiceReceiven) 声明到项目中的
AndroidManifestxmi 文件中
④ 解压得到的目录里创建 projectproperties 文件,添加 androidlibrary=true 表示作为库项目使用
⑤ 删除 aapt 和 ni 文件夹以及 Rtxt 文件
⑥ 一个 EclipseLibrary 项目已经构建完成了,接下来只需打开 Eclipse 导入项目并在你的项目中配置引用这个项目即可
如果接入方接入了阿里系的其它 sdk 从而导致包冲突,则去掉冲突的依赖或者 ar 包即可.
(2)权限:需要相册和相机权限;android 6.0 需要开发者自己的方式实现权限获取,等地版本的使用上面即可。
(3)混淆配置 :应用进行混淆打包时,应加入如下混淆配置
-keepclass com.alibaba.sdkandroid.feedbackimplFeedbackServiceImpl{*;}
-keep class com.alibaba.sdk.androidfeedback.impl FeedbackAPI{*;}
-keep class comalibabasdk.androidfeedback.util.IWxCallback{*;}
-keepclass com.alibaba.sdkandroid.feedbackutilIUnreadCountCallback{*;}
-keepclass com.alibaba.sdkandroidfeedback.FeedbackService{*;}
-keep public class comalibabamtllogmodel.LogField {public{*;}
-keep classcomtaobao.securityjni.**{*;}
-keep class comtaobaowireless.security.**{*;}
-keepclass com.ut.secbody.**{*;}
-keep class comta.utdid2device.*{*;}
3. 开始使用
(1)反馈组件初始化:
FeedbackAPI.init(application,appkeyappSecret);
参数说明:
application:Application
对象
appkey
: 阿里云上应用的唯一标识,阿里云控制台可查询到
appSecret
: 阿里云上应用的 appSecret 阿里云控制台可查询到
(2)打开用户反馈界面:
另起一个 Activity 打开用户反馈 H5 界面
fragment 的使用务必使用上还setFeedbackFragment 的回调在xml中声明tragment那种方式暂时不支持包装fragment的activity务必调用 FeedbackAPlcleanFeedbackFragment此时的Frament是suppor-v4包中的Fragment。
(3)获取反领未读数:
FeedbackAPI.getFeedbackUnreadCount(IUnreadCountCallback callback)
参数callback:onSuccess(intcount)
回调方法 count 指示当前未读消息数
(4)设置反馈消息自定义参数:
.FeedbackAPI.setAppExtInfo(JSONObject extInfo)
参数 extinfo:反馈消息自定义 son 对象数据,可以在反馈控制台查看这些自定义数据
4. Demo
地址:
https://github.com/aptentity/alicioud-android-demo.git
注意:
demo 工程中,FeedbackAPl.init 被调用了多次,这是为了能够达到实时更新配置的效果,实际使用上建议只在 Application 中,调用 FeedbackAPl.init 方法一次即可。