打包和釋出

初學者演練

先決條件：完成桌面本地設定，包括 Rust 和作業系統構建工具。在構建安裝程式之前停止 Tauri 開發過程；讓 Web 後端保持執行。從儲存庫根目錄執行下面的每項檢查，並等待其完成，然後再執行下一項。過濾後的包命令適用於僅桌面版和所有平臺簽出。

簡而言之：工作區是一個團隊的單獨使用者、資料和設定。伺服器是可信後端；讓提供商金鑰遠離瀏覽器和電話程式碼。遷移是建立或更新表的版本化資料庫更改。人工智慧模型是回答的引擎；型號目錄是伺服器上可用型號 ID 和價格的列表。提供商是一種外部服務，例如人工智慧、電子郵件或計費服務。權利是允許工作區使用某項功能的授權。 Webhook 是一個服務傳送到另一個服務的 URL 的訊息。

1. 在本地分支機構，請您的編碼代理檢查 apps/desktop/src-tauri/tauri.conf.json 並將產品識別符號、應用程式名稱、圖示和後端 URL 設定為您擁有的值。使用公共 HTTPS 後端 URL 進行釋出版本。

2. 從儲存庫根目錄執行下面的桌面包檢查。在check:release-config之前，使用桌面本地設定中的作業系統命令在此終端中設定SUPASTACK_APP_URL；公共 HTTPS 後端必須正在執行，並且應用程式識別符號必須是您自己的。

3. 成功的構建不會簽署、公證或釋出安裝程式；如果 Rust 或系統庫丟失，請完成桌面本地設定。

對於自定義程式碼，請從提供的 prompts/README.md 開始，然後複製最接近的提示：對於應用程式螢幕為 prompts/new-app-screen.md，對於公共頁面為 prompts/new-landing-page.md。對於伺服器、資料庫或提供商工作，請為您的編碼代理提供本指南的任務，並要求其讀取 AGENTS.md、.ai/PROJECT_CONTEXT.md 和匹配的 .ai/ 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。

• 開始之前
• 終端基礎知識
• 桌面本地設定
• 座席提示和專案記憶體

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

配置產品外殼

檢視 src-tauri/tauri.conf.json、Cargo 後設資料、功能和平臺識別符號。通過共享資產流程替換應用程式圖示，並在構建/執行時設定預期後端 URL。託管 Web 應用程式必須已部署且可訪問。

執行本機構建門

這些包命令執行 Rust 型別檢查和測試、驗證釋出設定並構建 Tauri 安裝程式。簽名和分發配置取決於目標平臺和您的帳戶/證書；不要將簽名材料儲存在源中。

corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build

驗證目標作業系統上的安裝程式

檢查全新安裝、啟動、後端可訪問性、身份驗證、選單/托盤、熱鍵註冊、第二例項、深連結、離線重試與解除安裝。每個受支援的作業系統分別驗證。本地構建不能證明經過簽名或公證的商業分發；簽名配置由你自行準備，出廠的釋出工作流與更新器源見“自動更新”篇。

• 本機驗收清單
• 自動更新與釋出頻道
• 部署共享後端

安裝與配置

準備安裝包前先執行 corepack pnpm --filter @supastack/desktop check:release-config。它檢查 SUPASTACK_APP_URL 是否為公共主機上的無憑據 HTTPS，以及 Tauri 識別符號是否產品專屬；該檢查為可選，不阻塞本地開發。

corepack pnpm --filter @supastack/desktop build 執行 tauri build。tauri.conf.json 中的打包目標生成宿主作業系統可用的安裝包格式 —— 你要釋出到哪個作業系統就在哪個作業系統上構建。產物落在 apps/desktop/src-tauri/target/release/bundle/ 下。

productName、version 與識別符號都在 tauri.conf.json 中 —— 釋出前先在那裡提升版本。用 corepack pnpm --filter @supastack/desktop icons 重新生成圖示，它會用 placeholder-icon.png 重寫 src-tauri/placeholder-icons。

corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop icons
corepack pnpm --filter @supastack/desktop build
# artifacts: apps/desktop/src-tauri/target/release/bundle/

實現流程

未簽名安裝包可以在本機安裝，但會觸發作業系統信任警告。程式碼簽名和 Apple 公證需要在自己的釋出配置中完成；證書應存放在專用金鑰庫，不能提交到倉庫。

在釋出構建中寫入生產環境 SUPASTACK_APP_URL，使安裝後的外殼指向已部署 Web 應用，而不是 localhost。

驗證與排障

在每個目標作業系統安裝產物，並記錄構建版本、系統和應用地址。驗證應用啟動、載入目標部署、托盤和快捷鍵工作，以及登入狀態保留；僅完成 tauri build 不能作為釋出驗收。