hololake-platform/docs/IOS-TESTFLIGHT.md

47 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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