前提条件
Vega SDKをインストールします。すべてのビルドオプション
Vegaでは、開発者が独自の要件に基づいてカスタムアプリを作成できるように複数の方法が用意されています。ビルド方法は次の中から選択できます。- Vega Studio
- Vega CLI
Vega Studioを使用したアプリのビルド
Vega Studioは、アプリのビルド、実行、テスト、デバッグ、パフォーマンス分析を行うことができるVS Codeの拡張機能です。Fire TVやその他のVega対応デバイスをサポートしています。このセクションでは、Vega Studioを使用してVegaアプリをビルドする手順について説明します。手順1:Vegaプロジェクトを作成する
- VS Codeを開きます。
-
アクティビティバーからVega拡張機能のアイコン
をクリックして、Vega Studioパネルを開きます。
- [プロジェクト] セクションの [+](Vegaプロジェクトの作成)アイコンをクリックします。
-
プロジェクトテンプレートを選択します。
- helloWorld - React Native v0.72に依存するアプリを作成するには、このプロジェクトテンプレートを使用します。
- basic-turbo-module - カスタムターボモジュールを作成するには、このプロジェクトテンプレートを使用します。
- idl-turbo-module - サポートされているReact NativeのすべてのバージョンおよびネイティブのIDL APIと互換性があるアプリを作成するには、このプロジェクトテンプレートを使用します。
- プロジェクトのディレクトリを選択します。
- アプリのプロジェクト名を入力します(スペースや特殊文字は使用できません)。 例:MySampleProject プロジェクト名を入力したら、Enterキーを押します。
-
プロジェクトのパッケージ名を
<top-level domain>.<company_name>.<app_name>の形式で入力します。 例:com.mycompany.vegaproject プロジェクトのパッケージ名を入力したら、Enterキーを押します。 Vega Studioにより、選択したテンプレートに基づいてプロジェクトが作成されます。 プロジェクトを開いた状態でbasic-turbo-moduleテンプレートまたはidl-turbo-moduleテンプレートを選択すると、Vega Studioによってマルチルートワークスペースが作成されます。新しいプロジェクトは、同じVS Codeウィンドウにフォルダとして表示されます。Vega Studioは、開いているプロジェクトに新しいターボモジュールを依存関係として追加します。 複数のVegaアプリを開いている場合は、拡張機能から、ターゲットアプリを選択するように求められます。
手順2:Vegaアプリをビルドする
-
[Vega Studio] > [Projects] からプロジェクトを選択します。
-
[Build Mode] セクションからビルドモード(デバッグまたはリリース)を選択します。
-
[Devices] セクションの再生ボタン
をクリックして、対象の仮想デバイスを起動します。
-
プロジェクト名の横にあるビルドボタン
をクリックして、ビルドプロセスを開始します。
ビルド出力の表示
- VS Codeの統合ターミナルパネルに移動します。
- [出力] タブを選択します。
- ドロップダウンリストから [Vega] を選択します。 info build-kepler completedと表示されます。
手順3:(任意)カスタムポートを構成する
ポート8081が既に別のプロセスで使用されている場合は、カスタムポートを指定できます。- VS Codeで、[Code] > [基本設定] > [設定] に移動します。
- 検索ボックスに「React Native Port」と入力します。
- ポート番号を入力します。
-
プロンプトが表示されたら、VS Codeを再読み込みします。
デバッグセッションを開始すると、Vega Studioは、デバイスの共有の環境設定を自動的に
/data/shared_preferences.jsonに構成します。
手順4:Vegaアプリを実行してテストする
Vega仮想デバイスを使用する場合
- [Vega Studio] > [Devices] に移動し、[VirtualDevice:Tv] を選択します。
- [再生] ボタンをクリックして仮想デバイスを起動します。
- VVDウィンドウが開いてデバイスの読み込みが完了するまで待ちます。
- プロジェクト名の横にある [再生] ボタンをクリックします。 詳細については、Vega仮想デバイスを参照してください。
Fire TV Stickを使用する場合
- [Vega Studio] > [Devices] から、Fire TV Stickデバイスを選択します。
- プロジェクト名の横にある [再生] ボタンをクリックします。 Fire TV Stick上でアプリが開きます。詳細については、Fire TV Stickを参照してください。
手順5:(任意)React Native Packagerを停止する
React Native Packagerを停止するには、VS Codeステータスバーを使用する方法と、VS Codeコマンドパレットを使用する方法の2つがあります。オプション1:VS Codeステータスバーからの操作
下部にあるVS Codeステータスバーで、[React Native Packager] ボタンをクリックします。ボタンにカーソルを合わせると、[Stop Packager] というツールチップが表示されます。[Stop Packager] ツールチップボタンをクリックします。![VS Codeステータスバーの [React Native Packager] ボタンに [Stop Packager] ツールチップが表示されている画面のスクリーンショット。](https://m.media-amazon.com/images/G/01/mobile-apps/dex/vega/build-an-app/rn-packager._TTH_.png)
オプション2:VS Codeコマンドパレットからの操作

- コマンドパレットを開きます。 Mac: Cmd+Shift+P Linux: Ctrl+Shift+P
- 「React Native: Stop Packager」と入力して選択します。
手順6:Vegaアプリをデバッグする
Vega Studioにはデバッガーが組み込まれています。これを使用するには、Vega Studioを使用して1行ずつデバッグを実行する方法の手順に従います。手順7:アプリのパフォーマンスを分析する
Vega Studioには、アプリパフォーマンスの分析と最適化に役立つツールが用意されています。詳細については、次のページを参照してください。関連トピック
- Vega Studioでのビルドに関する問題の修正
- Vega仮想デバイスまたはFire TV Stickでのアプリの実行
- Vega CLIを使用してアプリをビルドするための高速リフレッシュの設定
- Vega拡張機能に関する問題を解決する

