集成 SDK

本文主要介绍如何快速将腾讯云 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/ 目录，使用 npm 或 yarn 安装相关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 失败如何解决？
请参见官网配置 国内镜像。

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

平台	支持状态
iOS	支持
Android	支持
Web	支持，4.1.1+2版本起
macOS	支持，4.1.9版本起
Windows	支持，4.1.9版本起
混合开发（将 Flutter SDK 添加至现有原生应用）	5.0.0版本起支持

移动端 APP	WEB - H5
iOS/Android APP	手机扫码体验在线Web版DEMO