从第一次上传，
到做好证书。

下载与安装

AppBridge 支持 Windows 10 和 Windows 11（64 位）。

1. 在官网首页点「下载 Windows 版」，得到 AppBridge-Setup-版本号.exe。
2. 双击运行，阅读并同意服务协议，选择安装位置后点「安装」。装好后桌面和开始菜单里都有 AppBridge。
3. 以后有新版本，AppBridge 会在后台下载好，点「立即重启更新」就会自动装好并重新打开；不点的话，下次关掉 AppBridge 时也会自动装好。

注册与登录

打开 AppBridge 会先看到登录页。AppBridge 账号和用户中心是同一个账号。

注册

1. 在登录页点「注册」，填写用户名（字母开头，4–32 位）、密码（至少 8 位）和手机号。
2. 点「获取验证码」，填入短信里的验证码，勾选同意服务协议，点「注册并登录」。注册完直接进入软件。

   

登录

1. 默认用「账号密码」登录，用户名或手机号都可以；也可以切到「手机验证码」登录。忘记密码点「忘记密码？」，会在浏览器里打开找回页面。

   

2. 登录后，侧栏左下角显示当前账号和套餐。点进去是账号页：能看到套餐、到期时间和包含的功能，有兑换码的话在这里输入就能开通或续期，也可以在这里退出登录。

   

一个账号能同时登录的电脑数有上限，满了的时候会列出已登录的电脑，选一台让它退出就能登录。断网时会继续用这台电脑上保存的订阅信息，账号页会写明能离线用到什么时候。

添加 App Store Connect API 密钥

AppBridge 用 App Store Connect API 密钥上传，不需要 Apple ID 密码，也不会触发双重认证。密钥只需添加一次。

在 App Store Connect 生成密钥

1. 用账户持有人或管理员身份登录 App Store Connect，进入「用户和访问」→「集成」→「App Store Connect API」→「团队密钥」。
2. 点「+」生成密钥，名称随意，访问权限建议选「App 管理」。
3. 点「下载」保存 AuthKey_XXXXXXXXXX.p8 文件。这个文件只能下载一次，请妥善保存。页面上方的 Issuer ID 和这把密钥的 Key ID 也记下来。

添加到 AppBridge

1. 在 AppBridge 打开「API 密钥」，点「添加密钥」。
2. 填一个好认的名称和 Issuer ID，点虚线框选择刚下载的 .p8 文件（也可以直接拖进去），Key ID 会自动填好。点「测试连接」，看到「连接成功」后点「保存」。

   

有多个团队可以添加多把密钥。上传时如果选的密钥看不到这个 App，AppBridge 会自动换成能看到的那把。

上传 IPA 到 TestFlight

上传页按步骤从上到下排列：选择 IPA → 上传前检查 → TestFlight → 上传。

1. 打开「上传」页，把 .ipa 文件拖进虚线框，或点击选择。IPA 需要用 App Store 分发方式导出。一次选多个会排进上传队列，传完一个自动接着传下一个。

   

2. AppBridge 会读出 App 名称、版本号、构建号和描述文件，并自动做上传前检查：描述文件类型和有效期、打包用的 Xcode 和 SDK、framework 架构、版本号和构建号。全部通过时只显示一行；有提醒或报错时会自动展开，有问题的排在最前面。

   

3. 在 TestFlight 一栏点「修改」，可以设置出口合规、填写测试内容、选择测试组，以及要不要通知测试员。同一个 App 下次上传会自动沿用这次的选择。选了外部测试组的话，处理完成后会自动提交 TestFlight 审核，记得填写测试内容。

   

4. 点「开始上传」。进度、速度和剩余时间都显示在「上传」这一步里，运行日志在下方。上传期间电脑不会自动睡眠；关掉窗口可以选择隐藏到托盘，在后台继续。

   

5. 文件传完后，AppBridge 会一直等到 Apple 校验和构建处理结束，再自动完成出口合规、测试内容和测试组设置。看到「上传成功」就可以在 TestFlight 里分发了。

   

上传中断或失败怎么办

每次上传都会留在「上传记录」里，可以按 App 名称、Bundle ID、版本号或构建号搜索。根据状态不同，有这几种处理方式：

1. 可接着传：传到一半断网或退出了程序，已经传上去的部分会保留。在 Apple 给的分片地址过期前，点「接着传」只传剩下的。
2. 等待结果：点了「停止等待」或者等 Apple 处理超时的，点「继续跟进」，处理完成后照样会自动设置测试组等选项。
3. 失败：点「重新上传」，不用再去找文件。Apple 校验没通过时会显示 ITMS 错误码，按提示修改后重新打包。

每条记录都保存了完整日志，点「导出日志」存成文件，方便发给同事或我们排查问题。

查看构建

「构建」页列出每个 App 最近上传的构建：处理状态、内部和外部测试状态、还剩几天过期。不再需要的旧构建可以直接设为过期。在上传记录里点「最近构建」也能跳到这里。

生成 iOS 证书、导出 .p12

没有 Mac 也能做 iOS 证书。导出的 .p12 可以给 HBuilderX 等打包平台使用。

1. 打开「证书」页，点「生成 CSR」。填一个常用名（只用来区分不同的 CSR，Apple 不检查）和邮箱（可不填），点「生成并保存」，得到 .certSigningRequest 文件。对应的私钥会加密保存在这台电脑上，不用自己另存。

   

2. 点「打开 Apple 开发者网站」，在 Certificates 里新建证书：上架 App Store 和 TestFlight 选 Apple Distribution 或 iOS Distribution (App Store Connect and Ad Hoc)，真机调试选 Apple Development；有些打包平台只认 iOS Distribution，以平台的要求为准。上传刚才的 CSR 文件，然后下载 .cer。

   

3. 把下载的 .cer 拖回证书页（或点「导入 .cer」）。隔几天再导入也没关系，会自动找到对应的私钥。

   

4. 点证书右侧的「导出 .p12」，设置并确认密码后点「导出」。导出过一次后会记住密码，列表里能查看和复制，下次点「导出 .p12」直接就能存。

   

私钥只保存在这台电脑上。换电脑或重装系统前，记得先导出 .p12 备份。

查 App 备案信息

阿里云、腾讯云、华为云的 iOS App 备案都要填 Bundle ID、公钥和签名信息，AppBridge 可以直接读出来。

1. 在「证书」页点「备案信息」，拖入 .p12（需要输入密码）、.cer、描述文件或 IPA。列表里已有的证书，点指纹图标也能直接查。
2. 窗口里会显示公钥、签名 SHA-1、证书 MD5 和 SHA-256，点右侧按钮复制，或点「复制全部」。拖入 IPA 或描述文件时，还会顺带读出 Bundle ID。公钥可以在 16 进制和 10 进制之间切换。

   

备案页面上的「签名 MD5 值」或「证书 MD5 指纹」一栏，填的是这里的签名 SHA-1。

网络慢、需要代理

在「设置」里有两种办法：

1. 通过云端上传：本机连 Apple 很慢或经常断的话，打开这个开关，文件会先传到 AppBridge 的云端节点，再由节点推给 Apple。API 密钥不会离开这台电脑。需要套餐包含云端上传。
2. 网络代理：可以跟随系统代理，或选「自定义代理」，添加 HTTP、HTTPS、SOCKS5、SOCKS4 代理（支持用户名密码）。可以保存多个，点一下就能切换，点「测试」检查能不能连上 App Store Connect。

   

   

网络不稳定时，也可以把「并发上传数」调低一些。

常见问题

没找到答案？发邮件到 hi@setonink.com，或登录用户中心管理账号和订阅。