インストールとアンインストール

Twinwright Studio のインストール方法（多数のコンピューターに確認なしで一度にインストールする方法を含みます）、各ファイルの置き場所、アンインストールの方法を説明します。

Linux については Linux の場合を参照してください。

インストール

TwinwrightStudio-<version>-setup.exe を実行します。
ライセンス契約書を読み、I Agree をクリックします。
インストール先のフォルダー（%LOCALAPPDATA%\Programs\Twinwright Studio）をそのまま使うか、別のフォルダーを選びます。
最後のページで、Studio を起動するかどうかと、デスクトップにショートカットを置くかどうかを選びます。

インストーラーの表示言語は英語か中国語で、システムの言語に従います。

自分用か、コンピューターの全員用か

インストーラーは、実行した人のために Studio をインストールします。管理者権限は不要で、スタートメニューの項目とデスクトップのショートカットは、その人のものになります。このコンピューターを使う人はそれぞれ、自分用に Studio をインストールします。

ライセンスは人ではなくコンピューターに属し、このコンピューターのすべてのユーザーが共有します（ライセンスフォルダーを参照）。

Studio は、ファイルの関連付け、PATH、ファイアウォールの設定を変更せず、サービスもインストールしません。

サイレントインストール

TwinwrightStudio-<version>-setup.exe /S [/DESKTOP] [/D=<folder>]

/S は、ページを表示せずにインストールします。Studio は起動しません。
/DESKTOP は、デスクトップのショートカットを追加します。
/D= は、インストール先のフォルダーを指定します。必ず最後の引数にし、引用符は付けません。フォルダー名に空白が含まれていても同じです。

確認なしでアンインストールするには、Studio 本体のフォルダーで uninstall.exe /S を実行します。

置き場所

内容	場所
Studio 本体	`%LOCALAPPDATA%\Programs\Twinwright Studio`
作業内容：プログラム、バージョン、レポート、監査ログ	`ドキュメント\Twinwright Studio`
Studio 自身の状態：設定、機械、AI サービスのキー	`%LOCALAPPDATA%\Twinwright\Studio`
ライセンス	`%ProgramData%\Twinwright\licence`

Studio 本体のフォルダー

TwinwrightStudio.exe、マニュアル（manual\）、README.txt、THIRD-PARTY-NOTICES.txt、uninstall.exe が入っています。このフォルダーはアップデートしても変わらないので、接続した AIクライアントはそのまま動作し続けます。

ドキュメント

ドキュメント\Twinwright Studio（Windows が割り当てるドキュメントフォルダーで、リダイレクトされている場合も同じです）の中身は、次のとおりです。

programs\：すべてのプログラムのバージョンと、CAM ジョブのバージョン。
Reports\：検査レポート、段取りシート、診断パッケージ。
logs\：監査ログ。

ツール > 設定… > ファイル とログで、プログラムとログの保存場所を別の場所に移せます（次回起動時に反映）。

Studio 自身の状態

%LOCALAPPDATA%\Twinwright\Studio：設定、ウィンドウの位置、機械ごとの「ワールド」（ワーク、工具、オフセット、コントローラの設定）、AI サービスのキー（お使いの Windows アカウント用に暗号化されます）、クラッシュレポート（30日間保持されます）。

ライセンスフォルダー

%ProgramData%\Twinwright\licence には、ライセンスファイル（試用を含む）が保存され、このコンピューターのすべてのユーザーで共有されます。Studio は、最初のアクティベートまたは試用のときに、このフォルダーを作成します。Studio がここに書き込めない場合は、管理者がフォルダーを作成し、ユーザーに書き込み権限を与えることができます。

特殊な構成では、次の環境変数でフォルダーを移せます。

環境変数	移動対象
`TWINWRIGHT_STATE_DIR`	Studio 自身の状態
`TWINWRIGHT_WORKDIR`	プログラムのフォルダー
`TWINWRIGHT_LOGDIR`	監査ログ
`TWINWRIGHT_LICENCE_DIR`	ライセンスフォルダー

新しいバージョンへのアップデート

Studio を閉じてから、新しいバージョンのインストーラーを実行します。同じフォルダーにインストールされ、作業内容、設定、機械、ライセンスはそのまま残ります。Studio は、アップデートがあるかどうかを自分で確認しません（アップデートを参照）。

Studio がバックグラウンドでまだ動作している場合（AIクライアントが起動したものの場合があります）、インストーラーは古い実行ファイルを退避させ、次回のアップデートまたはアンインストールのときに削除します。

アンインストール

Windows の 設定 > アプリ > Twinwright Studio > アンインストール を使うか、Studio 本体のフォルダーにある uninstall.exe を実行します。

アンインストール後に残るもの

アンインストールすると、Studio 本体、そのショートカット、アプリ の項目が削除されます。次のものは残ります。

ドキュメント\Twinwright Studio にある作業内容。
%LOCALAPPDATA%\Twinwright\Studio にある Studio 自身の状態。
ライセンスフォルダー。
接続した AIクライアントの設定にある twinwright の項目。

すべてを削除するには、これらを手動で削除してください。ライセンスフォルダーを削除しても、試用を使い直すことはできません。ライセンスサーバーが、各コンピューターに各エディションの試用を 1 回ずつ与えるためです。

Linux の場合

インストール

Linux 版 Studio は 1 つのファイル、AppImage です。システムには何もインストールされません。

ファイルを確認します：sha256sum TwinwrightStudio-<version>-x86_64.AppImage の結果がダウンロードページの SHA-256 と一致すること。
置いたままにできる場所に、バージョンを含まない名前で置きます（更新後も接続した AI クライアントがそのまま使えるように）。そして実行可能にします：
```
 mkdir -p ~/Applications
 mv TwinwrightStudio-<version>-x86_64.AppImage ~/Applications/TwinwrightStudio.AppImage
 chmod +x ~/Applications/TwinwrightStudio.AppImage
```

起動します：~/Applications/TwinwrightStudio.AppImage、またはファイルマネージャーでダブルクリックします。

AppImage には FUSE 2 が必要です。そのために起動しない場合はインストールするか（Ubuntu 24.04 以降：sudo apt install libfuse2t64）、代わりに .tar.gz を使います：好きな場所に展開し、そのフォルダーの TwinwrightStudio を起動します。

Linux での保存場所

何	どこ
プログラム（マニュアル付き）	AppImage（置いた場所）
あなたの作業：プログラム、バージョン、レポート、監査ログ	`~/Documents/Twinwright Studio`
プログラム自身の状態：設定、機械	`~/.local/state/twinwright/studio`（`$XDG_STATE_HOME` が設定されていればその下）
AI サービスのキー	デスクトップのキーリング。ない場合は状態フォルダー内の、あなただけが読めるファイル
ライセンス	`/etc/twinwright/licence`、または `~/.local/share/Twinwright/licence`

ご自分のアカウントでライセンスフォルダーを作成または書き込みできる場合、フォルダーはそのコンピューターのもので、すべてのユーザーが共有します。できない場合、Studio はライセンスを ~/.local/share/Twinwright/licence（$XDG_DATA_HOME が設定されていればその下）に保存します。あなただけのもので、引き続きこのコンピューターでのみ有効です。コンピューターのユーザー全員で 1 つのライセンスを共有するには、sudo install -d -m 1777 /etc/twinwright/licence でフォルダーを一度作成してください。

Linux での試用と有効化

試用、有効化、更新は Windows と同じくオンラインで行い、システムの libcurl を使います。libcurl がない場合やインターネットに接続できない場合は、オフラインで有効化します（ライセンスを参照）。

Linux での更新と削除

更新するには、Studio を終了し、新しい AppImage を古いものと同じ名前で置き換えます（上の手順 2）。削除するには、AppImage を削除します。どちらの場合も、ドキュメント、状態フォルダー、ライセンスフォルダー、キーリング内のキー、接続した AI クライアントの twinwright 項目は残ります。すべて消すには、これらを手で削除してください。