更新ポリシー
インストーラーの再実行で Turboism を更新し、stable、beta、nightly のリリースチャンネルを選択する。
Turboism は 3 つのチャンネルで製品リリースを公開し、すべてのパッケージを機械可読なリリースフィードの背後でミラーしています。Turboism は stable 更新を自動でチェックしますが、更新のインストールは引き続き明示的な手動操作です。インストーラーの自動ダウンロードや実行は行われません。
リリースチャンネル
| チャンネル | バージョンの形式 | 目的 |
|---|---|---|
stable | X.Y.Z | 日常的な利用。レビュー済みのリリースノートと翻訳。 |
beta | X.Y.Z-beta.N、X.Y.Z-rc.N、または X.Y.Z-alpha.N | stable になる前の変更を試す。 |
nightly | X.Y.Z-0.nightly.BUILD | 日次の開発ビルド。ソースが変更されたときだけ生成されます。 |
- チャンネルが
status: not_publishedを返すことは正常で、エラーではなく空のチャンネルです。 - nightly ビルドは開発ビルドです。使用前にプロジェクトをバックアップしてください。
- すべてのチャンネルが同じ 4 つのパッケージ形式と、同じパッケージ単位の SHA-256 サイドカーを生成します。
機械可読フィード
各チャンネルは JSON ドキュメントを公開します。
https://api.turboism.dev/v1/releases/stable.json
https://api.turboism.dev/v1/releases/beta.json
https://api.turboism.dev/v1/releases/nightly.jsonドキュメントには、channel、選択された release（version、tag、buildNumber、sourceRevision、publishedAt）、ローカライズされた release notes、および asset ごとの name、size、SHA-256、checksum file、利用可能な source（official ミラーと github）の行が含まれます。条件付きリクエストに対応しています。サービスのエラー、空のレスポンス、失敗したリクエストを「最新である」と解釈してはいけません。
製品サイトも同じデータを turboism.dev/download に使用しています。
フレームワークを更新する
config.jsonと、重要な persistent プラグインのconfig/・data/の内容を backup します。- プラットフォームとチャンネルに合った新しいパッケージをダウンロードし、その SHA-256 チェックサムを検証します。
- 新しいインストーラーを実行し、同じ Turboism home ディレクトリを対象にします。または、展開済みのポータブルアーカイブのファイルを置き換えます。
- 更新の一部としてプラグイン選択（Full、Thin、Lite）を再実行します。
- 更新後に startup、plugin discovery、host capability status、logs を確認します。
インストーラーを再実行すると、同じ home と選択が更新され、無関係な設定を盲目的に上書きすることはありません。更新の手段として Cubism installation file を上書きまたは書き換えないでください。
プラグインを置換または更新する
同じ plugin ID を持つ新しいプラグイン JAR をインストールすると、Cubism の再起動後に適用される replacement intent がステージングされます。
- 現在の plugin JAR と、重要な場合は plugin の persistent
config/<pluginId>/・data/<pluginId>/の内容を backup します。 - plugin management を通じて新しい JAR をインストールします。
- Cubism を再起動します。
- version、lifecycle state、configuration migration、logs を確認します。
適用に失敗した場合、private backup から以前の plugin file が復元されます。この workflow は historical generation を保持せず、完全なユーザー向け修復・ロールバック・purge UI も提供しません。
互換性に関する期待値
- Turboism は単一の public SDK 階層を公開します。source repository のレビュー済みバイナリ API ベースラインが compatibility gate です。
- API が存在しても、すべての Cubism version に Provider があるとは限りません。
- host-sensitive operation は、未サポートまたは未検証の version では利用できないままになることがあります。
- plugin author は宣言された Turboism API range を使用し、unavailable behavior をテストすべきです。
- 対応する Cubism Editor バージョンは 5.2.03、5.3.02、5.3.03 で、Windows x64 が対応するホストプラットフォームです。
更新チェッカー
Turboism は、デプロイ済みのリリース API（api.turboism.dev/v1/releases/stable.json）に対して stable 更新を確認します。比較にはインストール済みパッケージに埋め込まれた正規のビルド番号を使用するため、より低いビルドが更新として提示されることはなく、ビルド番号が同じでバージョンが異なる場合は更新ではなく識別情報の競合として扱われます。ビルド番号導入前のインストールは引き続きバージョンのみで比較し、推測された番号が割り当てられることはありません。
利用可能な更新は、描画領域上のネイティブ Cubism ヒントとして提示されます。ヒントをクリックすると固定の公式ダウンロードページが開きます。リリースフィードの URL を開いたりインストールしたりすることはなく、インストーラーを自動でダウンロード・実行することもありません。
更新チェックは UI をブロックせず、24 時間に最大 1 回だけ実行され、手動チェックは常に利用可能です。自動チェックは「起動」設定タブに専用の永続トグルがあり、Cubism 自身の更新抑制設定とは独立しています。
現在利用できないもの
- フレームワークまたはプラグイン更新の自動ダウンロードとインストール。
- 本番有効化されたマーケットプレイス。
- publisher signature と revocation。
- 保持される immutable な JAR generation。
- 完全なユーザー向け修復・ロールバック・リカバリ UI。
- Cubism launcher のグローバルな変更。
組み込みの Official Directory client と UI は存在しますが、本番アクティベーションは未準備です。本番 key list は空で、ライブ署名済み catalog の準備は確立されていません。