- AI支援による移行 - Amazon Devices Builder Tools MCPサーバーでAI Assisted Upgrade Helperを使用します。ヘルパーは現在のバージョンを検出し、必要な変更のチェックリストを生成して、各手順を対話形式で案内します。
- 手動による移行 - このガイドの手順のページに従って、それぞれの変更を自分で行います。
前提条件
移行を開始する前に、次の要件が満たされていることを確認してください。- Vega SDK 0.24がインストールされていること
- Node.jsバージョン22.14.0以降
- npm(Node 22に付属)
- gitと、クリーンな作業ツリーおよびバックアップブランチ
- テスト用に開発者モードを有効にしたVega Fire TVデバイス
AI支援による移行
Amazon Devices Builder Toolsのモデルコンテキストプロトコル(MCP)サーバーには、VegaでのReact Nativeバージョンの移行用に設計されたAI Assisted Upgrade Helperが含まれています。このヘルパーは次の機能を提供します。- Vega固有のコンテキスト - Vegaの要件と制約を理解しています。
- TODOの自動生成 - アップグレードタスクのチェックリストを作成します。
- バージョン固有のナレッジ - React Native 0.83に固有の構成の詳細を読み込みます。
- 対話型のステップバイステップガイダンス - 各変更を順番に説明付きで案内します。
- チェックポイントと再開 - 進行状況を保存し、後でアップグレードを再開します。
MCPサーバーのインストール
Amazon Devices Builder Tools MCPサーバーをインストールします。0.1.31以上であることを確認します。
アップグレードヘルパーの起動
AIコーディングアシスタントを使用して、次のプロンプトコマンドを実行します。 Kiro、Claude Code、Clineの場合:- 開発者に作業ディレクトリの入力を求めます。または、既にプロジェクトがある場合はそのディレクトリを検出します。
package.jsonから現在のReact Nativeバージョンを検出します。- プロジェクトの構造と環境を検証します。
- React Native 0.83に関するVega固有のナレッジを読み込みます。
- 必要なすべての変更を含むTODOリストを生成します。
- 対話モードを開始して変更手順を案内します。
生成されたTODOリストの確認
アップグレードヘルパーは、プロジェクトディレクトリにRN_UPGRADE_TODO_[current_version]_to_0.83.mdという名前でTODOファイルを生成します。たとえば、RN_UPGRADE_TODO_0.72_to_0.83.mdのようになります。
このファイルがプロジェクトディレクトリに作成されていることを確認します。これにより、アップグレードヘルパーが正しく初期化されたことが確認できます。
TODOファイルには以下が含まれています。
- チェックボックスによる進行状況の追跡
- 優先度インジケーター(重要から低まで)
- 各変更の詳細な実装手順
- コード例とファイル参照
対話形式での変更の実行
アップグレードヘルパーは、コマンドベースのインターフェイスで対話モードを開始します。保留中のすべての変更が優先度別に整理されたメニューが表示されます。 対話型コマンド- [1-N] - 変更に対応する番号を選択すると、その実装ガイドが表示されます。単純な変更では、AIによる自動実装が提案される場合があります。
- complete - 現在の変更を手動で実装した後に完了としてマークします。
- build - ビルドエラーを報告し、ナレッジに基づいてトラブルシューティングを支援します。
- status - 詳細な進行状況レポートを表示します。
- help - コマンドリファレンスを表示します。
- exit - 進行状況を保存して終了します。後で再開できるように、
.rn-upgrade-checkpoint.jsonが作成されます。
- ヘルパーから表示された、優先度別の保留中の変更を確認します。
- 選択する変更の番号を入力します。
- 詳細な手順を含む実装ガイドを確認します。
- AIから提案された変更の実装を受け入れるか、手動で実装して
completeと入力します。 - 残りの変更について同じ手順を繰り返します。
ビルドとテストの実行
アップグレードの変更が完了したら、接続されているVegaデバイスでアプリをビルドして実行するようにAIアシスタントに指示します。AIにより、ビルド、デプロイ、起動が処理されます。 ビルドエラーが発生した場合は、アップグレードヘルパーが問題を説明し、解決策を提供します。また、RN83にアップグレードするにはpackage.jsonのどの依存関係を変更する必要があるかなど、具体的な変更について質問することもできます。
ビルドと検証のコマンドを手動で実行するには、手順7:ビルドと検証を行うを参照してください。
手動による移行
アプリを手動で移行するには、以下の手順を順番に実行します。手順1~4と6~7はすべてのアプリに必要です。手順5は、アプリでCarouselコンポーネントを使用している場合にのみ必要です。関連トピック
外部リソース
- React Native 0.83リリースノート(英語のみ)
- React 19リリースに関するブログ記事(英語のみ)

