文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>即时通信 IM>Demo 专区>快速跑通>移动端>Flutter

Flutter

最近更新时间：2025-12-04 11:53:22

我的收藏

本页目录：

本文介绍如何快速跑通 IM Demo 来体验文字、语音、视频等消息发送功能。跑通后运行效果如下图所示：
登录页
会话列表页
聊天页




快速体验

您可以前往该页面体验各端 Chat Demo：体验 Demo。

前提条件

开通服务

1. 登录 即时通信 IM 控制台。如果您已有应用，请记录其 SDKAppID 和密钥信息。
2. 在应用管理页面，单击创建新应用。

3. 输入应用名称、选择适用的数据中心，单击确定即可完成应用的创建。



4. 在应用管理页面的 SDKAppID 列获取 SDKAppID 和密钥信息。

注意：
查看密钥信息需要验证身份。
密钥信息为敏感信息，为防止他人盗用，请妥善保管，谨防泄露。

环境准备

Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本
Android Studio Dolphin | 2021.3.1 及以上版本
Xcode 12.0 及以上版本

版本兼容性说明：

为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：版本说明。
Kotlin、Android Gradle Plugin 与 Gradle 的版本对应关系，请参阅 Kotlin 官方文档：Kotlin-Gradle 插件兼容性。
Android Studio 安装时如果您使用了默认的 JDK 版本比较高将有可能编译失败，建议使用 JDK 17 版本，请参阅：Java 版本切换
我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。

操作步骤

获取 Demo

说明：
为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。在正式上线商用前，请您替换为自己设计或拥有版权的其他表情包。请注意，下图所示的默认小黄脸表情包版权属于腾讯云，您可以通过升级至 IM 企业版套餐 免费使用该表情包。



1. 下载即时通信 Flutter IM Demo 工程，具体下载地址请参见 经典风格源码地址 或者 简约风格源码地址。
2. 使用 Android Studio 打开下载的 Demo 项目，Android Studio > File > Open > 选择 Demo 根目录，找到对应的 config 文件，路径为 lib/config.dart。
3. 设置 config 文件中的相关参数：
sdkAppID: 请设置为前文中获取的实际应用 SDKAppID。
key: 请设置为前文中获取的实际密钥信息 。
注意：
本文提到的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。

编译并运行 Demo

用 Android Studio 导入工程，并安装 Flutter 和 Dart 插件。



在项目根目录执行如下命令安装依赖。
flutter pub get
以运行 Android 设备为例：
将 Android 设备连接至电脑，在 Android 设备上打开开发者模式，启用 USB 调试，并且在 Android 设备上选择 USB 用于传输文件（如有）。
在 Android Studio 界面顶部的 Running devices 选项中选择您用来测试的 Android 设备。
点击运行按钮开始编译。编译成功后，您的设备上会自动安装好腾讯云 IM App。
打开 App，输入任意 UserID 即可创建并登录用户账号。

为方便测试消息互通，您可以创建两个不同的用户账号，添加好友后互相发送消息。
添加好友
搜索好友
通讯录新增好友
与好友聊天




开通内容审核功能
在消息发送、资料修改等场景中，可能会扩散不合适的内容，特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容，不仅严重损害了用户们的身心健康，还有可能违法并导致业务被监管部门查封。
即时通信 IM 支持 云端审核（反垃圾信息）功能，可针对不安全、不适宜的内容进行自动识别、处理，为您的产品体验和业务安全保驾护航。您可直接前往 云端审核控制台 开通免费试用，每个应用可免费试用7天（含10000次免费抵扣量）。

常见问题

iOS 端 Pods 依赖无法安装成功的问题

方案一：手动删除 ios/Pods 文件夹，及 ios/Podfile.lock 文件，并执行如下命令，重新安装依赖。
cd ios
sudo gem install ffi
pod install --repo-update
方案二：配置运行后，如果报错，可以单击 Product > Clean Build Folder，清除产物后重新运行 pod install 或 flutter run




佩戴 Apple Watch 时，真机调试 iOS 报错的问题




请将您的 Apple Watch 调整至飞行模式，并将 iPhone 的蓝牙功能通过设置 > 蓝牙彻底关闭。
重新启动 Xcode（若打开），并重新运行 flutter run 即可。

Flutter 环境的问题

如您需得知 Flutter 的环境是否存在问题，请运行 Flutter doctor 检测 Flutter 环境是否装好。

使用 Flutter 自动生成的项目，引入 TUIKit 后，运行 Android 端报错的问题




1. 打开 android\\app\\src\\main\\AndroidManifest.xml，根据如下，补全 xmlns:tools="http://schemas.android.com/tools" / android:label="@string/android_label" 及 tools:replace="android:label"。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
 package="替换成您的 Android 端包名"
 xmlns:tools="http://schemas.android.com/tools">
 <application
     android:label="@string/android_label"
     tools:replace="android:label"
     android:icon="@mipmap/ic_launcher" // 指定一个 icon 路径
     android:usesCleartextTraffic="true"
     android:requestLegacyExternalStorage="true">
2. 打开 android\\app\\build.gradle，补全 defaultConfig 中 minSdkVersion 及 targetSdkVersion。
defaultConfig {
  applicationId "" // 替换成您的Android端包名
  minSdkVersion 21
  targetSdkVersion 30
}

Windows 11 运行 Demo 报错的问题

报错一：
Error waiting for a debug connection: The log reader stopped unexpectedly, or never started. 
Error launching application on Windows.
1. 首先，将项目名称中的横线改为下划线。例如，将 "im-flutter-uikit-full-platform" 改为 "im_flutter_uikit_full_platform"。
2. 删除根目录下的 "windows" 文件夹。
3. 在命令行中运行以下命令：flutter create . --org=com.tencent.im.flutter。这将创建一个新的 Flutter 项目，并将其组织名称设置为 "com.tencent.im.flutter"。
4. 运行 flutter clean 命令以清除缓存。
5. 运行 flutter pub get 命令以获取项目所需的依赖项。
6. 最后，运行 flutter run -d windows 命令以在 Windows 平台上运行应用程序。
通过按照上述步骤操作，您可以尝试在新项目中运行应用程序，以确定问题是否出在您的项目中。如果新项目可以正常工作，则可以尝试将新项目中的 pubspec.yaml 文件复制到原来不工作的项目中，并保存以便 Flutter 可以运行新的 pubspec.yaml 代码。然后，您可以返回到旧的 pubspec.yaml 文件，这样它就可以正常工作了。
报错二：
Nuget.exe not found, trying to download or use cached version.
这个提示表明您的系统中没有找到 nuget.exe，因此程序尝试下载或使用缓存的版本。nuget.exe 是 NuGet 包管理器的命令行工具，用于在 .NET 项目中管理依赖项。
要解决此问题，您可以手动下载并安装 nuget.exe。以下是操作步骤：
1. 访问 NuGet 官方网站的下载页面：页面链接。
2. 在 "Command-line" 部分，找到 "Windows x86 Commandline"，点击 "Download" 下载 nuget.exe。
3. 将下载的 nuget.exe 文件保存到一个合适的位置，例如 C:\\NuGet。
4. 将 nuget.exe 的路径添加到系统的环境变量 PATH 中。这样，您就可以在命令行中全局访问 nuget.exe 。

错误码查询

IM SDK 的 API 层面错误码，请查看 错误码。

Demo 中语音转文字支持的数据中心

目前语音转文字仅支持中国数据中心的 SDKAppID 体验。
中国站
目录