跑通 Demo

本文介绍如何快速跑通 Chat Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页
会话列表页
聊天页
﻿
﻿
﻿
快速体验
您可以前往该页面体验各端 Chat Demo：体验 Demo。
前提条件
开通服务
1. 登录控制台。如果您已有应用，请记录其 SDKAppID 和密钥信息。
2. 单击创建应用，在对话框中输入您的应用名称，选择产品、部署区域，单击创建来创建应用。
﻿
3. 创建完成后，可在控制台总览页查看新建应用的 SDKAppID、SDKSecretKey，后续运行 Demo 时需要用到这两个信息。
﻿
注意：
请妥善保管 SDKSecretKey，谨防泄露！
环境准备
Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本
Android Studio Ladybug | 2024.2.1 及以上版本，Android Gradle plugin 7.3.1 以上版本，JDK 17 版本。
Xcode 12.0 及以上版本
﻿版本兼容性说明：
﻿
为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：版本说明﻿。
Kotlin、Android Gradle Plugin 与 Gradle 的版本对应关系，请参阅 Kotlin 官方文档：Kotlin-Gradle 插件兼容性﻿。
使用 JDK 17 版本，其他版本可能导致编译失败，请参阅：Java 版本切换。
我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
操作步骤
获取 Demo
说明：
为尊重表情设计版权，Chat Demo/TUIKit 工程中不包含大表情元素切图，正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的小黄脸表情包版权归腾讯云所有，您可以通过升级至 Chat 专业版 Plus 和企业版 免费使用该表情包。
﻿
1. 下载即时通信 Flutter Chat UIKit 工程。
2. 使用 Android Studio 打开下载的 chat/demo 项目，Android Studio > File > Open > 选择 demo 根目录，找到对应的 login_page 文件，路径为 lib/login_page.dart。
3. 设置 login_page 文件中的相关参数：
SDKAppID: 请设置为前文中获取的实际应用 SDKAppID。
SecretKey: 请设置为前文中获取的实际密钥信息 。
禁止：
本文提到的获取 UserSig 的方案是在客户端代码中配置 SecretKey，该方法中 SecretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
编译并运行 Demo
用 Android Studio 导入工程，并安装 Flutter 和 Dart 插件。
﻿
在项目根目录执行如下命令安装依赖。
flutter pub get
以运行 Android 设备为例：
将 Android 设备连接至电脑，在 Android 设备上打开开发者模式，启用 USB 调试，并且在 Android 设备上选择 USB 用于传输文件（如有）。
在 Android Studio 界面顶部的 Running devices 选项中选择您用来测试的 Android 设备。
点击运行按钮开始编译。编译成功后，您的设备上会自动安装好 Chat App。
打开 App，输入任意 UserID 即可创建并登录用户账号。
﻿
为方便测试消息互通，您可以创建两个不同的用户账号，添加好友后互相发送消息。
添加好友
搜索好友
通讯录新增好友
与好友聊天
﻿
﻿
﻿
﻿
常见问题
iOS 端 Pods 依赖无法安装成功的问题？
方案一：手动删除 ios/Pods 文件夹，及 ios/Podfile.lock 文件，并执行如下命令，重新安装依赖。
cd ios
sudo gem install ffi
pod install --repo-update
方案二：配置运行后，如果报错，可以单击 Product > Clean Build Folder，清除产物后重新运行 pod install 或 flutter run
﻿
Flutter 环境的问题？
如您需得知 Flutter 的环境是否存在问题，请运行 Flutter doctor 检测 Flutter 环境是否装好。
使用 Flutter 自动生成的项目，引入 TUIKit 后，运行 Android 端报错的问题？
﻿
1. 打开 android\app\src\main\AndroidManifest.xml，根据如下，补全 xmlns:tools="http://schemas.android.com/tools" / android:label="@string/android_label" 及 tools:replace="android:label"。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
 package="替换成您的 Android 端包名"
 xmlns:tools="http://schemas.android.com/tools">
 <application
     android:label="@string/android_label"
     tools:replace="android:label"
     android:icon="@mipmap/ic_launcher" // 指定一个 icon 路径
     android:usesCleartextTraffic="true"
     android:requestLegacyExternalStorage="true">
2. 打开 android\app\build.gradle，补全 defaultConfig 中 minSdkVersion 及 targetSdkVersion。
defaultConfig {
  applicationId "" // 替换成您的Android端包名
  minSdkVersion 21
  targetSdkVersion 30
}
Demo 中语音转文字支持的数据中心？
目前语音转文字仅支持中国数据中心的 SDKAppID 体验。
联系我们
如果您在接入或使用过程中有任何疑问或者建议，欢迎 联系我们 提交反馈。
﻿
添加好友	搜索好友	通讯录新增好友	与好友聊天