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-tw/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 或儲存桶。
然後按順序繼續: