diff --git a/ios/GlassRemote/COMMUNITY_SIGN.md b/ios/GlassRemote/COMMUNITY_SIGN.md new file mode 100644 index 0000000..77792e7 --- /dev/null +++ b/ios/GlassRemote/COMMUNITY_SIGN.md @@ -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` 兜底。** \ No newline at end of file diff --git a/ios/GlassRemote/README.md b/ios/GlassRemote/README.md index 20461a0..95bcb70 100644 --- a/ios/GlassRemote/README.md +++ b/ios/GlassRemote/README.md @@ -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` 自签。** diff --git a/ios/GlassRemote/build_ipa.sh b/ios/GlassRemote/build_ipa.sh new file mode 100755 index 0000000..990e102 --- /dev/null +++ b/ios/GlassRemote/build_ipa.sh @@ -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" \ No newline at end of file