本文主要介绍如何快速将腾讯云即时通信 IM SDK 集成到您的 Flutter 项目中。
环境要求
平台 | 版本 |
Flutter | 2.2.0 及以上版本。 |
Android | Android Studio 3.5及以上版本，App 要求 Android 4.1及以上版本设备。 |
iOS | Xcode 11.0及以上版本，真机调试请确保您的项目已设置有效的开发者签名。 |
支持平台
我们致力于打造一套支持 Flutter 全平台的即时通信 IM SDK 及 TUIKit，帮助您一套代码，全平台运行。
体验 DEMO
在开始接入前，您可以体验我们的 DEMO，快速了解腾讯云 IM Flutter 跨平台 SDK 及 TUIKit 的能力。
以下各版本 DEMO，均由同一 Flutter 项目制作打包而成。 Desktop(macOS/Windows)平台，SDK 已支持，DEMO 将于近期上线。
移动端 App | WEB - H5 |
iOS/Android App，自动判断平台下载  | 手机扫码体验在线 Web 版 DEMO  |
集成 IM 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。
引入并初始化 SDK
import 'package:tencent_cloud_chat_sdk/tencent_cloud_chat_sdk.dart';
拓展更多平台
腾讯云IM for Flutter 相关SDK默认支持 Android / iOS平台， 如果您需要拓展更多平台（ Web/Desktop ），请参考本部分。
Flutter for Web支持
我们的 SDK，TUIKit(tencent_cloud_chat_uikit) 0.1.5版本，无 UI 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 webnpm initnpm i @tencentcloud/chatnpm i tim-upload-plugin
打开
web/index.html ，在 <head> </head> 间引入 JS 文件。如下：<script src="./node_modules/tim-upload-plugin/index.js"></script><script src="./node_modules/@tencentcloud/chat/index.js"></script> <script src="./node_modules/@tencentcloud/chat/modules/group-module.js"></script> <script src="./node_modules/@tencentcloud/chat/modules/relationship-module.js"></script> <script src="./node_modules/@tencentcloud/chat/modules/signaling-module.js"></script>
Flutter for Desktop(PC) 支持
我们的 TUIKit(tencent_cloud_chat_uikit) 自 2.0.0 版本，无 UI SDK(tencent_cloud_chat_sdk) 4.1.9 版本起，可兼容 Desktop 端，包含 Windows / macOS / 桌面 Web。相比移动端，需要一些额外步骤。如下：
升级 Flutter 3.x 版本
从 Flutter 3.0 版本起，才可用于打包 desktop 端，因此，如需使用，请升级至 Flutter 3.x 版本。
macOS修改
打开
macos/Runner/DebugProfile.entitlements 文件。在
<dict></dict> 中，加入如下 key-value 键值对。<key>com.apple.security.app-sandbox</key><false/>
