Flutter

最后更新时间：2025-12-02 10:15:18
Flutter
最后更新时间： 2025-12-02 10:15:18
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+1
  tencent_cloud_chat_conversation: ^4.1.0
  tencent_cloud_chat_message: ^4.1.0+3
  tencent_cloud_chat_contact: ^4.1.0
  tencent_cloud_chat_sticker: ^4.1.0
  tencent_cloud_chat_message_reaction: ^4.1.0
  tencent_cloud_chat_text_translate: ^4.1.0
  tencent_cloud_chat_sound_to_text: ^4.1.0
3. 配置权限。
由于 TUIKit 运行需要拍摄/相册/录音/网络等权限，需要您在 Native 的文件中手动声明，才可正常使用相关能力。
Android
iOS
打开 android/app/src/main/AndroidManifest.xml 添加权限:
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission
    android: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"    
        end
    target.build_configurations.each do |config|
          config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
            '$(inherited)',
            'PERMISSION_MICROPHONE=1',
            'PERMISSION_CAMERA=1',
            'PERMISSION_PHOTOS=1',
          ]
        end
  end
end
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>
至此，你已经成功将 TUIKit 集成到你的项目中。如果您想要继续构建聊天、会话等基础界面，请参考 Demo 示例。
常见问题
Android 平台运行报错：Unsupported class file major version 65
原因：
Unsupported class file major version 65（​​版本 65​​ 对应的是 ​​Java 21​​，Java 每个版本都有一个 class 文件版本号）。
项目使用了过旧的 Gradle 版本或系统安装了高于项目支持的 Java 版本。
解决方法：
建议使用 JDK 17 版本，请参阅：Java 版本切换。
本页内容是否解决了您的问题？
您也可以联系销售或提交工单以寻求帮助。
是
否
文档反馈
tencent cloud

前提条件

集成 TUIKit

常见问题

Android 平台运行报错：Unsupported class file major version 65
