配置与起步
将KF5SDKLibrary导入到Eclipse并复制到WorkSpace,步骤如下。
1.点击Import,选择Existing Android Code Into Workspace
2.点击Browse,找到KF5SDKLibrary的路径,选中KF5SDKLibrary
注意:一定要选择:Copy projects into workSpace,依赖工程包的路径必须同与之关联的工程的workspace一致,否则会出现报错。
3.将导入的SDK包依赖到自己的工程:选中Properties;
4. 点击Add,选择KF5SDKLibrary
同时在应用程序manifest.xml文件声明:直接拷贝进去即可;
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<activity
android:name="com.chosen.kf5sdk.FeedBackActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.FeedBackDetailsActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.HelpCenterActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.HelpCenterTypeActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.HelpCenterTypeChildActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.HelpCenterTypeDetailsActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:hardwareAccelerated="true" >
</activity>
<activity
android:name="com.chosen.kf5sdk.LookFeedBackActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.ImageActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.OrderAttributeActivity"
android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
<activity
android:name="com.chosen.kf5sdk.LinkUrlActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:hardwareAccelerated="true" >
</activity>
方法说明
1.开发者在应用程序Application中调用全局设置初始化方法:
KF5SDKInitializer.initialize(context);
2.初始化用户信息方法:
KF5SDKConfig.INSTANCE.init(context, userInfo, callBack);
3.初始化参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
context | Context | 是 | 当前上下文 |
userInfo | UserInfo | 是 | 用户信息封装类,详情请见步骤4 |
callback | CallBack | 是 | 回调接口 |
4.UserInfo属性说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
String | 是 | 登录邮箱 | |
password | String | 否 | 登录密码 |
appid | String | 是 | 传输秘钥 |
helpAddress | String | 是 | 平台地址 |
name | String | 否 | 用户昵称 |
登录邮箱:验证逻辑是当前登录邮箱不存在时,则自动注册并登录,邮箱存在,则为登录。
登录密码:体分为两种情况,第一,该用户已存在,如果填写了密码,则验证密码,否则不验证;第二,该用户不存在,如果填写了密码,则注册并登录,同时设置登录密码;否则只是注册并登录,未设置密码。
传输秘钥:传输秘钥的具体生成方式如下,登录您所注册的云客服平台—>系统设置—>移动APP SDK —>添加一个APP —>(设置完成之后)提交—>查看与编辑—>最后找到传输秘钥栏目;传输秘钥的建立与设置权限需要是管理员角色。 由于传输秘钥长度过长使得内容框无法正常显示完,请开发者在复制appid的时候光标移动复制完全。以免出现validate failed的错误提示,出现该错误提示的原因有两个:第一是传输秘钥复制不完整,第二传输秘钥已被删除。
平台地址:即您所注册的平台地址,如 helptest.kf5.com;
用户昵称:如果当前用户已存在,则填写的用户昵称不能被修改;如果用户不存在,如果未填,则用户昵称默认使用登录邮箱@之前的字符串,如果填写,则使用当前初始化的昵称;
注:资源包里面提供了界面,对于界面的修改,可以修改组件的属性和布局以及背景,但是ID不能修改,由于已将源代码打包,修改了ID会报出空指针异常。