产品动态
公告
git clone https://github.com/Tencent-RTC/TUIKit_Android_Compose.git
atomic-x/├── src/main/│ ├── java/io/trtc/tuikit/atomicx/ # UI 组件源码(必需集成)│ ├── messagelist/ # 消息列表组件│ ├── messageinput/ # 消息输入组件│ ├── conversationlist/ # 会话列表组件│ ├── contactlist/ # 联系人列表组件│ ├── basecomponent/ # 基础组件│ └── ... # 其他 UI 组件│ # 资源文件(必需集成)│ ├── res/ # 公共资源│ ├── res-message-list/ # 消息列表组件资源│ ├── res-message-input/ # 消息输入组件资源│ ├── res-conversation-list/ # 会话列表组件资源│ └── ... # 其他组件资源chat/├── uikit/src/main/java/io/trtc/tuikit/chat/pages # Page 组件(参考实现)│ ├── ChatPage.kt│ ├── ContactsPage.kt│ └── ConversationsPage.kt└── demo/ # 示例应用(可选参考)

// settings.gradle.ktsinclude(":atomicx")project(":atomicx").projectDir = file("../TUIKit_Android_Compose/atomic-x")
// settings.gradleinclude ':atomicx'project(':atomicx').projectDir = new File(settingsDir, '../TUIKit_Android_Compose/atomic-x')
// app/build.gradle.ktsdependencies {implementation(project(":atomicx"))}
// app/build.gradledependencies {api project(':atomicx')}
application 节点中添加 tools:replace="android:allowBackup",覆盖组件内的设置,使用自己的设置。// app/src/main/AndroidManifest.xml<applicationandroid:name=".BaseApplication"android:allowBackup="false"android:icon="@drawable/app_ic_launcher"android:label="@string/app_name"android:largeHeap="true"android:theme="@style/AppTheme"tools:replace="android:allowBackup">
# gradle/libs.versions.toml[versions]agp = "8.13.0"kotlin = "2.0.21"coreKtx = "1.10.1"junit = "4.13.2"junitVersion = "1.1.5"espressoCore = "3.5.1"appcompat = "1.7.1"material = "1.13.0"runner = "1.0.2"espressoCoreVersion = "3.0.2"appcompatV7 = "28.0.0"tuicore = "8.6.7021"lifecycleRuntimeKtx = "2.8.7"ui = "1.8.0"foundation = "1.8.0"composeBom = "2024.09.00"activityCompose = "1.10.1"activity = "1.8.0"constraintlayout = "2.2.1"[libraries]androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }junit = { group = "junit", name = "junit", version.ref = "junit" }androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }material = { group = "com.google.android.material", name = "material", version.ref = "material" }runner = { group = "com.android.support.test", name = "runner", version.ref = "runner" }espresso-core = { group = "com.android.support.test.espresso", name = "espresso-core", version.ref = "espressoCoreVersion" }appcompat-v7 = { group = "com.android.support", name = "appcompat-v7", version.ref = "appcompatV7" }androidx-lifecycle-viewmodel-compose = { module = "androidx.lifecycle:lifecycle-viewmodel-compose", version.ref = "lifecycleRuntimeKtx" }androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }androidx-compose-foundation = { group = "androidx.compose.foundation", name = "foundation", version.ref = "foundation" }androidx-compose-ui = { group = "androidx.compose.ui", name = "ui", version.ref = "ui" }androidx-compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }androidx-compose-material3 = { group = "androidx.compose.material3", name = "material3" }androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycleRuntimeKtx" }androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }androidx-ui-test-manifest = { group = "androidx.compose.ui", name = "ui-test-manifest" }tuicore = { module = "com.tencent.liteav.tuikit:tuicore", version.ref = "tuicore" }com-tencent-mmkv = { group = "com.tencent", name = "mmkv", version = "1.3.14" }[plugins]android-application = { id = "com.android.application", version.ref = "agp" }kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }android-library = { id = "com.android.library", version.ref = "agp" }kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
// app/build.gradle.ktsplugins {// 添加 Compose 插件alias(libs.plugins.kotlin.compose)}android {// 开启 ComposebuildFeatures {compose = true}}
// app/build.gradleplugins {// 添加 Compose 插件id libs.plugins.kotlin.compose.get().pluginId}android {// 开启 ComposebuildFeatures {compose true}}
-keep class com.tencent.** { *; }

chat/demo/app/src/main/java/io/trtc/tuikit/chat/login/LoginActivity.kt 文件里实现:// 用户登录LoginStore.shared.login(context, SDKAPPID, userID, userSig,object : CompletionHandler {override fun onSuccess() {// 登录成功,可跳转聊天或会话页}override fun onFailure(code: Int, desc: String) {// 登录失败,可弹框报错}})

chat/uikit/src/main/java/io/trtc/tuikit/chat/pages/ConversationsPage.kt 文件里的实现,ConversationsPage 主要做了以下工作:@Composablefun ConversationsPage(onConversationClick: (ConversationInfo) -> Unit = {},editContent: @Composable () -> Unit = {},) {val colors = LocalTheme.current.colorsColumn(modifier = Modifier.fillMaxSize().background(Colors.Transparent)) {PageHeader(stringResource(R.string.chat_uikit_chat)) {editContent()}Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {ConversationList(modifier = Modifier.navigationBarsPadding(), onConversationClick = onConversationClick)}}}

chat/uikit/src/main/java/io/trtc/tuikit/chat/pages/ChatPage.kt 文件里的实现,ChatPage 主要做了以下工作:@Composablefun ChatPage(conversationID: String,locateMessage: MessageInfo? = null,onUserClick: (String) -> Unit,onChatHeaderClick: (String) -> Unit,onBackClick: () -> Unit,) {...val avatarUrl = conversationState.value?.avatarURLval displayName = conversationState.value?.titleval colors = LocalTheme.current.colorsScaffold(modifier = Modifier.background(color = colors.bgColorOperate).fillMaxSize().wrapContentHeight(), topBar = {Box(modifier = Modifier.background(color = colors.bgColorOperate).fillMaxWidth().statusBarsPadding()) {ChatHeader(avatarUrl = avatarUrl,name = displayName ?: "",onBackClick = onBackClick,onAvatarClick = {onChatHeaderClick(conversationID)})}},bottomBar = {Box(modifier = Modifier.fillMaxWidth().background(color = colors.bgColorOperate)) {MessageInput(modifier = Modifier.navigationBarsPadding(), conversationID = conversationID)}}) { padding ->Box(modifier = Modifier.padding(padding)) {MessageList(conversationID = conversationID, locateMessage = locateMessage) {onUserClick(it)}}}}

chat/uikit/src/main/java/io/trtc/tuikit/chat/pages/ContactsPage.kt 文件里的实现,ContactsPage 主要做了以下工作:@Composablefun ContactsPage(onContactClick: (ContactInfo) -> Unit = {},onGroupClick: (ContactInfo) -> Unit = {},editContent: @Composable () -> Unit = {},) {val colors = LocalTheme.current.colorsColumn(modifier = Modifier.fillMaxSize().background(Colors.Transparent)) {PageHeader(stringResource(R.string.chat_uikit_contacts)) {editContent()}Box(modifier = Modifier.fillMaxSize().navigationBarsPadding(), contentAlignment = Alignment.Center) {ContactList(onGroupClick = onGroupClick, onContactClick = onContactClick)}}}
Page | 回调 | 建议跳转逻辑 |
ConversationsPage | onConversationClick: (ConversationInfo) -> Unit | 点击会话列表中的会话时触发,建议跳转到聊天页面(ChatPage)。 |
ContactsPage | onContactClick: (ContactInfo) -> Unit | 点击联系人 cell 时触发,建议跳转用户信息页(C2CChatSetting)。 |
| onGroupClick: (ContactInfo) -> Unit | 点击群组 cell 时触发,建议跳转群聊页面(ChatPage)。 |
ChatPage | onUserClick: (String) -> Unit | 点击消息中的用户头像或昵称时触发,建议跳转用户信息页(C2CChatSetting)。 |
| onChatHeaderClick: (String) -> Unit | 点击导航栏中的头像时触发,建议跳转用户信息页(C2CChatSetting)或群聊信息页(GroupChatSetting) |
| onBackClick: () -> Unit | 点击返回按钮时触发,建议返回上一级页面。 |
// chat/demo/app/src/main/java/io/trtc/tuikit/chat/MainActivity.kt// 点击会话列表 cell 跳转ConversationsPage(onConversationClick = {activity?.startActivity(Intent(activity, ChatActivity::class.java).apply {putExtra("conversationID", it.conversationID)})})// 点击联系人页面跳转ContactsPage(onGroupClick = {ChatSettingActivity.start(context, "", it.contactID, true)}, onContactClick = {ChatSettingActivity.start(context, it.contactID, "", true)})
// chat/demo/app/src/main/java/io/trtc/tuikit/chat/chat/ChatActivity.kt// 点击聊天页面跳转ChatPage(conversationID = conversationID,locateMessage = message,onUserClick = {handleChatSettingNavigation(it)}, onChatHeaderClick = {val userID = getUserID(conversationID)val groupID = getGroupID(conversationID)handleChatSettingNavigation(userID, groupID)}, onBackClick = { finish() })
文档反馈