绕过 7 天自签过期的应急路径:xcodebuild build 产物手打成 IPA, 上传爱思助手等企业证书服务重签分发,理论 1 年内不再弹「未受信任开发者」。 主路径仍是 deploy.sh + renew.sh 自签,正式账号走 testflight。 Co-Authored-By: Claude Opus 4.8 <[email protected]>
45 lines
2.8 KiB
Markdown
45 lines
2.8 KiB
Markdown
# 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` 自签。**
|