インストール

Turboism のインストールにはインストーラーを使用します。インストーラーには、Windows ネイティブの TurboismInstaller-<version>.exe と、クロスプラットフォームの TurboismInstaller-<version>.jar（Windows と macOS にインストールでき、Java 17+ ランタイムが必要）の 2 種類があります。一般ユーザーはどちらかのインストーラーでインストールします。ソースからのビルドは開発者・メンテナー向けの作業です。

どちらのインストーラーも、Cubism JAR、DLL、公式 launcher file、licensing state、既存 project を変更しません。

インストーラーを選ぶ

• Windows では .exe インストーラーを使用します。ネイティブ経路であり、ユーザー単位でインストールされ、管理者権限は不要で、Windows 設定ツールとスタートメニュー連携を含みます。
• Windows または macOS で、プラットフォームをまたいで 1 つのインストーラーファイルを使いたい場合は .jar インストーラーを使用します。Java 17+ が必要で、java -jar TurboismInstaller-<version>.jar で実行します。
• インストーラーファイルは、そのビルドを提供した release または preview チャネルから入手する必要があります。Turboism は現在、これらのインストーラーの公開ダウンロードアセットを提供していません。
• インストーラー JAR はプラグイン JAR とは別物です。プラグインはこのインストーラーではなくプラグイン管理で管理します。

Windows .exe インストーラー

TurboismInstaller-<version>.exe は Windows ネイティブの NSIS インストーラーです。

• ユーザー単位で実行され、管理者権限を要求しません。
• 既定では %LOCALAPPDATA%\Turboism にインストールされます。別のディレクトリも選択できます。
• Lite と Full の 2 つのモードを提供します。Full は first-party plugin をインストールし、Lite は agent と共通ファイルのみをインストールします。
• Full モードでは、インストール前に個々のプラグインの選択を解除できます。
• ユーザー単位のスタートメニュー項目を追加し、現在のユーザーの「プログラムと機能」にアンインストールを登録します。
• インストール後に configure_turboism.ps1 を自動的に開き、Cubism ルートと管理起動エントリを設定できます。
• 後で削除するための uninstall.exe を書き込みます。
• Cubism のインストールファイルを変更しません。

クロスプラットフォーム .jar インストーラー（Windows/macOS）

TurboismInstaller-<version>.jar は IzPack ベースの Windows および macOS 用インストーラーです。

• Java 17 以降が必要です。
• 実行方法：

java -jar TurboismInstaller-<version>.jar

• 既定のインストール先：Windows では %LOCALAPPDATA%\Turboism、macOS では ~/Library/Application Support/Turboism。別のディレクトリも選択できます。
• .exe インストーラーと同じ Lite/Full モードを提供します。Full は first-party plugin をインストールし、Lite は agent と共通ファイルのみをインストールし、Full では個々のプラグインの選択を解除できます。
• インストーラーを再実行すると、同じ Turboism home とプラグイン選択が更新されます。無関係な設定を盲目的に上書きすることはありません。
• どちらのプラットフォームでも、生成されたアンインストーラーでアンインストールできます。

macOS のパッケージングとアンインストールは Preview です。Apple Silicon と Intel のパッケージングレーンでは検証されていますが、macOS Cubism ホストの起動と準備状態は未検証で、macOS Cubism ランチャーはインストールされません。macOS では、このインストーラーで Turboism のインストールとアンインストールはできますが、Cubism 内で Turboism を起動する検証済みの方法はまだ提供されていません。

インストール後

1. Windows では、Turboism home にある configure_turboism.ps1 を実行します。サポート対象の Cubism 5.2/5.3 ルートを検出し、選択した各ルートに管理起動エントリを 1 つ作成します。設定をキャンセルしても、フレームワークのみの有効なインストールが残ります。
2. 選択した Cubism ルートの管理ランチャーで Turboism を起動します（Windows では launch-cubism-turboism.bat）。
3. Turboism が起動し、Turboism home に診断情報が書き込まれることを確認します。
4. プラグイン管理でプラグインをインストールします。プラグイン JAR はステージングされ、Cubism の再起動後に適用されます。

アンインストール

• .exe インストーラーで作成した Windows インストール：Turboism home ディレクトリの uninstall.exe を実行します。確認時に config.json を保持するかどうかが尋ねられます。
• .jar インストーラーで作成した Windows インストール：以下を実行します。

java -jar <home>\Uninstaller\uninstaller.jar

• .jar インストーラーで作成した macOS インストール：home ディレクトリの uninstall.command をダブルクリックするか、ターミナルで実行します。

アンインストーラーは、インストーラー所有のファイルとランタイムの logs、state、cache データを削除します。不明なファイルと third-party plugin JAR は保持されます。config.json は、削除を選択した場合にのみ削除されます。

開発者とメンテナー

ソースからの Turboism のビルドとインストーラーパッケージのビルドは、開発者・メンテナー向けの作業です。ソース、フレームワーク、インストーラーのビルドは開発者・メンテナーのワークフローであり、このユーザーガイドには意図的に含めていません。

現在の制限

• macOS Cubism ホストの起動は未検証で、macOS Cubism ランチャーもインストールされません。
• インストーラーパッケージはまだ署名・ノータリゼーションされておらず、公開ダウンロードチャネルもありません。
• 自動オンラインアップデーターはありません。更新は新しいインストーラーの再実行を意味します。
• プラグイン置換の失敗は内部の backup/restore で保護されますが、完全なユーザー向け修復・履歴 UI はまだ存在しません。
• feature readiness は capability と version に依存します。