hololake-platform/docs/IOS-TESTFLIGHT.md

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 工程已生成”写成“手机版已发布”。