用途:为 CometChat v6 Android 应用做生产发布准备,包括从 authKey 切换到基于令牌的认证、配置 ProGuard/R8、应用安全最佳实践以及优化发布构建。
适用场景:应用发布/上线前的准备;从 authKey 改为令牌认证;为 CometChat 配置 ProGuard/R8 规则;审查安全最佳实践。不适用于开发环境搭建(用 cometchat-android-v6-core)和问题排查(用 cometchat-android-v6-troubleshooting)。配套技能还有 cometchat-android-v6-builder-settings 与 cometchat-android-v6-push。
主要能力与用法: 1)令牌认证:生产环境绝不能在客户端携带 authKey,应使用 loginWithAuthToken(authToken, callback)。令牌由后端通过 CometChat REST API 生成,端点 POST https://{appId}.api-{region}.cometchat.io/v3/users/{uid}/auth_tokens,请求头 apiKey: YOUR_API_KEY 仅限服务端使用。 2)ProGuard/R8:UIKit 模块自带 consumer-rules.pro 会自动应用;若开启压缩出问题,可补充保留规则,例如 -keep class com.cometchat.chat.** { ; }、-keep class com.cometchat.calls.* { ; }、-keep class com.cometchat.uikit.* { *; },以及 Gson、Firebase 相关保留规则与 -keepattributes Signature、-keepattributes Annotation。 3)安全检查清单:客户端移除 authKey(必需)、安全存储 appId(建议)、自定义端点使用 HTTPS(必需)、服务端校验令牌且令牌应过期(必需)、不记录敏感数据并在发布版移除调试日志(必需)、启用 R8/ProGuard(建议)、可选 SSL 证书固定。 4)发布构建:compileSdk 与 targetSdk 为 36,minSdk 为 28,release 中 isMinifyEnabled 与 isShrinkResources 为 true,Java/Kotlin 目标 11。 5)依赖管理:Compose 使用 BOM 对齐版本;显式固定 CometChat SDK 版本,如 com.cometchat:chatuikit-compose-android:6.0.0-beta2 或 chatuikit-kotlin-android:6.0.0-beta2。
限制与注意:minSdk 必须为 28(Android 9.0 Pie),不支持 Android 7.0–8.1,但完整支持 TLS 1.3、原生 BiometricPrompt 与自适应图标。CometChat 部分区域使用反射,发布前务必在开启 ProGuard/R8 的 release 包上测试。发布版必须移除 Log.d() 等调试日志,可用 BuildConfig.DEBUG 守卫。具体版本号、价格与平台支持等资料暂未提供。