用途:帮助排查 CometChat Angular UI Kit v4 集成失败,覆盖 NgModule 与独立组件两种搭建方式,先做分诊再给修复建议。
主要能力:按症状给出原因与修复对照,涵盖初始化与登录(init 未完成、getLoggedinUser 返回 null、UIKitSettingsBuilder 导入错误)、模块与 schema 错误(缺少 CUSTOM_ELEMENTS_SCHEMA、组件未导入、NullInjectorError)、assets 与图标 404、布局高度为零、Angular Router 集成、主题不生效、组件输入与回调、通话、扩展启用、生产环境 auth token 及 SSR 问题。
使用方式:先收集事实再修复。用 grep 检查 CUSTOM_ELEMENTS_SCHEMA、angular.json 的 assets、init/isReady/APP_INITIALIZER、UIKitSettingsBuilder、组件导入和 BrowserAnimationsModule。常用命令如 grep -r "CUSTOM_ELEMENTS_SCHEMA" src/、grep -A5 '"assets"' angular.json | grep cometchat。修复示例包括在模块 schemas 加 CUSTOM_ELEMENTS_SCHEMA、在 imports 导入组件、用 *ngIf="isReady" 门控渲染、给父容器设置 height: 100vh 或 flex: 1。
适用场景:Angular 项目接入 CometChat UI Kit v4 时出现空白、报错、图标缺失、布局异常、路由或主题问题,以及从 v3 升级到 v4。
限制:资料未提供具体版本兼容范围、收费信息或完整 API 参考;部分修复需结合其他技能(如 core、components、patterns、production)使用。