手順1：
依存関係を更新する
依存関係を更新する
手順1： 依存関係を更新する
手順1： 依存関係を更新する
オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、最新のリリースノートを参照してください。
1.1 コア依存関係を更新する
package.jsonで、依存関係に関連するセクションをRN 0.83用の新しいバージョンに置き換えます。
{
"dependencies": {
"react": "19.2.0",
"react-native": "0.83.0",
"@amazon-devices/react-native-kepler": "4.0.0",
"@react-native/new-app-screen": "0.83.0",
"react-native-safe-area-context": "^5.5.2"
},
"devDependencies": {
"@babel/core": "^7.25.2",
"@babel/preset-env": "^7.25.3",
"@babel/runtime": "^7.25.0",
"@react-native/babel-preset": "0.83.0",
"@react-native/eslint-config": "0.83.0",
"@react-native/metro-config": "0.83.0",
"@react-native/typescript-config": "0.83.0",
"@react-native-community/cli": "11.3.2",
"@types/react": "^19.2.0",
"@types/react-test-renderer": "^19.1.0",
"@types/jest": "^29.5.0",
"babel-jest": "^29.6.3",
"eslint": "^8.57.0",
"jest": "^29.6.3",
"prettier": "2.8.8",
"react-test-renderer": "19.2.0",
"ts-jest": "^29.1.0",
"typescript": "5.8.3",
"@amazon-devices/keplerscript-commonmodules": "^1.0.0"
},
"engines": {
"node": ">=22.14.0"
}
}
RN83に必要な依存関係
RN83には以下の依存関係が必要です。
-
@react-native-community/cli：@amazon-devices/kepler-cli-platformでvega buildコマンドを登録するために、バージョン11.3.2が必要です。これを削除すると、npm run build:releaseが「Unrecognized command vega build」というエラーで失敗します。 -
jestの依存関係：jest、babel-jest、ts-jest、@types/jestはすべてv29にする必要があります。v28とv29が混在していると、「ERESOLVE unable to resolve dependency tree」というエラーが発生します。 -
reactのオーバーライド：overridesセクションに"react"がある場合は、"19.2.0"に更新します。"overrides": { "react": "19.2.0" }
1.2 サードパーティパッケージを更新する
すべてのサードパーティパッケージを、RN 0.83と互換性のあるバージョンに更新します。バージョンの一覧表については、サポート対象のライブラリとサービスを参照してください。
よく使用されるパッケージの例
{
"@amazon-devices/react-native-reanimated": "~4.0.0",
"@amazon-devices/react-native-worklets": "~1.0.0",
"@amazon-devices/react-native-gesture-handler": "~4.0.0",
"@amazon-devices/react-native-screens": "~3.0.0",
"@amazon-devices/react-native-svg": "~3.0.0",
"@amazon-devices/react-native-fast-image": "~3.0.0",
"@amazon-devices/kepler-ui-components": "^3.0.0",
"@amazon-devices/react-native-localize": "~2.1.0",
"@amazon-devices/react-native-async-storage__async-storage": "~2.1.0"
}
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のスプリットバンドルシステムでモジュール解決エラーが発生します。 -
kepler-ui-componentsは3.0.0+にする必要があります。バージョン2.xにはreact-nativeの独自のコピーがバンドルされ、間接的な依存関係が存在するため、Jestテストがフロー／ESM解析エラーで失敗します。この要件は、カルーセルを使用するアプリだけでなく、kepler-ui-componentsを使用するすべてのアプリに適用されます。
1.4 依存関係をインストールする
npm installを実行して、ほかの依存関係をすべて取得します。
# 古いキャッシュとの競合を避けるためにクリーンインストールを実行します。
rm -rf node_modules package-lock.json
npm install
Last updated: 2026年7月9日
