1.1 更新核心依赖项
使用RN 0.83中的新版本替换package.json依赖项的相关部分。
-
@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是一个无法识别的命令。 -
jest依赖项:jest、babel-jest、ts-jest和@types/jest都必须为v29。混合使用v28和v29会导致ERESOLVE unable to resolve dependency tree。 -
react覆盖: 如果您有一个包含"react"的overrides,请将其更新为"19.2.0":
@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以接收所有其他依赖项。

