tencent cloud

文档反馈

最后更新时间:2025-02-13 08:57:38
    本文主要介绍如何快速将腾讯云 Chat SDK 集成到您的 Flutter 项目中。

    环境要求

    平台
    版本
    Flutter
    2.2.0 及以上版本。
    Android
    Android Studio 3.5及以上版本,App 要求 Android 4.1及以上版本设备。
    iOS
    Xcode 11.0及以上版本,真机调试请确保您的项目已设置有效的开发者签名。

    支持平台

    我们致力于打造一套支持 Flutter 全平台的 Chat SDK 及 TUIKit,帮助您一套代码,全平台运行。
    平台
    支持状态
    iOS
    支持
    Android
    支持
    Web
    支持,4.1.1+2版本起
    macOS
    支持,4.1.9版本起
    Windows
    支持,4.1.9版本起
    混合开发 (将 Flutter SDK 添加至现有原生应用)
    5.0.0版本起支持
    说明:
    Web 平台需要简单的几步额外引入,详情请查看本文 Web 支持 部分。

    体验 DEMO

    在开始接入前,您可以体验我们的 DEMO,快速了解腾讯云 Chat Flutter 跨平台 SDK 及 TUIKit 的能力。
    以下各版本 DEMO,均由同一 Flutter 项目制作打包而成。 Desktop(macOS/Windows)平台,SDK 已支持,DEMO 将于近期上线。
    移动端 APP
    WEB - H5
    iOS/Android APP
    
    手机扫码体验在线Web版DEMO
    

    集成 Chat SDK

    您可以通过 pub add 的方式直接集成腾讯云 Chat SDK(Flutter),或者在 pubspec.yaml 中写入 Chat SDK 的方式来集成。

    flutter pub add 安装

    在终端窗口中输入如下命令(需要提前安装 Flutter 环境):
    flutter pub add tencent_cloud_chat_sdk

    在 pubspec.yaml 中写入

    dependencies:
    tencent_cloud_chat_sdk: "最新版本" //可在https://pub.dev/packages/tencent_cloud_chat_sdk 上查看im flutter sdk的最新版本并使用
    此时您的 editor 或许会自动 flutter pub get,如果没有请您在命令行中手动输入 flutter pub get。

    Flutter for Web 支持

    Chat SDK(tencent_cloud_chat_sdk) 4.1.1+2版本起,可兼容Web端。
    相比 Android 和 iOS 端,需要一些额外步骤。如下:

    升级 Flutter 3.x 版本

    Flutter 3.x 版本 针对 Web 性能做了较多优化,强烈建议您使用其来开发 Flutter Web 项目。

    引入 JS

    说明:
    如果您现有的 Flutter 项目不支持 Web,请在项目根目录下运行 flutter create . 添加 Web 支持。
    进入您项目的 web/ 目录,使用 npmyarn 安装相关JS依赖。初始化项目时,根据屏幕指引,进行即可。
    cd web
    
    npm init
    
    npm i tim-js-sdk
    
    npm i tim-upload-plugin
    打开 web/index.html ,在 <head> </head> 间引入这JS文件。如下:
    <script src="./node_modules/tim-upload-plugin/index.js"></script>
    <script src="./node_modules/tim-js-sdk/tim-js-friendship.js"></script>
    
    
    

    常见问题

    flutter pub get/add 失败如何解决?

    请参见官网配置 国内镜像
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持