[Reference App Structure](https://sap.github.io/spartacus-docs/reference-app-structure/#spartacus-features-module)

這個推薦的 Spartacus 應用程式結構旨在作為您設定自己的 Spartacus 應用程式時的參考。

Spartacus 是一個 Angular 庫，這意味著它可以在 Angular 應用程式中單獨使用，也可以整合到現有的 Angular 專案中。相反，您可以將任何其他 Angular 解決方案或庫新增到您的 Spartacus 專案中。

Spartacus 本身帶有多個層和概念，以及一些可以延遲載入開箱即用的較小特徵庫。自定義和第三方程式碼進一步增加了複雜性，您最終可能會得到難以維護的模組，因為它們將太多這些元素混合在一起。

這可以透過定義和遵守標準化結構來解決，例如 Spartacus 參考應用程式結構。擁有標準化結構還可以更輕鬆地將新開發人員納入您的專案、處理外部支援案例以及進行審計。

透過使用 Spartacus 參考應用程式結構，您可以從每個主要 Spartacus 版本提供的自動遷移中獲益最多，同時還保持新增自定義的靈活性，並在這些自定義之上構建新功能。使用參考應用程式結構還可以為 3.0 版本後移入單獨庫的功能利用程式碼拆分。

要檢視使用參考應用程式結構的工作示例，請參閱此[儲存庫](https://github.com/dunqan/spartacus-reference-structure)。

# Spartacus Module

該 module 匯入 B2C 或者 B2B 配置 module，以及 BaseStorefrontModule 和 SpartacusFeaturesModule：

![](https://img-blog.csdnimg.cn/img_convert/f2aef775083baafa07f8bf8de0b5b7eb.png)

匯出 BaseStorefrontModule.

注意，雖然 Angular Router 和 NgRx 都是 Spartacus 使用的，但是這些都會影響全域性應用，所以它們被儲存在 SpartacusModule 之外，直接匯入到 AppModule 中。

SpartacusModule 由以下部分組成：

* BaseStorefrontModule，它封裝了大多數 Spartacus 應用程式通常需要的核心 Spartacus 匯入。

BaseStorefrontModule 直接從@spartacus/storefront 匯入。
* SpartacusFeaturesModule，它封裝了 Spartacus 功能。
* SpartacusConfigurationModule，它封裝了通用的 Spartacus 配置。

在大多數情況下，Spartacus 模組不會被修改，因為更改通常封裝在配置模組或功能模組中。

下面是 SpartacusModule 的實現：

```typescript
import { NgModule } from '@angular/core';
import { BaseStorefrontModule } from '@spartacus/storefront';
import { SpartacusConfigurationModule } from './spartacus-configuration.module';
import { SpartacusFeaturesModule } from './spartacus-features.module';

@NgModule({
  imports: [
    BaseStorefrontModule,
    SpartacusFeaturesModule,
    SpartacusConfigurationModule,
  ],
  exports: [BaseStorefrontModule],
})
export class SpartacusModule {}
```

# Spartacus Configuration Module

該 Module 包含所有全域性的配置元素。

特性特定的配置可以儲存在特性模組中，也可以儲存在 SpartacusConfigurationModule 中。 將它們儲存在功能模組中有助於保持良好的關注點分離，因此通常建議這樣做，但如果有助於解決特定問題（例如，透過使用 env 更改配置）。

# Spartacus Features Module

SpartacusFeaturesModule 旨在輕鬆管理所有非核心 Spartacus 功能，包括靜態載入和延遲載入。 它充當所有功能的入口點，理想情況下，這些功能被包裝到自己的獨立功能模組中。

在早期的 3.x 次要版本中，SpartacusFeaturesModule 可能看起來臃腫而忙碌，但隨著每個連續的釋出，它應該變得更加簡潔，因為努力將大部分功能移到單獨的庫中。

例子：

![](https://img-blog.csdnimg.cn/img_convert/51d9757beca5352dce32c955d2391c6b.png)

![](https://img-blog.csdnimg.cn/img_convert/75e52508338999283f51ce13d09c136c.png)

# Specific Feature Modules

理想情況下，可以將一個完整的功能封裝到一個特定的功能模組中。該模組可以包含與功能相關的配置以及自定義。

以下是具有延遲載入配置的功能模組的示例：

![](https://img-blog.csdnimg.cn/img_convert/519214382fc884fe46e02a640d16b5b7.png)

FeatureModule eager 載入輕量級的 QuickOrderRootModule，然後使用延遲載入，去處理包含了重量級的 Service 和 Component 實現的 QuickOrderModule.

某些 feature module 的啟用與否，透過環境變數來決定：

![](https://img-blog.csdnimg.cn/img_convert/6efc616341d0082b025070e167e9df39.png)

SAP Spartacus module 層級結構設計的一種實踐

相關文章