ビルドとリリース

流通モデル

デスクトップ ビルドは、Vite フロントエンド、Bun でコンパイルされたサイドカー、生成された SQLite 移行を Tauri アプリケーションにパッケージ化します。このリポジトリは、macOS Apple Silicon と Intel、Windows x64 と ARM64、Linux x64 と ARM64 のビルドを定義します。リリースの自動化は次のように構成されます .github/workflows/release.yml;プラットフォームのビルド チェックも、 build-platforms.yml.

ワークフロー定義は公開プロセスを記述します。インストーラーの可用性と有効性は、その特定の実行およびリリース資産から確立する必要があります。ソース コードだけでは、署名資格情報、公証結果、ターゲット マシンへのインストールの成功を証明することはできません。

パイプラインの構築

scripts/build.ts 6 つの順序付けされたステージを実行し、ステージが失敗すると中止します。

1. インストール： すべてのオペレーティング システムと CPU アーキテクチャのオプションの依存関係を含む、凍結されたロックファイルのインストール。
2. チェック： ワークスペースのタイプチェック。単体テストは別の CI コマンドです。
3. コンパイル： でサイドカーを構築します scripts/compile-sidecar.ts rust ターゲット トリプルの場合。
4. リソース： ステージ packages/db/drizzle バンドルされた移行として。
5. バンドル： フロントエンドを構築し、ターゲット、バンドル、署名、およびアップデーター設定を使用して Tauri を呼び出します。
6. アーティファクト: インストーラー アセットのインデックスを作成し、SHA-256 チェックサムを書き込み、Git 履歴からリリース ノートを生成します。

bun scripts/build.ts --help
bun scripts/build.ts --dry-run
bun run build:sidecar
bun scripts/build.ts --only=resources
bun scripts/build.ts --no-updater

--only そして --skip 芸名を受け入れる。 --target, --bundles、 そして --out-dir 出力を選択します。デフォルトのターゲットは、によって報告されたホストです。 rustc -vV。サイドカーバイナリは次のように書き込まれます。 apps/desktop/src-tauri/binaries/sidecar-<triple>、 と .exe windows 上で。不必要な開発の再開を避けるために、同一のバイナリと移行ツリーは変更されずに維持されます。

使用 compile-sidecar.ts パイプラインを通じて、組み込みホストのバンドル調整を適用します。直接の汎用コンパイル コマンドは、同じビルド手順を表しません。デフォルトのアーティファクト ディレクトリは次のとおりです。 apps/desktop/src-tauri/target/release-artifacts.

の resources ステップコピー packages/db/drizzle/ の中へ apps/desktop/src-tauri/resources/migrations/ 繰り返しても安全です。の artifacts ステップ書き込み SHA256SUMS そして RELEASE_NOTES.md、最後のタグ以降のコミットから構築されます。ステップエイリアスは次によって受け入れられます --only そして --skip: deps, checks/test, sidecar, migrations、 そして notes/checksums/release。スクリプトは決して読まれない .env* シークレット値をファイルまたは出力します。

CIと出版物

リリース ワークフローは次の目的で実行されます。 v* タグ、または非フォーク リポジトリ上で手動で選択した既存のバージョン タグ。 release-ref.ts タグとアプリケーションのバージョンを確認し、コミットを解決します。各ビルドでは、接尾辞が付いているバージョン タグなどのプラットフォーム リリースが作成されます。 macos-arm64 または linux-x64。すべてのプラットフォーム リリースが公開された後でのみ、バージョン インデックスがマージされたバージョンを公開します。 latest.json.

stage-release.ts 公開前に、選択したアーティファクト、チェックサム/署名関係、マニフェスト リンクをチェックします。すでに公開されているリリースは上書きされません。インデックス リリースは、安定バージョンの最新版となる資格があります。プレリリースはプレリリースとしてマークされたままになります。

アップデーターのビルドには、Tauri 署名秘密キーと、次の公開キーに対応するパスワード構成が必要です。 tauri.conf.json。 macOS リリースの署名/公証には Apple 証明書とアカウント設定が使用されます。 Windows は署名証明書をインポートし、その拇印をバンドラーに渡します。必要なリリース署名入力が欠落していると、リリースのビルドが失敗します。これらは CI シークレット ストアを通じて構成します。

npm トークンが利用可能な場合、別のリリース ジョブによって nikcli プラグイン パッケージが公開されます。プライマリ スコープを公開できない場合は、すでに公開されているバージョンをスキップし、構成されたフォールバック パッケージ名を使用できます。このパッケージ ジョブは、デスクトップ インストーラーの可用性を確立しません。

アップデーターの動作

構成されたアップデータ エンドポイントは、リポジトリの最新の GitHub リリースのダウンロードです。 latest.json。 Rust アップデーターは、起動時と 4 時間ごとにチェックを行い、サービスを通じて手動チェックがキューに入れられます。各リクエストでは、30 秒のタイムアウトが使用されます。マニフェストはプラットフォーム固有の資産と署名を識別します。公開キーはアプリケーション構成の一部です。

update://status チェック、最新、利用可能、ダウンロード、準備完了、および失敗した状態を保持します。リリースノートの内容 [critical] 利用可能なアップデートを非表示としてマークします。再起動準備完了状態も解除できません。これはプロンプトに影響します。インストールでは、保存されていない作業ガードが引き続き考慮されます。

install_update 発表されたバージョンを記録して再チェックし、署名が検証されたパッケージをダウンロードします。エディターはダウンロード前とダウンロード前に再度保存します。 apply_update、ダウンロード中に行われた編集を保護します。保存されていない作業は両方の操作をブロックします。失敗した保存では、再試行のために検証されたバイトが保持されます。ネイティブ ステータスはサブスクライブ後に回復され、チェックはアクティブな進行状況または保留中の再起動を置き換えることはできません。 Windows は、インストーラーが制御を取得する前にサイドカーを排出します。他のプラットフォームでは、インストール後に再起動が行われます。

データベースの互換性

パッケージ化されたアプリケーションが開く cadcamfun.db アプリケーション データ ディレクトリの下にあります。保留中の移行は、バンドルに含まれる移行を使用して起動時にデータベース層によって適用されます。したがって、スキーマのアップグレードとバイナリの更新は、別個の成果物であっても関連しています。

生成されたリリース ノートでは、追跡された移行ツリーと以前のリリース タグが比較されます。変更されたツリーは、ダウングレードするには安全ではないと報告されます。変更されていないツリーは移行互換として報告されます。利用できない履歴は不明として報告されます。この自動比較では、アプリケーション レベルの互換性の問題の可能性がすべて検証されるわけではありません。

バイナリを古いバージョンに置き換える前に、現在のデータを保存し、リリースの互換性に関するメモを調べてください。順方向移行コードは逆方向移行を意味するものではありません。実際のデータ ディレクトリのデータベースのバックアップとリカバリの手順に従ってください。

リリースの検証

bun test scripts
bun scripts/build.ts --only=artifacts --dry-run

ヘルパー テストは、ターゲット マッピング、署名要件、アーティファクトの名前付け、マニフェストの処理、およびステージング ルールを検証します。ドライランでは、コンパイルや署名を行わずに、計画された操作が出力されます。どちらも、実際のネイティブ バンドル、アップデータのダウンロード/インストール テスト、またはコンパニオンの物理デバイスの受け入れに代わるものではありません。

運用リリースの場合は、正確なタグ/コミット、ワークフロー結果、ターゲット固有のインストーラーと更新アセット、チェックサム/署名ファイル、および公開されたマニフェストを保持します。インストールされたアプリがバンドルされたサイドカーと移行を開始し、アップデーターが目的のプラットフォーム アセットを選択することを検証します。

ターゲットとアセットのリファレンス

ジェネレーターには、上記のフォーマットごとに 1 つのアセットが必要です。そのアセットに隣接する .sig ファイルとリリースノート。アセット名には <triple>-- 接頭語;重複した名前と孤立した署名は拒否されます。 Tauri アップデータ 2.13.1 は、インストールされるパッケージの種類を自動的に選択します。 Linux では、AppImage のない署名付き Debian/RPM パッケージを使用します。

マージされたマニフェストは、バージョン、発行日、および注記について合意する必要があります。公開するには、上記の 10 個のキーがすべて必要です。 Windows ベース キーは、古いクライアントに対する NSIS 互換性を維持します。 MSI キーは MSI インストールを保存します。 URL は、認証情報、クエリ、またはフラグメントなしで HTTPS を使用する必要があります。ステージングでは、各ターゲットのプレフィックス、パッケージのサフィックス、署名、リリース URL をチェックします。

ローカルビルドオプションと署名入力

bun --no-env-file scripts/build.ts   --only=compile,resources   --target=aarch64-apple-darwin   --dry-run

bun --no-env-file scripts/build.ts   --skip=install,check   --target=x86_64-unknown-linux-gnu   --bundles=deb,rpm   --no-updater   --dry-run

取り除く --dry-run 選択したターゲット ツールチェーンとネイティブの前提条件がインストールされている場合のみ。 Bun 実行可能ファイルのクロスコンパイルだけでは、クロスプラットフォームの Tauri リンカーおよびBunドラーは提供されません。 --only そして --skip 相互に排他的です。 --skip-install は便宜的なエイリアスです。 --no-updater アップデーターのアーカイブ/署名の作成とその署名ゲートは省略されます。

ビルドは、バンドル ステップに対してのみローカル アップデーター資格情報をロードし、環境を通じてその子プロセスに署名値を渡します。ローカル署名ファイルを印刷したり、ドキュメントの例に実際の鍵マテリアルを配置したりしないでください。インストールされているアプリの公開キーと一致しない秘密キーは、そのアプリに対して承認された更新を生成できません。

リリース故障診断

有用なリリース レポートには、失敗したステージと構築中のターゲットが記録されます。非機密アーティファクト名、検証エラー、ワークフロー識別子を含めます。アップデーターの実行中に、以前にインストールされたバージョンと検証済みのデータのバックアップを利用できるようにしておいてください。移行の互換性は、署名の有効性とは別にチェックされます。

実装アンカー: scripts/release-helpers.ts, signing-config.ts, updater-manifest.ts, stage-release.ts、 そして apps/desktop/src-tauri/src/updater.rs.

6 つの構築ステップ

ステップは常にこの順序で実行され、ステップが失敗すると実行が停止します。スクリプトは決して読まれない .env ファイルを作成し、シークレット値を出力することはありません。

bun scripts/build.ts --dry-run                  # whole plan, no side effects
bun scripts/build.ts --only=resources           # restage migrations (idempotent)
bun scripts/build.ts --only=compile,resources   # rebuild the sidecar and migrations
bun scripts/build.ts --only=notes --dry-run     # preview release notes
bun scripts/build.ts --target=aarch64-apple-darwin

ローカルアップデータの署名では無視された tauri-signing.json 環境に署名キーが設定されていない場合。次の場合もプラットフォーム証明書が必要です CADCAM_RELEASE=1.

リリースマトリックス

1. 信頼できるジョブは、アプリケーションのバージョンに対してリリース タグを検証します。
2. 各マトリックス ジョブが実行される bun --no-env-file scripts/build.ts --target=… --bundles=… --out-dir=release、パッケージ形式のマニフェストに署名し、構築します。 Windows は、オプションの署名証明書をインポートした後、削除します。
3. マージ ジョブは、6 つのアーキテクチャ マニフェストすべてとその 10 個のパッケージ エントリを 1 つにまとめて検証します。 latest.json.
4. 1 つの完了ジョブでは、単一バージョンのリリースを作成または再開して公開する前に、すべてのインストーラー アーティファクト、署名、チェックサム、メモが検証されます。

プッシュごとに CI は 2 つのジョブを実行します。インストール、タイプチェック、テスト (およびサイドカー バイナリと移行のステージング)、および Clippy と src-tauri テスト。

3Dで