hololake-platform/docs/IOS-TESTFLIGHT.md

47 lines
2.9 KiB
Markdown
Raw Normal View History

# HoloLake Era iPhone / TestFlight 承接记录
状态日期2026-07-18
当前版本0.1.7
Bundle ID`com.guanghulab.hololake`
## 为什么这样做
手机版不是把 Mac 三栏界面等比例缩小,而是保留第五域的同一套频道语义,为手机增加固定的五入口导航:零点原核、第五域、心跳核心、光之湖人格体、服务器节点。知识库仍是频道工作区中的能力,不重新变回软件主体。
## 真实文件入口
- 手机频道结构:`src/components/HoloLakeHome.tsx`
- 手机响应式样式与安全区:`src/App.css`
- 手机导航回归测试:`src/components/HoloLakeHome.test.tsx`
- iOS 专用 Tauri 配置:`src-tauri/tauri.ios.conf.json`
- XcodeGen 工程源:`src-tauri/gen/apple/project.yml`
- 已生成 Xcode 工程:`src-tauri/gen/apple/HoloLake.xcodeproj`
- iOS 权限基线:`src-tauri/capabilities/mobile.json`
旧的 `src-tauri/gen/apple/laputa.xcodeproj``laputa_iOS` 目录来自 Tolaria 基座仅作为历史生成结构保留TestFlight 的新承接入口是 `HoloLake.xcodeproj` / `HoloLake_iOS`,不得再用旧包名 `club.refactoring.tolaria` 发布。
## 已验证
- Web/TypeScript 生产构建通过:`npm run build`
- 第五域与手机频道导航测试通过:`src/components/HoloLakeHome.test.tsx`8 项通过
- `aarch64-apple-ios``aarch64-apple-ios-sim` Rust 目标已安装
- Xcode 工程已经以 HoloLake 名称、0.1.7 版本和独立 Bundle ID 生成
## 尚未闭环的外部条件
1. Apple Developer 订阅已付款,但 Xcode 当前仍只显示 `Personal Team`;正式付费团队同步后才能建立发行签名并上传 TestFlight。
2. 本机 Xcode 的 iOS 26.5.1 + iOS 26.5 Simulator 组件未安装,官方界面显示占用 8.52 GB应在冰朔确认磁盘占用后下载。
3. iOS Rust 原生检查已进入 Tauri Swift 层,但 SwiftPM 从 GitHub 拉取 `Brendonovich/swift-rs` 时网络连接失败。这是依赖下载阻断,不是当前代码编译错误;网络恢复后重跑原生检查。
4. 创建 Apple Development / Distribution 证书属于持久凭据操作,必须在正式团队出现后由冰朔当场确认,再在 Xcode 的 `Manage Certificates…` 中执行。
## 下一实例最短继续路径
1. 打开 Xcode → Settings → Apple Accounts确认是否出现非 `Personal Team` 的正式团队。
2. 经冰朔确认后,安装 Xcode → Settings → Components 中的 iOS 26.5.1 + Simulator。
3. 网络可访问 GitHub 后运行:
`cargo check --manifest-path src-tauri/Cargo.toml --target aarch64-apple-ios`
4.`src-tauri/gen/apple/HoloLake.xcodeproj``HoloLake_iOS` scheme 做真机归档。
5. 正式团队出现且冰朔确认创建证书后,创建 App Store Connect 应用记录并上传 TestFlight 内测构建。
TestFlight 上线前不得把“前端构建通过”“Xcode 工程已生成”写成“手机版已发布”。