すべてのビルドオプション
Vegaでは、特定の要件に基づくカスタムアプリをビルドできるように複数の方法を用意しています。ビルド方法は次の中から選択できます。- Vega Studio
- Vega CLI
Vega Studioを使用したアプリのビルド
Vega Studioは、Fire TVやその他のVega対応プラットフォームでのアプリの作成、ビルド、実行、テスト、デバッグ、パフォーマンス分析を可能にするVS Codeの拡張機能です。このセクションでは、Vega Studioを使用してVegaアプリをビルドする手順について説明します。前提条件
手順1:Vegaプロジェクトを作成する
- Visual Studio Code(VS Code)を開きます。
- アクティビティバーからVega拡張機能のアイコンをクリックして、Kepler Studioパネルを開きます。
- [プロジェクト] セクションの [+](Vegaプロジェクトの作成)アイコンをクリックします。
-
プロジェクトテンプレートを選択します。
- hello-world - React Native v0.72に依存するアプリを作成するには、このプロジェクトテンプレートを使用します。
- basic-turbo-module - カスタムターボモジュールを作成するには、このプロジェクトテンプレートを使用します。
- idl-turbo-module - サポートされているReact NativeのすべてのバージョンおよびネイティブのIDL APIと互換性があるアプリを作成するには、このプロジェクトテンプレートを使用します。
- プロジェクトのディレクトリを選択します。
-
アプリのプロジェクト名を入力します(スペースや特殊文字は使用できません)。
以下に例を示します。 My3PSample
プロジェクト名を入力したら、
Enterキーを押します。 -
プロジェクトのパッケージ名を
<top-level domain>.<company_name>.<app_name>の形式で入力します。 例:com.org.vegaproject プロジェクトのパッケージ名を入力したら、Enterキーを押します。 Vega Studioにより、選択したテンプレートに基づいてプロジェクトが作成されます。開いているプロジェクトでbasic-turbo-moduleまたはidl-turbo-moduleテンプレートを選択すると、Vega Studioによりマルチルートワークスペースが作成されます。新しいプロジェクトがフォルダとして表示されるため、ターボモジュールを依存関係として使用し、両方を同じVS Codeウィンドウで開発できるようになります。Vega Studioにより、開いているプロジェクトに依存関係として新しいbasic-turbo-moduleが追加されます。basic-turbo-moduleの作成時に複数のVegaアプリを開いている場合は、拡張機能から、ターゲットアプリを選択するように求められます。
手順2:Vegaアプリをビルドする
-
[Kepler] > [プロジェクト] からプロジェクトを選択します。
-
[Build Mode] セクションからビルドモード(デバッグまたはリリース)を選択します。
- [Devices] セクションの再生ボタンをクリックして、対象の仮想デバイスを起動します。
- プロジェクト名の横にあるビルドボタンをクリックして、ビルドプロセスを開始します。
ビルド出力の表示
- VS Codeの統合ターミナルパネルに移動します。
- [出力] タブを選択します。
- ドロップダウンリストから [Kepler] を選択します。 info build-kepler completedと表示されます。ビルドが失敗した場合は、エラーメッセージを展開して問題を特定してください。
手順3:(任意)カスタムポートを構成する
ポート8081以外のカスタムポートを指定できます。- VS Codeで、[Code] > [基本設定] > [設定] に移動します。
- 検索ボックスに「React Native Port」と入力します。
- ポート番号を入力します。
-
プロンプトが表示されたら、VS Codeを再読み込みします。
デバッグセッションを開始すると、Vega Studioは、デバイスの共有の環境設定を自動的に
/data/shared_preferences.jsonに構成します。
手順4:Vegaアプリを実行してテストする
Vega仮想デバイスの場合:- [Kepler Studio] > [Devices] に移動し、[VirtualDevice:Tv] を選択します。
- [再生] ボタンをクリックして仮想デバイスを起動します。
- VVDウィンドウが開き、デバイスの読み込みが完了するまで待ちます(VirtualDevice:Tvのステータスは「読み込み中…」ではなく「準備完了」になります)
- プロジェクト名の横にある [再生] ボタンをクリックします。 詳細については、Vega仮想デバイスを参照してください。 Fire TV Stickの場合:
- [Kepler Studio] > [Devices] からFire TV Stickデバイスを選択します。
- プロジェクト名の横にある [再生] ボタンをクリックします。 詳細については、Fire TV Stickを参照してください。
手順5:(任意)React Native Packagerを停止する
React Native Packagerを停止するには次の2つの方法があります。オプション1:VS Codeステータスバーからの操作
下部にあるVS Codeステータスバーにある [React Native Packager] ボタンをクリックします。カーソルを合わせると、[Stop Packager] というツールチップが表示されます。オプション2:VS Codeコマンドパレットからの操作
- コマンドパレットを開きます。 Mac: Cmd+shift+P Linux: Ctrl+Shift+P
- 「React Native: Stop Packager」と入力して選択します。 いずれかのオプションを使用してPackagerを停止した後、[Kepler Studio] > [Projects] からアプリを再起動します。アプリ名の右側にある再生ボタンをクリックします。
手順6:Vegaアプリをデバッグする
Vega Studioにはデバッガーが組み込まれています。これを使用するには、Vega Studioでのデバッグにある手順に従います。手順7:アプリのパフォーマンスを分析する
Vega Studioには、アプリパフォーマンスの分析と最適化に役立つツールが用意されています。詳細については、次のページを参照してください。関連トピック
- Vega Studioでのビルドに関する問題の修正
- Vega仮想デバイスまたはFire TV Stickでのアプリの実行
- Vega CLIを使用してアプリをビルドするための高速リフレッシュの設定
- Vega拡張機能に関する問題を解決する

