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: ... })も失敗するため、パターンを切り替えるのではなく、依存関係の解決を修正してください。
npm ls @types/react-nativeを実行して、@types/react-nativeコミュニティがインストールされているかどうかを確認します。- それを
package.json(およびロックファイル内のトランジティブピン)から削除してから再インストールします。
'kepler'をPlatformOSTypeに自分で追加するのは、最後の手段です。別の理由でアップストリームのタイプに固定されている場合にのみ使用してください。
プラットフォーム固有の拡張子
プラットフォーム固有のコードが複雑になる場合は、コードを別々のファイルに分離することをお勧めします。React Nativeは、ファイルに付けられたプラットフォーム固有の拡張子を検出し、ほかのコンポーネントから要求されたときに適切なプラットフォームファイルを読み込みます。 Vega OS の場合は、.keplerエクステンションを使用してください。
例
プロジェクト内に次のファイルがあるとします。- 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などのプラットフォーム固有のファイル拡張子を使用した場合、ビルドシステムは次のように動作します。
- ビルドプロセス中にターゲットプラットフォームを検出します。
- Vega OSバンドルに
.keplerファイルのみを取り込みます。 .android最終バンドルからファイルを除外.ios- 使用されていないプラットフォーム固有のコードブランチを削除します。
重要な注意事項
Vega OSはプラットフォームシステムにkeplerとして登録されているため、Tree Shakingを正しく機能させるには、プラットフォーム固有のファイル名にkeplerというキーワード(vegaではなく)を使用する必要があります。
正しい例:
ベストプラクティス
- 違いが大きい場合はプラットフォーム固有のファイルを使用する: プラットフォーム間で実装が大きく異なる場合は、別のファイルに分離して
.kepler拡張子を付けます。 - 小さな違いにはPlatform.select()を使用する: スタイル設定や単純な条件ロジックなどの小さな違いには、1つのファイル内で
Platform.select()またはPlatform.OSによるチェックを使用します。 - 共有ロジックを共通ファイルにまとめる: プラットフォームに依存しないロジックは、プラットフォームの拡張子を付けずに共有ファイルにまとめて、できるだけコードを再利用します。
- Tree Shakingを利用する: プラットフォーム固有の拡張子を使用して、関連するコードだけをVega OSバンドルに含めるようにします。これにより、パフォーマンスを高め、バンドルサイズを小さくすることができます。

