用途：这是 CometChat iOS UI Kit v5 集成的基础技能，说明 CometChat 在 iOS 上的工作方式（初始化、登录、管理器模式与反模式），帮助编写贴合项目的代码而非套用模板。应先读本技能，再读任何放置或组件技能。
主要能力与用法：
- 安装：先确认依赖清单存在。可用 CocoaPods（Podfile 中 platform :ios, '13.0'、use_frameworks!、pod 'CometChatUIKitSwift', '~> 5.1'，然后 pod install，并从 .xcworkspace 工作；Xcode 15+ 需将 ENABLE_USER_SCRIPT_SANDBOXING 设为 No），或用 Swift Package Manager 在 Xcode 中添加 https://github.com/cometchat/cometchat-uikit-ios。未完成依赖配置前不要写 import CometChatUIKitSwift。
- 初始化：用 UIKitSettings 构建器设置 appID、authKey、region（us/eu/in）并 subscribePresenceForAllUsers，通过 CometChatUIKit 异步初始化，且只能初始化一次，建议用单例管理器防止重复初始化；可在 AppDelegate 或 SwiftUI App 的 init 中调用。
- 登录：开发模式用 CometChatUIKit.login(uid:)，测试用户为 cometchat-uid-1 至 cometchat-uid-5；生产模式用 login(authToken:)。回调使用 .success 与 .onError，而非标准 Result。可获取当前登录用户并登出。
- 错误处理：使用 CometChatException 的 errorCode、errorDescription、details，注意用 errorDescription 而非 localizedDescription；常见错误码包括 ERR_UID_NOT_FOUND、ERR_ALREADY_LOGGED_IN、ERR_NOT_LOGGED_IN、AUTH_ERR_AUTH_TOKEN_NOT_FOUND、ERR_INVALID_APP_ID、ERR_INVALID_API_KEY。
- 凭据管理：开发可用 Constants 文件（生产应加入 .gitignore）、Info.plist 或 xcconfig 文件。
- 管理器模式：推荐单例管理器统一处理初始化、登录状态与对外 API；注意 CometChatException 不遵循 Swift Error 协议。
适用场景：iOS 应用集成 CometChat 聊天 UI Kit v5 时的基础接入与状态管理。
限制：资料未提供收费、价格、平台支持范围或效果数据；具体组件用法需参考后续放置与组件技能。