npm错误
ERESOLVE—对等依赖项解析失败
错误:ERESOLVE unable to resolve dependency tree
修复:
- 全新安装:
- 如果仍失败,请根据错误输出 (“已发现:X” vs ” 无法解决:Y”) 来识别冲突
- 确保所有依赖版本均符合目标版本RN 0.83的要求
- 切勿使用
--legacy-peer-deps—它会掩盖冲突,进而导致运行时错误。
对等React版本冲突(已缓存0.72)
错误:peer react@... from react-native@0.72或Conflicting peer dependency: react@19
原因: node_modules中已缓存的react-native@0.72.0与React 19冲突。
修复:
"react": "19.2.0", "react-native": "0.83.0", "@types/react": "^19.2.0".
@types/react版本不匹配
错误:Found: @types/react@18 / peerOptional @types/react@^19
修复: 更新devDependencies:
ts-jest对等依赖项冲突
错误:peer jest@^28.0.0 from ts-jest
修复: 更新ts-jest以匹配jest v29:
TypeScript错误
未找到tsconfig.json扩展
错误:TS6053: File '@react-native/typescript-config/tsconfig.json' not found
修复:
/tsconfig.json后缀)
allowImportingTsExtensions / customConditions
错误:TS5096或TS5098
修复: 向tsconfig.json添加覆盖项:
使用isolatedModules重新导出类型
错误:TS1205: Re-exporting a type when 'isolatedModules' is enabled
修复:
CMake和原生版本错误
未找到keplerscript目标
错误:Target links to keplerscript-2 but the target was not found
修复: 在cxx/CMakeLists.txt中:
不支持C++20功能
错误:C++20 features not supported
修复: 确保已安装CMake 3.22以上版本,且支持C++20编译器(GCC 10以上版本或Clang 12以上版本)。
Metro Bundler错误
找不到模块 ‘@react-native/babel-preset’
修复:无法解析模块
修复:Jest错误与测试错误
SyntaxError:无法在模块(平台包)之外使用导入语句
原因:@amazon-devices/react-native-kepler@4.0.0在其Jest设置中使用了ES模块。
修复: 在jest.config中的transformIgnorePatterns中添加:
无法读取未定义的属性 (Dimensions/PixelRatio/StyleSheet)
原因: React 19更改了模拟行为。这些API无法自动模拟。 修复: 添加模拟到jest.setup.js(请参阅步骤7.2)。
无法在已卸载的测试渲染器上访问.root
原因: 将@testing-library/react-native render()包装在ReactTestRenderer.act()中。
修复: 移除act()包装—由测试库内部处理(请参阅步骤7.4)。
缺失NativeAnimatedModule方法存根
错误: 在Cannot read properties of undefined (reading 'apply')中NativeAnimatedHelper.js
原因: RN 0.83动画系统在NativeAnimatedModule上调用了23种特定方法。
修复: 添加完整模拟到(请参阅步骤7.2)。
导航栈计时器泄漏
错误:You are trying to import a file after the Jest environment has been torn down
修复:
已在keplerscript-native-ui-components中嵌套react-native
错误:keplerscript-native-ui-components/node_modules/react-native发生Flow/ESM解析错误
原因:kepler-ui-components@2.x捆绑了自身的react-native副本。
修复: 更新到@amazon-devices/kepler-ui-components@3.0.0版本。
运行时错误
运行时模块加载失败:IKeplerScript_2_0
原因:manifest.toml仍引用旧版Kepler 2.x运行时。 修复: 更新manifest.toml中的runtime-module路径(请参阅第4阶段)。未找到模块’@amazon-devices/keplerscript-commonmodules’
修复: 添加到devDependencies:无法识别的build-kepler命令
原因:已移除@react-native-community/cli。
修复: 保留devDependencies:

