アプリのマニフェストでランタイムモジュールを設定する方法

ランタイムモジュールは、アプリのアーキテクチャにおける重要なコンポーネントの1つで、アプリのコンポーネントの実行環境を定義するものです。コードがどのように解釈されて実行されるかはランタイムモジュールによって決定され、その影響はパフォーマンス、メモリ使用量、機能に及びます。ランタイムモジュールが不可欠な理由は、次のような役割を担っているためです。

アプリのコンポーネントと基盤のシステムとの互換性を確保する。
コンポーネントタイプ（対話型、タスク、サービス）に基づいてリソースの使用量を最適化する。
適切なプロセス管理とコンポーネントの分離を実現する。

ランタイムモジュールを定義するためのガイドライン

アプリのマニフェストでランタイムモジュールを定義するときは、以下のガイドラインに従ってください。

対話型コンポーネント

対話型コンポーネントには、次のランタイムモジュールのいずれかを使用します。

/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0
/com.amazon.kepler.runtime.keplerscript_2@IKeplerScript（新しい規則、検証ツールで警告が表示される場合があります）

マニフェストエントリの例

[components]
[[components.interactive]]
runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"

タスクコンポーネントまたはサービスコンポーネント

タスクコンポーネントまたはサービスコンポーネントでは、タスクやサービスが対話型コンポーネントと同じプロセスを共有していれば、対話型コンポーネントと同じランタイムモジュールを使用できます。 マニフェストエントリの例

[[components.interactive]]
id = "<アプリパッケージ名>.main"
runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0" 
launch-type = "singleton"

[[components.service]]
id = "<アプリパッケージ名>.service"
runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
launch-type = "singleton"

タスクコンポーネントまたはサービスコンポーネントが対話型コンポーネントと同じプロセスを共有していない場合は、headlessランタイムのいずれかを使用します。これらのランタイムは、より小さいメモリフットプリントで動作します。 /com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0 マニフェストエントリの例

[[components.service]]
id = "<アプリパッケージ名>.service"
runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0"
launch-type = "singleton"

プロセスグループの一貫性

同じプロセスグループ内のコンポーネントは、同じruntime-moduleを使用する必要があります。

バージョンの一貫性

マニフェスト内のすべてのランタイムモジュールには、常に同じKeplerScriptバージョンを使用する必要があります（バージョンは@記号の後の番号で示されます）。たとえば、バージョン2とバージョン1のランタイムモジュールを同じマニフェストに混在させることはできません。

検証の警告とエラー

上記のガイドラインに従っていない場合は、VPTでアプリのマニフェストを検証したときに警告メッセージまたはエラーメッセージが表示されます。以下のメッセージは、VPTから表示される警告とエラーの例を示しています。 例1：プロセスグループ内のランタイムモジュールに一貫性がない

manifest.toml:32:5 error: [processes.group] Inconsistent runtime modules in process group. Found multiple runtime modules: '/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0' (com.amazon.samplepkg.component.a), '/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0' (com.amazon.samplepkg.component.b, com.amazon.samplepkg.component.c)
  help: All components in a process group must have the same runtime module if declared

例2：ランタイムモジュールのバージョンに一貫性がない

manifest.toml:10:6 error: [components.runtime-module] Inconsistent runtime module versions found: 'IKeplerScript_1_0' (com.amazon.samplepkg.component.main), 'IKeplerScript_2_0' (com.amazon.samplepkg.component.main2, com.amazon.samplepkg.component.main3)
  help: All runtime modules declared must use the same version

​ランタイムモジュールを定義するためのガイドライン

​対話型コンポーネント

​タスクコンポーネントまたはサービスコンポーネント

​プロセスグループの一貫性

​バージョンの一貫性

​検証の警告とエラー