Files
multi-simadmin/apps/ios
chick c3d17b3daf release(ios): 0.2.2 构建 9 修复消息发送遮挡并中性化石墨灰阶
- 消息中心发送入口从被标签栏盖住的底部操作条移到导航栏右侧,发信恢复可用
- 停用态主按钮保留主色淡底与同色描边,与次级按钮拉开层级
- 消息行删除改安静线性图标,去掉一屏红块
- 缺数据读数统一为短横,卡片延迟补空格单位
- 中性灰阶改为严格 R=G=B,浅色主题不再读出冷调;图标石墨底同步去蓝
- 详情页延迟量表改用与卡片同一算法,身份信息值改为右对齐
- 标签加号按钮与输入框同高同圆角
2026-09-15 08:19:18 +08:00
..

MultiSimAdmin iOS

iPhone 原生应用的 Swift Package。产品与技术说明见 docs/ios-native.md, 本文件只写这个目录里怎么动手。

目录

Sources/MultiSimAdmin/
  AppMetadata.swift          版本号与 Bundle ID 的唯一来源
  MultiSimAdminApp.swift     入口、三个底部 Tab、调试直达参数
  Models/                    实例、标签、查询等值类型
  Features/{Fleet,Device,Messages,Logs,Settings}/   页面与 view model
  Upstream/                  路由白名单、HTTP 客户端、按实例隔离的会话 Cookie
  Services/                  连接探测、凭据存储、依赖装配
  Persistence/               沙盒 JSON 文件仓储与日志存储
  Theme/                     颜色令牌、按钮与卡片样式、骨架、主题模式
  Support/                   错误文案、时间显示、调试启动
  Resources/                 Info.plist、Assets.xcassets
Tests/MultiSimAdminTests/    48 个用例
Design/                      图标生成脚本与参考稿

常用命令

swift build
swift test
xcodebuild -scheme MultiSimAdmin \
  -destination 'platform=iOS Simulator,id=<UDID>' \
  -configuration Debug build
swift Design/generate_app_icon.swift \
  Sources/MultiSimAdmin/Resources/Assets.xcassets/AppIcon.appiconset/AppIcon1024.png

未签名 IPA 从仓库根目录执行 ./scripts/build-ios-ipa.sh 生成。

发版要改的地方

版本号必须四处一致,否则测试会失败:

  1. Sources/MultiSimAdmin/Resources/Info.plist 的 CFBundleShortVersionString 与 CFBundleVersion
  2. Sources/MultiSimAdmin/AppMetadata.swift
  3. Tests/MultiSimAdminTests/AppMetadataTests.swift
  4. Tests/MultiSimAdminTests/SettingsViewModelTests.swift

改完补一份 docs/ios-native-<version>.md 发布说明,并同步更新 docs/ios-native.md、仓库根 README 的版本引用。

界面约定

界面不含任何蓝色:主操作、选中态、进度填充一律用石墨墨色(AITheme.primary / AITheme.ink), 颜色只留给状态语义——危险红、告警琥珀、成功绿,且只在真的表示状态时出现,健康读数保持墨色。 选中态用实心主色加 onPrimary 文字,不用低透明度色雾,浅色深色两套主题下都必须一眼可读; 同屏并排控件等高;选中态不得改变控件尺寸;标签统一 28pt 胶囊;卡片内部不再嵌套卡片, 并列读数改用发丝线分隔的栅格;不得出现因配色而在深色背景上消失的按钮或文字。