54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# MultiSimAdmin iOS
|
||
|
||
iPhone 原生应用的 Swift Package。产品与技术说明见 [docs/ios-native.md](../../docs/ios-native.md)，
|
||
本文件只写这个目录里怎么动手。
|
||
|
||
## 目录
|
||
|
||
```text
|
||
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/ 图标生成脚本与参考稿
|
||
```
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
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 的版本引用。
|
||
|
||
## 界面约定
|
||
|
||
主操作只用一种蓝色，危险操作只用红色；同屏并排控件等高；选中态不得改变控件尺寸；标签统一
|
||
28pt 胶囊；卡片内部不再嵌套卡片；不得出现因配色而在深色背景上消失的按钮或文字。
|