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

120 lines
4.6 KiB
Markdown

# 社区签名(应急方案)— 跳过 7 天签名过期
> 解决 `ios/GlassRemote` 每周一次的"未受信任开发者"麻烦。
> 原理:用第三方签名服务(爱思助手等)的企业证书重签分发,理论 1 年内不再过期。
> 这是**应急方案**,不是长期主路径 — 主路径仍是 `deploy.sh` + `renew.sh`。
---
## 1. 完整流程
```
Xcode 本地 build_ipa.sh → 生成可重签的 IPA
│
▼
上传到 爱思助手(Mac 客户端或 Web)
│
▼
爱思助手用他们的企业证书重签 + 托管安装链接
│
▼
iPhone Safari 打开链接 → 安装 → 设置里信任企业证书
│
▼
GlassRemote 可用,1 年内不再弹"未受信任开发者"
```
## 2. 步骤 1:生成 IPA
```bash
cd ios/GlassRemote
bash build_ipa.sh --strip-profile # 推荐:剥离 profile 让签名服务完全重签
# 或者
bash build_ipa.sh # 默认:保留个人证书(profile 也保留)
```
- 脚本走 `xcodebuild build`(非 archive)+ 手 zip 成 IPA,避开 ad-hoc profile 注册设备等坑
- `--strip-profile` — 剥离 `embedded.mobileprovision`,让签名服务完全重签(**推荐**)
- 输出:`build/GlassRemote.ipa`(应该 1~3 MB)
## 3. 步骤 2:上传到爱思助手
### 方式 A:Mac 客户端(推荐,稳定)
1. 装 [爱思助手 Mac 版](https://www.i4.cn/) (`i4.cn` 官网下载)
2. 打开客户端 → 顶部「应用」标签 → 右上角「导入 IPA」→ 选 `build/GlassRemote.ipa`
3. 上传后,客户端显示「我的应用」列表 → 找到 GlassRemote → 「签名」按钮
4. 选择签名证书(免费试用版 / 付费稳定版)→ 确认 → 等待签名完成
5. 签名完成后点「安装」/「分享」会得到 URL + 二维码
### 方式 B:Web 上传(爱思助手的网页分发)
1. 浏览器打开 https://www.i4.cn/ → 找「IPA 签名」或「在线签名」入口
2. 上传 `build/GlassRemote.ipa`
3. 等签名完成 → 拿到安装链接/二维码
### 备选服务(任选一家)
| 服务 | URL | 备注 |
|------|-----|------|
| 蒲公英 | https://www.pgyer.com/ | 老牌,支持 API 上传 |
| fir.im | https://firim.net/ | 轻量,免费版有次数限制 |
| 牛蛙助手 / 苹果助手 | 各官网 | 备选,稳定性参差 |
## 4. 步骤 3:iPhone 安装 + 信任
1. iPhone Safari 打开签名服务给的链接
2. 弹窗「是否安装 XX」→ 点「安装」
3. 安装完后**首次启动不会弹**,需要先信任证书:
- `设置` → `通用` → `VPN 与设备管理`(iOS 16+)或 `描述文件与设备管理`(旧版)
- 点开企业级应用列表 → 找到对应签名证书(通常显示签名公司名)
- 点「信任」→ 二次确认
4. 返回桌面打开 GlassRemote → 正常启动,可用
## 5. 验证能用
打开 App 后:
- 顶栏 BLE 状态显示「已连接 INMO AIR3 5876」
- 控制页:触摸板拖动 → 眼镜光标跟随移动
- 投屏页:输入文字 → 投屏到眼镜
如果 BLE 连不上,检查眼镜端 `GlassMouse` App 是否在前台运行。
## 6. 已知风险与应对
### 风险 1:企业证书被 Apple 吊销 ⚠️ 概率存在
- **现象**:某天打开 GlassRemote 弹「无法验证 App」
- **应对**:
1. 重新跑 `bash build_ipa.sh --strip-profile` 生成 IPA
2. 上传到签名服务再签一次
3. 或者直接回退到 `bash renew.sh --force` 走自签模式(总有备胎)
### 风险 2:iOS 26 新限制
- Apple 持续打击滥用企业证书,**部分签名服务可能在 iOS 26 上失效或需更繁琐的信任步骤**
- 应对:第一次免费试,确认能装能信任再考虑付费
### 风险 3:免费签有效期短
- 爱思助手的免费试用签通常只有 3-7 天(等于没用),需要付费稳定版(几元到几十元/月)
- 应对:看自己用得多不多,值不值这个钱;不值就用 `renew.sh` 续
## 7. 何时该回退到 `renew.sh`
- 不想再付费签名服务
- 爱思助手服务挂了 / 收紧了政策
- 只是临时应急,正式路径仍是 7 天一次自签
回退零成本:
```bash
bash renew.sh # 自动检测 profile 到期时间
bash renew.sh --force # 强制续签
bash renew.sh --check # 只看剩余时间
```
## 8. 三条路径速查
| 路径 | 命令 | 频率 | 费用 |
|------|------|------|------|
| **本应急方案**(社区签) | `bash build_ipa.sh` + 上传服务 | 数月 ~ 1 年一次 | 免费试用 / 几元-几十元/月 |
| **自签**(主路径) | `bash renew.sh` | 7 天一次 | 0 元 |
| **正式账号**(长期最优) | `bash testflight.sh` | 90 天一次 | $99/年 |
---
**应急场景用本指南;想要长期省心就 `$99/年` 或 `renew.sh` 兜底。**