hololake-platform/docs/IOS-TESTFLIGHT.md

# HoloLake Era iPhone / TestFlight 承接记录

状态日期：2026-07-19
当前版本：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`

旧的 `laputa.xcodeproj`、旧 `HoloLake.xcodeproj`、`laputa_iOS` 与第一次生成的 `tolaria.xcodeproj` 是相互冲突的历史结构，已从当前工程移除并备份到外接盘。Rust 包、Xcode project 与 scheme 已统一去基座品牌化，当前唯一承接入口是 `hololake.xcodeproj` / `hololake_iOS`；产品显示名为 `HoloLake Era`，发布身份只能使用 `com.guanghulab.hololake`。

## 已验证

- Web/TypeScript 生产构建通过：`npm run build`
- 第五域与手机频道导航测试通过：`src/components/HoloLakeHome.test.tsx`，8 项通过
- `aarch64-apple-ios` 与 `aarch64-apple-ios-sim` Rust 目标已安装
- Xcode 工程已按 0.1.7（build 20）、独立 Bundle ID 和 `hololake_iOS` scheme 重新生成
- Apple 付费个人开发者团队 `825A9L3G7Q` 已在 Xcode 生效
- Apple Development 与 Apple Distribution 证书已由 Xcode 创建

## 当前闭环状态

2026-07-19 已完成付费团队同步、证书创建、iOS 26.5 平台导入、真机登记、前端生产构建和 Xcode scheme 对齐。私人设备标识不得写入仓库。

App Store Connect 应用记录已创建：名称 `HoloLake Era`，主语言简体中文，Bundle ID `com.guanghulab.hololake`。0.1.7 build 20 已由 Xcode 返回 `App upload complete`。build 19 曾因 `libapp.a` 被错误复制到 App 根目录而被 Apple 以 90171 拒绝；根因是 `project.yml` 把 `Externals` 同时声明为 sources，现已移除，build 20 包内预检确认不再包含该静态库。

外接盘留档：`/Volumes/JZAO/HoloLake/artifacts/ios-testflight/0.1.7-build20/`。IPA SHA-256：`c813d8fd6f639d5e91366e95e1b57d04ea6eec46ac9433261746b0c8cd18dc76`。

## 下一实例最短继续路径

1. 在 App Store Connect / TestFlight 查看 build 20 的 Apple 服务器处理状态。
2. 处理完成后设置内部测试信息并邀请测试者；若出现新的合规问题，记录 Apple 原始错误后再修，不重复上传同一 build number。
3. 真机从 TestFlight 安装后验收启动、五入口导航、安全区、频道切换和知识库入口。
4. 后续上传必须递增 build number，并保留归档、IPA、SHA-256 与 Apple 接收状态。

`App upload complete` 证明 Apple 已接收上传，不等于 TestFlight 已处理完成、已分配测试者或 App Store 已发布。