Files
adminandClaude Opus 4.8 d4e18230ae feat(ios): 新增社区签应急方案——build_ipa.sh + 爱思助手重签指南
绕过 7 天自签过期的应急路径:xcodebuild build 产物手打成 IPA,
上传爱思助手等企业证书服务重签分发,理论 1 年内不再弹「未受信任开发者」。
主路径仍是 deploy.sh + renew.sh 自签,正式账号走 testflight。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-26 10:14:39 +08:00

45 lines
2.8 KiB
Markdown
Raw Permalink 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.
# GlassRemote — iPhone 原生蓝牙遥控器(INMO Air3 眼镜)
用眼鏡現有的 BLE GATT 服務(`ProxyBleServer`,UUID `A9E0ABCD-0000-1000-8000-00805F9B34FB`)做原生 iPhone 遥控,
徹底繞開 Safari + WiFi 的慢路徑。**免改眼鏡 APK**——命令協議與 Mac 端 `ble_proxy.py` 完全一致。
## 架构
- **控制指令(光标/点击/返回/主页/拍照/光标开关/状态)→ BLE(CoreBluetooth,低延迟、无需 WiFi)**
- **投屏长文本 → BLE 分片直传(无密码、无需 WiFi),`CastView` 调 `ble.sendFragmented` 发送**
## 命令映射(与眼镜 `MouseService.handleCommand` 一致)
| 操作 | JSON |
|------|------|
| 移动光标 | `{"type":"mouse","action":"move","dx":N,"dy":N}` |
| 点击 | `{"type":"mouse","action":"click"}` |
| 滚轮 | `{"type":"mouse","action":"scroll","dy":N}` |
| 返回/主页 | `{"type":"key","action":"back"|"home"}` |
| 拍照 | `{"type":"camera","action":"capture"}` |
| 光标显隐 | `{"type":"cursor","visible":true/false}` |
| 查 IP | `{"type":"sys","action":"ip"}` |
| 查状态 | `{"type":"sys","action":"status"}` |
| 投屏文字 | `{"type":"text","content":"..."}` |
| 自动滚动 | `{"type":"text","action":"auto_scroll","content":"...","speed":7}` |
BLE 写特征:`A9E0ABCD-0001-1000-8000-00805F9B34FB`;通知特征:`A9E0ABCD-0002-1000-8000-00805F9B34FB`。
## 构建与运行
1. 用 Xcode 打开 `GlassRemote.xcodeproj`(本工程由 `xcodegen` 生成,`project.yml` 可重建)。
2. 选中 `GlassRemote` target → Signing & Capabilities → Team 选你的 Apple ID(免费账户即可,7 天重签)。
3. iPhone 与眼镜都打开蓝牙;iPhone 用数据线连 Mac,选设备为目标,▶ Run。
4. 控制页会自动扫描并连接眼镜;轻点触摸板=点击,滑动=移动光标。
5. 投屏页:BLE 直连后输入文字 → 📺 投屏 / 自动滚动(长文本自动分片,无密码)。
## 已知
- 点击/返回/滚动依赖眼镜端「无障碍服务」开启(设置→无障碍→GlassMouse),未开时控制页会红条提示。
- 投屏长文本已支持纯 BLE 分片(`GlassBLEManager` 分片 + 眼镜 `ProxyBleServer` 重组),无需 WiFi WS。
- 本工程用 `xcodegen`(见 `tools/`)生成;改 `project.yml` 后重跑 `xcodegen generate` 即可。
## 应急:跳过 7 天签名过期
每周一次的「未受信任开发者」提示很烦?把 IPA 传到爱思助手,让他们用企业证书帮分发,理论 1 年内不再过期。
```bash
bash build_ipa.sh --strip-profile # 生成可重签 IPA(推荐:剥 profile 让签名服务完全重签)
# 然后:上传 build/GlassRemote.ipa 到 爱思助手 Mac 客户端 或 https://www.i4.cn/
```
完整流程 + 风险 + 回退方案见 [`COMMUNITY_SIGN.md`](./COMMUNITY_SIGN.md)。**应急用,主路径仍是 `renew.sh` 自签。**