For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/desktop/external-accounts.md (or send Accept: text/markdown).
创建桌面端发布账户
Apple 签名与公证凭据、Windows 代码签名选项,以及已发布外壳需要的托管后端。
什么时候需要它们
本地桌面开发不需要本页任何内容——corepack pnpm --filter @supastack/desktop dev 就能运行外壳,tauri build 产出的未签名安装包在你自己的机器上也能正常工作。
这些账户只在公开发布前才重要:代码签名和 Apple 公证是消除他人电脑对未知应用弹出安全警告的手段。等发布临近时再创建,而不是第一天就办。
Apple:证书 + 公证密钥
1. 注册 Apple Developer Program——每年 99 美元。提交 iOS 应用的同一个会员资格同时覆盖 macOS 签名;无需重复付费。
2. 在 Mac 上创建 Developer ID Application 证书:Xcode → Settings → Accounts → 你的账户 → Manage Certificates → + → Developer ID Application(Keychain Access 的证书助理流程是替代方案)。
3. 公证——Gatekeeper 信任的 Apple 服务端检查——使用 App Store Connect API 密钥:打开 appstoreconnect.apple.com → Users and Access → Integrations → App Store Connect API → 生成密钥,立即下载 .p8 文件(只提供一次),并记下 Key ID 和 Issuer ID。
这些凭据对应“代码签名”文档中的 APPLE_* 环境变量名——证书、证书密码、签名身份,以及 API 密钥/签发者对。把它们全部放进密钥存储,绝不进仓库。
Windows 代码签名
有两个选择:从证书颁发机构购买 OV 或 EV 代码签名证书——EV 最快消除 SmartScreen 警告,OV 则随时间积累声誉;或者使用 Microsoft 的 Azure Trusted Signing 服务(需要 Azure 账户),这是较新的订阅制路线。
未签名的安装包仍然可以安装和运行;只是任何下载者都会看到 SmartScreen 警告。这对私下测试可以接受,对公开发布则不行。
证书指纹或自定义 signtool 命令写入 Windows 打包配置——细节在“代码签名”中,本页只讲账户。
公开的后端 URL
桌面外壳是一个 webview,不是独立应用:发布构建必须加载公开的 HTTPS 后端,通过把 SUPASTACK_APP_URL 烘入构建来提供。指向 localhost 的外壳只是本地工具,不是产品。
先部署 Web 应用——Google Cloud 指南会产出 HTTPS URL,部署清单是更简短的参考。构建发布版时把 SUPASTACK_APP_URL 指向它。
更新端点
Tauri 的更新器通过 HTTPS latest.json 清单来获知新版本。任何静态托管都可以——GitHub Releases 的发布,或 S3/R2 存储桶中的一个文件——所以现有的 GitHub 账户就足以起步;不需要单独的服务。
这只是账户层面的准备:更新器接线本身是“打包和发布”阶段的发布工作,现在不用配置。
完成的标志
开始发布工作前检查每一项:Apple 显示有效的 Developer Program 会员资格,Keychain 中已有 Developer ID Application 证书,App Store Connect 的 .p8 已保存且 Key ID 和 Issuer ID 已记录。Windows 侧已选定证书路线——CA 购买或 Trusted Signing——或者你已明确决定暂时发布未签名版本。
后端检查:存在一个公开的 HTTPS 部署,且发布构建的 SUPASTACK_APP_URL 指向它。更新检查:已为 latest.json 选定托管方——GitHub Releases 或存储桶。
然后按顺序继续:
如果你想继续完成设置,可以阅读《打包和发布》。