配置与起步

将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.初始化参数说明

参数名类型是否必填说明
contextContext当前上下文
userInfoUserInfo用户信息封装类,详情请见步骤4
callbackCallBack回调接口

4.UserInfo属性说明

参数名类型是否必填说明
emailString登录邮箱
passwordString登录密码
appidString传输秘钥
helpAddressString平台地址
nameString用户昵称

登录邮箱:验证逻辑是当前登录邮箱不存在时,则自动注册并登录,邮箱存在,则为登录。

登录密码:体分为两种情况,第一,该用户已存在,如果填写了密码,则验证密码,否则不验证;第二,该用户不存在,如果填写了密码,则注册并登录,同时设置登录密码;否则只是注册并登录,未设置密码。

传输秘钥:传输秘钥的具体生成方式如下,登录您所注册的云客服平台—>系统设置—>移动APP SDK —>添加一个APP —>(设置完成之后)提交—>查看与编辑—>最后找到传输秘钥栏目;传输秘钥的建立与设置权限需要是管理员角色。 由于传输秘钥长度过长使得内容框无法正常显示完,请开发者在复制appid的时候光标移动复制完全。以免出现validate failed的错误提示,出现该错误提示的原因有两个:第一是传输秘钥复制不完整,第二传输秘钥已被删除。

平台地址:即您所注册的平台地址,如 helptest.kf5.com;

用户昵称:如果当前用户已存在,则填写的用户昵称不能被修改;如果用户不存在,如果未填,则用户昵称默认使用登录邮箱@之前的字符串,如果填写,则使用当前初始化的昵称;

注:资源包里面提供了界面,对于界面的修改,可以修改组件的属性和布局以及背景,但是ID不能修改,由于已将源代码打包,修改了ID会报出空指针异常。