xuqmGroup/XuqmGroup-iOSSDK
0
0
派生 0
代码 工单 合并请求 版本发布 百科 动态
6867091c04
XuqmGroup-iOSSDK/XuqmDemo
文件历史
XuqmGroup 255974ae09 docs(deploy): 添加部署文档并更新SDK API设计规范 
- 新增完整的XuqmGroup部署文档，包含服务器配置、Docker Compose部署策略
- 更新SDK API重设计规范至V2.0，统一各端SDK初始化和登录接口
- 添加安全设计规范文档，涵盖密码安全、AppSecret验证等内容
- 新增离线推送架构设计文档，定义厂商推送集成方案
- 重构SDK登录流程，统一使用userId + userSig鉴权模式
- 移除dbName等外部配置参数，实现零感知平台地址配置
- 完善部署架构图和配置示例文件
2026-05-02 11:29:50 +08:00
..
Sources docs(deploy): 添加部署文档并更新SDK API设计规范 2026-05-02 11:29:50 +08:00
Package.swift feat(sdk): 更新 SDK 设计文档和 API 重构 2026-05-01 21:27:39 +08:00
README.md feat(sdk): 更新 SDK 设计文档和 API 重构 2026-05-01 21:27:39 +08:00

README.md

XuqmDemo

XuqmGroup iOS SDK 的 SwiftUI 演示应用。

功能

  • 登录：使用 demo-service 登录（user_a / 123456）
  • 会话列表：展示最近会话，支持搜索、置顶、静音、删除
  • 单聊：与某个用户收发文本消息
  • 更新检查：检查 App 更新
  • 个人资料：展示并修改当前用户信息

环境

  • 演示服务器：https://dev.xuqinmin.com
  • App ID：ak_demo_chat

运行方式

方式一：嵌入 Xcode 项目

  1. 将 XuqmDemo/Sources 下的所有 Swift 文件拖入你的 Xcode iOS App 项目
  2. 确保项目已依赖 XuqmSDK（本地 SPM 或源码引用）
  3. 构建并运行

方式二：Swift Package Manager（验证编译）

cd XuqmDemo
swift build

注：由于 Demo 是 iOS SwiftUI 应用，建议使用 Xcode 打开 XuqmGroup-iOSSDK 仓库，然后新建一个 iOS App Target 并将 XuqmDemo/Sources 中的文件加入该 Target 进行真机/模拟器运行。

项目结构

XuqmDemo/
  Package.swift
  Sources/
    XuqmDemoApp.swift            # @main 入口，初始化 SDK 与路由
    Views/
      LoginView.swift            # 登录页
      ConversationListView.swift # 会话列表页
      ChatView.swift             # 单聊页
      UpdateCheckView.swift      # 更新检查页
      ProfileView.swift          # 个人资料页
    ViewModels/
      AuthViewModel.swift        # 登录/登出逻辑
      ConversationViewModel.swift# 会话列表逻辑
      ChatViewModel.swift        # 聊天逻辑（含 ImEventDelegate 桥接）
    Models/
      DemoModels.swift           # 路由、状态、辅助函数
  README.md

关键 SDK API 使用

  • XuqmSDK.shared.initialize(config:) — 初始化 SDK
  • ImSDK.shared.loginWithDemo(userId:password:) — Demo 登录
  • ImSDK.shared.listConversations() — 获取会话列表
  • ImSDK.shared.fetchHistory(toId:page:size:) — 获取历史消息
  • ImSDK.shared.sendTextMessage(toId:chatType:content:) — 发送文本消息
  • ImSDK.shared.getProfile(userId:) / updateProfile(...) — 用户资料
  • UpdateSDK.shared.checkAppUpdate(currentVersionCode:) — 检查更新