インストール

ドキュメントのバージョン v0.1.0-beta.3GitHub でソースを見る

このページは OmsiLaunch 0.1.0-beta3 の英語版の原文ページの翻訳です。規範となるのは英語版です。内容が異なる場合は、英語版のページとコードが優先されます。

このページでは、OmsiLaunch 0.1.0-beta3 の要件、対応する OMSI ビルド、リリースパッケージを OMSI のインストールルートにインストールする方法、そしてセッションを開始する前に /version と /plan でインストールを確認する方法を説明します。パッケージの内容はパッケージングで規定されています。最初の起動については最初のセッションで説明します。

要件#

要件	詳細	満たされない場合の失敗
Windows 10 以降、64 ビット	コントローラーは `Environment.OSVersion.Version.Major >= 10`、x64 オペレーティングシステム、x64 プロセスであることを検査します。	`OL_E_UNSUPPORTED_OPERATING_SYSTEM`（または `OL_E_UNSUPPORTED_OS_ARCHITECTURE`）によりプランが実行不可となり、終了コードは `1`/`3` です。
.NET 6 Desktop Runtime、x64	`OmsiLaunch.Controller.runtimeconfig.json` は `Microsoft.NETCore.App` 6.0 と `Microsoft.WindowsDesktop.App` 6.0 を必要とします（トレイインジケーターが Windows Forms を使用するため）。シムは `nethost.dll` を使ってこれを探します。	`OmsiLaunch.exe` は何も出力する前にシムコード `102`..`106` で終了します。`OmsiLaunchW.exe` は `OmsiLaunch could not start the .NET host (code N).` を表示します。
.NET 6 Runtime、x86	プラグインは 32 ビットの `Omsi.exe` 内で実行されるため、`plugins\OmsiLaunch.Plugin.runtimeconfig.json` は x86 用の `Microsoft.NETCore.App` 6.0 を必要とします。x86 の .NET 6 Desktop Runtime バンドルでもこの要件を満たします。	プラグインが OMSI 内で起動せず、セッションは `Running` に到達できません（`OL_E_PLUGIN_NOT_LOADED` / `OL_E_STARTUP_TIMEOUT`）。終了コードは `1` で、ファイルは復元されます。
対応する OMSI 2 ビルド	SHA-256 が `692EBFBF2CD32FAB05A8B934E52C2BE14594E939882F3DBF2BA4E2B66CCC6243`（8,503,440 バイト）の `Omsi.exe`、プロファイル `Omsi23004_692EBFBF`、ランタイム検証済み。Steam LAA 実行ファイル `7DAB063D1F62E73B3A2C7A6AC1921D7EDF5E5DB0FBC731481D117EEC8DE7D759` も受け入れられますが、その検証ステータスは `pending_beta_field_validation` です。ハッシュはプランを作成するたび、および開始するたびに再検査されます。	`OL_E_UNSUPPORTED_BUILD`。プランは実行不可となり、終了コードは `1` です。互換性を参照してください。
書き込み可能なインストールルート	トランザクションは `.omsilaunch\`、`GUI\` と `Texture\` 配下のオーバーレイ、および `options.cfg` に書き込み、それらを復元します。ルートは現在のユーザーが書き込み可能でなければなりません（適切な権限なしで `Program Files` を使用することは避けてください）。	`OL_E_INSTALLATION_NOT_WRITABLE`、終了コード `1`。
インストール環境ごとに 1 ユーザー、1 オーナー	インストールリース `Local\OmsiLaunch.Installation.<sha256(root)>` と制御パイプはログオンセッション単位です。	`OL_E_INSTALLATION_BUSY` / `OL_E_SESSION_ALREADY_ACTIVE`、終了コード `7`。

どちらのランタイムも Microsoft から個別にダウンロードします。.NET 6 の x64 Desktop Runtime と x86 Runtime（または x86 Desktop Runtime）をインストールしてください。これ以外のコンポーネントは必要ありません。データがマシンの外に送信されることはありません。

OMSI ビルドを確認する#

<OMSI_PATH> を OMSI 2 のディレクトリ（例: C:\OMSI 2）に置き換えてください。

Get-FileHash '<OMSI_PATH>\Omsi.exe' -Algorithm SHA256
(Get-Item '<OMSI_PATH>\Omsi.exe').Length

ハッシュは上記の 2 つのいずれかでなければなりません。インストール後は、OmsiLaunch.exe profiles が同じ一覧を検証ステータス付きで出力します。

パッケージをインストールする#

OmsiLaunch-0.1.0-beta3.zip と OmsiLaunch-0.1.0-beta3.zip.sha256 をダウンロードし、チェックサムを確認します（Get-FileHash の結果が .sha256 ファイル内の値と一致しなければなりません）。
アーカイブを OMSI のインストールルート（Omsi.exe を含むフォルダー）に直接展開します。アーカイブはそのルートに合わせた構成になっています。
- ルートには OmsiLaunch.exe、OmsiLaunchW.exe、nethost.dll、OmsiLaunch.Controller.dll およびその他の OmsiLaunch.*.dll コントローラーアセンブリ、YamlDotNet.dll、release-manifest.json、LICENSE、THIRD-PARTY-NOTICES.md が配置されます。
- 常駐プラグインのクロージャ plugins\OmsiLaunch.*（9 ファイル）は既存のプラグインの隣に配置され、既存のプラグインには一切触れません。
- .omsilaunch\ にはスプラッシュ用アセット、オフラインドキュメント、サンプルが含まれます。
release-manifest.json は OmsiLaunch.exe の隣に置いたままにしてください。これにより、開始のたびにインストール済みのプラグインファイルが SHA-256 で検証されます（plugin.integrity.reference = manifest）。これがない場合は、存在と自己整合性のみが検査されます（plugin.integrity.reference = self）。
plugins\OmsiLaunch.* 配下のものを移動したり名前を変更したりしないでください。また、プラグインのバイナリを .omsilaunch\ に置かないでください。

アップグレードも同じ操作です。セッションが実行されておらず、保留中のリカバリもない状態（OmsiLaunch.exe /recovery-status）で、新しいパッケージを古いファイルの上に展開します。プラグインのハッシュとマニフェストは常に同じパッケージのものでなければなりません（そうでない場合は OL_E_PERMANENT_PLUGIN_HASH_MISMATCH）。

確認する#

OMSI ルートから実行します（インストール環境の引数は、既定では OmsiLaunch.exe を含むディレクトリになります）。

OmsiLaunch.exe /version

期待される結果: "version": "0.1.0-beta3"、"protocol_version": "0.1"、"supported_family": "OMSI_2_3_004_COMMON"、終了コード 0。終了コード 102..106 は、x64 の .NET 6 ランタイムが存在しないか、パッケージが不完全であることを意味します。

OmsiLaunch.exe profiles
OmsiLaunch.exe /list:Maps

期待される結果: 対応するハッシュ、続いてこのインストール環境で検出されたマップ。終了コード 0。

OmsiLaunch.exe /new /map:maps\Grundorf\global.cfg /entrypoint-index:1 /plan

期待される結果: Plan: READY profile=Omsi23004_692EBFBF と終了コード 0（/list:Maps の任意のマップ識別子を使用できます。エントリポイントのインデックスはそのマップで提示されたインデックスでなければなりません。/list:Entrypoints /map:<identity> を参照してください）。--json を付けると、プランには TouchedFiles（スプラッシュのオーバーレイ）、PlannedMutations、RequiredCapabilities（すべて STATICALLY_VALIDATED）、Diagnostics（plugin.integrity.reference を含む）、IsRunnable が一覧されます。終了コード 1 を伴う Plan: NOT RUNNABLE の場合は、Diagnostics にその理由が示されます（OL_E_UNSUPPORTED_BUILD、OL_E_MAP_NOT_FOUND、OL_E_ENTRYPOINT_REQUIRED、OL_E_RUNTIME_ARTIFACT_MISSING など）。プランの作成で OMSI が起動されることはなく、インストール環境に書き込まれることもありません。

インストール後のファイルの場所#

パス	内容
`<root>\.omsilaunch\diagnostics\<sessionId>-host.log`	各セッションのホストトレース（新しい 50 セッション分を保持）
`<root>\.omsilaunch\diagnostics\tray-host.log`	トレイインジケーターのログ
`<root>\.omsilaunch\journal.json`、`backup\<sessionId>\`	トランザクションが保留中の間のみ存在します。トランザクションとリカバリを参照してください
`<root>\.omsilaunch\session-profiles\<id>\profile.yaml`	利用者が事前定義したセッションプロファイル。セッションプロファイルを参照してください
`<root>\.omsilaunch\assets\splash\`	管理対象のスプラッシュ用アセット
`<root>\.omsilaunch\docs\`	このドキュメントのオフライン版（`README.md` から読み始めてください。CLI リファレンスは `reference\cli.md` です）
`<root>\.omsilaunch\examples\`	LaunchSpec とセッションプロファイルのサンプル

アンインストール#

セッションをすべて停止し、OmsiLaunch.exe /recovery-status を実行し（保留中であれば /recover も実行し）、その後ルートの製品ファイル、plugins\OmsiLaunch.*、.omsilaunch\ を削除します。詳細はパッケージングを参照してください。

次のステップ#

最初のセッション · CLI リファレンス · 既知の制限事項