as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content

1.1 更新核心依赖项

使用RN 0.83中的新版本替换package.json依赖项的相关部分。
RN83的必要依赖项 RN83需要以下依赖项:
  1. @react-native-community/cli: 保留Vega应用模板使用的版本20.0.0。@amazon-devices/kepler-cli-platform通过此程序包注册react-native build-vega命令。移除它会导致npm run build:release失败,因为react-native build-vega是一个无法识别的命令。
  2. jest依赖项:jest、babel-jest、ts-jest和@types/jest都必须为v29。混合使用v28和v29会导致ERESOLVE unable to resolve dependency tree。
  3. react覆盖: 如果您有一个包含"react"的overrides,请将其更新为"19.2.0":
可选依赖项 以下程序包不是Vega应用模板的一部分,标准应用也不需要它们。仅当您的应用使用它们时才添加:
  • @react-native/new-app-screen (0.83.0): 仅当您的应用从上游React Native模板渲染NewAppScreen组件时。
  • react-native-safe-area-context (^5.5.2): 仅当您的应用使用SafeAreaProvider或此程序包中的其他组件时。
  • @amazon-devices/keplerscript-commonmodules (^1.0.0): 仅当您的应用使用JavaScript系统捆绑时。

1.2 更新第三方程序包

更新所有第三方程序包至其RN 0.83兼容版本。有关完整的版本表,请参阅支持的库和服务。要确认哪些SDK版本附带RN 0.72和RN 0.83,请参阅版本兼容性矩阵。 常用程序包示例

1.3 其他库更新

部分库对React Native 0.83提出了新要求:
  • react-native-reanimated需要react-native-worklets。如果您的应用使用@amazon-devices/react-native-reanimated,则还必须添加@amazon-devices/react-native-worklets作为依赖项。这是reanimated 4.0.0中新增的必需运行时依赖项。缺失该依赖项会导致应用在启动时崩溃,且无明确的错误信息。
  • @amazon-devices/shopify__flash-list与RN 0.83不兼容。请改为直接使用上游@shopify/flash-list@2.1.0程序包。打包版本在RN 0.83的捆绑包分包系统中存在模块解析错误。
  • @amazon-devices/react-linear-gradient不是RN 0.83库集合的一部分。请将其移除,改用内置experimental_backgroundImage样式属性。请参阅将LinearGradient取代为backgroundImage样式属性。
  • kepler-ui-components必须是3.0.0+。2.x版本捆绑了自身的react-native副本,且带有传递依赖项,导致Jest测试因Flow/ESM解析错误而失败。这适用于所有使用kepler-ui-components的应用,而不仅仅是轮播用户。

1.4 安装依赖项

运行npm install以接收所有其他依赖项。
最后修改于 2026年10月28日