产品动态
公告
Flutter（V2）
聚焦模式
字号
TUIKit 是基于 Chat SDK 的一款 UI 组件库，可通过 UI 组件快速实现聊天、会话、关系链、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
注意：
为尊重表情设计版权，Chat Demo/TUIKit 工程中不包含大表情元素切图，正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的小黄脸表情包版权归腾讯云所有，您可以通过升级至 Chat 专业版 Plus 和企业版 免费使用该表情包。
前提条件
Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本
Android Studio 2022.3.1 及之后的版本，Android Gradle plugin 7.3.1 以上版本
Xcode 12.0 及以上版本
一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
SDKSecretKey：应用的密钥。
版本兼容性说明：
为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：版本说明。
Kotlin、Android Gradle Plugin 与 Gradle 的版本对应关系，请参阅 Kotlin 官方文档：Kotlin-Gradle 插件兼容性。
Android Studio 安装时如果默认使用的 JDK 版本比较高可能会编译失败，建议使用 JDK 17 版本，请参阅：Java 版本切换。
我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
集成 TUIKit
1. 请参见 Flutter 文档 快速创建一个 Flutter 应用。
2. 在项目根目录 pubspec.yaml 中添加如下依赖：
tencent_cloud_chat_common: ^4.1.0+1tencent_cloud_chat_conversation: ^4.1.0tencent_cloud_chat_message: ^4.1.0+3tencent_cloud_chat_contact: ^4.1.0tencent_cloud_chat_sticker: ^4.1.0tencent_cloud_chat_message_reaction: ^4.1.0tencent_cloud_chat_text_translate: ^4.1.0tencent_cloud_chat_sound_to_text: ^4.1.0
3. 配置权限。
由于 TUIKit 运行需要拍摄/相册/录音/网络等权限，需要您在 Native 的文件中手动声明，才可正常使用相关能力。
打开
android/app/src/main/AndroidManifest.xml 添加权限:<uses-permission android:name="android.permission.RECORD_AUDIO" /><uses-permissionandroid:name="android.permission.READ_EXTERNAL_STORAGE"android:maxSdkVersion="32" /><uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /><!-- Compatibility for Android13 --><uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
1. 打开 ios/Podfile ，在文件末尾新增如下权限代码：
post_install do |installer|installer.pods_project.targets.each do |target|flutter_additional_ios_build_settings(target)target.build_configurations.each do |config|config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'config.build_settings['ENABLE_BITCODE'] = 'NO'config.build_settings["ONLY_ACTIVE_ARCH"] = "NO"endtarget.build_configurations.each do |config|config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= ['$(inherited)','PERMISSION_MICROPHONE=1','PERMISSION_CAMERA=1','PERMISSION_PHOTOS=1',]endendend
2. 2、打开 ios/Runner/info.plist，添加权限描述 key
<key>NSCameraUsageDescription</key><string>Our app requires access to your camera to enable video calling and capturing photos or videos to share in your conversations.</string><key>NSMicrophoneUsageDescription</key><string>Our app requires access to your microphone to enable voice and video calling features.</string><key>NSPhotoLibraryUsageDescription</key><string>Our app requires access to your photo library to enable sharing photos, videos, and files in your conversations.</string>
常见问题
Android 平台运行报错：Unsupported class file major version 65
原因：
Unsupported class file major version 65（版本 65 对应的是 Java 21，Java 每个版本都有一个 class 文件版本号）。
项目使用了过旧的 Gradle 版本或系统安装了高于项目支持的 Java 版本。
解决方法：
文档反馈