bundleの作成と公開

初心者向けのウォークスルー

前提条件: Rust およびオペレーティング システム ビルド ツールを含む、デスクトップのローカル セットアップを完了します。インストーラーをビルドする前に、Tauri 開発プロセスを停止してください。 Web バックエンドは実行したままにしておきます。リポジトリ ルートから以下の各チェックを実行し、完了するまで待ってから次のチェックを実行します。フィルタリングされたパッケージ コマンドは、デスクトップのみおよびすべてのプラットフォームのチェックアウトで機能します。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. ローカル ブランチで、コーディング エージェントに apps/desktop/src-tauri/tauri.conf.json を検査し、製品 ID、アプリ名、アイコン、およびバックエンド URL を独自の値に設定するように依頼します。リリース ビルドにはパブリック HTTPS バックエンド URL を使用します。

2. リポジトリ ルートから、以下のデスクトップ パッケージ チェックを実行します。 check:release-config の前に、デスクトップ ローカル セットアップのオペレーティング システム コマンドを使用して、この端末で SUPASTACK_APP_URL を設定します。パブリック HTTPS バックエンドが実行されている必要があり、アプリ ID は独自のものである必要があります。

3. ビルドが成功しても、インストーラーの署名、公証、公開は行われません。 Rust またはシステム ライブラリが見つからない場合は、デスクトップのローカル セットアップを終了します。

カスタム コードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリック ページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

• 始める前に

【端末の基本】(/docs/web/terminal-basics)

• デスクトップローカルセットアップ
• エージェント プロンプトとプロジェクト メモリ

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 メタデータ、機能、およびプラットフォーム ID を確認します。共有アセット プロセスを通じてアプリ アイコンを置き換え、ビルド/実行時に目的のバックエンド 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

ターゲット OS 上のインストーラーを確認する

クリーンインストール、起動、バックエンドへの到達性、認証、メニュー/トレイ、ホットキー登録、2 インスタンス目、ディープリンク、オフラインリトライ、アンインストールを確認してください。サポートする各 OS で個別に検証します。ローカルビルドは署名・公証済みの商用配布を証明しません。署名の設定は自分でプロビジョニングするもので、同梱のリリースワークフローとアップデーターフィードは「自動アップデート」でカバーしています。

• ネイティブ受け入れチェックリスト
• 自動アップデートとリリースチャネル
• 共有バックエンドをデプロイする

インストールとセットアップ

インストーラーを準備する前に corepack pnpm --filter @supastack/desktop check:release-config を実行します。SUPASTACK_APP_URL が公開ホスト上の資格情報のない HTTPS であること、Tauri の識別子が製品固有であることをチェックします。このチェックはオプトインで、ローカル開発をブロックしません。

corepack pnpm --filter @supastack/desktop build は tauri build を実行します。tauri.conf.json のバンドルターゲットはホスト OS で利用可能なインストーラー形式を生成します — 出荷する各 OS でビルドしてください。アーティファクトは apps/desktop/src-tauri/target/release/bundle/ 配下に出力されます。

productName、version、identifier は 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/

実装ワークフロー

未署名installerはローカルに導入できますがOSの警告が出ます。コード署名とApple notarizationは製品側で設定し、証明書はrepositoryに置かず専用secret storeで管理します。

release buildに本番SUPASTACK_APP_URLを書き込み、導入済みshellがlocalhostではなく公開Webアプリを開くようにします。

検証とトラブルシューティング

各対象OSにbundleを導入し、build、OS、app URLを記録します。起動、対象deploymentの表示、tray、hotkey、ログイン保持を確認してください。tauri buildの成功だけではrelease合格になりません。