手順1：
依存関係を更新する
依存関係を更新する
手順3： Vegaの構成を更新する
手順3： Vegaの構成を更新する
オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、最新のリリースノートを参照してください。
デバイスでアプリが正しく読み込まれるようにするには、Vega固有の変更が必要です。
3.1 manifest.tomlの対話型コンポーネント
UIコンポーネントのランタイムモジュールのパスとインターフェイスを更新します。
# 更新前（RN 0.72/Vega 2.x）
[[components.interactive]]
id = "com.amazon.kepler.script.app.krl.2.yourapp.main"
runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
launch-type = "singleton"
# 更新後（RN 0.83/Vega 4.x）
[[components.interactive]]
id = "com.amazon.kepler.script.app.krl.4.yourapp.main"
runtime-module = "/com.amazon.kepler.runtime.react_native_kepler_4@IReactNativeKepler_0"
launch-type = "singleton"
主な変更点
- コンポーネントID：
krl.2→krl.4 - ランタイムモジュールのパス：
keplerscript.runtime.loader_2→runtime.react_native_kepler_4 - インターフェイス：
IKeplerScript_2_0→IReactNativeKepler_0
3.2 manifest.tomlのヘッドレスコンポーネント
アプリでヘッドレスコンポーネント（サービスまたはタスク）を使用している場合は、次の例のようにランタイムモジュールを更新します。
# 更新前（RN 0.72）
[[components.service]]
id = "<your-app-package-name>.service"
runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0"
launch-type = "singleton"
[[components.task]]
id = "<アプリパッケージ名>.onInstallTask"
runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0"
# 更新後（RN 0.83）
[[components.service]]
id = "<アプリパッケージ名>.service"
runtime-module = "/com.amazon.kepler.runtime.react_native_kepler_headless_4@IReactNativeKeplerHeadless_0"
launch-type = "singleton"
[[components.task]]
id = "<アプリパッケージ名>.onInstallTask"
runtime-module = "/com.amazon.kepler.runtime.react_native_kepler_headless_4@IReactNativeKeplerHeadless_0"
主な変更点
- ランタイムモジュールのパス：
headless.runtime.loader_2→runtime.react_native_kepler_headless_4 - インターフェイス：
IKeplerScript_2_0→IReactNativeKeplerHeadless_0
3.3 app.jsonを更新する
app.jsonで、コンポーネントIDをkrl.2からkrl.4に更新します。
{
"name": "com.amazon.kepler.script.app.krl.4.yourapp.main"
}
3.4 CMakeLists.txtを更新する
CMakeLists.txtファイルで、バージョン番号、C++標準、ライブラリターゲットを更新します。
テンプレートパターン（krl.2→krl.4）
# 更新前
set(EXECUTABLE_NAME sample-2)
set(PACKAGE_NAME KeplerScriptAppTemplate-2)
set(CMAKE_CXX_STANDARD 17)
project(${EXECUTABLE_NAME} VERSION 2.0)
# 更新後
set(EXECUTABLE_NAME sample-4)
set(PACKAGE_NAME KeplerScriptAppTemplate-4)
set(CMAKE_CXX_STANDARD 20)
project(${EXECUTABLE_NAME} VERSION 4.0)
バージョンサフィックスパターン（072→083）
# 更新前
set(VERSION_SUFFIX 072)
find_package(keplerui 0.72 CONFIG REQUIRED)
# 更新後
set(VERSION_SUFFIX 083)
find_package(keplerui 0.83 CONFIG REQUIRED)
ネイティブコードのリンク（C++ネイティブモジュールを使用している場合）
# cxx/CMakeLists.txt
# 更新前
target_link_libraries(${TARGET_NAME} keplerui::keplerscript-2)
# 更新後
target_link_libraries(${TARGET_NAME} keplerui::keplerscript-4)
要件
- CMake 3.22以降
- C++20互換コンパイラ（GCC 10以降、Clang 12以降、MSVC 2019以降）
3.5 Vegaバンドルを構成する
package.jsonファイルにバンドル構成パッケージを追加します。
{
"devDependencies": {
"@amazon-devices/keplerscript-commonmodules": "^1.0.0"
}
}
必要に応じて、package.jsonでバンドル分割を構成します。パフォーマンスの向上のために、本番アプリではdisableSplitBundleを削除するかfalseに設定して、コード分割を有効にすることをお勧めします。
{
"kepler": {
"disableSplitBundle": true
}
}
Last updated: 2026年7月9日
