プラグイン管理
Turboism プラグインの安全な検索、設定、有効化、無効化、および管理。
Turboism は、プラグインを管理するための複数の補完的な手段を提供します。
- Cubism 内のプラグインマーケット(Turboism メニュー → プラグインマーケット…)または turboism.dev/plugins: ファーストパーティおよびカタログ掲載プラグインの検索と導入。
- 検証済みファーストパーティプラグインのバックグラウンド自動更新。
- プラグイン管理…: プラグインの有効化・無効化、アンインストール、ローカル JAR のステージング。
- 専用の 2 ペインウィンドウでのプラグイン設定…: プラグイン設定の一元的な構成。
すべてのインストーラーおよび ZIP パッケージには、レビュー済みのファーストパーティプラグインバンドルがあらかじめ同梱されています。追加のプラグインや、削除した同梱プラグインは、プラグインマーケットから導入できます。
すべてのプラグインライフサイクルとファイルの変更は安全にステージングされて適用されます。ステージングされた変更は Cubism 再起動後に適用され、ホットリロード(hot-reload)対応プラグインは即座に適用されます。
Turboism トップメニュー
Cubism Editor では、すべてのフレームワークおよびプラグイン機能が最上位の Turboism メニュー(以前は「プラグイン」/「插件」)に統合されています。メニュー項目:
- プラグインマーケット… — カタログからファーストパーティおよび厳選プラグインを検索・導入。
- プラグイン管理… — インストール済みプラグインの一覧、有効/無効の切り替え、ローカル JAR の追加、アンインストール。
- プラグイン設定… — 専用の 2 ペイン設定ウィンドウを開き、各プラグインのオプションを設定。
- 更新を確認 — Turboism フレームワークの新しいリリースを確認。
- Turboism 設定… — フレームワーク全体の設定(更新確認、ランタイムログ、言語ロケール、起動設定)。
- キーバインド… — 各種アクションのショートカットキーを確認・編集。
- ログ… — ランタイムおよび診断ログの保存先フォルダを開く。
- プラグインのアクション — アクティブなプラグインが追加した操作項目。
- バージョン情報 — インストールされている Turboism のバージョンとビルド情報を表示。
プラグインマーケットと自動更新
0.67.0 以降、ファーストパーティプラグインはフレームワーク全体を再インストールすることなく個別に導入・更新できます。
- Turboism → プラグインマーケット… または turboism.dev/plugins からプラグインを導入できます。
- ファーストパーティプラグインは署名検証を経てバックグラウンドで自動更新されます。
- ホットリロード(hot-reload)対応プラグインはモデリング作業を中断することなく即座に反映されます。
- その他のプラグイン更新は次回の Cubism 再起動時に反映されます。
- ユーザーは設定画面から公式プラグインの自動更新をいつでも無効化できます。
- 0.67.4 以降、プラグイン管理ウィンドウにはインストール済みプラグインの数と、マーケットで利用可能なプラグインの数が表示されます。
- 宣言された API 範囲に実行中の Turboism API が含まれないプラグインは、マーケットで非互換として表示されます。
プラグインの詳細: API 範囲と Cubism バージョン
Turboism → プラグイン管理… でプラグインをダブルクリックするか Enter キーを押すと、詳細を表示できます。0.67.2 以降、詳細には次の内容が表示されます。
- プラグインの SDK API 互換範囲(例:
[0.67.0,1.0.0))。 - プラグインが宣言する正確な Cubism Editor バージョン。利用可能バージョン、全機能対応バージョン、一部機能対応バージョン に分けて表示されます。宣言がない、または無効な場合は 未宣言 と表示されます。
ファーストパーティプラグインの JAR は、レビュー済みのケイパビリティ要件から生成された META-INF/turboism/cubism-versions.json にこれらの宣言を含みます。プラグインごとの範囲は互換性を参照してください。
プラグインの API 範囲は、そのプラグインが必要とする最小の Turboism フレームワークバージョンから始まり、1.0.0 の手前で終わります。ほとんどの公式プラグインは 0.67.0 を必要とし、新しい SDK 追加機能を使う一部のプラグインは 0.67.2 または 0.67.4 を必要とします(ファーストパーティプラグインを参照)。[0.1.0,0.2.0) を宣言する旧式のプラグインは拒否されます。
プラグイン設定
プラグインごとの設定を行うには、Turboism → プラグイン設定… を選択します。
- 専用の 2 ペインウィンドウが開きます(左ペインにインストール済みプラグイン一覧、右ペインに選択中のプラグイン設定フォーム)。
- 設定値は保存前に検証され、
config/<pluginId>/に保存されます。 - フレームワーク本体の設定は Turboism → Turboism 設定… に分離されています。
ローカル JAR のマネージドインストール
独自にビルドしたプラグイン JAR を追加する場合:
- 信頼できるソースからプラグイン JAR を取得またはビルドします。
- Cubism で Turboism → プラグイン管理… を選択します。
- JAR からインストール…(Install from JAR…)をクリックします。
- ローカルの
.jarファイルを選択します。 - JAR がローカル/未検証のソースであることを示す確認ダイアログを承認します。
- 操作が保留中(pending)と表示されたことを確認します。
- Cubism を終了し、同じ Turboism home から再起動します。
- プラグイン管理… とランタイムログで有効な状態を確認します。
ステージング前、Runtime は選択された JAR を未検証の入力として扱います。アーカイブ制限(サイズ、展開サイズ、圧縮比など)の範囲内で単一の記述子とプラグイン内容を検査し、安全に保留状態へとスナップショットします。
プラグインの置換または更新
- ファーストパーティプラグイン: バックグラウンドで自動更新されるか、プラグインマーケットから更新します。
- ローカル/サードパーティプラグイン: プラグイン管理… → JAR からインストール… で同じプラグイン ID の新しい JAR を導入し、置換操作をステージングします。
ローカルプラグイン更新の推奨手順:
- 現在の JAR と重要な
config/・data/の内容をバックアップします。 - プラグイン管理から新しい JAR をインストールします。
- Cubism を再起動します。
- 表示バージョン、状態、ログを確認します。
起動時チェックで検証が行われ、適用に失敗した場合は以前のプラグインファイルが自動復元されます。
プラグインの有効化と無効化
Turboism → プラグイン管理… で、任意のプラグインの有効/無効を切り替えられます。
- 設定は
config.jsonのdisabledPluginsに保存され、Cubism 再起動後に反映されます。 - Runtime 所有の
turboism.coreは組み込みコードであり無効化できません。 - 無効化されたプラグインは次回の起動時にロードがスキップされます。
- インストーラーを再実行またはアップグレードしても
disabledPluginsの設定は保持されます。以前無効化したプラグインが勝手に有効化されることはありません。
プラグインのアンインストール
- Turboism → プラグイン管理… を開きます。
- 削除するプラグインを選択し、アンインストール をクリックします。
- 保留中の操作を確認します。
- Cubism を再起動します。
- プラグインがロードされていないことを確認します。
- 必要に応じて永続化データを保持または削除します。
プラグイン JAR を削除しても、プラグイン所有のデータがすべて消えるわけではありません:
- 再インストール後に設定やデータが必要な場合は
config/<pluginId>/やdata/<pluginId>/を残してください。 cache/、state/、logs/は Cubism 停止時に安全に削除できます。
手動インストール(高度な代替手順)
手動インストールは、UI を介さずにローカル JAR をテストするための代替経路です。<turboism.home>/plugins/ に直接 JAR を配置します。通常はプラグインマーケットまたはマネージドインストールを推奨します。
プラグイン JAR はプラグインのソースからビルドされたものであり、Turboism のインストーラー実行ファイルやアーカイブとは異なります。
手動インストール手順
- Cubism と Turboism を完全に終了します。
- 使用している正確な Turboism home を確認します。
<turboism.home>/plugins/フォルダを開きます。- プラグイン JAR を
plugins/直下にコピーします(プラグイン ID ごとに 1 ファイル)。 - 同じ Turboism home で Cubism を再起動します。
- プラグイン管理… とログで状態を確認します。
手動インストールしたプラグインのアンインストール
- Cubism と Turboism を終了します。
<turboism.home>/plugins/から対象の JAR を削除します。- 再起動してプラグインが読み込まれていないことを確認します。
現在の制限事項
プラグイン管理では、現時点で以下を提供していません:
- 未検証のサードパーティ署名管理や自由な公開ストアへの登録。
- 過去バージョンの無制限な履歴保存と一括ロールバック。
- 完全な自動復旧 UI。
- Cubism 本体のインストール先や公式ランチャーのシステムレベルの変更。