用途:这是 CometChat Android UI Kit v5 集成的基础技能,覆盖 SDK 初始化、登录/登出、UIKitSettings 构建器、Gradle 依赖、清单权限以及常见反模式,应在组件、放置、主题等技能之前阅读。
主要能力:提供 UIKitSettingsBuilder 的完整方法参考(setAppId、setRegion、setAuthKey、subscribePresenceForAllUsers 等),CometChatUIKit 的公开 API(init、login、loginWithAuthToken、logout、getLoggedInUser、isSDKInitialized、createUser 及各类 send 方法),以及开发模式与生产模式的登录方式。
使用方式:在 app 级 build.gradle 添加 implementation 'com.cometchat:chat-uikit-android:5.+',项目级仓库加入 CometChat Maven 地址;gradle.properties 必须设置 android.useAndroidX=true 与 android.enableJetifier=true。在 Application 或启动 Activity 中调用 CometChatUIKit.init(),用 isSDKInitialized() 防止重复初始化,登录需在 init 的 onSuccess 内进行。开发模式用 login(uid),生产模式用 loginWithAuthToken(token)。应用主题需继承 CometChatTheme.DayNight,不要用 Theme.AppCompat.* 或 Material 3。
适用场景:新 Android 项目接入 CometChat、初始化或登录失败排查、依赖与权限配置。
限制:最低 SDK 24,编译 SDK 34+,Java 8+,Kotlin 1.8+;生产环境不应硬编码 Auth Key;调用功能需额外添加 calls-sdk-android。具体收费与价格暂未提供。