feat(ios): 新增社区签应急方案——build_ipa.sh + 爱思助手重签指南

绕过 7 天自签过期的应急路径:xcodebuild build 产物手打成 IPA,
上传爱思助手等企业证书服务重签分发,理论 1 年内不再弹「未受信任开发者」。
主路径仍是 deploy.sh + renew.sh 自签,正式账号走 testflight。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
This commit is contained in:
adminandClaude Opus 4.8 committed 2026-09-26 10:14:39 +08:00
1 parent b6586b843f
commit d4e18230ae
3 files changed
+267

No files matched your search

+120
View File
@@ -0,0 +1,120 @@
# 社区签名(应急方案)— 跳过 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` 兜底。**
+8
View File
@@ -34,3 +34,11 @@ BLE 写特征:`A9E0ABCD-0001-1000-8000-00805F9B34FB`;通知特征:`A9E0ABC
- 点击/返回/滚动依赖眼镜端「无障碍服务」开启(设置→无障碍→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` 自签。**
+139
View File
@@ -0,0 +1,139 @@
#!/bin/bash
# build_ipa.sh - 生成可上传到社区签名服务(爱思助手等)的可重签 IPA
#
# 背景:
# ios/GlassRemote 当前走 deploy.sh + renew.sh,7 天 profile 过期要每周重签。
# 应急方案:把 IPA 传到爱思助手,用他们的企业证书重签分发,理论 1 年内不再过期。
#
# 本脚本:走 xcodebuild build(非 archive)→ 拿到签好个人证书的 .app →
# 手 zip 成 IPA(IPA 本质就是 Payload/AppName.app 的 zip) → 可选剥 profile。
# 签名服务拿到后用他们的企业证书重签。
#
# 用法:
# bash build_ipa.sh # 默认:build + 打包 IPA(带个人证书)
# bash build_ipa.sh --strip-profile # 剥离 embedded.mobileprovision
# # (推荐:让签名服务完全重签)
#
# 输出: ios/GlassRemote/build/GlassRemote.ipa
#
# 退出码:
# 0 = 成功
# 1 = Build 失败
# 2 = Xcode 账号问题(沙箱或未登录)
# 3 = 后处理失败(打包 / 找 .app 失败)
#
# 前置: Xcode 已登录 Apple ID(同 deploy.sh / renew.sh 的要求)
set -u
cd "$(dirname "$0")"
TEAM=H2C3YSR973
SCHEME=GlassRemote
PROJECT=GlassRemote.xcodeproj
DD=/tmp/dd_ipa
LOG=/tmp/ipa_build.log
: > "$LOG"
STRIP_PROFILE=0
while [ $# -gt 0 ]; do
case "$1" in
--strip-profile) STRIP_PROFILE=1; shift ;;
--method|--method=*) shift 2 ;; # legacy arg, ignored
-h|--help) sed -n '2,28p' "$0"; exit 0 ;;
*) echo "未知参数: $1(可用 -h 看帮助)"; exit 1 ;;
esac
done
say() { echo "$@" | tee -a "$LOG"; }
# ---------- [0/3] 沙箱预检 ----------
SANDBOX_BLOCKED=0
if security add-generic-password -a "ipabuild-probe" -s "ipabuild-probe" -w probe -U >/dev/null 2>&1; then
security delete-generic-password -a "ipabuild-probe" -s "ipabuild-probe" >/dev/null 2>&1
else
SANDBOX_BLOCKED=1
say "!! 警告:keychain 不可写,当前在沙箱环境。"
say "!! 请在普通终端直接运行: cd $(pwd) && bash build_ipa.sh"
fi
mkdir -p "$DD" build
# ---------- [1/3] Build (Release,generic) ----------
say "=== [1/3] Build (Release) ==="
xcodebuild -project "$PROJECT" -scheme "$SCHEME" \
-configuration Release \
-destination "generic/platform=iOS" \
-derivedDataPath "$DD" \
DEVELOPMENT_TEAM="$TEAM" CODE_SIGN_STYLE=Automatic \
-allowProvisioningUpdates \
CODE_SIGN_IDENTITY="Apple Development" \
build 2>&1 | tee -a "$LOG"
BUILD_EXIT=${PIPESTATUS[0]}
say "BUILD_EXIT=$BUILD_EXIT"
if [ "$BUILD_EXIT" != "0" ]; then
if grep -q "No Accounts" "$LOG" 2>/dev/null; then
if [ "$SANDBOX_BLOCKED" = "1" ]; then
say "!! 沙箱阻断 keychain,在普通终端重跑即可"
exit 2
fi
say "!! Xcode 无账号 → Settings(⌘,) → Accounts → + 加 Apple ID"
exit 2
fi
say "!! Build 失败,看 $LOG"
exit 1
fi
# ---------- [2/3] 找 .app ----------
say ""
say "=== [2/3] 定位 .app ==="
APP_PATH=$(find "$DD" -name "GlassRemote.app" -type d 2>/dev/null | grep -i "Release-iphoneos" | head -1)
if [ -z "$APP_PATH" ]; then
# 兜底:任何 GlassRemote.app
APP_PATH=$(find "$DD" -name "GlassRemote.app" -type d 2>/dev/null | head -1)
fi
if [ -z "$APP_PATH" ]; then
say "!! 没找到 GlassRemote.app,Build 产物异常"
exit 3
fi
say "App: $APP_PATH"
# 校验确实被签了
if ! codesign -dv "$APP_PATH" 2>&1 | tee -a "$LOG" | grep -q "Signature"; then
say "!! .app 未签名,签名服务无法接管"
exit 3
fi
say "已签名 ✓"
# ---------- [3/3] 打包成 IPA + 可选剥 profile ----------
say ""
say "=== [3/3] 打包 ==="
PAYLOAD_DIR=$(mktemp -d)
mkdir -p "$PAYLOAD_DIR/Payload"
cp -R "$APP_PATH" "$PAYLOAD_DIR/Payload/GlassRemote.app"
if [ "$STRIP_PROFILE" = "1" ]; then
PROFILE="$PAYLOAD_DIR/Payload/GlassRemote.app/embedded.mobileprovision"
if [ -f "$PROFILE" ]; then
rm "$PROFILE"
say "已剥离 embedded.mobileprovision"
else
say "(未找到 embedded.mobileprovision,跳过剥离)"
fi
fi
DEST="build/GlassRemote.ipa"
rm -f "$DEST"
# IPA = zip + Payload 目录 + iTunesArtwork(可选)+ iTunesMetadata.plist(可选)
# 加 -y 保留符号链接(若 .app 内有),zip 必须从 Payload 父目录跑
( cd "$PAYLOAD_DIR" && zip -q -r "$OLDPWD/$DEST" Payload )
rm -rf "$PAYLOAD_DIR"
say ""
say "=== DONE ==="
say "IPA: $DEST"
say "大小: $(du -h "$DEST" | awk '{print $1}')"
say ""
say "下一步:"
say " 1. 把 build/GlassRemote.ipa 传到爱思助手(或 COMMUNITY_SIGN.md 列的其他服务)"
say " 2. 服务签名后会给你一个安装链接 / 二维码"
say " 3. iPhone Safari 打开链接 → 安装 → 设置里信任企业证书"
say " 详见 COMMUNITY_SIGN.md"