tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Chat
    Documentation
    Download PDF

    Flutter

    Last updated: 2025-02-13 08:57:38
    Download PDF
      This document describes how to quickly integrate the Tencent Cloud Chat SDK into your Flutter project.

      Environment Requirements

      Platform
      Version
      Flutter
      2.2.0 or later
      Android
      Android Studio 3.5 or later; devices with Android 4.1 or later for apps
      iOS
      Xcode 11.0 or later. For testing with a real device, ensure that your project has a valid developer signature.

      Supported Platforms

      We are committed to building a set of Chat SDK and TUIKit for all Flutter platforms, allowing you to run one set of code across all platforms.
      Platform
      Support or Not
      iOS
      Supported
      Android
      Supported
      Web
      Supported from v4.1.1+2
      macOS
      Supported from v4.1.9
      Windows
      Supported from v4.1.9
      Hybrid development (Adding SDK for Flutter to existing native applications)
      Supported from v5.0.0
      Note:
      For web, you need to perform a few extra steps for SDK integration. For details, see Support for the Flutter for Web in this document.

      Trying Out Demos

      Before integration, you can try out our demos to quickly understand the capabilities of the Tencent Cloud Chat cross-platform SDK and TUIKit for Flutter.
      All of the following demos are packaged by the same Flutter project. The Chat SDK for Flutter already supports desktop platforms (macOS/Windows), and the corresponding demo will be available soon.
      Mobile App
      Web - HTML5
      iOS/Android app
      
      
      Scan the QR code with your mobile phone to try out
      
      

      Integrating the Chat SDK

      You can directly integrate the Chat SDK for Flutter through pub add, or write the Chat SDK into pubspec.yaml.

      Installing the Chat SDK via flutter pub add

      Enter the following command in the terminal window (the Flutter environment is ready):
      flutter pub add tencent_cloud_chat_sdk

      Writing the Chat SDK into pubspec.yaml

      dependencies:
        tencent_cloud_chat_sdk: "Latest version" // You can check the latest version of the Chat SDK for Flutter on https://pub.dev/packages/tencent_cloud_chat_sdk
      Here, your editor may automatically run flutter pub get. If not, enter the command flutter pub get.

      Support for the Flutter for Web

      Chat SDK (tencent_cloud_chat_sdk) 4.1.1+2 or later provides full compatibility with web.
      To enable support for web, you need to perform the following extra steps, compared with the steps to enable support for Android and iOS:

      Upgrading to Flutter 3.x

      Flutter 3.x has been dramatically optimized for web performance and is highly recommended for Flutter web project development.

      Importing JS

      Note:
      If your existing Flutter project does not support web, run flutter create . in the root directory of the project to add web support.
      Go to the web/ directory of your project and use npm or Yarn to install related JS dependencies. To initialize the project, follow the on-screen instructions.
      cd web
      
      npm init
      
      npm i tim-js-sdk
      
      npm i tim-upload-plugin
      Open web/index.html and import the JS files in <head> </head>. See below:
      <script src="./node_modules/tim-upload-plugin/index.js"></script>
      <script src="./node_modules/tim-js-sdk/tim-js-friendship.js"></script>
      
      
      

      FAQs

      What should I do if flutter pub get/add fails?

      Configure Flutter to use a mirror site as instructed in Flutter.
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2025 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy