TUIKit

TUIKit is a UI component library built on the Chat SDK. It enables rapid implementation of chat, conversation, search, relationship chain, and group management features through ready-to-use UI components. Message sending and receiving are handled by the TUIChat component. This guide explains how to quickly integrate TUIKit and implement its core features.
Key Concepts
Classic UI: Starting from version 5.7.1435, TUIKit supports modular integration and provides the Classic UI (WeChat-style).
Minimalist UI: Starting from version 6.9.3557, TUIKit introduces a new Minimalist UI (WhatsApp-style).
You can select either the Classic or Minimalist UI components as needed. If you are unfamiliar with the appearance of each UI library, see TUIKit UI Library Introduction.
Note：
This demo uses TRTC's emoji pack with restricted licensing.
Commercial Usage Options
Option A: Keep Our Emoji (Recommended) 
Upgrade to Chat Pro Plus or Enterprise Plan and use our emoji pack at no additional cost.
Option B: Use Your Own
Replace default emoji with your own custom designs, or use emoji packs with proper commercial licensing.
﻿
﻿
﻿
Prerequisites
Xcode 10 or later
iOS 9.0 or later (physical device or simulator)
CocoaPods 1.7.5 or later. If you have not installed CocoaPods, see CocoaPods Guides - Getting Started.
A valid Tencent Cloud account and Chat application. See Enable Service to obtain the following information from the console:
SDKAppID: The Chat application ID from the console, serving as your app’s unique identifier.
SDKSecretKey: The application's secret key.
CocoaPods Integration
1. Create a Podfile. Navigate to your project directory and run the following command to generate a Podfile:
pod init
2. Add the required TUIKit components to your Podfile based on your business needs. Components are independent; adding or removing them does not affect project compilation. TUIKit supports two integration methods:
Remote CocoaPods Integration
Local Development Pods Integration
  The following table summarizes the advantages and disadvantages of each integration method:
Integration Method
Scenarios
Advantages
Disadvantages
Remote CocoaPods
Used when no source code modification is required.
To update TUIKit, simply run pod update.
If you modify the source code, running pod update will overwrite your changes with the latest TUIKit version.
Local Development Pods
Recommended for customizing the source code.
If you use your own git repository, you can track changes. Updating other remote Pod libraries with pod update will not overwrite your customizations.
You must manually update your local TUIKit folder by replacing it with the latest source code.
Choose one of the following methods to integrate TUIKit:
Remote CocoaPods Integration
Local DevelopmentPods Integration
Note：
1. Starting from version 8.5.6870, TUIKit supports Swift components.
2. If you add only pod 'TUIChat' in your Podfile without specifying Classic or Minimalist UI, both UI component versions will be integrated by default.
3. Classic and Minimalist UI cannot be mixed. When integrating multiple components, select either all Classic UI or all Minimalist UI components. For example, the Classic TUIChat component must be used with Classic TUIConversation and TUIContact components. Similarly, the Minimalist TUIChat component must be used with Minimalist TUIConversation and TUIContact components.
4. If you use Swift, enable use_modular_headers! and use the @import module format for header imports.
Add the required component libraries to your Podfile as needed:
Minimalist UI
Classic UI
Swift
Objective-C
# Uncomment the next line to define a global platform for your project
# ...
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
# Prevent `*.xcassets` in TUIKit from conflicting with your project
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  use_frameworks!
  use_modular_headers!
﻿
  # Integrate the chat feature
  pod 'TUIChat_Swift/UI_Minimalist' 
  # Integrate the conversation list feature
  pod 'TUIConversation_Swift/UI_Minimalist'
  # Integrate the relationship chain feature
  pod 'TUIContact_Swift/UI_Minimalist'
  # Integrate the search feature (To use this feature, you need to purchase the  Pro edition 、Pro Plus edition or Enterprise edition)
  pod 'TUISearch_Swift/UI_Minimalist' 
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  # Integrate Translation Plugin(Value-added feature activation required, please contact Tencent Cloud Business to activate)
  pod 'TUITranslationPlugin_Swift'  
  # Integrate Session Tagging Plugin
  pod 'TUIConversationMarkPlugin_Swift'
  # Integrate Speech-to-Text Plugin
  pod 'TUIVoiceToTextPlugin_Swift'
end
﻿
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
# Uncomment the next line to define a global platform for your project
# ...
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
# Prevent `*.xcassets` in TUIKit from conflicting with your project
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  # Comment the next line if you don't want to use dynamic frameworks
  # TUIKit components are dependent on static libraries. Therefore, you need to mask the configuration.
  # use_frameworks!
﻿
  # Enable modular headers as needed. Only after you enable modular headers, the Pod module can be imported using @import.
  # use_modular_headers!
﻿
  # Integrate the chat feature
  pod 'TUIChat/UI_Minimalist' 
  # Integrate the conversation list feature
  pod 'TUIConversation/UI_Minimalist'
  # Integrate the relationship chain feature
  pod 'TUIContact/UI_Minimalist'
  # Integrate the search feature (To use this feature, you need to purchase the  Pro edition 、Pro Plus edition or Enterprise edition)
  pod 'TUISearch/UI_Minimalist' 
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  # Integrate Translation Plugin, supported starting from version 7.2 (Value-added feature activation required, please contact Tencent Cloud Business to activate)
  pod 'TUITranslationPlugin'  
  # Integrate Session Tagging Plugin, supported starting from version 7.3
  pod 'TUIConversationMarkPlugin'
  # Integrate Speech-to-Text Plugin, supported starting from version 7.5
  pod 'TUIVoiceToTextPlugin'
  # Integrate message push plugin, supported starting from version 7.6
  pod 'TIMPush'
end
﻿
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
Swift
Objective-C
# Uncomment the next line to define a global platform for your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
# Prevent `*.xcassets` in TUIKit from conflicting with your project
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  use_modular_headers!
﻿
  # Integrate the chat feature
  pod 'TUIChat_Swift/UI_Classic' 
  # Integrate the conversation list feature
  pod 'TUIConversation_Swift/UI_Classic'
  # Integrate the relationship chain feature
  pod 'TUIContact_Swift/UI_Classic'
  # Integrate the search feature (To use this feature, you need to purchase the  Pro edition 、Pro Plus edition or Enterprise edition)
  pod 'TUISearch_Swift/UI_Classic' 
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  # Integrate Voting Plugin
  pod 'TUIPollPlugin_Swift'
  # Integrate Group Chain Plugin
  pod 'TUIGroupNotePlugin_Swift'
  # Integrate Translation Plugin (Value-added feature activation required, please contact Tencent Cloud Business to activate)
  pod 'TUITranslationPlugin_Swift'  
  # Integrate Session Grouping Plugin
  pod 'TUIConversationGroupPlugin_Swift'
  # Integrate Session Tagging Plugin
  pod 'TUIConversationMarkPlugin_Swift'
  # Integrate Speech-to-Text Plugin
  pod 'TUIVoiceToTextPlugin_Swift'
  # Integrate Customer Service Plugin
  pod 'TUICustomerServicePlugin_Swift'
﻿
end
﻿
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
# Uncomment the next line to define a global platform for your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
# Prevent `*.xcassets` in TUIKit from conflicting with your project
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  # Comment the next line if you don't want to use dynamic frameworks
  # TUIKit components are dependent on static libraries. Therefore, you need to mask the configuration.
  # use_frameworks!
﻿
  # Enable modular headers as needed. Only after you enable modular headers, the Pod module can be imported using @import.
  # use_modular_headers!
﻿
  # Integrate the chat feature
  pod 'TUIChat/UI_Classic' 
  # Integrate the conversation list feature
  pod 'TUIConversation/UI_Classic'
  # Integrate the relationship chain feature
  pod 'TUIContact/UI_Classic'
  # Integrate the search feature (To use this feature, you need to purchase the  Pro edition 、Pro Plus edition or Enterprise edition)
  pod 'TUISearch/UI_Classic' 
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  # Integrate Voting Plugin, supported starting from version 7.1
  pod 'TUIPollPlugin'
  # Integrate Group Chain Plugin, supported starting from version 7.1
  pod 'TUIGroupNotePlugin'
  # Integrate Translation Plugin, supported starting from version 7.2 (Value-added feature activation required, please contact Tencent Cloud Business to activate)
  pod 'TUITranslationPlugin'  
  # Integrate Session Grouping Plugin, supported starting from version 7.3
  pod 'TUIConversationGroupPlugin'
  # Integrate Session Tagging Plugin, supported starting from version 7.3
  pod 'TUIConversationMarkPlugin'
  # Integrate Speech-to-Text Plugin, supported starting from version 7.5
  pod 'TUIVoiceToTextPlugin'
  # Integrate Customer Service Plugin, supported starting from version 7.6
  pod 'TUICustomerServicePlugin'
  # Integrate message push plugin, supported starting from version 7.6
  pod 'TIMPush'
﻿
end
﻿
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
﻿
After updating your Podfile, run the following command to install the TUIKit components:
pod install
Note：
1. If you cannot install the latest version of TUIKit, run pod repo update to update your local CocoaPods repository, then run pod update to update the component library version.
2. If you encounter third-party library version conflicts, see CocoaPods FAQs - Dependency Version Conflicts.
After successfully integrating all TUIKit components, your project directory should resemble the following:
﻿
﻿
﻿
1. Download the TUIKit source code from GitHub and add the TUIKit directory directly to your project directory:
﻿Swift TUIKit Source Code GitHub:
﻿
﻿
﻿
﻿Objective-C TUIKit Source Code GitHub:
﻿
﻿
﻿
2. Specify the local path for each component in your Podfile. The :path parameter value depends on the TUIKit folder’s location relative to the Podfile:
Common path configurations:
TUIKit is in the parent directory of the Podfile: pod 'TUICore', :path => "../TUIKit/TUICore"
TUIKit is in the current directory of the Podfile: pod 'TUICore', :path => "./TUIKit/TUICore"
TUIKit is in a subdirectory of the Podfile: pod 'TUICore', :path => "TUIKit/TUICore"
 The following Podfile path configuration assumes the TUIKit folder is in the parent directory of the Podfile:
DevelopmentPodfile
Swift
Objective-C
# Uncomment the next line to define a global platform for your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  use_frameworks!
  use_modular_headers!
﻿
  # Integrate the basic library (required)
  pod 'TUICore', :path => "../TUIKit/TUICore"
  pod 'TIMCommon_Swift', :path => "../TUIKit/TIMCommon"
  
  # Integrate TUIKit components (optional)
  # Integrate the chat feature
  pod 'TUIChat_Swift', :path => "../TUIKit/TUIChat"
  # Integrate the conversation list feature
  pod 'TUIConversation_Swift', :path => "../TUIKit/TUIConversation"
  # Integrate the relationship chain feature
  pod 'TUIContact_Swift', :path => "../TUIKit/TUIContact"
  # Integrate the search feature (To use this feature, you need to purchase the Ultimate edition)
  pod 'TUISearch_Swift', :path => "../TUIKit/TUISearch"
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  
  # Integrate the TUIKitPlugin plugin (optional)
  # Integrate translation plugin (Value-added feature activation is required. Please contact Tencent Cloud sales)
  pod 'TUITranslationPlugin_Swift'
  
  # Other Pods
  pod 'MJRefresh'
  pod 'SnapKit'
end
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
# Uncomment the next line to define a global platform for your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
install! 'cocoapods', :disable_input_output_paths => true
﻿
# Replace `your_project_name` with your actual project name
target 'your_project_name' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  use_frameworks!
  use_modular_headers!
﻿
  # Integrate the basic library (required)
  pod 'TUICore', :path => "../TUIKit/TUICore"
  pod 'TIMCommon', :path => "../TUIKit/TIMCommon"
  
  # Integrate TUIKit components (optional)
  # Integrate the chat feature
  pod 'TUIChat', :path => "../TUIKit/TUIChat"
  # Integrate the conversation list feature
  pod 'TUIConversation', :path => "../TUIKit/TUIConversation"
  # Integrate the relationship chain feature
  pod 'TUIContact', :path => "../TUIKit/TUIContact"
  # Integrate the search feature (To use this feature, you need to purchase the Ultimate edition)
  pod 'TUISearch', :path => "../TUIKit/TUISearch"
  # Integrate the audio/video call feature
  pod 'TUICallKit_Swift'
  # Integrate the video conference feature
  pod 'TUIRoomKit'
  
  # Integrate the TUIKitPlugin plugin (optional)
  # Note: The TUIKitPlugin plugin version must be the same as the TUICore version.
  # Ensure that the plugin version matches spec.version in "../TUIKit/TUICore/TUICore.spec".
  
  # Integrate the voting plugin, supported from version 7.1
  pod 'TUIPollPlugin'
  # Integrate the group chain plugin, supported from version 7.1
  pod 'TUIGroupNotePlugin'
  # Integrate translation plugin, supported from version 7.2 (Value-added feature activation is required. Please contact Tencent Cloud sales)
  pod 'TUITranslationPlugin'
  # Integrate the session grouping plugin, supported from version 7.3
  pod 'TUIConversationGroupPlugin'
  # Integrate the session tagging plugin, supported from version 7.3
  pod 'TUIConversationMarkPlugin'
  # Integrate the offline push feature
  pod 'TIMPush'
  
  # Other Pods
  pod 'MJRefresh'
  pod 'Masonry'
end
#Pods config
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|                
            #Fix Xcode14 Bundle target error
            config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
            config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
            config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
            config.build_settings['ENABLE_BITCODE'] = "NO"
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "13.0"
            #Fix Xcode15 other links  flag  -ld64
            xcode_version = `xcrun xcodebuild -version | grep Xcode | cut -d' ' -f2`.to_f
            if xcode_version >= 15
              xcconfig_path = config.base_configuration_reference.real_path
              xcconfig = File.read(xcconfig_path)
              if xcconfig.include?("OTHER_LDFLAGS") == false
                xcconfig = xcconfig + "\n" + 'OTHER_LDFLAGS = $(inherited) "-ld64"'
              else
                if xcconfig.include?("OTHER_LDFLAGS = $(inherited)") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS", "OTHER_LDFLAGS = $(inherited)")
                end
                if xcconfig.include?("-ld64") == false
                  xcconfig = xcconfig.sub("OTHER_LDFLAGS = $(inherited)", 'OTHER_LDFLAGS = $(inherited) "-ld64"')
                end
              end
              File.open(xcconfig_path, "w") { |file| file << xcconfig }
            end
        end
    end
end
3. After updating your Podfile, run the following command to install the TUIKit components:
pod install
Notes：
1. When using local integration, you must obtain the latest component code from GitHub and overwrite your local TUIKit directory when upgrading.
2. If you have private modifications that conflict with the remote repository, manually merge and resolve conflicts.
3. TUIKit plugins depend on the TUICore version. Ensure the plugin version matches the spec.version in ../TUIKit/TUICore/TUICore.spec.
4. If you encounter third-party library version conflicts, see CocoaPods FAQs - Dependency Version Conflicts.
Now you have successfully integrated TUIKit into your project. To continue building basic interfaces such as chat and conversation, see Build Chat Interface and Build Conversation List.﻿
FAQs
Xcode
Integration Error: [Xcodeproj] Unknown object version (60). (RuntimeError)
﻿
When creating a new project with Xcode 15 and integrating TUIKit, this error may occur after running pod install. It is caused by an outdated version of CocoaPods. There are two solutions:
Solution 1: Change your Xcode project’s Project Format version to Xcode 13.0.
﻿
 Solution 2: Upgrade your local version of CocoaPods. (Upgrade steps not detailed here.)
Assertion failed: (false && "compact unwind compressed function offset doesn't fit in 24 bits"), function operator(), file Layout.cpp.
﻿
Alternatively, when integrating TUIRoom with Xcode 15, you may encounter symbol conflicts in TUIRoomEngine caused by the latest linker. Both issues have the same root cause.
﻿
 Solution: Update the linker configuration. Add -ld64 to Other Linker Flags in Build Settings.
 Official document: https://developer.apple.com/forums/thread/735426﻿
﻿
Rosetta Simulator Issue
On Apple Silicon chips (M1/M2 series), you may see a popup due to some third-party libraries (such as SDWebImage) not supporting XCFramework. Apple provides a workaround: enable Rosetta on the simulator. The Rosetta option usually appears automatically during compilation.
﻿
Xcode 15 Developer Sandbox Option Error: Sandbox: bash(xxx) deny(1) file-write-create
﻿
 When creating a new project with Xcode 15, enabling this option may cause build and run failures. We recommend disabling this option.
﻿
Xcode 16 Does Not Support Framework Bitcode
Solution 1: Upgrade SDK
If you are using an older SDK version that includes Bitcode (such as TXIMSDK_iOS), upgrade to TXIMSDK_Plus_iOS_XCFramework as described in this documentation.
Solution 2: Modify Podfile Configuration
Add the following configuration to the end of your Podfile and run pod install again.
post_install do |installer|
  bitcode_strip_path = 'xcrun --find bitcode_strip'.chop!
  def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
    framework_path = File.join(Dir.pwd, framework_relative_path)
    command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
    puts "Stripping bitcode: #{command}"
    system(command)
  end
  framework_paths = [
    "/Pods/TXIMSDK_iOS/ImSDK.framework/ImSDK",
  ]
  framework_paths.each do |framework_relative_path|
    strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
   end
end
CocoaPods
Pod Dependency Version Mismatch When Using Remote Integration
 If you encounter a version mismatch between Podfile.lock and the plugin's TUICore dependency when using remote CocoaPods integration:
 Delete the Podfile.lock file, run pod repo update to update the local code repository, and then run pod update.
﻿
Pod Dependency Version Mismatch When Using Local Integration
When integrating TUI components (such as TUIChat, TUIConversation, TIMCommon, etc.) using local Development Pods, and integrating TUICallKit via remote CocoaPods, you may encounter dependency conflicts caused by inconsistent version numbers. This issue is specifically manifested as follows:
Locally integrated TUI components and their dependency TUICore use a default version number of 1.0.0.
Remotely integrated TUICallKit and its dependency TUICore use a specific remote version (for example, 7.5.4852).
This results in a version conflict for TUICore.
﻿
Solution：
To resolve this issue, align the version numbers of your local TUI components and TUICore with the version used by the remote TUICallKit. Follow these steps:
1.1 In Podfile_local, update the version numbers of the relevant local components to match the remote version.
1.2 In the TUICore.podspec file, set the version number to the same remote version (for example, 7.5.4852).By ensuring all components use a consistent version, you can avoid dependency conflicts during integration.
﻿Which third-party libraries does TUIKit depend on? What should I do if there are version conflicts?
﻿
TUIKit manages dependencies automatically via CocoaPods, so manual intervention is typically unnecessary. If you encounter version conflicts, ensure your third-party library versions meet the following minimum requirements:
Swift Components
Objective-C Components
- MJExtension (3.4.1)
- MJRefresh (3.7.5)
- SnapKit (5.7.1)
- SSZipArchive (2.4.3)
- SDWebImage (5.18.11)
- Masonry (1.1.0)
- MJExtension (3.4.1)
- MJRefresh (3.7.5)
- ReactiveObjC (3.1.1)
- SDWebImage (5.18.11):
  - SDWebImage/Core (= 5.18.11)
- SDWebImage/Core (5.18.11)
- SnapKit (5.6.0)
- SSZipArchive (2.4.3)
App Store Submission
Packaging Fails When Submitting to App Store, Error: Unsupported Architectures
The following error may occur during packaging: ImSDK_Plus.framework contains the x86_64 simulator version, which is not supported by the App Store. This is because the SDK includes the simulator version by default for developer debugging.
﻿
Solution：
 To remove the simulator version during packaging:
1.1 Select your project's Target, go to the Build Phases tab, and add a Run Script in the current panel.
﻿
1.2 In the new Run Script, add the following script:
#!/bin/sh
﻿
# Strip invalid architectures
strip_invalid_archs() {
    binary="$1"
    echo "current binary ${binary}"
    # Get architectures for current file
    archs="$(lipo -info "$binary" | rev | cut -d ':' -f1 | rev)"
    stripped=""
    for arch in $archs; do
        if ! [[ "${ARCHS}" == *"$arch"* ]]; then
            if [ -f "$binary" ]; then
                # Strip non-valid architectures in-place
                lipo -remove "$arch" -output "$binary" "$binary" || exit 1
                stripped="$stripped $arch"
            fi
        fi
    done
    if [[ "$stripped" ]]; then
        echo "Stripped $binary of architectures:$stripped"
    fi
}
﻿
APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"
﻿
# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
do
    FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
    FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
    echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"
    strip_invalid_archs "$FRAMEWORK_EXECUTABLE_PATH"
done
﻿
TUICallKit
TUICallKit Conflicts with Your Own Integrated Audio/Video Library?
 Tencent Cloud audio/video libraries cannot be integrated together, as symbol conflicts may occur. Handle this according to your scenario:
1.1 If you use the TXLiteAVSDK_TRTC library, no symbol conflicts will occur. Add the dependency in your Podfile:
pod 'TUICallKit_Swift'  
1.2 If you use the TXLiteAVSDK_Professional library, symbol conflicts will occur. Add the dependency in your Podfile:
  pod 'TUICallKit_Swift/Professional'
1.3 If you use the TXLiteAVSDK_Enterprise library, symbol conflicts will occur. We recommend upgrading to TXLiteAVSDK_Professional and then using TUICallKit_Swift/Professional.
What is the default timeout for call invitations?
 The default timeout for call invitations is 30 seconds.
If the invitee goes offline and comes back online within the invitation timeout, can they receive the invitation immediately?
1.1 For one-on-one call invitations, if the invitee goes offline and comes back online, they will receive the call invitation. TUIKit will automatically display the call invitation interface.
1.2 For group call invitations, if the invitee goes offline and comes back online, TUIKit will automatically retrieve invitations from the last 30 seconds and display the group call interface.
Contact Us
If you have any questions or suggestions, feel free to join our Telegram or WhatsApp community, or contact us for support.
Integration Method	Scenarios	Advantages	Disadvantages
Remote CocoaPods	Used when no source code modification is required.	To update TUIKit, simply run `pod update`.	If you modify the source code, running `pod update` will overwrite your changes with the latest TUIKit version.
Local Development Pods	Recommended for customizing the source code.	If you use your own git repository, you can track changes. Updating other remote Pod libraries with `pod update` will not overwrite your customizations.	You must manually update your local TUIKit folder by replacing it with the latest source code.