安卓-5分钟集成自定义UI[萝卜丝]

5分钟集成自定义UI

• Demo

准备工作

• 到萝卜丝官网注册管理员账号，并登录管理后台。
• 到 所有设置->应用管理->App 添加应用，填写相关信息之后点击确定，在生成记录中可见appkey，后面会用到。
• 到 所有设置->客服管理->客服账号 添加客服账号。注意：生成记录中有一列 ‘唯一ID(uid)’ 会在指定客服接口中使用
• 到 所有设置->客服管理->技能组 添加技能组，并可将客服账号添加到相关技能组。注意：生成记录中有一列 ‘唯一ID（wId）’ 会在工作组会话中用到

开始集成

第一步：在总项目build.gradle的 allprojects -> repositories 添加

maven {
    url  "https://dl.bintray.com/jackning/maven"
}

修改完后，效果如下：

allprojects {
    repositories {
        jcenter()
        google()
        maven {
            url  "https://dl.bintray.com/jackning/maven"
        }
    }
}

文件末尾添加

ext {
    // Sdk and tools
    minSdkVersion = 18
    targetSdkVersion = 26
    compileSdkVersion = 28
    buildToolsVersion = '28.0.3'
    supportLibVersion = '28.0.0'

    appcompatVersion= '1.1.0-rc01'
    butterknifeVersion = '10.1.0'
    recyleviewxVersion = '1.1.0-beta01'
    stethoVersion = '1.5.1'

    archLifecycleVersion = "2.2.0-alpha02"
    archRoomVersion = "2.1.0"
}

第二步：复制bytedesk-ui库到自己项目目录

开发者可以参考demo，直接从demo目录中复制到自己项目中

第三步：在总项目的settings.gradle末尾添加

include ':bytedesk-ui'

添加完毕后，同步 Sync Now

第四步：在module的build.gradle android{}添加

android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    ...
}

第五步：在module的build.gradle dependencies{}添加

// 萝卜丝第三步
// 加载萝卜丝核心库
implementation 'com.bytedesk:core:2.0.2'
// 加载萝卜丝自定义UI库
implementation project(':bytedesk-ui')

// 腾讯QMUI界面库
// http://qmuiteam.com/android/page/start.html
// https://bintray.com/chanthuang/qmuirepo
implementation 'com.qmuiteam:qmui:1.4.0'

第六步：AndroidManifest.xml添加权限

第七步：AndroidManifest.xml添加Activity和Service

第八步：在样式文件styles.xml中添加

第九部：初始化UI和建立长连接

参考demo中MainActivity.java

// 初始化萝卜丝UI界面库
BDUiApi.init(this);
// 具体代码请参考MainActivity.java
anonymousLogin();

第十步：开始客服会话

// 打开客服对话界面
BDUiApi.startWorkGroupChatActivity(context, wId, "工作组客服");

集成完毕