Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
Vega OS用のアプリの構築時には、Vegaでのみ動作するプラットフォーム固有のコードを記述したり、プラットフォーム間の違いを処理するようにコードを構成したりしなければならない場合があります。このガイドでは、プラットフォーム固有の拡張子とPlatformモジュールをVega OSで使用する方法について説明します。

Platformモジュール

Vega向けReact Nativeには、アプリが実行されているプラットフォームを検出するためのPlatformモジュールが用意されています。Vega OSでは、このモジュールを使用してVega固有のコードを実行できます。

Platform.OS

Platform.OSプロパティは、現在のプラットフォームを表す文字列を返します。注: Vega OS では、Platform.OSを返します'kepler'。

Platform.select()

Platform.select()メソッドは、現在実行中のプラットフォームに応じた値を返します。Vega固有の値には、キーとしてkeplerを使用します。

タイプチェックPlatform.OS

Platform.OS === 'kepler'はVega SDKに同梱されているReact Nativeタイプをプロジェクトが解決する場合、タイプセーフになります。これらの型は'kepler'をPlatformOSTypeの結合に追加し、OS: 'kepler'とのVega OSインターフェイスを定義するので、TypeScriptは比較対象を正しく絞り込みます。Vegaアプリテンプレートはデフォルトでこのように設定されています。
tscでTS2367: This comparison appears to be unintentional because the types have no overlapが報告される場合、プロジェクトはSDKに同梱されている型ではなく、DefinitelyTypedのコミュニティ版@types/react-nativeパッケージを解決しています。その組合には'kepler'が含まれていません。同じ原因でPlatform.select({ kepler: ... })も失敗するため、パターンを切り替えるのではなく、依存関係の解決を修正してください。
  1. npm ls @types/react-nativeを実行して、@types/react-nativeコミュニティがインストールされているかどうかを確認します。
  2. それをpackage.json(およびロックファイル内のトランジティブピン)から削除してから再インストールします。
モジュール拡張によって'kepler'をPlatformOSTypeに自分で追加するのは、最後の手段です。別の理由でアップストリームのタイプに固定されている場合にのみ使用してください。

プラットフォーム固有の拡張子

プラットフォーム固有のコードが複雑になる場合は、コードを別々のファイルに分離することをお勧めします。React Nativeは、ファイルに付けられたプラットフォーム固有の拡張子を検出し、ほかのコンポーネントから要求されたときに適切なプラットフォームファイルを読み込みます。 Vega OS の場合は、.keplerエクステンションを使用してください。

例

プロジェクト内に次のファイルがあるとします。
このコンポーネントをインポートします。
React Nativeは、実行中のプラットフォームに基づいて適切なファイルを自動的に選択します。
  • Vega OSの場合:Button.kepler.tsxが読み込まれます
  • iOSの場合:Button.ios.tsxが読み込まれます
  • Androidの場合:Button.android.tsxが読み込まれます

サポートされる拡張子

次のファイルタイプで.kepler拡張子を使用できます。
  • .kepler.tsx - JSXを使用したTypeScript
  • .kepler.ts - TypeScript
  • .kepler.jsx - JSXを使用したJavaScript
  • .kepler.js - JavaScript

Tree Shakingとプラットフォーム固有のコード

Vega OSでは、プラットフォーム固有のTree Shakingが完全にサポートされています。つまり、アプリをビルドすると、バンドラーによってほかのプラットフォーム用のコードが自動的に除外され、バンドルサイズが小さくなります。

動作のしくみ

.kepler.tsxなどのプラットフォーム固有のファイル拡張子を使用した場合、ビルドシステムは次のように動作します。
  1. ビルドプロセス中にターゲットプラットフォームを検出します。
  2. Vega OSバンドルに.keplerファイルのみを取り込みます。
  3. .android最終バンドルからファイルを除外 .ios
  4. 使用されていないプラットフォーム固有のコードブランチを削除します。

重要な注意事項

Vega OSはプラットフォームシステムにkeplerとして登録されているため、Tree Shakingを正しく機能させるには、プラットフォーム固有のファイル名にkeplerというキーワード(vegaではなく)を使用する必要があります。 正しい例:
間違った例:

ベストプラクティス

  1. 違いが大きい場合はプラットフォーム固有のファイルを使用する: プラットフォーム間で実装が大きく異なる場合は、別のファイルに分離して.kepler拡張子を付けます。
  2. 小さな違いにはPlatform.select()を使用する: スタイル設定や単純な条件ロジックなどの小さな違いには、1つのファイル内でPlatform.select()またはPlatform.OSによるチェックを使用します。
  3. 共有ロジックを共通ファイルにまとめる: プラットフォームに依存しないロジックは、プラットフォームの拡張子を付けずに共有ファイルにまとめて、できるだけコードを再利用します。
  4. Tree Shakingを利用する: プラットフォーム固有の拡張子を使用して、関連するコードだけをVega OSバンドルに含めるようにします。これにより、パフォーマンスを高め、バンドルサイズを小さくすることができます。

関連リソース

React Nativeのプラットフォーム固有のコードパターンの詳細については、プラットフォーム固有のコードに関するReact Nativeのドキュメント(英語のみ)を参照してください。
最終更新日 2026年9月10日