Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
ターボモジュールは、スタンドアロンライブラリで作成することも、アプリパッケージの一部として作成することもできます。これらをそれぞれ「スタンドアロン」と「アプリ内」のターボモジュールと呼びます。 Vega SDKには、スタンドアロンライブラリでターボモジュールを作成するためのテンプレートが用意されていますが、プロジェクトに最適な方法を選択できます。以下の手順では、両方の方法を説明します。完了すると、ディレクトリ構造は次のようになります。

前提条件

ターボモジュールのビルドでは、ホストマシン上でネイティブC++コードがコンパイルされますが、これにはVega SDKにバンドルされていないビルドツールチェーンが必要です。Ubuntuに、makeおよびC/C++ コンパイラを提供するbuild-essentialパッケージをインストールします。Ubuntuの依存関係を参照してください。これらのツールがない場合、ネイティブビルドはNo such file or directory: 'make'のようなエラーで早期に失敗します。

セットアップ

アプリ内ターボモジュール

アプリ内モジュールの場合は、アプリを作成の手順に従って開始アプリを作成します。

スタンドアロンターボモジュール

スタンドアロンモジュールの場合は、ターボモジュールテンプレートから開始できます。パッケージのルートから以下のコマンドを実行すると、使用可能なテンプレートのリストが表示されます。
ターボモジュールの場合は、次のいずれかを選択してプロジェクトを生成します。
  • idlTurboModule: OS API(IDL)を使用している場合
  • basicTurboModule: 独自のコードからTurbo Moduleを作成する場合
コマンドが成功すると、出力ディレクトリには新しいターボモジュールプロジェクトが含まれます。

IDLターボモジュール

IDLターボモジュールのテンプレートは、次の追加引数を受け入れます。
  • --idlPackage: ターボモジュールで使用するIDLパッケージ。逆引きDNS表記で記述します。たとえば、com.amazondeveloper.kepler.fooのように指定します。
  • --outputDir:[任意] プロジェクトを生成するディレクトリ。指定しない場合、コマンドを実行したフォルダにプロジェクトが生成されます。
--idlPackageに渡すパッケージ名を確認するには、Vega Native APIリファレンスを参照してください。ここでは、利用可能なすべてのIDLパッケージが分野別に一覧表示されています。 テンプレートによって生成されたプロジェクトでは、指定されたOKIDLインターフェイスへの依存関係だけが宣言されます。インターフェイスを機能的に使用するには、開発者がターボモジュールC++実装ファイルのコードを変更する必要があります。ただし、これらの変更を行わなくても、テンプレートからインターフェイスが生成されると、プロジェクトはリクエストされたインターフェイスを検出して正常にビルドします。 例

プレーンターボモジュール

プレーンターボモジュールのテンプレートは、次の追加引数を受け入れます。
  • --outputDir:[任意] プロジェクトを生成するディレクトリ。指定しない場合、コマンドを実行したフォルダにプロジェクトが生成されます。

ターボモジュールの作成

手順1: TurbomoduleAPIをインストールする

テンプレートを使用してTurbo Moduleを作成した場合、@amazon-devices/keplerscript-turbomodule-apiパッケージはpackage.jsonのdependenciesセクションに既に記載されているため、この手順はスキップできます。 パッケージのルートから、次のコマンドを実行します。

手順2: TypeScriptでインターフェイス定義を作成する

ターボモジュールのテンプレートを使用した場合、このファイルは既に存在しますが、必要に応じて変更する必要があります。NativePinger.tsファイル(注: ファイル名はテンプレートに渡した名前に基づいて付けられます)は、ネイティブモジュールのJavaScriptへのインターフェイスを定義します。慣例上、src/turbo-modulesに配置されます。 インターフェイスは次のようになるはずです。
前述のコードではPingerというインターフェイスを定義し、数値を返す単一の関数pingを公開します。使用可能な戻り値の型の詳細については、ネイティブコードでのJavaScriptの型を参照してください。 TurboModuleRegistry.getEnforcingは'Pinger'をルックアップキーとして使用してモジュールのネイティブオブジェクトをロードし、見つからない場合は例外を発生させます。次に、返されたオブジェクトにPingerインターフェイスがバインドされます。

手順3: Codegenを実行してネイティブスキャフォールディングを生成する

TurbomoduleAPIライブラリには、TypeScriptインターフェイスに基づいてC++スキャフォールディングを生成できるCodegenツールが含まれています。生成されたコードは、ターボモジュールのC++仕様を定義します。Codegenを使用するには、次のコマンドを実行します。
Codegenは一度に1つのTypeScriptインターフェイスのみを受け入れます。同じパッケージで複数のターボモジュールを作成している場合は、異なる引数を使用してCodegenを複数回実行できます。 codegen ツールの詳細については、npx keplerscript-turbomodule-api codegen -hを実行するか、Vega Codegen FAQを参照してください。

手順4: C++関数を実装する

通常、kepler/turbo-modules/generated/ディレクトリ内にcodegenによって作成されたファイルを手動で変更する必要はありません。変更すると、Codegenを再実行したときにこれらのファイルが上書きされることに注意してください。更新内容が失われないようにするには、変更したファイルを別の場所にキャッシュし、codegenを再実行した後にその変更内容をもう一度適用してください。 kepler/turbo-modules/ディレクトリ内の C++ (.h/.cpp) ファイルに、インターフェイスを実装します。前のステップで生成された関数本体を入力する必要があります。

IDL

ターボモジュールがIDL経由でOS APIを使用する場合、インポートを追加し、IDLコンポーネントをインスタンス化し、必要に応じてAPIを使用する必要があります。 各IDLパッケージが公開するインターフェイス、メソッド、およびタイプについては、Vega Native APIリファレンスを参照してください。 例 インポートを追加します。
IDLコンポーネントをインスタンス化し、APIを使用します。
com.amazondeveloper.kepler.fooは存在する場合、テンプレートに渡した--idlPackage と一致する必要があります。 より詳細な例については、インターナショナリゼーション開発者ガイドを参照してください。

手順5: JavaScriptレイヤーを実装する

作成したTypeScriptインターフェイスは、ネイティブオブジェクトをJavaScriptから呼び出すための型情報を提供します。エラー処理、JavaScriptロギング、オプションパラメーターやサポートされていない型の引数の前処理などの操作では、ネイティブメソッドよりもJavaScriptロジックのレイヤーを追加したい場合があります。現時点ではそのようなロジックが必要ない場合でも、JavaScriptとネイティブAPIを切り分ける基本的なラッパーを追加すれば、今後のAPIの変更に柔軟に対応できるようになります。
その場合は、ターボモジュールのユーザー用にラッパーのインスタンスをエクスポートして、ユーザーとネイティブオブジェクトとの間のレイヤーとして使用します。たとえば、スタンドアロンのTurbo Moduleパッケージには、そのindex.tsにexport {default as Pinger} from './turbo-modules/Pinger'が含まれている場合があります。

JavaScriptテストを追加する

Jestなどのフレームワークを使用して、JavaScriptコードをテキスト化することができます。Jestでテストを実行する場合、C++ターボモジュールインスタンスは存在しないため、JavaScriptテスト用にモックを作成する必要があります。 次の例は、C++ターボモジュールインスタンスを模倣する方法を示しています。
Turbo Module用の手動モックを、モジュールに隣接する__mocks__サブディレクトリ(src/turbo-modules/__mocks__/NativePinger.tsなど)に追加できます。 ターボモジュールのコンシューマーにモックを提供して、独自のテストを円滑に行えるようにすることができます。たとえば、JestのsetupFilesに渡せるモックファイルを提供できます。

手順6: ビルド構成を追加する

テンプレートからターボモジュールを生成した場合、この手順はすでに完了しているはずです。ただし、テンプレートによって提供されるコードを調整したり、追加のCodegenパラメーターを指定したりした場合は、この情報が役立つ場合があります。

自動リンク

Vegaターボモジュールは自動リンクされています。つまり、ネイティブモジュールはアプリによって直接リンクされるのではなく、アプリの依存関係とパッケージ構成に従ってVega向けReact Nativeによってロードされます。ターボモジュールの開発者は、ターボモジュールの登録と構成コードを追加する必要があります。
手順1: AutoLinkInit.cppにモジュールを登録する
kepler/AutoLinkInit.cppには、お使いのTurbo Moduleに合わせて調整された次のコードがあるはずです。
名前空間とクラス名はCodegenに渡される引数と一致しなければなりません。クラス名を渡さなかった場合、codegenはTurboModuleRegistry.getEnforcingの文字列を使用するため、KEPLER_REGISTER_TURBO_MODULE(namespace, classname)を上記のように使用できます。TurboModuleRegistryが使用する文字列とは異なるクラス名を渡した場合は、KEPLER_REGISTER_TURBO_MODULE_WITH_NAME(TurboModuleRegistry namestring, namespace, classname)マクロを使用できます。
手順2: react-native.config.jsにメタデータを追加する
すべてのターボモジュール型で、react-native.config.jsに自動リンク構成を指定します。 スタンドアロンのターボモジュールライブラリの場合
アプリ内ターボモジュールの場合。
動的リンク
linkDynamicは、アプリの起動時(起動レイテンシーが増加する)に自動リンクライブラリを読み込むか、JavaScriptによってTurbo Moduleが要求されたときに読み込むかを制御します。ライブラリの設定に関係なく、アプリケーションは独自のreact-native.config.jsで値をニーズに合ったものに上書きできます。わからない場合は、デフォルトをtrueに設定してください。

CMakeLists.txt

CMakeLists.txtはプロジェクトのビルドプロセスを定義し、CMakeがさまざまなコンパイラやIDE用の「makefiles」またはプロジェクトファイルを生成するために使用するコマンドと指示を含みます。プロジェクトのルートには、次のようなCMakeLists.txtがあるはずです。
この例では、プロジェクトのすべてのソースに1つのCMakeLists.txtファイルを使用していますが、プロジェクトのニーズに合わせて分割することもできます。

ビルドターゲティング

アプリ内ターボモジュールの場合、ビルドターゲティングはアプリのセットアップ手順に従って行う必要があります。 ビルドターゲティングはpackage.jsonまたはCLIビルドフラグで指定できます。

手順7: ターボモジュールをビルドする

チームでよく使用されるコマンドを実行したり、既存のスクリプトを段階的に実行したりするために、package.jsonスクリプトを調整できます。

手順8: 新しいターボモジュールをアプリで使用する

アプリ内ターボモジュールの場合、相対パスを使用してモジュールをインポートし、標準のJSモジュールと同じように呼び出すことができます。
スタンドアロンのターボモジュールライブラリの場合は、まずライブラリパッケージをアプリにインストールする必要があります。npm packによって生成された.tgzファイルをインストールするか、yarn workspacesやシンボリックリンクなどのセットアップを使用して、レジストリに公開せずにターボモジュールライブラリを消費することができます。
次に、標準のJSパッケージと同じようにインポートして使用します。
Jestでアプリのテストに合格するには、ネイティブのターボモジュールを模倣する必要があります。

再ビルド

npm packによって生成された.tgzファイルを使用してスタンドアロンのターボモジュールをアプリにインストールし、後でターボモジュールに変更を加える場合は、ターボモジュールを再ビルドした後に新しい.tgzを再インストールする必要があります。 このプロセスは通常、次のとおりです。
  1. ターボモジュールコードの変更
  2. ターボモジュール(npmパック)の再ビルド
  3. の実行
  4. アプリの再ビルド
アプリがシンボリックリンクを介してスタンドアロンのターボモジュールを使用している場合(つまり、依存関係がnpm install <TMパッケージへのパス>を介して追加されたか、アプリのpackage.jsonが.tgzへのパスの代わりにディレクトリパスを表示している)、またはyarn workspacesのようなセットアップを使用している場合は、ターボモジュールからアプリに変更を伝播するための再インストール手順は必要はありません。

関連トピック


最終更新日 2026年10月22日