VUIC CarouselからVega Carouselへの移行
以下のセクションでは、Vega UIコンポーネントライブラリに含まれているCarouselから、個別のパッケージとして提供されているVega Carouselに移行する方法について説明します。プロパティの移行
新しいバージョンのCarouselを使用するには、以下に示すプロパティに変更を加える必要があります。
Vega Carouselとサポートされるプロパティの詳細については、こちらを参照してください。
Vega Carouselパッケージのインポート
例
次の例は、Vega Carouselとそのプロパティの使用方法を示しています。AI向けAmazon Devices Builder Toolsを使用してVega Carouselに移行する方法
AI向けAmazon Devices Builder Toolsは、Vega UIコンポーネントライブラリに含まれているCarouselから、個別のパッケージとして提供されているVega Carouselへの移行を支援することができます。AI向けAmazon Devices Builder Toolsのトラブルシューティングは@amazon-devices/amazon-devices-buildertools-mcpです。詳細については、AI向けAmazon Devices Builder Toolsで開発を開始する方法を参照してください。
前提条件
- MCPをサポートするAIエージェント。
- Kiro CLI
- Cursor
- VSCode Copilot
- Claude Code CLI
- Amazon Q IDE
- Amazon Q CLI
- Cline
- VUIC Carouselが実装されているVegaアプリプロジェクト。
手順1: AI向けAmazon Devices Builder Toolsのインストール
プロジェクトディレクトリで次のコマンドを実行します。- AIエージェントを選択します(たとえば、Clineの場合は7と入力します)。
- エージェントのMCP設定を自動更新するかどうかを選択するプロンプトで、Yと入力します。
- コンテキストドキュメントのインストールパスとして、デフォルトのパスを選択します。
- インストールされたコンテキストドキュメントを確認し、マージ/更新します。
手順2: MCPのインストールを検証する
AIエージェントのチャットインターフェイスで、エージェントに次のように指示します。手順3: Carouselの移行を実行する(自然言語)
AIエージェントのチャットインターフェイスで、次のように指示します。AIエージェントが自動的に実行する手順の概要
- MCPドキュメントからカルーセルの移行ワークフローを読み取ります。
- ステップバイステップの移行手順に従います。
- 手順ごとに開発者に承認を求めます。
AIガイドによる移行プロセスの詳細
AIエージェントにより、次の手順が案内されます。- バックアップの作成:
YourCarousel_ORIGINAL.tsx - インポートの更新:
@amazon-devices/kepler-ui-components→@amazon-devices/keplerscript-native-ui-components - package.jsonの更新:
@amazon-devices/keplerscript-native-ui-components: ~0.1.0を追加 - データアクセスの移行: データプロパティ →
dataAdapterと関数 - すべてのプロパティの移行: VUICL Vegaのプロパティ → Vega Carouselの同等のプロパティ
- ロジックの更新:
onFocus→onSelectionChanged(該当する場合) - クリーンアップ: 使用されないVUIC Carouselコードの削除
手順4: 依存関係をインストールする
移行が完了したら、次のコマンドを実行して@amazon-devices/keplerscript-native-ui-componentsパッケージをダウンロードします。
手順5: ビルドとテストを実行する
-
ビルドするには、次のコマンドを使用します。
-
実行するには、次のコマンドを使用します。
- ビルドが成功する。
- テストに合格する(
npm test -- -uによるスナップショットの更新が必要な場合があります)。 - リンティングエラーがない。
例: Clineでの移行セッション
エージェントに次のように指示します。- MCPからcarousel.mdワークフローを読み取ります。
- バックアップファイルを作成します。
- 変更を1つずつ提案します。
- 変更を行う前に、毎回承認を求めます。
- 移行を自動的に完了します。
よくある問題と解決策
使用されない変数を削除する
原因: VUIC Carouselの変数(viewInfos、getViewForIndex)は不要になりました。
解決策: AIに 「Remove unused variables from the migration」と指示します。
インラインスタイルの警告が発生する
原因:itemStyleオブジェクトがインラインで渡されています。
解決策: AIに 「Extract itemStyle to constants」と指示します。
スナップショットテストが失敗する
原因: コンポーネント構造が変更されています。解決策:npm test -- -uを実行してスナップショットを更新します。
移行の検証
移行が完了したら、次の点を確認してください。- インポートが更新されていること。 インポートに
@amazon-devices/keplerscript-native-ui-componentsが含まれていることを確認します。 - package.jsonが更新されていること。 両方のパッケージ(
vega-carousel+ほかのコンポーネント用のkepler-ui-components)が存在することを確認します。 - バックアップが作成されていること。*_ORIGINAL.tsxファイルが存在することを確認します。
- ビルドが成功すること。
npm run buildが正常に完了することを確認します。 - テストに合格すること。
npm testが成功することを確認します。
移行による主な変更点
MCPを使用してサポートされているAIエージェントをセットアップする方法
以下に、サポートされている各AIエージェントをMCPでセットアップする手順へのリンクを示します。成功基準
- Carouselのすべてのファイルが移行される。
- ビルドがエラーなしで完了する。
- テストに合格する(必要に応じてスナップショットが更新される)。
- リンティングエラーが新たに発生しない。
- ロールバック用にバックアップファイルが作成される。

