次世代プラットフォーム

アプリケーションのディレクトリー・レイアウト

アプリケーションのディレクトリー・レイアウトを確認し、理解します。

表 1. アプリケーションが提供するソースコードのディレクトリ構造
ディレクトリー・パスまたはファイル 説明
パッケージ アプリケーション提供のストア・ルート・アプリケーション、シングル・スパ対応の角アプリケーション、およびライブラリーが含まれます。
パッケージ/アプリ/ストアルートアプリ store-root-application は、単一 spa フレームワークを活用してルーターまたはオーケストレーターとして機能し、複数の単一 spa 対応の角アプリケーションを構成する、バニラ JavaScript アプリケーションです。
注: このアプリケーションはカスタマイズできません。
packages/apps/store-root-app/src/assets/root-config/設定 アプリケーション提供の角アプリケーションの UMD (Universal Module Definition) モジュール、および各角アプリケーションのすべての経路を登録するための JSON 構成ファイルが含まれています。
  • core-import-map.json: カスタマイズできない、アプリケーションで提供される角アプリケーションの UMD モジュール。
  • feature-import-map.json: カスタマイズ可能な、アプリケーションで提供される角度アプリケーションの UMD モジュール。
  • core-routes.json: single-spa フレームワークに登録される認証前の経路。
  • feature-routes.json: single-spa フレームワークに登録される認証後の経路。
パッケージ/ライブラリー アプリケーション提供の角度ライブラリーが入っています。
パッケージ/フィーチャー アプリケーション提供のシングル・スパー対応の角度アプリケーションが含まれます。
パッケージ/ライブラリー/コア 再使用可能なシングルトンの角度サービス、コンポーネント、およびユーティリティー・サービスを含む角度ライブラリー。
パッケージ/ライブラリ/共通コンポーネント 再使用可能な角度コンポーネント、ディレクティブ、およびパイプを含む角度ライブラリー。

このライブラリー内のコンポーネントは、カスタマイズをサポートしていません。

パッケージ/ライブラリー/機能コンポーネント 再使用可能な角度機能コンポーネントを含む角度ライブラリー。 これらのコンポーネントは、特定のドメインまたは機能のユース・ケースに対応するために構築されています。 これらのコンポーネントは、Notes モーダル、住所キャプチャー/表示、製品詳細モーダルなどの画面で使用できます。
app-config.json アプリケーションが提供するすべてのAngularアプリケーションのポート contextRoot,などの開発サーバー構成を含むアプリケーション構成JSON。 app-config.json スキーマ定義について詳しくは、 表 1を参照してください。
注: カスタマイズのために app-config.json ファイルを編集したり変更したりしないようにしてください。
パッケージ/ライブラリー/スタイル このライブラリーには、アプリケーションで使用されるグローバルおよび共通のコンポーネント・スタイル、アイコン、およびイメージが含まれています。
表 2. 顧客のエクステンション・ソースコードを格納するディレクトリ構造
ディレクトリー・パスまたはファイル 説明
拡張 (extensions) 拡張シングル・スパ対応の角度アプリケーションおよびライブラリーが含まれています。
拡張/機能 拡張シングル・スパ対応の角アプリケーションが含まれています。 これには、新規に作成されたカスタム・アプリケーションおよびオーバーライドされたアプリケーション提供の画面が含まれます。
拡張機能/ライブラリー 拡張機能/ライブラリー
拡張機能/機能/コンポーネントのオーバーライド 差分拡張性を使用してアプリケーション提供のコンポーネントをオーバーライドするための角度アプリケーション。
拡張機能/機能/オーバーライド・モーダル 差分拡張性を使用してアプリケーション提供のモーダルをオーバーライドするための角度アプリケーション。
拡張機能/静的アセットのオーバーライド/ルート設定/カスタム カスタマイズに使用される JSON 構成ファイルが含まれています。
  • import-map.json: このファイルは、特定のアプリケーション用にロードする JavaScript モジュールを登録します。 import-mapsについて詳しくは、以下を参照してください。
  • routes.json: このファイルは、マイクロフロントエンド・アプリケーション内の経路を、経路をレンダリングする角度アプリケーションにリンクします。
app-config-overrides.json アプリケーション構成は、すべてのカスタム角度アプリケーションのポート contextRoot などの開発サーバー構成を含む JSON をオーバーライドします。 さらに、リモート・サーバーからカスタム・アプリケーションを提供する場合は、 useRemote: trueを構成することで実現できます。 app-config.json スキーマ定義について詳しくは、 表 1を参照してください。
拡張機能/ライブラリー/スタイル このライブラリーを使用して、アプリケーション提供の SASS スタイル変数をオーバーライドし、拡張で使用するカスタム・スタイルを追加します。
拡張機能/静的アセットのオーバーライド このフォルダーを使用して、アプリケーション提供の JSON 構成ファイル (変換バンドル JSON、ペルソナ構成 JSON、その他の類似の JSON 構成ファイルなど) をオーバーライドします。