步骤1：
依赖项更新
依赖项更新
步骤3： Vega配置更新
步骤3： Vega配置更新
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
为确保您的应用在设备上正常加载，须进行Vega相关的特定更改。
3.1 Manifest.toml交互组件
更新适用于用户界面组件的运行时模块路径和接口：
# 之前 (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 = "<your-app-package-name>.onInstallTask"
runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0"
# 之后 (RN 0.83)
[[components.service]]
id = "<your-app-package-name>.service"
runtime-module = "/com.amazon.kepler.runtime.react_native_kepler_headless_4@IReactNativeKeplerHeadless_0"
launch-type = "singleton"
[[components.task]]
id = "<your-app-package-name>.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日
